Jira Automation | cside docs

Você pode transformar qualquer notificação do cside em um item de trabalho do Jira apontando um destino de webhook para uma regra do Jira Automation. Isso funciona em todos os planos e é a forma de levar resumos como PCI Report Available e Script Blocked by CSP para o Jira, já que a integração do Jira não entrega resumos.

Coloque o secret do Jira na URL

O Jira Automation espera o secret em um header X-Automation-Webhook-Token. Os webhooks do cside não conseguem enviar headers personalizados, então adicione o secret ao final da URL do webhook, como a Atlassian documenta para remetentes sem headers personalizados. Sem isso, o Jira rejeita todas as requisições com HTTP 400.

Jira Automation ou a integração do Jira?

A integração do Jira conecta o cside ao Jira via OAuth e cria uma issue por alerta, com uma tabela de detalhes e um link para o painel. Ela está incluída no plano Enterprise e atende somente os triggers imediatos.

Uma regra do Jira Automation alimentada por um webhook funciona em qualquer plano e para todos os triggers, incluindo os resumos. Você define no Jira como o item de trabalho vai ficar.

O que você vai precisar

Permissão para criar regras de automação no seu projeto do Jira
Uma notification config do cside para os alertas que você quer no Jira

Crie a regra no Jira

Adicione um trigger de incoming webhook

No seu projeto do Jira, abra Project settings > Automation e crie uma regra. Escolha o trigger Incoming webhook e defina Execute this rule with como No work items from the webhook (alguns sites do Jira ainda mostram o rótulo No issues from the webhook).

Crie o item de trabalho

Adicione uma ação Create work item e escolha o projeto e o tipo de trabalho. Preencha os campos a partir do payload do cside:

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

Defina somente campos que estão na tela de criação do projeto. O Jira ignora os demais e os informa no log de auditoria.

Ative a regra e copie a URL e o secret

Salve e ative a regra. O trigger passa a mostrar uma URL de webhook e um secret. Copie os dois.

Adicione o destino de webhook no cside

Monte a URL

Adicione uma barra e o secret ao final da URL do webhook:

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

Adicione o destino

Abra o painel e navegue até Team Settings > Notifications. Edite a notification config, clique em Add destination em Send To, selecione Webhook e preencha:

URL: a URL do passo anterior
Secret: qualquer valor. O cside o usa para assinar a requisição com um header x-cside-signature, que o Jira não verifica
Format: JSON

Clique em Save & Test.

Confirme que está funcionando

Save & Test envia um payload de exemplo. Para a maioria dos triggers, o summary dele começa com [Test]. Abra o Audit log da regra no Jira: você deve ver uma nova execução e um item de trabalho criado.

O Jira responde com HTTP 200 quando o secret está errado, então um teste bem-sucedido no cside não prova que a regra foi executada. A confirmação é o log de auditoria.

O que você vê	O que significa
O teste do cside falha com HTTP 400	O secret está faltando na URL. O Jira responde `Missing token`
O teste do cside falha com HTTP 404	A URL está errada, ou a regra foi excluída
O teste do cside é bem-sucedido, mas o log de auditoria não mostra nenhuma execução	O secret na URL está errado. Copie-o novamente do trigger
Log de auditoria: Summary is required	O campo Summary ficou vazio. Use `{{webhookData.summary}}`
Log de auditoria: Fields ignored	Um campo da ação não está na tela de criação, ou o usuário da automação não tem permissão para defini-lo. Remova o campo da ação

Mapeando outros campos

Todo webhook JSON do cside traz summary e description tanto no nível superior quanto dentro do seu objeto data, porque o Jira Automation trata de forma especial uma chave data de nível superior. É por isso que {{webhookData.summary}} funciona para todos os eventos. Os outros campos variam por evento; veja a referência do payload.

Para mapear mais campos, adicione uma Log action com {{webhookData}} antes de Create work item, envie um teste e leia o log de auditoria para ver exatamente o que o Jira recebeu. Referencie os campos como eles aparecem lá.

Mantenha o secret seguro

O secret agora faz parte da URL do destino, então qualquer pessoa que possa ver ou editar as suas configurações de notificação consegue lê-lo. Se ele vazar, gere um novo secret no trigger do Jira e atualize a URL no cside.

O que isso ainda não faz

O cside não consegue enviar o header X-Automation-Webhook-Token, que a Atlassian recomenda em vez do formato na URL
O cside não tenta reenviar um webhook de resumo que o Jira rejeita, e o histórico de entregas não é exibido no painel. Use Save & Test e o log de auditoria do Jira para confirmar a configuração