Para ver o índice completo da documentação, consulte llms.txt. Para acessar a versão em Markdown de uma página da documentação, acrescente .md ao final da URL da página.
Navegação principal
Tema

Notificações do Daybreak

Envie eventos de varredura do Daybreak para um webhook do espaço de trabalho.

Você pode usar um webhook do espaço de trabalho para enviar eventos de varredura a um serviço que você controla. Por exemplo, você pode atualizar um painel de segurança quando uma varredura terminar ou atualizar um chamado quando os resultados da varredura mudarem. Cada destino recebe os eventos que você selecionar em todo o seu espaço de trabalho do ChatGPT.

Adicionar um webhook do espaço de trabalho

  1. No Daybreak, acesse Configurações > Notificações e selecione Adicionar.

  2. Preencha os campos Nome e URL do endpoint. Use um endpoint HTTPS acessível publicamente que aceite solicitações POST na porta 443.

  3. Escolha quais eventos deseja receber.

    • Varredura finalizada (scan.finished) indica que a varredura foi concluída, falhou ou foi cancelada.
    • Varredura atualizada (scan.updated) indica alterações posteriores nos resultados de uma varredura, como mudanças na validação ou no nível de gravidade.
  4. Selecione Adicionar. Copie o segredo de assinatura e guarde-o em um local seguro. O Daybreak exibe o segredo completo uma única vez.

  5. No menu do destino, selecione Enviar notificação de teste e, em seguida, Enviar teste. O Daybreak envia um evento scan.finished de exemplo com is_test: true e confirma a entrega quando o endpoint retorna uma resposta 2xx.

Verificar e processar entregas

O Daybreak envia uma solicitação POST com corpo em JSON e assinatura HMAC-SHA256. A assinatura abrange os valores de webhook-id e webhook-timestamp e o corpo original da solicitação. Use o cabeçalho webhook-signature para verificar a solicitação antes de processar o evento. Passe os bytes originais da solicitação ao verificador para evitar que alterações nos espaços em branco ou na formatação do JSON invalidem a assinatura. Para mais detalhes, consulte a especificação Standard Webhooks. Para encontrar bibliotecas de verificação para sua linguagem, consulte as implementações de referência do Standard Webhooks.

Verifique is_test antes de acionar o fluxo de trabalho de produção. Use o id do payload para identificar entregas repetidas e o campo data.scan_id para agrupar eventos da mesma varredura. O Daybreak aguarda até 10 segundos por tentativa de entrega, inclusive nos testes. Assim que o serviço aceitar o evento, retorne uma resposta 2xx dentro desse prazo. Se o processamento exigir mais tempo, coloque o evento em uma fila e responda antes de processá-lo.

Gerenciar destinos e fazer a rotação de segredos

No menu do destino, selecione Editar. Você pode alterar a URL, escolher outros eventos ou desmarcar a opção Ativado para pausar as entregas. Selecione Rotacionar segredo para substituir o segredo de assinatura. Copie o novo segredo e atualize o serviço que recebe os eventos. Se o serviço precisar de tempo para passar a usar o novo segredo, selecione Manter o segredo atual ativo por 24 horas durante a rotação. Nesse período, o Daybreak assina cada entrega com os dois segredos, e o serviço pode verificá-la com qualquer um deles. Se optar pela rotação imediata, atualize o serviço antes de enviar um novo teste.