Zum Hauptinhalt springen
Stairwell kann Detektionsereignisse an jeden HTTP-Endpunkt senden, der JSON akzeptiert. So lassen sich Stairwell-Warnungen einfach über Ihre bestehende webhookfähige Pipeline an Wirespeed weiterleiten. Wenn konfigurierte Ereignisse ausgelöst werden (zum Beispiel ein Treffer einer AV-Engine oder einer YARA-Regel), sendet Stairwell eine JSON-Nutzlast an die Webhook-URI von Wirespeed.

​
Authentifizierungstoken in Stairwell erstellen

  1. Melden Sie sich unter app.stairwell.com an
  2. Klicken Sie im linken Menü auf das Symbol Settings
  3. Wählen Sie im Abschnitt Organization die Option Auth tokens
  4. Klicken Sie auf Generate Token und wählen Sie API/CLI token
  5. Geben Sie dem Token einen aussagekräftigen Namen (z. B. Wirespeed)
  6. Klicken Sie auf Generate und kopieren Sie das Token sofort – es wird nicht erneut angezeigt

​
Umgebungs-ID in Stairwell finden

  1. Wählen Sie unter Settings die Registerkarte Environments
  2. Ihre Umgebungs-ID wird auf der Detailseite der Umgebung angezeigt

​
Einrichtung in Wirespeed

  1. Melden Sie sich bei Wirespeed an und navigieren Sie zu Integrationen > Integration hinzufügen > Stairwell
  2. Lesen Sie diese Dokumentation und bestätigen Sie, dass Sie die erforderlichen Einrichtungsschritte abgeschlossen haben
  3. Fügen Sie das API-Token aus Stairwell in das Feld API-Token ein
  4. Fügen Sie Ihre Umgebungs-ID aus Stairwell in das Feld Umgebungs-ID ein
  5. Klicken Sie auf Integrieren
  6. Wählen Sie Webhook-Details
  7. Kopieren Sie die Webhook-URL – Sie benötigen sie in Stairwell

​
Webhook in Stairwell konfigurieren

  1. Melden Sie sich bei Ihrer Stairwell-Umgebung an
  2. Erstellen oder aktualisieren Sie die Konfiguration für Ereignisweiterleitung/Webhook für die Detektionen, die Sie senden möchten
  3. Fügen Sie die Webhook-URL aus Wirespeed als Zielendpunkt ein
  4. Speichern Sie die Webhook-Konfiguration und lösen Sie, falls verfügbar, ein Testereignis aus

​
Optionale Webhook-Authentifizierung

Um Callbacks zu authentifizieren, aktivieren Sie Webhook-Authentizität überprüfen in der Stairwell-Integration und kopieren Sie das zugehörige Webhook-Secret aus den Webhook-Details in Wirespeed. Verwenden Sie bevorzugt Authorization: Bearer <WEBHOOK_SECRET>, wo immer das Webhook-Relay Header setzen kann. Die native Webhook-Oberfläche von Stairwell akzeptiert eine Ziel-URI, aber keine benutzerdefinierten Header. Hängen Sie in diesem Fall als letzte Möglichkeit &webhookSecret=<WEBHOOK_SECRET> an. Das Secret erscheint dann in der vollständigen Anfrage-URI, die Webserver, Reverse Proxies und Protokollsammler häufig aufzeichnen. Betrachten Sie ein in der URI eingebettetes Secret als offengelegt, wenn eine zwischengeschaltete Komponente Query-Strings protokolliert, und rotieren Sie es in diesem Fall. Wenn die Authentifizierung aktiviert ist, werden Callbacks ohne das korrekte Secret abgelehnt.

​
Was erfasst wird

Wirespeed erfasst Stairwell-Detektionsereignisse als JSON-Nutzlasten, einschließlich Webhook-Ereignissen wie:
  • Treffer von AV-Engines
  • Treffer von YARA-Regeln
  • Andere konfigurierte Stairwell-Detektionen
Der Webhook erwartet die JSON-Struktur eines Stairwell-Trigger-Matches: die Felder name, label, createTime, matchType, objectMetadata, objectSightings und triggerCondition auf oberster Ebene (einschließlich optionaler YARA-Treffer, MalEval, Opinions und Threat Reports). Jedes Ereignis wird in einen Detektionsdatensatz normalisiert und in Wirespeed für Untersuchung und Triage durchsuchbar gemacht.