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
-
No Daybreak, acesse Configurações > Notificações e selecione Adicionar.
-
Preencha os campos Nome e URL do endpoint. Use um endpoint HTTPS acessível publicamente que aceite solicitações
POSTna porta 443. -
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.
- Varredura finalizada (
-
Selecione Adicionar. Copie o segredo de assinatura e guarde-o em um local seguro. O Daybreak exibe o segredo completo uma única vez.
-
No menu do destino, selecione Enviar notificação de teste e, em seguida, Enviar teste. O Daybreak envia um evento
scan.finishedde exemplo comis_test: truee confirma a entrega quando o endpoint retorna uma resposta2xx.
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.