Saltar al contenido principal
Stairwell puede enviar eventos de detección a cualquier endpoint HTTP que acepte JSON. Así es sencillo dirigir las alertas de Stairwell a Wirespeed con su pipeline existente compatible con webhooks. Cuando se desencadenan los eventos configurados (por ejemplo, una coincidencia de motor AV o un acierto de regla YARA), Stairwell envía una carga útil JSON a la URI de webhook de Wirespeed.

​
Crear un token de autenticación en Stairwell

  1. Inicie sesión en app.stairwell.com
  2. Haga clic en el icono Settings del menú izquierdo
  3. Seleccione Auth tokens en la sección Organization
  4. Haga clic en Generate Token y elija API/CLI token
  5. Asigne al token un nombre descriptivo (p. ej., Wirespeed)
  6. Haga clic en Generate y copie el token de inmediato: no se volverá a mostrar

​
Buscar su environment ID en Stairwell

  1. En Settings, seleccione la pestaña Environments
  2. Su environment ID se muestra en la página de detalle del entorno

​
Configuración en Wirespeed

  1. Inicie sesión en Wirespeed y vaya a Integraciones > Añadir integración > Stairwell
  2. Lea esta documentación y confirme que ha completado los pasos de configuración necesarios
  3. Pegue el API token de Stairwell en el campo API Token
  4. Pegue su Environment ID de Stairwell en el campo Environment ID
  5. Haga clic en Integrar
  6. Seleccione Detalles del webhook
  7. Copie la URL del webhook: la usará en Stairwell

​
Configurar el webhook en Stairwell

  1. Inicie sesión en su entorno de Stairwell
  2. Cree o actualice la configuración de reenvío de eventos/webhook para las detecciones que desea enviar
  3. Pegue la URL del webhook de Wirespeed como endpoint de destino
  4. Guarde la configuración del webhook y desencadene un evento de prueba si está disponible

​
Autenticación opcional del webhook

Para autenticar las devoluciones de llamada, active Verificar la autenticidad del webhook en la integración de Stairwell y copie su Secreto del webhook desde Detalles del webhook de Wirespeed. Prefiera Authorization: Bearer <WEBHOOK_SECRET> siempre que el relay del webhook pueda establecer cabeceras. La interfaz nativa de webhook de Stairwell acepta una URI de destino en lugar de cabeceras personalizadas. En ese caso, añada &webhookSecret=<WEBHOOK_SECRET> como último recurso. El secreto aparece entonces en la URI completa de la solicitud, que los servidores web, los proxies inversos y los recolectores de registros suelen registrar. Trate un secreto incrustado en la URI como expuesto si algún intermediario registra las cadenas de consulta, y rótelo si eso ocurre. Si la autenticación está activada, se rechazan las devoluciones de llamada sin el secreto correcto.

​
Qué se ingesta

Wirespeed ingesta eventos de detección de Stairwell como cargas útiles JSON, incluidos eventos de webhook como:
  • Coincidencias de motor AV
  • Aciertos de reglas YARA
  • Otras detecciones de Stairwell configuradas
El webhook espera la forma JSON de coincidencia de desencadenador de Stairwell: name, label, createTime, matchType, objectMetadata, objectSightings y triggerCondition de nivel superior (incluidas coincidencias YARA opcionales, MalEval, opiniones e informes de amenazas). Cada evento se normaliza en un registro de detección y queda disponible para búsqueda en Wirespeed para investigación y triaje.