Visão geral
Language

Linear

Aprenda como configurar o Linear como um endpoint de notificação para criar automaticamente issues a partir de alertas de segurança do cside.

Disponibilidade

Os endpoints de notificação do Linear estão incluídos no plano Enterprise e disponíveis como complemento para os planos Business. Entre em contato com vendas para começar.

Visão geral

Conecte o cside ao seu espaço de trabalho do Linear para criar automaticamente issues quando alertas de segurança são acionados. Cada alerta cria um issue do Linear na equipe que você configurar, proporcionando à sua equipe visibilidade completa dentro do fluxo de trabalho existente.

Pré-requisitos

Antes de configurar um endpoint de notificação do Linear, você precisa conectar sua conta do Linear como uma integração de equipe:

  1. Abra o painel e navegue até as Configurações da equipe
  2. Selecione a aba Integrations
  3. Clique em Connect ao lado de Linear e siga o fluxo de autorização OAuth
  4. Uma vez autorizado, você pode configurar endpoints de notificação do Linear em qualquer domínio da equipe

Configurar um endpoint de notificação do Linear

  1. Abra o painel, navegue até as Configurações do domínio e selecione a aba Notifications
  2. Clique em Add em Notification Endpoints
  3. Selecione Linear das opções
  4. Clique em Next para prosseguir para a tela de configuração
  5. No modal Configure Linear Endpoint, preencha os campos obrigatórios:
    • Team: Selecione a equipe do Linear onde os issues devem ser criados
  6. Clique em Create Linear Endpoint para completar a configuração

Uma vez criado, o cside criará automaticamente um issue do Linear na sua equipe selecionada sempre que um alerta de segurança for acionado para este domínio.

Como é um issue do Linear?

Cada issue do Linear criado pelo cside inclui:

  • Título: cside Security Alert: {tipo de alerta} on {domínio}
  • Descrição (em markdown) com os seguintes detalhes:
    • O domínio afetado
    • O tipo de alerta
    • O alvo (URL do script ou hash que acionou o alerta)
    • A ação tomada
    • Um link para o painel do cside para investigação adicional

Testes

Após configurar um endpoint de notificação do Linear, use o botão Send a Test Notification na página de configurações de Notificações para verificar se a integração está funcionando. Um issue de teste será criado na sua equipe do Linear com um aviso de que nenhuma ação é necessária.

Próximos passos

  • Adicionar mais endpoints de notificação - você pode configurar múltiplos endpoints por domínio (por exemplo, Linear + webhook do Slack) na aba Notifications nas configurações do seu domínio
  • Conectar outras integrações - visite Configurações da equipe > Integrações para conectar Jira ou outros serviços
  • Configurar domínios adicionais - cada domínio pode ter seu próprio conjunto de endpoints de notificação, então repita a configuração para qualquer outro domínio que deseje monitorar

Remover um endpoint do Linear

Para remover um endpoint de notificação do Linear:

  1. Navegue até as Configurações do domínio e selecione a aba Notifications
  2. Encontre o endpoint do Linear na lista
  3. Clique no botão de excluir ao lado do endpoint