Saltar para o conteúdo principal

​
Visão Geral

O ZeroPath se integra ao Linear para enviar descobertas de segurança como issues do Linear. Quando uma issue do Linear é concluída, a descoberta correspondente no ZeroPath é automaticamente marcada como resolvida.

​
Configuração

  1. Navegue até Settings → Integrations no painel do ZeroPath.
  2. Clique em “Connect Linear”.
  3. Autorize o ZeroPath na tela de consentimento do Linear.
  4. O ZeroPath detecta seu workspace do Linear e as equipes disponíveis.
A integração registra webhooks para todas as suas equipes do Linear para habilitar a sincronização bidirecional. Os webhooks são configurados com os tipos de recurso Issue e Comment — Issue é obrigatório para a sincronização de status, enquanto Comment é opcional, mas habilita uma triagem mais inteligente quando os tickets são fechados. Para configuração manual de webhooks, selecione no mínimo o tipo de recurso Issue. Adicionar Comment é recomendado — isso permite que o ZeroPath analise os comentários do ticket e classifique tickets fechados com mais precisão.
O Linear pode ser conectado no nível da organização (compartilhado entre todos os membros) ou no nível do usuário (pessoal). Conexões no nível da organização são recomendadas para que todos os membros da equipe possam exportar descobertas para o Linear sem que cada um precise da própria conexão. Se ambas existirem, a integração no nível da organização tem prioridade.

​
Exportação Manual de Issues

A partir de qualquer descoberta no painel do ZeroPath:
  1. Clique em “Export to Linear” na visualização de detalhes da issue.
  2. Selecione uma equipe do Linear e, opcionalmente, um responsável.
  3. Se você tiver um template configurado (consulte Templates Personalizados), pode ativar “Use Linear Template” para aplicá-lo. Desative o botão para editar manualmente o título e a descrição antes de exportar.
  4. O ZeroPath cria a issue do Linear com os detalhes da vulnerabilidade. Para descobertas de secrets, o trecho de código é automaticamente redigido para que valores de segredos em texto claro nunca sejam gravados em issues do Linear.
O ID da issue do Linear fica vinculado à descoberta no ZeroPath para rastreamento.

​
Exportação em Massa

Você pode exportar várias descobertas para o Linear de uma só vez:
  1. Selecione as descobertas que deseja exportar na lista de issues.
  2. Escolha “Export to Linear” no menu de ações em massa.
  3. Selecione uma equipe do Linear e, opcionalmente, um responsável.
  4. Se um template estiver configurado, você pode ativá-lo para aplicar o template a todas as issues exportadas.
  5. O ZeroPath cria issues do Linear para todas as descobertas selecionadas em lotes. Trechos de código de descobertas de secrets são automaticamente redigidos em todas as issues criadas.
Descobertas que já foram exportadas para o Linear são automaticamente ignoradas. Após a conclusão da exportação, você verá um resumo mostrando quantas issues foram exportadas, ignoradas ou falharam.

​
Criação Automática de Tickets

Configure a criação automática de issues:
  1. Acesse Settings → Integrations, selecione Linear na barra lateral e abra Auto-Ticketing.
  2. Defina um limite de pontuação — apenas descobertas acima dessa pontuação criam issues no Linear.
  3. Escolha quais tipos de scan disparam issues.
  4. Selecione a equipe do Linear na qual as issues serão criadas.
Trechos de código de descobertas de secrets são automaticamente redigidos em todas as issues criadas automaticamente, de modo que valores de segredos em texto claro nunca sejam gravados no Linear.

​
Datas de Vencimento por SLA

Habilite Set due date from SLA para marcar cada issue criada com o prazo de remediação da descoberta como a data de vencimento do Linear — a data de violação mais próxima entre todas as políticas de SLA que cobrem a issue. Isso se aplica tanto a issues criadas automaticamente quanto a issues exportadas manualmente. Se nenhuma política de SLA cobrir a descoberta, nenhuma data de vencimento é definida.

​
Atribuição Automática

A criação automática de tickets suporta a atribuição automática das issues recém-criadas no Linear. Você pode configurar o comportamento de atribuição de três maneiras:
  • Automática (git blame) — O ZeroPath analisa os dados de git blame do arquivo afetado e faz a correspondência dos contribuidores com usuários do Linear por email ou nome. O usuário do Linear com melhor correspondência é atribuído à issue. Este é o padrão.
  • Responsável fixo — Sempre atribui as issues criadas automaticamente a um usuário específico do Linear que você seleciona.
  • Desabilitada — Não atribui as issues criadas automaticamente a ninguém.
Ao exportar issues manualmente (individualmente ou em massa), você ainda pode escolher um responsável no diálogo de exportação. Se você selecionar um responsável manualmente, ele sempre tem prioridade sobre a configuração de atribuição automática.

​
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.
  • Você pode atribuir labels do Linear (obtidas da equipe selecionada) e definir um nível de prioridade (Urgent, High, Medium, Low, No Priority) para as issues criadas automaticamente.
  • Variáveis personalizadas podem ser mapeadas para dados da descoberta no ZeroPath ou definidas com valores estáticos.
Para configurar um template, abra as configurações de criação automática de tickets do Linear e clique em “Ticket Template”. O editor de templates oferece:
  • Abas de título e descrição para editar cada template de forma independente.
  • Um seletor de variáveis para inserir variáveis predefinidas ou personalizadas.
  • Uma pré-visualização ao vivo que mostra como o template será renderizado com dados de exemplo.
  • A possibilidade de restaurar os padrões a qualquer momento.
Ao exportar issues manualmente (individualmente ou em massa), você pode escolher entre aplicar o template configurado ou usar o formato padrão.

​
Sincronização Bidirecional

Quando o estado de uma issue do Linear muda para 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 o tipo de recurso Comment não estiver habilitado, 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 a mudança na trilha de auditoria da descoberta
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 Linear com concorrência controlada para respeitar os limites de taxa do Linear. 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 webhooks registrados no Linear durante a configuração. Diferentemente do Jira, os webhooks do Linear não expiram. Quando você desconecta uma integração do Linear, o ZeroPath limpa automaticamente os webhooks associados. Se várias integrações compartilharem o mesmo workspace do Linear, os webhooks são transferidos para uma integração ativa remanescente em vez de serem excluídos.

​
Solução de Problemas

“Linear integration not found”
  • Verifique se a integração está conectada em Settings → Integrations.
Issues não sincronizam de volta
  • Verifique se a issue do Linear foi criada pelo ZeroPath (apenas issues vinculadas sincronizam).
  • Verifique se o estado da issue mudou para “completed” (outros estados são ignorados).