API-Referenz

Jede ausgehende Zustellung wird mit HMAC-SHA256 unter Verwendung des Signing-Secrets Ihres Webhooks signiert. Das aktuelle Schema (v2) bindet einen Zeitstempel in die signierte Zeichenkette ein, um Replay-Angriffe zu verhindern; das Legacy-Schema v1 bleibt für laufende Zustellungen während eines Deploys unterstützt.

Verifizierung auf Empfängerseite (Node.js):

const crypto = require('crypto'); function verify(headers, rawBody, secret) {  const ts = headers['x-execlave-timestamp'];  const sig = headers['x-execlave-signature'].replace('sha256=', '');  const ver = headers['x-execlave-signature-version'] ?? 'v1';   const signedPayload = ver === 'v2' ? `${ts}.${rawBody}` : rawBody;  const expected = crypto.createHmac('sha256', secret)    .update(signedPayload)    .digest('hex');   // Vergleich in konstanter Zeit  const a = Buffer.from(expected, 'hex');  const b = Buffer.from(sig, 'hex');  if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) {    throw new Error('Invalid webhook signature');  }   // v2: ein gleitendes Replay-Fenster erzwingen (±5 Minuten empfohlen)  if (ver === 'v2') {    const now = Math.floor(Date.now() / 1000);    if (Math.abs(now - parseInt(ts, 10)) > 300) {      throw new Error('Webhook timestamp outside replay window');    }  }} // Idempotenz: über X-Execlave-Idempotency-Key deduplizieren (stabil über Wiederholungen).// Schlüssel mit kurzer TTL (z. B. 24 Std.) persistieren und Duplikate ablehnen.

Wichtig: Verifizieren Sie gegen die rohen Anfrage-Bytes, nicht gegen ein neu serialisiertes JSON-Objekt — jede Änderung an Leerzeichen oder Schlüsselreihenfolge bricht den HMAC-Vergleich.

Ein Wechsel auf resolved, closed oder false_positive setzt die Auflösungs-Zeitstempel, aus denen time_to_resolution_seconds berechnet wird, hängt einen status_change-Eintrag an die Zeitleiste an und benachrichtigt die zugewiesene Person. Wird ein Vorfall mit agentId angelegt, löst das zusätzlich ein trace.error-Webhook-Ereignis aus. Jedes Anlegen und Ändern wird im manipulationssicheren Audit-Log festgehalten.

Diese Endpunkte werden vom Python-Processing-Dienst bedient. Prüfen Sie zuerst GET /api/v1/anomaly/health — er meldet available, die gemessene latencyMs, die database-Konnektivität und bei Störung einen reason. Ist der Dienst nicht verfügbar, können die Endpunkte für Erkennung, RCA und Prognose keine Ergebnisse liefern.