Saltar para o conteúdo principal

Visão Geral

Envie achados ao Jira Cloud ou ao Jira Data Center para acompanhar a correção com a equipe responsável. Com o webhook configurado, o status de tickets encerrados no Jira pode atualizar os achados vinculados no ZeroPath. A conexão exige a permissão Create Integrations, reservada a administradores da organização. Para trocar entre Cloud e Data Center, desconecte a integração atual antes de criar a nova.

Configuração

1

Navegue até Integrations

Acesse Settings → Integrations no painel do ZeroPath.
2

Conecte o Jira

Clique em Add Integration, selecione Jira / Confluence, escolha Connect with OAuth e autorize o ZeroPath na Atlassian.
3

Configuração Automática

O ZeroPath detecta automaticamente sua instância do Jira Cloud e o projeto padrão.
O ZeroPath tenta registrar um webhook para a sincronização bidirecional. Conexões OAuth usam a API de webhooks dinâmicos. Conexões com token de API ou de acesso pessoal usam a API legada de webhooks de administrador do Jira. Se o registro for recusado, inclusive para tokens com escopos ou contas sem permissões de administrador, a conexão é concluída e a configuração exibe a URL para um administrador do Jira registrar o webhook manualmente. A exportação de tickets funciona independentemente do webhook; atualizações automáticas vindas do Jira exigem o webhook.
OAuth também está disponível para o Jira Cloud. É necessário usar uma conta Atlassian que possa fazer login e autorizar o ZeroPath; contas de serviço não podem concluir esse login interativo.

Eventos de Webhook

O webhook do ZeroPath usa os seguintes eventos do Jira: Os eventos de comentário são opcionais, mas recomendados. Quando habilitados, o ZeroPath usa os comentários do ticket para classificar de forma inteligente tickets fechados como Resolved, False Positive ou Accepted Risk, em vez de sempre usar Resolved como padrão.

Exportação Manual de Issues

A partir de qualquer descoberta no painel do ZeroPath:
  1. Abra o achado, selecione More actions (⋯) e clique em Export to Jira. A opção só aparece quando o achado ainda não está vinculado a um ticket do Jira.
  2. Selecione um projeto do Jira, um tipo de issue (Bug, Story, Task etc.) e, opcionalmente, um epic e um responsável. Escolha um epic para um tipo de issue filho, como Bug, Story ou Task.
  3. O ZeroPath cria a issue do Jira com todos os detalhes da vulnerabilidade — título, descrição, arquivo afetado, severidade, pontuação CVSS, CWEs, trecho de código e link do patch, se disponível. Para descobertas de secrets, o trecho de código é automaticamente redigido para que valores de segredos em texto claro nunca sejam gravados em tickets do Jira.
O ZeroPath usa Parent no Jira Cloud e Epic Link no Jira Data Center. No Data Center, Epic Link deve estar disponível na tela de criação do tipo de issue selecionado, e a conta da integração deve poder visualizar o epic. Se o Jira rejeitar a exportação, a janela exibe o erro e mantém suas seleções e edições para que você possa corrigi-las e tentar novamente. O ZeroPath não tenta novamente uma exportação removendo o epic selecionado. A chave da issue do Jira fica vinculada à descoberta no ZeroPath para rastreamento bidirecional.

Exportação em Massa

Você pode exportar várias descobertas para o Jira de uma só vez:
  1. Selecione as descobertas que deseja exportar na lista de issues.
  2. Clique em Export no cabeçalho e escolha Export to Jira no diálogo Export Issues. Sem uma seleção, a exportação usa os primeiros 10.000 achados que correspondem aos filtros.
  3. Selecione um projeto do Jira, um tipo de issue e, opcionalmente, um epic e um responsável. Você pode selecionar “None” para limpar explicitamente a seleção de epic.
  4. Se um template do Jira estiver configurado, você pode ativar “Use Jira Template” para aplicá-lo a todas as issues exportadas.
  5. O ZeroPath cria issues do Jira para todas as descobertas selecionadas em lotes. Trechos de código de descobertas de secrets são automaticamente redigidos em todos os tickets criados.
Descobertas já vinculadas a tickets do Jira são automaticamente ignoradas. Após a conclusão da exportação, você verá um resumo mostrando quantas issues foram exportadas, ignoradas ou falharam, junto com o primeiro erro do Jira quando disponível. Se alguma exportação falhar, a janela permanece aberta com suas seleções preservadas. Ao tentar novamente, descobertas já vinculadas com sucesso são ignoradas.

Quem Pode Criar Tickets no Jira

Criar um ticket no Jira grava na sua instância do Jira usando as credenciais compartilhadas do Jira da organização, então o ZeroPath controla essa ação por uma permissão por repositório — Create Jira Tickets — e não pela conexão da integração no nível da organização. Essa permissão fica no grupo Issue Tracker Export do sistema de Equipes e Permissões e é concedida por equipe, controlando também o fluxo de exportação em massa. O comportamento do controle depende de a sua organização ter o controle de acesso habilitado:
  • Controle de acesso desabilitado (padrão). Qualquer membro da organização pode exportar descobertas para o Jira. Nenhuma restrição por equipe é aplicada.
  • Controle de acesso habilitado. Admins da organização sempre podem exportar. Qualquer outro membro só pode exportar uma descoberta se uma de suas equipes tiver a permissão Create Jira Tickets no repositório daquela descoberta — concedida diretamente, por meio de uma tag ou para toda a organização.
A exportação em massa aplica a mesma verificação por repositório a cada descoberta selecionada. Descobertas em repositórios onde você não tem a permissão são contadas como falhas e ignoradas, e o restante do lote ainda é exportado.
Restringir a criação de tickets a admins. Para limitar a criação de tickets no Jira aos admins da organização, habilite o controle de acesso e não conceda a permissão Create Jira Tickets a nenhuma equipe que não seja de admins. Admins sempre mantêm a capacidade de exportar; todos os demais ficam bloqueados. Conceda a permissão a equipes específicas (ou a repositórios específicos via tags) para ampliar o acesso conforme necessário.
O ZeroPath registra solicitações de exportação de uma única descoberta que passam pelas verificações de permissão como ações jira.exportIssue no log de auditoria da sua organização e solicitações de exportação em massa como ações jira.bulkExportIssues. Cada registro captura quem iniciou a solicitação, a descoberta ou as descobertas selecionadas e o projeto de destino no Jira. Essas ações registram tentativas de exportação, inclusive solicitações que o Jira rejeita posteriormente, portanto não confirmam por si só que os tickets foram criados.
A Criação Automática de Tickets é executada como uma ação do sistema a partir da configuração salva da sua organização e não está sujeita à permissão de exportação por usuário. Controle-a gerenciando quem pode editar as configurações da integração e definindo o escopo de cada configuração de criação automática para repositórios ou tags específicos.

Criação Automática de Tickets

Configure a criação automática de issues para novas descobertas:
  1. Em Settings → Integrations, selecione Jira e clique em Add Config em Jira Auto-Export Configurations.
  2. Defina a pontuação mínima. Achados abertos com pontuação igual ou superior podem criar tickets. Achados sem pontuação ficam fora da criação automática. Descobertas de secrets também precisam de um veredito confirmado: um segredo sinalizado pelo scanner, mas não confirmado pelo validador, não cria ticket, qualquer que seja sua pontuação. Isso evita que um ticket afirme um vazamento que nunca foi verificado.
  3. Escolha Full scans and dependency monitoring para scans completos, scans de dependências avulsos e novos achados do monitoramento de dependências. Use Export on PR Scans para configurar scans de PR separadamente.
  4. Selecione o projeto do Jira e o tipo de issue.
  5. Opcionalmente, selecione um epic para agrupar os tickets criados automaticamente. Se um epic configurado anteriormente não estiver mais disponível no Jira, um aviso é exibido para que você selecione um novo ou limpe a seleção.
  6. Opcionalmente, configure atribuição automática, templates personalizados e escopo (todos os repositórios, repositórios específicos ou repositórios que correspondam a tags específicas).
Se uma exportação automática falhar, sua configuração exibirá o erro mais recente nas configurações do Jira. O epic selecionado é preservado: se o Jira rejeitar esse vínculo, o ZeroPath informa a falha em vez de criar um ticket sem o epic. Corrija e salve a configuração; a mensagem também é removida após uma exportação bem-sucedida. Trechos de código de descobertas de secrets são automaticamente redigidos em todos os tickets criados automaticamente, de modo que valores de segredos em texto claro nunca sejam gravados no Jira.

Datas de Vencimento por SLA

Habilite Set due date from SLA para marcar cada ticket criado com o prazo de remediação da descoberta como a data de vencimento do Jira — a data de violação mais próxima entre todas as políticas de SLA que cobrem a issue. Isso se aplica tanto a tickets criados automaticamente quanto a tickets exportados manualmente. Se nenhuma política de SLA cobrir a descoberta, nenhuma data de vencimento é definida.
A data de vencimento exige que o tipo de issue selecionado exponha um campo Due date em sua tela de criação. Se não expuser, o ZeroPath avisa você ao salvar a configuração e ainda assim cria os tickets (sem data de vencimento). Se o Jira posteriormente rejeitar a data de vencimento de um ticket individual, o ZeroPath tenta novamente sem ela, de modo que o ticket ainda seja criado.

Templates Personalizados

A criação automática de tickets suporta templates personalizáveis de título e descrição com variáveis:
  • {{severity}}, {{issueTitle}}, {{repositoryName}}, {{affectedFile}}, {{vulnClass}}, entre outras.
  • Campos personalizados do Jira podem ser mapeados para dados da descoberta no ZeroPath ou para valores estáticos.

Sincronização Bidirecional

Quando o status de uma issue do Jira muda para Done, Resolved, Closed ou Completed, o ZeroPath automaticamente:
  • Analisa os comentários do ticket para determinar o status apropriado — Resolved, False Positive ou Accepted Risk
  • Se não houver comentários ou os eventos de comentário não estiverem habilitados, a descoberta assume Resolved como padrão
  • Se houver comentários, mas a intenção não puder ser determinada com confiança, a mudança de status é ignorada em vez de assumir Resolved como padrão, evitando uma triagem incorreta
  • Registra quem fez a mudança e quando
  • Registra a transição de estado na trilha de auditoria da descoberta
O ZeroPath seleciona a transição de workflow correta do Jira com base no status de destino. Ao marcar uma descoberta como Resolved, o ZeroPath escolhe uma transição de conclusão (como “Done”) e evita transições de cancelamento como “Won’t Do”. Ao marcar uma descoberta como False Positive ou Accepted Risk, o ZeroPath prefere uma transição de cancelamento, se houver uma disponível. Isso garante que os estados do workflow do Jira reflitam com precisão a decisão de triagem. Quando você muda o status de várias descobertas de uma vez (por exemplo, marcando muitas issues como falso positivo), o ZeroPath sincroniza cada atualização com o Jira com concorrência controlada para respeitar os limites de taxa do Jira Cloud. Se a atualização de um ticket individual falhar, as demais atualizações continuam — falhas parciais são registradas sem bloquear a ação em massa. Essa sincronização é alimentada por um webhook registrado na sua instância do Jira durante a configuração.
Webhooks do Jira Cloud criados pela API dinâmica (usada por conexões OAuth) expiram após 30 dias. O ZeroPath os renova automaticamente, mas se a sincronização parar de funcionar, reconecte a integração em Settings → Integrations para atualizar o webhook. Webhooks criados pela API legada de administrador (usada por conexões com token de API quando o usuário é administrador do site Jira) não expiram. Quando você reconecta, o ZeroPath remove automaticamente quaisquer webhooks obsoletos com segredos desatualizados antes de criar um novo.

Acesso ao Confluence

A integração com o Jira Cloud também pode habilitar o acesso ao Confluence. Para isso, conecte o Jira Cloud via OAuth ou token de API. Quando o Confluence está habilitado, o AI AppSec Assistant pode pesquisar e ler suas páginas do Confluence em busca de documentação de segurança, contexto de arquitetura e runbooks.

Habilitando o Confluence

  1. Conecte o Jira usando o método OAuth ou o de token de API descritos acima.
  2. Depois que o Jira estiver conectado, uma opção Confluence aparece na página de integrações. Você pode habilitá-la diretamente no diálogo Add Integration com um único clique — nenhuma autenticação adicional é necessária.
  3. Como alternativa, selecione Confluence na barra lateral de integrações e ative o botão Confluence Access.
A configuração usa as credenciais da integração existente com o Jira Cloud.

Desabilitando o Confluence

Para desabilitar o acesso ao Confluence, selecione Confluence na barra lateral de integrações e desative o botão Confluence Access. Isso não afeta sua integração com o Jira.

Templates de PR de Auto-Fix

Quando uma descoberta tem um ticket do Jira vinculado, os templates de auto-fix do ZeroPath podem referenciar o ticket. Você pode usar os placeholders {jira_id}, {jira_title} e {jira_url} nos templates de título do PR, descrição do PR, nome da branch e mensagem de commit para incluir os detalhes do ticket do Jira vinculado nos PRs de patch gerados. Consulte Referências a Tickets do Jira em Templates para mais detalhes.

Solução de Problemas

Verifique se a integração está conectada em Settings → Integrations.
Para conexões OAuth, verifique se o webhook do Jira expirou (limite de 30 dias) e reconecte a integração para atualizá-lo. Para conexões com token de API, verifique se o webhook foi registrado automaticamente (a resposta da configuração indica isso) ou crie-o manualmente na administração do Jira. Verifique também se a chave da issue do Jira corresponde a uma descoberta no ZeroPath (o vínculo é criado durante a exportação).
Verifique se o projeto e o tipo de issue selecionados existem na sua instância do Jira. Certifique-se de que os campos obrigatórios do Jira estejam configurados nas configurações de criação automática de tickets.