Saltar al contenido
StartupKit
ES

Integración con PagerDuty

Conecta PagerDuty para recibir alertas de VDP, sincronizar guardias y hacer seguimiento del estado de incidentes en Kit.

Por qué importa

PagerDuty es donde la mayoría de los equipos de seguridad ya gestionan incidentes y guardias. Conectarlo a Kit significa que los informes de vulnerabilidades que requieren atención inmediata generan alertas reales en lugar de correos que quedan en una bandeja de entrada durante la noche.

Qué necesitas

  • Suscripción activa de Kit
  • Cuenta de PagerDuty con permiso para crear claves de API
  • Un servicio de PagerDuty dedicado a las alertas de VDP (recomendado)

Configuración

1. Crea una clave de API de PagerDuty

  1. Ve a PagerDuty > Integrations > API Access Keys
  2. Haz clic en Create New API Key
  3. Ponle el nombre “Kit VDP” y copia la clave

2. Obtén tu clave de integración

  1. Ve a PagerDuty > Services > Your VDP Service > Integrations
  2. Añade una integración Events API v2 (o usa una existente)
  3. Copia la Integration Key (también llamada routing key)

Para que los avisos de cada componente lleguen al equipo responsable, usa en su lugar la clave de integración de una Event Orchestration. Consulta Envía cada aviso al equipo responsable.

3. Conecta en Kit

  1. Ve a VDP > Settings > PagerDuty
  2. Pega ambas claves y haz clic en Connect to PagerDuty
  3. Kit valida la conexión y muestra una insignia de estado en verde

Eventos de alerta

Configura qué eventos generan avisos en PagerDuty. Cada evento tiene su propia severidad, Warning hasta que la cambies.

Evento Cuándo se dispara
Nuevo informe enviado Un investigador envía un informe de vulnerabilidad
SLA en riesgo Un informe se acerca a su fecha límite de SLA (verificado cada 15 min)
Incumplimiento de SLA Un informe supera su fecha límite de SLA
Severidad crítica evaluada Validas un informe con una de tus severidades de escalamiento (Crítico y Súper crítico de forma predeterminada)
Informe validado Validas cualquier informe
Informe atascado escalado Un informe atascado se escala a los administradores de tu programa

Qué dice cada aviso: el evento, la severidad evaluada, el componente del informe y su ID, por ejemplo SLA breached · Critical · Payments API — rpt_8Kd2. El campo de origen del incidente muestra el nombre de tu programa. Kit nunca copia en PagerDuty texto escrito por el investigador (título, tipo de vulnerabilidad, descripción), así que un informe no puede hacer llegar sus propias palabras al móvil de quien está de guardia. Un informe restringido genera el aviso Restricted report needs attention — rpt_8Kd2, sin su evento, su severidad ni su componente. El aviso conserva la severidad que fija su regla de alerta, así que la guardia lo sigue recibiendo con la urgencia adecuada.

Un incidente por informe

Kit asocia todos los avisos al informe, así que cada informe tiene como máximo un incidente abierto en PagerDuty. El primer evento lo abre. Mientras siga abierto, los eventos posteriores del mismo informe no vuelven a avisar: PagerDuty añade cada uno al registro de alertas del incidente como una activación más, de modo que el incidente reúne el historial del informe. Validar un informe Crítico con las reglas Severidad crítica evaluada e Informe validado activadas genera un solo aviso, no dos.

Cuando un informe se agrava: PagerDuty conserva la severidad más alta que recibe en un incidente. Si Informe validado abrió el incidente con severidad Warning y más tarde llega Severidad crítica evaluada con Critical, el incidente pasa a Critical. En un servicio configurado con notificaciones dinámicas, eso sube la urgencia del incidente de baja a alta, con lo que pasan a aplicarse tus reglas de notificación de urgencia alta. En un servicio con urgencia fija, el evento posterior solo queda en el registro de alertas, y PagerDuty no vuelve a avisar de un incidente que alguien ya ha reconocido. Para recibir un aviso cuando un informe pase a crítico, usa notificaciones dinámicas y asigna a Severidad crítica evaluada una severidad más alta que al resto de tus reglas.

Las repeticiones del disparador Incumplimiento de SLA también se limitan antes de llegar siquiera a PagerDuty, según el cupo de alertas de incumplimiento de tu programa: tres repeticiones separadas por seis horas, de forma predeterminada.

Envía cada aviso al equipo responsable

Kit envía todos los avisos a una sola clave de integración. Con la clave de un servicio, todos los avisos llegan a ese servicio. Para avisar al equipo responsable del componente de un informe, pega en Kit la clave de integración de una Event Orchestration y deja que la orquestación elija el servicio. Las reglas de enrutamiento de las orquestaciones están disponibles en todos los planes de PagerDuty.

  1. En PagerDuty, abre Event Orchestration (en Configuration > Events & Routing, o en AIOps en algunas cuentas) y crea una orquestación
  2. Abre sus Integrations y copia la clave de integración
  3. En Kit, pégala como Clave de integración en VDP > Settings > PagerDuty
  4. Añade una Service Route por componente, con la condición event.custom_details.component_id matches 'cmp_…'. Copia el ID de cada componente desde VDP > Configuración del programa > Componentes. El ID no cambia cuando renombras un componente, así que una ruta basada en él sigue funcionando
  5. Edita la ruta catch-all para que envíe los eventos sin coincidencia a tu servicio de triaje

No te olvides de la ruta catch-all: por defecto, PagerDuty silencia un aviso que no coincide con ninguna ruta y no notifica a nadie. Los avisos de informe nuevo suelen llegar antes de que alguien asigne un componente, y los informes restringidos nunca llevan uno, así que ambos solo llegan a la ruta catch-all.

El enrutamiento sigue al primer aviso del incidente: un incidente se queda en el servicio en el que se abrió, y los avisos posteriores del informe se suman a él allí. Cambiar el componente de un informe no avisa a nadie. El siguiente aviso del informe resuelve el incidente abierto en su servicio anterior y abre uno nuevo para el nuevo componente, de modo que un informe nunca tiene dos incidentes abiertos. El aviso de un agente de revisión se suma al incidente abierto sin moverlo. Solo el componente que confirmas en el informe dirige un aviso, nunca uno sugerido.

Campo Qué envía Kit
component El nombre del componente del informe; no se envía si el informe no tiene o si está restringido
group El nombre de tu programa
class El evento: new_report, sla_at_risk, sla_breach, critical_assessment, report_validated, escalation, o agent_escalation cuando un agente de revisión marca un informe como posiblemente crítico. En un informe restringido, siempre restricted_report
custom_details.component_id El ID del componente, cmp_…
custom_details.component El nombre del componente
custom_details.program_id El ID de tu programa
custom_details.report_id El ID del informe, rpt_…
custom_details.severity La severidad evaluada; no se envía en los informes restringidos

El aviso de un informe restringido no indica componente, severidad evaluada ni evento: solo el ID del informe, tu programa y restricted_report como evento.

El Dynamic Routing de PagerDuty también puede elegir el servicio a partir de un campo del evento, pero solo en orquestaciones con el complemento AIOps, y descarta los eventos cuyo campo de enrutamiento no puede leer. Una ruta por componente es la configuración más segura.

Sincronización de guardias

Cuando está activada, Kit consulta tu horario de guardia de PagerDuty cada 5 minutos y actualiza automáticamente a la persona de guardia en Kit.

  1. En la página de configuración de PagerDuty, selecciona un horario de guardia en el menú desplegable
  2. Kit asocia los usuarios de PagerDuty con los usuarios de Kit por dirección de correo
  3. En la página de guardias, selecciona el modo PagerDuty

Si un usuario de PagerDuty no se encuentra en Kit: la guardia anterior se mantiene activa y aparece una advertencia en la página de configuración.

El cambio manual sigue disponible en el modo PagerDuty. El horario de guardia se reanuda en la siguiente sincronización.

Actualizaciones de incidentes (bidireccional)

Cuando alguien reconoce o resuelve un incidente en PagerDuty, Kit recibe la actualización vía webhook y la refleja en la cronología del informe.

Acción en PagerDuty Efecto en Kit
Incidente reconocido El informe muestra el estado “Acknowledged via PagerDuty”
Incidente resuelto El informe muestra el estado “Resolved via PagerDuty”

Importante: Los cambios de estado en PagerDuty no cambian el estado del informe de forma automática. Las decisiones de triaje (validar, rechazar, resolver) se mantienen manuales en Kit.

Cerrar un informe resuelve su incidente

Cuando un informe deja de estar abierto (lo resuelves, lo cierras como informativo o lo rechazas, duplicados incluidos), Kit resuelve en PagerDuty el incidente del informe. Los cambios entre estados cerrados, como de Resuelto a Corrección verificada, no envían nada. Una vez resuelto el incidente, en Kit o en PagerDuty, el siguiente evento del informe abre un incidente nuevo, por ejemplo cuando un informe cerrado se reabre y vuelve a generar avisos.

Configuración del webhook

  1. Copia la Webhook URL que aparece en la página de configuración de PagerDuty
  2. En PagerDuty, ve a Integrations > Generic Webhooks (v3)
  3. Crea una nueva suscripción de webhook con tu URL de Kit
  4. Selecciona los eventos: incident.acknowledged e incident.resolved

Solución de problemas

Síntoma Causa Solución
“Connection failed” al guardar Token de API no válido Regenera el token en PagerDuty y pégalo de nuevo
Las alertas no crean incidentes El evento no está activado en las reglas de alerta Revisa el interruptor de cada tipo de evento en la página de configuración
Un evento posterior no generó ningún aviso El informe ya tiene un incidente abierto Busca el evento en el registro de alertas de ese incidente en PagerDuty
Los avisos no llegan a nadie No coinciden con ninguna ruta y la ruta catch-all los silencia Dirige la ruta catch-all de la orquestación a tu servicio de triaje
Un aviso siguió llegando al equipo anterior El incidente se abrió antes de cambiar el componente El siguiente aviso del informe abre el incidente en el servicio del nuevo componente
Las guardias no se sincronizan El correo del usuario en PD no coincide con el de Kit Asegúrate de que el correo del usuario en PagerDuty coincida con el de su cuenta de Kit
La conexión muestra una insignia roja de error El token de API fue revocado o caducó Reconecta con un token nuevo; Kit pausa todas las alertas cuando falla la autenticación

Lista de verificación rápida

  • Crea una clave de API de PagerDuty con alcance a tu servicio de VDP
  • Pega la clave de API y la clave de integración en VDP > Settings > PagerDuty
  • Activa al menos una regla de alerta (recomendado: SLA incumplido + evaluación crítica)
  • (Opcional) Selecciona un horario de guardia de PagerDuty para la sincronización de guardias
  • (Opcional) Configura el webhook en PagerDuty para las actualizaciones bidireccionales
  • Verifica haciendo clic en Test en la página de configuración

Escriba para buscar...