> ## 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

> Ingérez les événements de détection Stairwell via un webhook JSON

Stairwell peut envoyer des événements de détection à n’importe quel point de terminaison HTTP qui accepte du JSON. Il est ainsi facile d’acheminer les alertes Stairwell vers Wirespeed à l’aide de votre pipeline existant compatible avec les webhooks.

Lorsque les événements configurés se déclenchent (par exemple, une correspondance d’un moteur antivirus ou une correspondance de règle YARA), Stairwell envoie une charge utile JSON à l’URI du webhook fournie par Wirespeed.

## Créer un jeton d’authentification dans Stairwell

1. Connectez-vous à [app.stairwell.com](https://app.stairwell.com)
2. Cliquez sur l’icône **Settings** dans le menu de gauche
3. Sélectionnez **Auth tokens** dans la section **Organization**
4. Cliquez sur **Generate Token** et choisissez **API/CLI token**
5. Donnez au jeton un nom descriptif (par exemple, `Wirespeed`)
6. Cliquez sur **Generate** et copiez immédiatement le jeton : il ne sera plus affiché

## Trouver l’ID de votre environnement dans Stairwell

1. Dans **Settings**, sélectionnez l’onglet **Environments**
2. L’ID de votre environnement est affiché sur la page de détail de l’environnement

## Configuration dans Wirespeed

1. Connectez-vous à Wirespeed et accédez à Intégrations > [**Ajouter une intégration**](https://app.wirespeed.co/settings/integrations?tab=browse) > **Stairwell**
2. Lisez cette documentation et confirmez que vous avez effectué les étapes de configuration requises
3. Collez le **jeton API** de Stairwell dans le champ **Jeton API**
4. Collez l’**Environment ID** de Stairwell dans le champ **ID d’environnement**
5. Cliquez sur **Intégrer**
6. Sélectionnez **Détails du webhook**
7. Copiez l’**URL du webhook** : vous l’utiliserez dans Stairwell

## Configurer le webhook dans Stairwell

1. Connectez-vous à votre environnement Stairwell
2. Créez ou mettez à jour la configuration de transfert d’événements/de webhook pour les détections que vous souhaitez envoyer
3. Collez l’**URL du webhook** de Wirespeed comme point de terminaison de destination
4. Enregistrez la configuration du webhook et déclenchez un événement de test si cette option est disponible

### Authentification facultative du webhook

Pour authentifier les rappels, activez **Vérifier l’authenticité du webhook** sur l’intégration Stairwell et copiez son **Secret du webhook** depuis les Détails du webhook de Wirespeed.

Privilégiez `Authorization: Bearer <WEBHOOK_SECRET>` partout où le relais de webhook peut définir des en-têtes.

L’interface de webhook native de Stairwell accepte une URI de destination plutôt que des en-têtes personnalisés. Dans ce cas, ajoutez `&webhookSecret=<WEBHOOK_SECRET>` en dernier recours. Le secret apparaît alors dans l’URI complète de la requête, que les serveurs web, les proxys inverses et les collecteurs de journaux enregistrent souvent. Considérez un secret intégré à l’URI comme exposé si un intermédiaire journalise les chaînes de requête, et renouvelez-le le cas échéant.

Si l’authentification est activée, les rappels sans le secret correct sont rejetés.

## Données ingérées

Wirespeed ingère les événements de détection Stairwell sous forme de charges utiles JSON, y compris des événements de webhook tels que :

* **Correspondances de moteurs antivirus**
* **Correspondances de règles YARA**
* **Autres détections Stairwell configurées**

Le webhook attend la structure JSON de correspondance de déclencheur de Stairwell : les champs de premier niveau `name`, `label`, `createTime`, `matchType`, `objectMetadata`, `objectSightings` et `triggerCondition` (y compris les correspondances YARA, MalEval, avis et rapports de menace facultatifs).

Chaque événement est normalisé en un enregistrement de détection et rendu consultable dans Wirespeed pour l’investigation et le triage.


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