Jira Automation | cside docs

Puedes convertir cualquier notificación de cside en un elemento de trabajo de Jira apuntando un destino de webhook a una regla de Jira Automation. Funciona en todos los planes, y es la forma de llevar a Jira resúmenes como PCI Report Available y Script Blocked by CSP, ya que la integración de Jira no entrega resúmenes.

Pon el secreto de Jira en la URL

Jira Automation espera su secreto en un encabezado X-Automation-Webhook-Token. Los webhooks de cside no pueden enviar encabezados personalizados, así que agrega el secreto al final de la URL del webhook, como indica Atlassian para los emisores que no admiten encabezados personalizados. Sin él, Jira rechaza todas las solicitudes con HTTP 400.

¿Jira Automation o la integración de Jira?

La integración de Jira conecta cside con Jira mediante OAuth y crea un issue por alerta, con una tabla de detalles y un enlace al panel de control. Está incluida en el plan Enterprise y solo gestiona los disparadores inmediatos.

Una regla de Jira Automation alimentada por un webhook funciona en cualquier plan y con todos los disparadores, incluidos los resúmenes. Tú decides en Jira cómo es el elemento de trabajo.

Lo que necesitarás

Permiso para crear reglas de automatización en tu proyecto de Jira
Una configuración de notificación de cside para las alertas que quieres llevar a Jira

Crear la regla en Jira

Agrega un disparador de webhook entrante

En tu proyecto de Jira, abre Project settings > Automation y crea una regla. Elige el disparador Incoming webhook y configura Execute this rule with como No work items from the webhook (algunos sitios de Jira todavía lo llaman No issues from the webhook).

Crea el elemento de trabajo

Agrega una acción Create work item y elige el proyecto y el tipo de trabajo. Rellena los campos con el payload de cside:

Summary: {{webhookData.summary}}
Description: {{webhookData.description}}

Configura solo los campos que estén en la pantalla de creación del proyecto. Jira ignora el resto y los indica en el registro de auditoría.

Activa la regla y copia la URL y el secreto

Guarda y activa la regla. El disparador muestra entonces una URL de webhook y un secreto. Copia ambos.

Agregar el destino de webhook en cside

Construye la URL

Agrega una barra y el secreto al final de la URL del webhook:

https://api-private.atlassian.com/automation/webhooks/jira/a/<id>/<id>/<secret>

Agrega el destino

Abre el panel de control y ve a Team Settings > Notifications. Edita la configuración de notificación, haz clic en Add destination debajo de Send To, selecciona Webhook y completa los campos:

URL: la URL del paso anterior
Secret: cualquier valor. cside lo usa para firmar la solicitud con un encabezado x-cside-signature, que Jira no comprueba
Format: JSON

Haz clic en Save & Test.

Confirma que funciona

Save & Test envía un payload de ejemplo. En la mayoría de los disparadores, su summary empieza por [Test]. Abre el Audit log de la regla en Jira: deberías ver una nueva ejecución y un elemento de trabajo creado.

Jira responde con HTTP 200 cuando el secreto es incorrecto, así que una prueba correcta en cside no demuestra que la regla se haya ejecutado. La confirmación es el registro de auditoría.

Lo que ves	Qué significa
La prueba de cside falla con HTTP 400	Falta el secreto en la URL. Jira responde `Missing token`
La prueba de cside falla con HTTP 404	La URL es incorrecta, o la regla se eliminó
La prueba de cside tiene éxito, pero el registro de auditoría no muestra ninguna ejecución	El secreto de la URL es incorrecto. Vuelve a copiarlo desde el disparador
Audit log: Summary is required	El campo Summary quedó vacío. Usa `{{webhookData.summary}}`
Audit log: Fields ignored	Un campo de la acción no está en la pantalla de creación, o el usuario de automatización no tiene permiso para configurarlo. Quita el campo de la acción

Asignar otros campos

Cada webhook JSON de cside incluye summary y description tanto en el nivel superior como dentro de su objeto data, porque Jira Automation trata de forma especial una clave data de nivel superior. Por eso {{webhookData.summary}} funciona con todos los eventos. Los demás campos varían según el evento; consulta la referencia del payload.

Para asignar más campos, agrega una Log action con {{webhookData}} antes de Create work item, envía una prueba y lee el registro de auditoría para ver exactamente qué recibió Jira. Haz referencia a los campos tal como aparecen ahí.

Protege el secreto

El secreto ahora forma parte de la URL del destino, así que cualquiera que pueda ver o editar tu configuración de notificaciones puede leerlo. Si se filtra, genera un secreto nuevo en el disparador de Jira y actualiza la URL en cside.

Lo que todavía no hace

cside no puede enviar el encabezado X-Automation-Webhook-Token, que Atlassian recomienda en lugar de poner el secreto en la URL
cside no reintenta un webhook de resumen que Jira rechace, y el historial de entregas no se muestra en el panel de control. Usa Save & Test y el registro de auditoría de Jira para confirmar la configuración