Jira
O que é
Plataforma de gestão de projetos e tickets. A integração é bidirecional: EterShield cria issues no Jira a partir de Tasks e Riscos, e o Jira atualiza o status de volta.
Como configurar
Em Settings → Integrações → Jira:
| Campo | Exemplo |
|---|---|
| URL | https://empresa.atlassian.net |
| Project Key | ES |
| Issue Type | Task |
utilizador@empresa.pt |
|
| API Token | Gerado em id.atlassian.com → API tokens |
Push automático de Tasks (novo)
Na integração Jira existe agora o toggle "Push automático para o Jira" (config.autoPush). Quando ativo:
- Toda Task nova ou atualizada é enviada automaticamente para o Jira, sem ser preciso clicar em "Sincronizar com Jira"
- Aplica-se à criação e à atualização de Tasks (não dispara a partir de Gaps diretamente, só via Task)
- Por omissão vem desativado, o fluxo manual (botão na página de detalhes) continua disponível
Como os dados entram/saem
EterShield → Jira:
- Qualquer Task pode ser enviada para Jira manualmente (botão na página de detalhes) ou automaticamente (ver acima)
- Qualquer Risk pode ser enviado para Jira
- Mapeamento de prioridades:
EterShield Jira CRITICAL Highest HIGH High MEDIUM Medium LOW Low INFO Lowest - Guarda
jiraIssueKeyejiraIssueUrlno registo
Jira → EterShield (webhook): Configurar em Jira → Settings → System → Webhooks:
- URL:
https://etershield.etergrowth.com/api/v1/integrations/jira/webhook - Headers:
x-api-key: SEU_API_KEY+x-tenant-id: SEU_TENANT_ID - Event:
Issue Updated
O endpoint valida a assinatura HMAC-SHA256 (x-hub-signature / x-hub-signature-256) quando um segredo de webhook está configurado no EterShield. Importante: configure sempre o segredo; se estiver em falta, a verificação de assinatura é ignorada (o webhook continua a exigir x-api-key + x-tenant-id, mas sem prova criptográfica de origem Jira).
Mapeamento de status:
| Jira | EterShield |
|---|---|
| To Do | TODO |
| In Progress | IN_PROGRESS |
| In Review | IN_REVIEW |
| Done | DONE (e Risk → MITIGATED) |
| Blocked | BLOCKED |
Fluxo completo
Onde aparece no EterShield
- Tasks → com link direto ao issue Jira
- Risks → com link direto ao issue Jira