> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Stairwell

> Stairwell-Detektionsereignisse per JSON-Webhook erfassen

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](https://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**](https://app.wirespeed.co/settings/integrations?tab=browse) > **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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.