sdk/1.1.0 · aktualisiert am 09.07.2026

Integrationen und SDK

Erste Abläufe zum Verbinden von Sensoren, Empfangen von Signalen und Nutzen der ADDA-Auswertung.

Das Integrationshandbuch zeigt, wie Sensoren, Vertrauensabfragen, Evidence und Reputationsmodule mit einer gemeinsamen Referenz verbunden werden.

Eine gute Integration endet nicht, wenn der Endpoint antwortet. Sie erfordert auch die Prüfung von Format, Governance, Nachvollziehbarkeit und der Wirkung der neuen Quelle auf Aufgaben, Vorfälle, Automatisierungen und das lebende Handbuch.

Nutzen Sie diesen Leitfaden, um eine technische Verbindung in eine echte betriebliche Fähigkeit innerhalb von ADDA zu verwandeln.

Checkliste

• Sensor oder Domain registrieren, bevor produktive Ingestion aktiviert wird.
• Vertrauensauswertung und Evidence-Erfassung mit kontrollierten Fällen testen.
• Häufige Integrationsfehler dokumentieren.

Schnellstart

1. Zuerst die zu integrierende Quelle oder Domain registrieren.
2. Einen minimalen End-to-End-Ablauf testen, bevor die Integration als bereit gilt.
3. Eine wiederkehrende Frage der Integration in einen Handbuchkandidaten umwandeln.

Operativer Ablauf

Verbinden

Sensor, Quelle oder Modul registrieren, das Signale übertragen wird.

Technische und betriebliche Identität der Integration definieren.

Validieren

Prüfen, ob Ereignisse, Scores oder Evidence ein für ADDA nützliches Format haben.

Feststellen, ob die Auswertung wirklich in den richtigen Ablauf gelangt.

Produktiv machen

Die Integration gegebenenfalls mit Dokumentation, Handbuch, Aufgaben oder Automatisierungen verknüpfen.

Vom übrigen Produkt isolierte Integrationen vermeiden.

flowchart LR
  S1["Verbinden"]
  S2["Validieren"]
  S3["Produktiv machen"]
  S1 --> S2
  S2 --> S3

Validatoren und Prüfungen

Sie führen eine kontextbezogene Auswertung dieser Oberfläche aus und liefern vorgeschlagene Schritte mit operativem Fokus.

Integrationsablauf validieren

Fasst Artikel und nächste Schritte für technisches und betriebliches Onboarding zusammen.

Beispiele

Minimales Ereignis für Ingestion

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

Links und Referenzen

Zugehörige Routen

Öffentliche Integrationen Sensoren im Workspace

APIs

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

Docs und unterstützende Routen

docs/ADDA_API.md
docs/ADDA_MANUAL.md

Häufige Probleme

• Eine Quelle ohne betriebliche Validierung zu verbinden, erzeugt meist mehr Rauschen als Abdeckung.
• Fehlende Dokumentation häufiger Fehler lässt das Team Diagnosen wiederholen.

Empfohlene Aktionen

• Die Integration mit Quickstarts, Beispielen und sichtbaren Routen produktiv machen.
• Jede wiederkehrende Onboarding-Lücke zum Handbuchkandidaten hochstufen.

Nützliche Reason Codes

Score-Wörterbuch

severity

Institutionelle Priorität des Signals auf der ADDA-Skala.

action

Vom System empfohlener nächster betrieblicher Schritt.

reasonCodes

Erklärbare Gründe zur Rechtfertigung der Bewertung.

Protokollhinweise

• Eine bereite Integration fließt in betriebliche Abläufe ein, nicht nur in die API.

Artikelverlauf

09.07.2026

Der Artikel wurde um einen Integrations-Quickstart und ein Ingestion-Beispiel erweitert.