Migrar da API CrowdStrike Detects para a API Alerts

Nesta seção, descrevemos como migrar sua configuração para usar a API Alerts e evitar interrupções na ingestão de dados.

Quem será afetado?

Essa mudança vai afetar você se as duas condições a seguir forem atendidas:

  • Você tem feeds de dados ativos usando o conector da API Cloud Monitoring de detecção do CrowdStrike, que é mapeado para o tipo de registro CS_DETECTS.
  • O cliente da API CrowdStrike configurado para esse feed não tem privilégios de leitura para alertas.

Para evitar interrupções no serviço, siga um dos procedimentos abaixo antes de 30 de setembro de 2025.

Opção 1: atualizar as permissões do cliente de API atual do CrowdStrike (recomendado)

Essa abordagem requer mudanças de configuração apenas no console do CrowdStrike Falcon e tem o menor impacto nas regras de detecção atuais que fazem referência ao tipo de registro CS_DETECTS.

Antes de começar, identifique os clientes de API usando a API Detects. A CrowdStrike oferece um painel para ajudar você a identificar clientes de API que usam endpoints descontinuados. Os clientes de API usados pelo feed de monitoramento de detecção do Google SecOps têm uma string de user agent que começa com Google-Chronicle-Security.

Para configurar e usar o painel, siga estas etapas:

  1. Acesse o artigo de suporte do CrowdStrike e faça o download do arquivo YAML, intitulado PlannedDecommissionofthedetectsAPI(September30,2025), anexado na parte de baixo da página.
  2. No console do Falcon, acesse SIEM de última geração > Gerenciamento de registros > Painéis.
  3. Na lista Criar painel, selecione Criar novo. Criar novo
  4. Clique em Importar painéis.
  5. Importe o arquivo YAML que você baixou. Arquivo YAML
  6. No painel, acesse a tabela Chamadas para os endpoints de API "/detects" descontinuados. Esta tabela lista os IDs do cliente de todos os clientes de API que chamam o endpoint descontinuado.
  7. Para cada ID do cliente de API identificado na etapa anterior, conceda a permissão de leitura para alertas, conforme mostrado na imagem. Permissões de leitura
  8. No console do Falcon, acesse a guia Clientes da API OAuth2. Talvez seja necessário percorrer várias páginas para encontrar um ID do cliente específico.
  9. Selecione o cliente de API que você quer modificar e clique em Editar cliente de API.
  10. Na tabela do formulário Editar cliente de API, marque a caixa de seleção Ler para alertas. Editar formulário do cliente de API
  11. Clique em Atualizar detalhes do cliente.
  12. Verifique as mudanças para garantir que a migração foi bem-sucedida.

    • Confirme se os feeds do CrowdStrike no Google SecOps continuam recebendo dados.
    • Verifique o painel no console do Falcon novamente após 30 minutos. O painel não deve mais registrar chamadas para a API Detects dos IDs do cliente atualizados.

Opção 2: criar e usar um novo cliente de API do CrowdStrike

Use essa opção se tiver problemas para identificar os IDs de cliente da API. O conector do Google SecOps para o tipo de registro CS_DETECTS tenta usar automaticamente a API Alerts primeiro. Se as permissões necessárias estiverem ausentes, ela vai usar a API Detects. Ao criar um novo cliente com as permissões corretas, você garante que o conector use a API Alerts moderna.

  1. No console do CrowdStrike Falcon, acesse a seção Clientes da API OAuth2.
  2. Clique em Criar cliente de API.
  3. Na tabela do formulário Criar cliente de API, marque a caixa de seleção Ler para alertas.
  4. No formulário Cliente de API criado, copie as informações nos campos ID do cliente, Secret e URL de base.
  5. No Google SecOps, acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
  6. Localize o feed do CrowdStrike Detection Monitoring (CS_DETECTS) e clique em Editar feed.
  7. Substitua as credenciais atuais pelo ID e pela chave secreta do cliente que você copiou do console do Falcon.
  8. Revise a configuração do feed e clique em Enviar.
  9. Repita essas etapas para cada feed CS_DETECTS em todas as instâncias do Google SecOps.

Verifique as alterações

Depois de atualizar o feed, verifique se a migração foi concluída:

  • Confirme se o feed do CrowdStrike no Google SecOps continua recebendo dados.
  • Verifique o painel no console do Falcon, conforme descrito no método recomendado. O painel não deve mais registrar chamadas para a API Detects.

Para mais detalhes, consulte o aviso oficial de desativação da CrowdStrike.

Descontinuação da API CrowdStrike Detections na integração com o SOAR

A integração do CrowdStrike Falcon SOAR usava a API Detections nas ações e nos conectores. A descontinuação dessa API pela CrowdStrike afeta as seguintes ações e conectores:

  • Adicionar comentário à detecção
  • Detecção de proximidade
  • Atualizar detecção
  • CrowdStrike: conector de detecções

A integração do SOAR com o CrowdStrike já é compatível com a API Alerts, que substitui a API Detections. Para usar a nova API Alerts, faça o seguinte:

  1. Instale o CrowdStrike - Alerts Connector.
  2. Atualize os playbooks para usar as ações Atualizar alerta e Adicionar comentário ao alerta.

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