Recolha registos do Atlassian Bitbucket

Vista geral

Este analisador extrai campos dos registos JSON do Atlassian Bitbucket e mapeia-os para o UDM. Processa vários formatos de registos, preenche entidades principais ou de destino com base em campos disponíveis, como endereços IP, IDs de utilizadores e informações de recursos. Também categoriza os eventos com base na atividade de rede e do utilizador, e enriquece os dados com conclusões de segurança, se presentes. O analisador dá prioridade a agentRealtimeInfo em relação a agentDetectionInfo ao preencher campos.

Antes de começar

Certifique-se de que tem os seguintes pré-requisitos:

• Instância do Google SecOps.
• Acesso privilegiado a um repositório no interior.

Configure feeds

Para configurar um feed, siga estes passos:

1. Aceda a Definições do SIEM > Feeds.
2. Clique em Adicionar novo feed.
3. Na página seguinte, clique em Configurar um único feed.
4. No campo Nome do feed, introduza um nome para o feed (por exemplo, Registos do Atlassian Bitbucket).
5. Selecione Webhook como o Tipo de origem.
6. Selecione Atlassian Bitbucket como o Tipo de registo.
7. Clicar em Seguinte.
8. Opcional: especifique valores para os seguintes parâmetros de entrada:
   • Delimitador de divisão: o delimitador usado para separar linhas de registo, como \n.
   • Espaço de nomes do recurso: o espaço de nomes do recurso.
   • Etiquetas de carregamento: a etiqueta aplicada aos eventos deste feed.
9. Clicar em Seguinte.
10. Reveja a configuração do feed no ecrã Finalizar e, de seguida, clique em Enviar.
11. Clique em Gerar chave secreta para gerar uma chave secreta para autenticar este feed.
12. Copie e armazene a chave secreta. Não pode ver esta chave secreta novamente. Se necessário, pode regenerar uma nova chave secreta, mas esta ação torna a chave secreta anterior obsoleta.
13. No separador Detalhes, copie o URL do ponto final do feed do campo Informações do ponto final. Tem de especificar este URL do ponto final na sua aplicação cliente.
14. Clique em Concluído.

Crie uma chave da API para o feed de webhook

1. Aceda à Google Cloud consola > Credenciais.

   Aceder a Credenciais

2. Clique em Criar credenciais e, de seguida, selecione Chave de API.

3. Restrinja o acesso da chave de API à API Google Security Operations.

Especifique o URL do ponto final

1. Na aplicação cliente, especifique o URL do ponto final HTTPS fornecido no feed do webhook.

2. Ative a autenticação especificando a chave da API e a chave secreta como parte do cabeçalho personalizado no seguinte formato:

   X-goog-api-key = API_KEY
   X-Webhook-Access-Key = SECRET
   

   Recomendação: especifique a chave da API como um cabeçalho em vez de a especificar no URL. Se o seu cliente de webhook não suportar cabeçalhos personalizados, pode especificar a chave da API e a chave secreta através de parâmetros de consulta no seguinte formato:

   ENDPOINT_URL?key=API_KEY&secret=SECRET
   

Substitua o seguinte:

• ENDPOINT_URL: o URL do ponto final do feed.
• API_KEY: a chave da API para autenticar no Google Security Operations.
• SECRET: a chave secreta que gerou para autenticar o feed.

Crie um webhook no Atlassian Bitbucket

1. No Bitbucket, aceda às definições do repositório.
2. Clique em Webhooks em Fluxo de trabalho.
3. Clique em Adicionar webhook.
4. Configure os seguintes campos:
   • Título: forneça um nome descritivo (por exemplo, Google SecOps).
   • URL: introduza o URL do ponto final da API Google SecOps.
   • Estado: definido como Ativo.
   • Acionadores: selecione os eventos relevantes.
5. Clique em Guardar.

Tabela de mapeamento da UDM

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais da Google SecOps.