Para ver el índice completo de la documentación, consulta llms.txt. Para ver la versión en Markdown de una página de la documentación, agrega .md al final de la URL de esa página.
Navegación principal
Tema

Notificaciones de Daybreak

Envía eventos de análisis de Daybreak a un webhook del Espacio de trabajo.

Con un webhook del Espacio de trabajo puedes enviar eventos de análisis a un servicio que controles. Por ejemplo, puedes usarlo para actualizar un panel de seguridad cuando termine un análisis o un ticket cuando cambien los resultados del análisis. Cada destino recibe los eventos que selecciones de todo tu Espacio de trabajo de ChatGPT.

Agregar un webhook del Espacio de trabajo

  1. En Daybreak, ve a Configuración > Notificaciones y selecciona Agregar.

  2. Ingresa un Nombre y una URL del punto de acceso. Usa un punto de acceso HTTPS accesible desde Internet que acepte solicitudes POST en el puerto 443.

  3. Elige qué eventos quieres recibir.

    • Análisis finalizado (scan.finished) indica si un análisis se completó, falló o se canceló.
    • Análisis actualizado (scan.updated) informa de cambios posteriores en los resultados de un análisis, como cambios en la validación o en el nivel de gravedad.
  4. Selecciona Agregar. Copia el secreto de firma y guárdalo en un lugar seguro. Daybreak muestra el secreto completo una sola vez.

  5. En el menú del destino, selecciona Enviar notificación de prueba y luego Enviar prueba. Daybreak envía un evento scan.finished de ejemplo con is_test: true y confirma la entrega cuando tu punto de acceso devuelve una respuesta 2xx.

Verificar y procesar las entregas

Daybreak envía una solicitud POST con un cuerpo en formato JSON y la firma con HMAC-SHA256. La firma abarca webhook-id, webhook-timestamp y el cuerpo original de la solicitud. Usa el encabezado webhook-signature para verificar la solicitud antes de procesar el evento. Pasa los bytes originales de la solicitud al verificador para evitar que los cambios en los espacios en blanco o en el formato JSON invaliden la firma. Para más detalles, consulta la especificación de Standard Webhooks. Para encontrar una biblioteca de verificación para tu lenguaje de programación, consulta las implementaciones de referencia de Standard Webhooks.

Comprueba el valor de is_test antes de iniciar tu flujo de trabajo de producción. Usa el campo id de la carga útil para identificar entregas repetidas y data.scan_id para agrupar los eventos de un mismo análisis. Daybreak concede 10 segundos por intento de entrega, incluidas las entregas de prueba. Una vez que tu servicio acepte el evento, devuelve una respuesta 2xx dentro de ese plazo. Si necesitas más tiempo para procesar el evento, guárdalo en una cola y responde antes de procesarlo.

Administrar destinos y rotar secretos

Selecciona Editar en el menú del destino. Puedes cambiar la URL, elegir otros eventos o desactivar la opción Habilitado para pausar las entregas. Selecciona Rotar secreto para reemplazar el secreto de firma. Copia el nuevo secreto y actualiza tu receptor. Si el receptor necesita tiempo para hacer el cambio, selecciona Mantener el secreto actual activo durante 24 horas al rotar el secreto. Durante ese plazo, Daybreak firma las entregas con ambos secretos, por lo que puedes verificar cada entrega con cualquiera de los dos. Si eliges la rotación inmediata, actualiza el receptor antes de enviar una nueva prueba.