sdk/1.1.0 · mis à jour le 9 juil. 2026

Intégrations et SDK

Premiers parcours pour connecter des capteurs, recevoir des signaux et consommer l'évaluation ADDA.

Le manuel des intégrations montre comment connecter les capteurs, les requêtes de confiance, evidence et les modules de réputation avec une référence partagée.

Une bonne intégration ne s'arrête pas lorsque l'endpoint répond. Elle exige aussi de valider le format, la gouvernance, la traçabilité et l'impact de cette nouvelle source sur tasks, incidents, automations et le manuel vivant.

Utilisez ce guide pour transformer une connexion technique en véritable capacité opérationnelle dans ADDA.

Liste de contrôle

• Enregistrer le capteur ou le domaine avant d'activer l'ingestion en production.
• Tester l'évaluation de confiance et l'enregistrement d'evidence avec des cas contrôlés.
• Documenter les erreurs d'intégration fréquentes.

Démarrage rapide

1. Enregistrez d'abord la source ou le domaine à intégrer.
2. Testez un flux end-to-end minimal avant de considérer l'intégration comme prête.
3. Si l'intégration laisse une question récurrente, transformez-la en manual candidate.

Flux opérationnel

Connecter

Enregistrer le capteur, la source ou le module qui enverra les signaux.

Définir l'identité technique et opérationnelle de l'intégration.

Valider

Vérifier que les événements, scores ou evidence utilisent un format utile pour ADDA.

Voir si l'évaluation entre réellement dans le bon flux.

Industrialiser

Relier l'intégration aux docs, au manuel, aux tasks ou automations lorsque nécessaire.

Éviter les intégrations isolées du reste du produit.

flowchart LR
  S1["Connecter"]
  S2["Valider"]
  S3["Industrialiser"]
  S1 --> S2
  S2 --> S3

Validateurs et contrôles

Ils exécutent une lecture contextuelle de cette surface et proposent des étapes à visée opérationnelle.

Valider le parcours d'intégration

Résume les articles et prochaines étapes de l'onboarding technique et opérationnel.

Exemples

Événement minimal pour l'ingestion

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

Liens et références

Routes associées

Intégrations publiques Capteurs dans l'espace de travail

APIs

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

Docs et routes d'appui

docs/ADDA_API.md
docs/ADDA_MANUAL.md

Problèmes fréquents

• Connecter une source sans validation opérationnelle produit souvent plus de bruit que de couverture.
• Ne pas documenter les erreurs fréquentes oblige l'équipe à répéter les diagnostics.

Actions suggérées

• Industrialisez l'intégration avec des quickstarts, des exemples et des routes visibles.
• Promouvez en manual candidate toute lacune récurrente de l'onboarding.

Reason codes utiles

Dictionnaire de score

severity

Priorité institutionnelle du signal sur l'échelle ADDA.

action

Prochaine étape opérationnelle recommandée par le moteur.

reasonCodes

Motifs explicables qui justifient l'évaluation.

Notes de protocole

• Une intégration prête entre dans les flux opérationnels, pas uniquement dans l'API.

Historique de l'article

9 juil. 2026

Article enrichi d'un quickstart d'intégration et d'un exemple d'ingestion.