Passer au contenu principal
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
  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 > 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.