sdk/1.1.0 · aggiornato il 9 lug 2026

Integrazioni e SDK

Primi percorsi per collegare sensori, ricevere segnali e utilizzare la valutazione ADDA.

Il manuale delle integrazioni mostra come collegare sensori, query di fiducia, evidence e moduli di reputazione con un riferimento condiviso.

Una buona integrazione non termina quando l'endpoint risponde. Richiede anche di convalidare formato, governance, tracciabilità e l'impatto della nuova fonte su tasks, incidents, automations e manuale vivo.

Usa questa guida per trasformare una connessione tecnica in una reale capacità operativa all'interno di ADDA.

Lista di controllo

• Registrare il sensore o il dominio prima di abilitare l'ingestione in produzione.
• Testare la valutazione della fiducia e la registrazione di evidence con casi controllati.
• Documentare gli errori frequenti dell'integrazione.

Avvio rapido

1. Registra prima la fonte o il dominio da integrare.
2. Prova un flusso end-to-end minimo prima di considerare pronta l'integrazione.
3. Se l'integrazione lascia un dubbio ricorrente, trasformalo in manual candidate.

Flusso operativo

Collegare

Registrare il sensore, la fonte o il modulo che invierà i segnali.

Definire l'identità tecnica e operativa dell'integrazione.

Convalidare

Verificare che eventi, scores o evidence abbiano un formato utile per ADDA.

Controllare che la valutazione entri davvero nel flusso corretto.

Trasformare in prodotto

Collegare l'integrazione a documentazione, manuale, tasks o automations quando applicabile.

Evitare integrazioni isolate dal resto del prodotto.

flowchart LR
  S1["Collegare"]
  S2["Convalidare"]
  S3["Trasformare in prodotto"]
  S1 --> S2
  S2 --> S3

Validatori e controlli

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

Convalidare il percorso di integrazione

Riepiloga articoli e prossimi passi per l'onboarding tecnico e operativo.

Esempi

Evento minimo per l'ingestione

{
  "type": "sensor.alert",
  "source": "adda-agent-demo",
  "severity": "yellow",
  "summary": "Se detecta actividad anómala en endpoint observado."
}

Link e riferimenti

Route correlate

Integrazioni pubbliche Sensori nel workspace

APIs

/api/adda/v1/sensors
/api/adda/v1/sensors/register
/api/adda/v1/events/ingest

Docs e route di supporto

docs/ADDA_API.md
docs/ADDA_MANUAL.md

Problemi frequenti

• Collegare una fonte senza convalida operativa produce spesso più rumore che copertura.
• Non documentare gli errori frequenti porta il team a ripetere le diagnosi.

Azioni suggerite

• Trasforma l'integrazione in prodotto con quickstarts, esempi e rotte visibili.
• Promuovi a manual candidate ogni lacuna ricorrente dell'onboarding.

Reason code utili

Dizionario degli score

severity

Priorità istituzionale del segnale sulla scala ADDA.

action

Prossimo passo operativo consigliato dal motore.

reasonCodes

Motivi spiegabili che giustificano la valutazione.

Note di protocollo

• Un'integrazione pronta entra nei flussi operativi, non soltanto nell'API.

Cronologia dell'articolo

9 lug 2026

L'articolo è stato ampliato con quickstart di integrazione ed esempio di ingestione.