Configurar um webhook de SIEM
Antes de começar
- Verifique se um projeto doGoogle Cloud para o Google SecOps está configurado e se a API Chronicle está ativada para o projeto.
Vincular uma instância do Google SecOps aos serviços do Google Cloud .
Como usar os exemplos de linha de comando
Este documento inclui exemplos de comandos curl para ajudar você a configurar e testar seu feed de webhook. Esses exemplos usam variáveis de marcador de posição editáveis. Para usá-los de forma eficaz:
Edite as variáveis: ao seguir as etapas de configuração, você vai receber valores para o endpoint do webhook, uma chave de API e um secret. Clique nas variáveis de marcador de posição no exemplo de código e as substitua pelos valores reais:
ENDPOINT_URL: o URL do endpoint do feed recebido ao criar um feed de webhook HTTPS.API_KEY: a chave de API que você criou para o feed de webhook para autenticar no Google SecOps.SECRET: a chave secreta gerada quando você cria um feed de webhook HTTPS.
Se você editar uma variável em um exemplo de código, ela será atualizada em todos os exemplos desta página.
Copiar o comando: clique no ícone Copiar o exemplo de código no bloco de código.
Execute o comando: cole o comando copiado no ambiente do terminal e execute-o.
Verifique se o comando
curlinclui a flag--fail(ou-f). Isso garante que ocurlretorne um código de saída diferente de zero se a solicitação HTTP falhar e um código de saída de0para indicar sucesso. Isso é necessário para a próxima etapa.Verifique se o comando foi bem-sucedido: um comando
curlbem-sucedido não retorna nenhuma saída. Para confirmar o sucesso, faça o seguinte:Se o comando
curlincluiu a flag--fail(ou-f), verifique o código de saída executando o seguinte comando imediatamente depois:echo $?Um código de saída
0indica que a operação foi concluída.
Configurar um feed de webhook HTTPS
Para configurar um feed de webhook HTTPS, faça o seguinte:
- Crie um feed de webhook HTTPS e copie o URL do endpoint e a chave secreta.
- Crie uma chave de API para usar com o URL do endpoint. Também é possível reutilizar sua chave de API para autenticar no Google SecOps.
- Especifique o URL do endpoint no aplicativo.
Enviar vários eventos em uma única solicitação de webhook
O exemplo de código a seguir mostra como formatar um único corpo de solicitação com vários objetos JSON separados por nova linha:
curl --location 'ENDPOINT_URL' \
--header 'Content-Type: application/json' \
--header 'X-goog-api-key: API_KEY' \
--header 'X-Webhook-Access-Key: SECRET' \
--data $'{"principal": {"asset_id": "asset 123"}, "metadata": {"event_type": "GENERIC_EVENT", "product_name": "Product Acme"}}\n{"principal": {"asset_id": "asset 123"}, "metadata": {"event_type": "GENERIC_EVENT", "product_name": "Product Acme"}}' \
--fail
Criar um feed de webhook HTTPS
- No menu do Google SecOps, selecione Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
- Clique em Adicionar novo feed.
- No campo Nome do feed, insira um nome para o feed.
- Na lista Tipo de origem, selecione Webhook.
- Selecione o Tipo de registro. Por exemplo, para criar um feed para o Open Cybersecurity Schema Framework, selecione Open Cybersecurity Schema Framework (OCSF) como o Tipo de registro.
- Clique em Próxima.
- Opcional: especifique valores para os seguintes parâmetros de entrada:
- Delimitador de divisão: o delimitador usado para separar linhas de registro, como
\n. - Namespace do recurso: o namespace do recurso.
- Rótulos de ingestão: o rótulo a ser aplicado aos eventos desse feed.
- Delimitador de divisão: o delimitador usado para separar linhas de registro, como
- Clique em Próxima.
- Revise a configuração do novo feed na tela Finalizar e clique em Enviar.
- Clique em Gerar chave secreta para gerar uma chave secreta e autenticar esse feed.
- Copie e armazene a chave secreta, porque não será possível visualizá-la novamente. É possível gerar uma nova chave secreta, mas isso torna a chave secreta anterior obsoleta.
- Na guia Detalhes, copie o URL do endpoint do feed no campo Informações do endpoint. É necessário especificar esse URL de endpoint no aplicativo cliente.
- Opcional: clique no botão Feed ativado para desativar o feed. O feed é ativado por padrão.
- Clique em Concluído.
Criar uma chave de API para o feed de webhook
- Acesse a página Credenciais do console do Google Cloud .
- Clique em Criar credenciais e, em seguida, selecione Chave de API.
- Restrinja o acesso da chave de API à API Chronicle.
Especificar o URL do endpoint
- No aplicativo cliente, especifique o endpoint HTTPS disponível no feed do webhook.
Ative a autenticação especificando a chave de API e a chave secreta como cabeçalhos personalizados no seguinte formato:
X-goog-api-key: API_KEY X-Webhook-Access-Key: SECRETRecomendamos que você especifique a chave de API como um cabeçalho em vez de especificá-la no URL.
curl --location 'ENDPOINT_URL' \ --header 'Content-Type: application/json' \ --header 'X-goog-api-key: API_KEY' \ --header 'X-Webhook-Access-Key: SECRET' \ --data '{"principal": {"asset_id": "asset 123"}, "metadata": {"event_type": "GENERIC_EVENT", "product_name": "Product Acme"}}' \ --failSe o cliente do webhook não for compatível com cabeçalhos personalizados, especifique a chave de API e a chave secreta usando parâmetros de consulta no seguinte formato:
ENDPOINT_URL?key=API_KEY&secret=>SECRET
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.