trustapi/1.1.0 · aggiornato il 9 lug 2026

Indice di fiducia e automazione

Come capire se una visita sembra umana, automatizzata o coordinata e stabilire il passaggio successivo.

L'indice di fiducia riunisce in un solo punto la lettura di IP, dominio, sessione o campagna. Supporta il giudizio umano con motivi espliciti e un'azione suggerita.

La lettura dello score non sostituisce la decisione dell'operatore: la orienta. I reason codes chiariscono perché un caso sembra benigno, misto o rischioso e aiutano a procedere verso verifica, limitazione, watchlist o Evidence.

Quando lo stesso pattern appare su più superfici, lo score migliora se usato insieme a incidents, tasks, Access, Mail, WAF o Intel.

Lista di controllo

• Confrontare la lettura dell'automazione con quelle di sessione e dominio.
• Confermare che l'azione consigliata corrisponda alla gravità.
• Registrare contributi se i motivi non bastano a spiegare la decisione.

Avvio rapido

1. Leggi severity, action e reason codes come un'unica frase operativa.
2. Confronta lo score con il modulo interessato prima di bloccare per impostazione predefinita.
3. Se il caso è sensibile, porta la lettura in un incident, task o Evidence.

Flusso operativo

Consultare

Acquisisci una lettura di IP, dominio, sessione o campagna.

Usare il tipo di score più adatto al caso.

Spiegare

Trasforma i reason codes in criteri condivisi per il team.

Allineare il linguaggio tecnico e operativo.

Decidere

Collega l'azione suggerita al modulo che eseguirà realmente la misura.

Non trattare lo score come se fosse l'azione stessa.

flowchart LR
  S1["Consultare"]
  S2["Spiegare"]
  S3["Decidere"]
  S1 --> S2
  S2 --> S3

Validatori e controlli

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

Convalidare la lettura TrustAPI

Riassume articoli, checks e prossimi passaggi su score e spiegazione.

Esempi

Payload per lo score di sessione

{
  "sessionId": "sess_ops_001",
  "domain": "login.capacero.ar",
  "ip": "198.51.100.18"
}

Link e riferimenti

Route correlate

BotRadar nella console TrustAPI pubblica

APIs

/api/adda/v1/trust/score
/api/adda/v1/score/ip
/api/adda/v1/score/domain

Docs e route di supporto

docs/ADDA_API.md
docs/ADDA_PROTOCOLO.md

Problemi frequenti

• Trattare l'azione suggerita come ordine automatico senza esaminare il modulo interessato.
• Non registrare i motivi quando il segnale è misto impedisce una revisione successiva.

Azioni suggerite

• Usare Copilot e Manual quando lo score non basta a giustificare l'azione.
• Passare a Evidence se la lettura ha portato a blocco, revoca o contenimento forte.

Reason code utili

BOT_HIGH

L'automazione stimata è elevata per il contesto analizzato.

Applicare verifica o limitazione progressiva.

GEO_ANOMALY

L'origine o il percorso atteso non sono coerenti.

Confrontare con Access, DNS o un incident prima di accordare fiducia.

SESSION_RISK

La sessione presenta caratteristiche che richiedono un monitoraggio attento.

Esaminare continuità e controlli sulla sessione o sul dispositivo.

Dizionario degli score

severity

Priorità istituzionale del segnale sulla scala ADDA.

action

Passaggio operativo successivo consigliato dal motore.

reasonCodes

Motivi spiegabili per giustificare la lettura.

Note di protocollo

• Lo score acquista valore quando è collegato a una superficie di risposta concreta.

Cronologia dell'articolo

9 lug 2026

Sono stati ampliati il glossario e il percorso operativo dello score.