Visão geral da migração do SOAR

Compatível com:

Neste documento, descrevemos o processo e os cronogramas para migrar a infraestrutura do SOAR para o Google Cloud. O objetivo da migração é modernizar a infraestrutura e melhorar a integração com os serviços do Google Cloud , beneficiando tanto os clientes unificados do Google Security Operations quanto os usuários independentes do SOAR que estão migrando para o Google Cloud.

Essa migração é necessária para fornecer upgrades de infraestrutura críticos, incluindo maior confiabilidade, segurança aprimorada, maior conformidade e controle de acesso mais granular. Ele também permite o acesso a recursos de IA agêntica por meio da integração com o Protocolo de Contexto de Modelo (MCP) e serviços de primeira linha, incluindo o IAM para controle de acesso, o Cloud Monitoring e os Registros de Auditoria do Cloud.

A migração é realizada em duas etapas: Etapa 1 e Etapa 2.

A etapa 1 inclui as seguintes migrações:

  • Migração do seu projeto do SOAR de propriedade do Google para a infraestrutura do Google Cloud . Isso é feito pelo Google.
  • Migração da autenticação do SOAR para o Google Cloud (aplicável apenas a clientes do SOAR independente).

A Fase 2 inclui as seguintes migrações:

  • Migração de grupos de permissões e permissões do SOAR para o IAM do Google Cloud .
  • Migração de APIs SOAR para a API Chronicle unificada para scripts e integrações personalizadas.
  • Atualizações de versão para integrações comerciais prontas para uso no Content Hub, sem necessidade de mudanças no código.
  • Migração de webhooks.
  • Migração da infraestrutura de autenticação de agentes remotos.

Verificar se a migração foi bem-sucedida

  • Para verificar se a Etapa 1 foi concluída, acesse Configurações do SOAR > License Manager e confirme se aparece Google.com após o número da versão do sistema.

  • Verifique se a migração da Fase 2 das permissões do SOAR para os papéis do IAM foi concluída. Para isso, acesse Configurações do SOAR > Gerenciamento de licenças e confirme se aparece Google.com e CloudIAM ativado após o número da versão do sistema.

  • Confirme a conclusão total da Fase 2 verificando no Análise de registros do Cloud Logging se a consulta de registros operacionais do SOAR resource.labels.namespace_name="chronicle-soar" AND labels.auth_deprecation="true" não retorna entradas de registro por 30 dias consecutivos. Para consultas e etapas de verificação no nível do componente, consulte as Perguntas frequentes sobre a migração do SOAR.

Fase 1 da migração para clientes unificados do Google SecOps

Confira a notificação no produto para saber a data da migração da Fase 1 e o arquivo do Formulários Google incluído para confirmar o horário. A etapa 1 inclui as migrações a seguir.

  • Migrar o projeto do SOAR do Google para o Google Cloud

A migração envolve até 90 minutos de inatividade em que a plataforma do Google SecOps não fica acessível. Durante esse período, os serviços de SIEM vão continuar operando em segundo plano, enquanto os serviços de SOAR serão pausados temporariamente. Após o período de inatividade, a plataforma estará acessível e os serviços de SOAR vão retomar o processamento de todos os alertas gerados ou ingeridos durante o período de inatividade.

Quando a migração for concluída, vamos enviar um e-mail para você.

Etapa 1 da migração para clientes do SOAR independente

Dependendo das suas necessidades e casos de uso, escolha uma das seguintes opções de migração:

  • Opção 1 (recomendada): unificar sua instância do SOAR com uma instância do SIEM: se você tiver uma instância do SIEM que não tenha o SOAR ativado, recomendamos unificar sua instância do SOAR na implantação do SIEM sempre que possível. Essa opção usa o projeto do Google Cloud associado à sua instância atual do SIEM e unifica os dois produtos em uma única interface do Google SecOps com autenticação, controle de acesso e geração de registros de auditoria compartilhados.

  • Opção 2: implantar uma nova instância do Google SecOps: como alternativa, se você não tiver uma instância do SIEM ou precisar manter as implantações do SOAR e do SIEM separadas, implante uma nova instância do Google SecOps em um projeto dedicado do Google Cloud .

Você vai receber uma mensagem do aviso no produto quando estivermos prontos para iniciar a Etapa 1. Faça o seguinte:

  1. Identifique ou configure o projeto do Google Cloud com base na opção de migração escolhida:
    • Opção 1 (unificar com um SIEM atual): use o projeto do Google Cloud atual vinculado à sua instância do SIEM.
    • Opção 2 (implantar uma nova instância do Google SecOps): configure um projeto do Google Cloud . Também é possível usar um projeto do Google Cloud que foi configurado para acessar o suporte do Google SecOps, mas que ainda não tem uma instância do Google Security Operations.
  2. Ative a API Chronicle no projeto do Google Cloud (se ainda não estiver ativada).
  3. Configure a autenticação do Google Cloud para acessar o SOAR. Consulte Configurar a autenticação do Google Cloud para acessar o SOAR.
  4. Informe o ID do projeto do Google Cloud no formulário do Google na notificação no produto e confirme a data e o horário da migração antes de enviar o formulário.
  5. Aceite o e-mail de convite para a página "Acessar o Google Security Operations" e conclua a configuração (se estiver implantando uma nova instância do Google SecOps). Verifique se as informações da sua região estão corretas.
  6. Consulte o Guia de validação pré-migração para verificar se as etapas anteriores foram configuradas corretamente.

Depois que você concluir as etapas, o Google vai realizar a migração na data e hora programadas. A migração exige aproximadamente 2 horas de inatividade para os serviços do SOAR. Após a conclusão, você vai receber um e-mail com o novo URL para acessar a plataforma SOAR. O URL antigo vai continuar funcionando até 30 de junho de 2026 e vai redirecionar para o novo.

Configurar a autenticação do Google Cloud para acessar o SOAR

Dependendo do tipo de identidade que você quer usar, configure uma das opções a seguir. Talvez você precise da ajuda do administrador do Google Cloud e de identidade ou do IdP para concluir estas etapas.

Opção 1: configurar a autenticação do Cloud Identity no Google Cloud (contas gerenciadas pelo Google)

Esse cenário é aplicável se você gerencia contas de usuário diretamente no Cloud Identity usando nomes de usuário e senhas gerenciados pelo Google. Isso não se aplica se você estiver usando o Cloud Identity para SSO com um provedor de identidade de terceiros, como o Okta ou o Azure AD.

Siga estas etapas:

  1. Configurar o Cloud Identity no Google Cloud.

    Pule esta etapa se você já tiver configurado o Cloud Identity com nome de usuário e senha gerenciados pelo Google.

  2. Verifique se todos os usuários do SOAR estão configurados no Admin Console do Cloud Identity.

  3. Conceda os papéis necessários no IAM seguindo o formato de atribuição de papéis para Contas do Google.

    1. Atribua os seguintes papéis predefinidos do IAM em Google Cloud ao especialista em integração:

    2. Atribua um dos seguintes papéis predefinidos do IAM a todos os usuários do SOAR:

  4. Conclua a configuração de autenticação no SOAR mapeando cada usuário (incluindo administradores) para um grupo de e-mail de usuários.

    1. Acesse Configurações do SOAR > Avançado > Mapeamento de grupos.
    2. Clique em add Adicionar e preencha as seguintes informações:

      • IdP / Grupo de usuários: o nome do grupo de e-mail de usuários (como Analistas T1).
      • Grupos de permissões: selecione os grupos de permissões.
      • Papéis do SOC: selecione os papéis do SOC.
      • Ambientes: selecione os ambientes (como Todos os ambientes).
      • Participantes do grupo: insira os e-mails dos usuários necessários. Pressione Enter depois de adicionar cada e-mail.
    3. Clique em Adicionar.

      Sempre que um usuário faz login na plataforma, ele é adicionado automaticamente à página Configurações do SOAR > Organização > Gerenciamento de usuários. A instância migrada mantém esses mapeamentos, que servem como base para determinar o acesso do usuário ao SOAR. Verifique se todos os usuários estão mapeados nessa página para acessar o Google SecOps.

Opção 2: configurar a autenticação da federação de identidade de colaboradores no Google Cloud

Esse cenário é aplicável se você gerencia as identidades dos usuários usando IdPs de terceiros, como Microsoft Azure Active Directory, Okta, Ping Identity e AD FS.

  1. Configure a federação de identidade de colaboradores no Google Cloud. Se ela já estiver configurada, pule esta etapa.
  2. Verifique se todos os usuários do SOAR fazem parte dos grupos de pool de colaboradores configurados na federação de identidade de colaboradores.
  3. Conceda os papéis necessários no IAM seguindo o formato de atribuição de papéis para identidades de colaboradores.

    1. Atribua todos os papéis predefinidos do IAM a seguir ao especialista em integração.

    2. Atribua um dos seguintes papéis no IAM a todos os usuários do SOAR:

  4. Conclua a configuração de autenticação no SOAR mapeando todos os grupos do IdP que precisam de acesso ao SOAR.

    Verifique se os usuários atuais estão mapeados para pelo menos um dos grupos do IdP.

    1. Acesse Configurações do SOAR > Avançado > Mapeamento de grupos.
    2. Clique em add Adicionar e preencha as seguintes informações:
      • IdP / Grupo de usuários: insira o nome do grupo do seu IdP.
      • Grupos de permissões: selecione os grupos de permissões.
      • Papéis do SOC: selecione os papéis do SOC.
      • Ambientes: selecione os ambientes (como Todos os ambientes).
    3. Verifique se você adicionou o grupo de IdP de administrador com permissões de administrador para grupos de permissões, papéis do SOC e selecione "Todos os ambientes".
    4. Se você tiver mapeamentos de grupos de IdP na página "Autenticação externa", deixe como está para não substituir a autenticação do SOAR. Para que a nova autenticação do Google Cloud acesse o SOAR, você ainda precisa configurar o mapeamento de grupos do IdP na página Configurações > Configurações do SOAR > Avançado > Mapeamento de grupos.
    5. Clique em Adicionar. Sempre que um usuário faz login na plataforma, ele é adicionado automaticamente à página Configurações > Organização > Gerenciamento de usuários. A instância migrada mantém esses mapeamentos, que servem como base para determinar o acesso do usuário ao SOAR. Verifique se todos os usuários estão mapeados nessa página para acessar o Google SecOps.

Migração da fase 2 para todos os clientes

Importante: é necessário concluir a Etapa 1 antes de iniciar a migração da Etapa 2.

A migração do estágio 2 estará em disponibilidade geral para todos os clientes a partir de 26 de janeiro de 2026. Depois que a Etapa 1 for concluída, você poderá migrar os componentes da Etapa 2 em qualquer ordem e no seu próprio ritmo antes dos respectivos prazos.

O prazo final para concluir a transição do Estágio 2 para os papéis do IAM é 30 de novembro de 2026. O prazo de migração da API foi estendido até 31 de março de 2027.

Migrar grupos de permissões do SOAR para o IAM do Google Cloud

Migre os grupos de permissões e as permissões do SOAR para o IAM com um único clique no script de migração em Google Cloud. O script cria novos papéis personalizados para cada grupo de permissões e os atribui a usuários para clientes do Cloud Identity ou grupos do IdP para clientes da federação de identidade de colaboradores. Também é possível migrar as permissões do SOAR usando o Terraform.

Para detalhes completos sobre o script de migração e os comandos do Terraform, consulte Migrar permissões do SOAR para o IAM do Google Cloud .

Para mais informações sobre como configurar permissões, consulte Configurar o acesso a recursos.

Depois da migração das permissões, o seguinte acontece:

  • A página Configurações do SOAR > Organização > Permissões ainda está disponível até 31 de março de 2027 (para compatibilidade com versões anteriores de APIs legadas). Não faça mudanças nessa página. Todas as permissões são gerenciadas pelo IAM.
  • A coluna Grupo de permissões na página Mapeamento de grupos é exibida para compatibilidade com versões anteriores da API SOAR legada. Não exclua essas atribuições. A coluna será removida automaticamente até 31 de março de 2027, sem impacto para o cliente.
  • A seção de ações restritas na página Permissões será movida para a página Mapeamento de grupos.

Migrar APIs SOAR para a API Chronicle

Se você chamar a API SOAR de forma programática usando scripts externos, integrações personalizadas ou ações personalizadas, migre essas chamadas para a API Chronicle.

Atualize scripts externos e código Python personalizado que criam manualmente solicitações HTTP para APIs SOAR legadas (como chamadas usando siemplify.API_ROOT e siemplify.api_key) para usar endpoints de API Chronicle e autenticação OAuth 2.0. O código Python personalizado que usa métodos padrão integrados do SDK do Siemplify não requer mudanças no código. Consulte Migrar chamadas de API personalizadas para a API Chronicle. As integrações comerciais prontas para uso do Content Hub também não exigem mudanças no código. Consulte Atualizar as integrações prontas para uso do Content Hub.

A API SOAR legada e as chaves de API vão continuar disponíveis até 31 de março de 2027. Depois disso, elas vão deixar de funcionar. Para mais informações, consulte Migrar para a API Chronicle.

Atualizar as integrações prontas para uso do hub de conteúdo

Se uma integração comercial instalada ainda chamar APIs SOAR legadas, atualize o pacote de integração antes de 31 de março de 2027:

  • Integrações do Content Hub: abra o Content Hub no Google SecOps e atualize todas as integrações comerciais desatualizadas para as versões mais recentes. Para mais informações, consulte Visão geral do Content Hub.
  • Complemento do Chronicle SOAR para Splunk: se você usa o complemento do Chronicle SOAR para Splunk, faça upgrade do complemento TA-Siemplify no Splunk para uma versão compatível com a API Chronicle. Depois de fazer o upgrade, reconfigure o complemento para usar o endpoint regional da API Chronicle e as credenciais da conta de serviço do Google Cloud .

Migrar webhooks

Para migrar os webhooks do SOAR para a API Chronicle, siga estas etapas antes de 31 de março de 2027:

Atualize o URL do webhook no lado do cliente substituindo o domínio legado siemplify-soar.com pelo novo domínio googleapis.com usando o novo formato de solicitação. O domínio legado siemplify-soar.com vai continuar funcionando até 31 de março de 2027.

Por exemplo, um webhook definido em: https://zzzz.siemplify-soar.com/api/external/v1/webhooks/{webhook_id}?api_key={api_key}

precisará ser atualizado para: https://us-chronicle.googleapis.com/v1alpha/projects/{project_id}/locations/{location}/instances/{instance_id}/webhooks/{webhook_id}:ingest?apiKey={api_key}

A autenticação para webhooks permanece inalterada. Os webhooks continuam usando a chave de API que foi criada inicialmente com o link do webhook. Depois de clicar em Ativar IAM na Etapa 2, a página Webhooks no Google SecOps vai mostrar os URLs do webhook do chronicle.googleapis.com atualizados.

Migrar a infraestrutura de autenticação do agente remoto

As etapas a seguir detalham como migrar a infraestrutura de autenticação dos seus agentes remotos para a autenticação da conta de serviço do Google Cloud . Esse processo não exige a migração ou substituição das instâncias ou dos hosts do agente remoto.

  1. Crie uma conta de serviço em vez de uma chave de API para o agente remoto.
  2. Faça um upgrade da versão principal do agente remoto.

Os agentes remotos atuais vão estar disponíveis até 31 de março de 2027. Depois disso, eles não vão mais funcionar. Para instruções detalhadas, consulte Migrar agentes remotos para o Google Cloud.

Impacto nos registros operacionais do SOAR e nos registros de auditoria do Cloud

  • Registros operacionais do SOAR (namespace chronicle-soar no Cloud Logging): disponíveis no projeto do Google Cloud após a conclusão da Fase 1 (Google.com), incluindo registros de aviso de descontinuação de playbook, Python, ETL e API legada (labels.auth_deprecation="true"). A coleta de registros é ativada automaticamente para instâncias unificadas do Google SecOps e configurada usando uma conta de serviço de Gravador de registros para instâncias independentes do SOAR. Para instruções de configuração e consulta, consulte Coletar registros da plataforma SOAR.
  • Registros de auditoria do Cloud (cloudaudit.googleapis.com): após a Fase 1, os registros de auditoria permanecem armazenados na página Auditoria na plataforma SOAR. Os registros de auditoria para ações de usuários e APIs do SOAR ficam disponíveis nos Registros de auditoria do Cloud no seu projeto do Google Cloud após a conclusão da Etapa 2 (ativação do IAM do Google Cloud e roteamento de chamadas de API pelo chronicle.googleapis.com). Todas as chamadas feitas para a API siemplify-soar.com legada até 31 de março de 2027 continuam sendo registradas na página interna de Auditoria do SOAR e emitem registros de aviso do labels.auth_deprecation="true" no Logging.

Outras mudanças após a migração:

Tipo de licença: o tipo de licença agora é determinado pelas permissões atribuídas ao usuário no IAM.

Página de destino: a página de destino vai ser movida da página "Permissões" para o menu Preferências do usuário, acessível pelo seu avatar.

A seguir

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