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

> Ingestar eventos de detección de Stairwell mediante webhook JSON

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


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