adda-access/1.1.0 · aggiornato il 9 lug 2026

ADDA Access: dispositivi, sessioni e tunnel

Come gestire la fiducia dei dispositivi, le sessioni, le policy e i tunnel senza perdere continuità.

ADDA Access riunisce dispositivi, sessioni, policy, chiavi, rotte e tunnel per garantire continuità di accesso secondo criteri di fiducia.

L'operatività non termina con l'apertura o la chiusura di una sessione. Occorre anche capire se il dispositivo ha perso postura, se il tunnel si è degradato, se la policy è obsoleta o se una credenziale non merita più fiducia.

Questa guida aiuta a collegare la valutazione Access con Login Shield, API Shield, incident, task ed evidence affinché una misura sensibile rimanga spiegabile e reversibile.

Lista di controllo

• Esaminare dispositivi, sessioni e policy prima di revocare l'accesso.
• Confermare se il tunnel o il dispositivo hanno perso trust score.
• Registrare evidence o task quando la misura influisce sulla continuità operativa.

Avvio rapido

1. Leggi prima lo stato generale di Access per vedere copertura, fiducia e peer degradati.
2. Poi esamina dispositivi o sessioni per individuare l'origine della perdita di fiducia.
3. Se la misura influisce sulla continuità, apri un task o un incident prima di chiudere definitivamente.

Flusso operativo

Misurare la postura

Esamina il numero di dispositivi, sessioni attive, policy e tunnel rischiosi.

Rilevare se il problema è ampio o circoscritto.

Isolare la causa

Individua se il rischio proviene dal dispositivo, dalla sessione, dal peer o dalla policy.

Applicare la misura più piccola che risolva il problema.

Coordinare la continuità

Se è necessario chiudere, ruotare o revocare, collega la misura a task, incident o evidence.

Preservare continuità e verificabilità.

flowchart LR
  S1["Misurare la postura"]
  S2["Isolare la causa"]
  S3["Coordinare la continuità"]
  S1 --> S2
  S2 --> S3

Validatori e controlli

Eseguono una lettura contestuale di questa superficie e restituiscono passaggi suggeriti con un taglio operativo.

Esaminare lo stato Access

Restituisce i segnali Access attuali e gli articoli correlati.

Incrociare Access con il login

Si concentra sulla continuità di accesso davanti a tentativi di autenticazione sensibili.

Esempi

Payload per creare o aggiornare una sessione

{
  "deviceId": "device_demo_001",
  "policyId": "policy_ops_001",
  "memberId": "member-demo-001",
  "riskScore": 48
}

Link e riferimenti

Route correlate

Access nel workspace Access nell'amministrazione

APIs

/api/adda/v1/access/status
/api/adda/v1/access/devices
/api/adda/v1/access/sessions
/api/adda/v1/access/policies

Docs e route di supporto

docs/ADDA_API.md
docs/ADDA_SOC_OPERATIVO.md

Problemi frequenti

• Chiudere sessioni senza considerare policy o continuità può interrompere operazioni legittime.
• Mantenere un trust score basso senza task o incident rende difficili da spiegare le decisioni ripetute.

Azioni suggerite

• Esegui l'escalation a un incident se il problema coinvolge più dispositivi, tunnel o peer.
• Usa evidence se revochi una credenziale o interrompi una continuità rilevante.

Reason code utili

SESSION_RISK

La sessione attiva presenta caratteristiche che richiedono contenimento.

Esaminare policy, dispositivo e continuità prima di chiudere.

ACCESS_DEVICE_LOW_TRUST

Il dispositivo ha perso fiducia operativa.

Rafforzare la verifica o riesaminare la postura del dispositivo.

TUNNEL_DEGRADED

Il tunnel o il peer presenta degrado o rischio.

Valutare rotazione, contenimento o cambio di rotta.

Dizionario degli score

trustScore

Fiducia del dispositivo in base a postura e attività.

deviceRisk

Rischio accumulato da agente, tunnel e sessioni.

sessionsActive

Numero di sessioni attive associate al dispositivo.

Note di protocollo

• La continuità sicura vale più di una revoca anticipata senza coordinamento.

Cronologia dell'articolo

9 lug 2026

Nuovo articolo operativo Access incentrato su continuità, fiducia ed escalation.