SOAR migration overview
This document describes the process and timelines to migrate SOAR infrastructure to Google Cloud. The migration aims to modernize the infrastructure and enhance its integration with Google Cloud services, benefiting both Google Security Operations unified customers and standalone SOAR users transitioning to Google Cloud.
This migration is necessary to provide critical infrastructure upgrades including enhanced reliability, improved security, greater compliance, and more granular access control. It also enables access to Agentic AI capabilities through Model Context Protocol (MCP) integration and best-in-class services including IAM for access control, Cloud Monitoring, and Cloud Audit Logs.
The migration is carried out in two Stages - Stage 1 and Stage 2.
Stage 1 includes the following migrations:
- Migration of your Google-owned SOAR Project to Google Cloud infrastructure. This is carried out by Google.
- Migration of SOAR Authentication to Google Cloud (only applicable for SOAR standalone customers).
Stage 2 includes the following migrations:
- Migration of SOAR Permission Groups and Permissions to Google Cloud IAM.
- Migration of SOAR APIs to the unified Chronicle API for custom scripts and custom integrations.
- Version updates for out-of-the-box commercial integrations in Content Hub, with no code changes required.
- Migration of webhooks.
- Migration of remote agents authentication infrastructure.
Check for successful migration
Check for successful completion of Stage 1 by going to SOAR Settings > License Management and verifying it says Google.com after the system version number.
Check for successful completion of Stage 2 migration of SOAR permissions to IAM roles by going to SOAR Settings > License Management and verifying it says Google.com and CloudIAM Enabled after the system version number.
Confirm full end-to-end Stage 2 completion by verifying in Cloud Logging Logs Explorer that the SOAR operational logs query
resource.labels.namespace_name="chronicle-soar" AND labels.auth_deprecation="true"returns zero log entries for 30 consecutive days. For component-level verification queries and steps, see Frequently Asked Questions on SOAR migration.
Migration stage 1 for Google SecOps unified customers
Check your in-product notification for your Stage 1 migration date and the included Google Form to confirm the time slot. Stage 1 includes the following migrations.
- Migrate Google owned SOAR Project to Google Cloud
The migration involves up to 90 minute downtime where the Google SecOps platform is not accessible. During this downtime, your SIEM services will continue to operate in the background, while SOAR services will be temporarily paused. Following the downtime, the platform will be accessible, and SOAR services will resume processing any alerts generated or ingested during the downtime.
Once the migration is complete, we will send you an email.
Migration stage 1 for SOAR standalone customers
Depending on your needs and use cases, you can choose one of the following migration options:
Option 1 (Recommended) — Unify your SOAR instance with an existing SIEM instance: if you have an existing SIEM instance that doesn't have SOAR enabled, we recommend unifying your SOAR instance into your existing SIEM deployment whenever possible. This option uses the Google Cloud project associated with your existing SIEM instance and unifies both products under a single Google SecOps interface with shared authentication, access control, and audit logging.
Option 2 — Deploy a new Google SecOps instance: alternatively, if you don't have an existing SIEM instance or need to keep your SOAR and SIEM deployments separate, you can deploy a new Google SecOps instance in a dedicated Google Cloud project.
You will get an in-product notification message when we are ready to initiate Stage 1 for you. Make sure to do the following:
- Identify or set up your Google Cloud project based on your chosen migration option:
- Option 1 (Unify with an existing SIEM): use the existing Google Cloud project linked to your SIEM instance.
- Option 2 (Deploy a new Google SecOps instance): set up a Google Cloud project. You can also use a Google Cloud project that was set up to access Google SecOps Support but doesn't have a Google Security Operations instance yet.
- Enable Chronicle API in the Google Cloud project (if not already enabled).
- Set up Google Cloud Authentication to access SOAR. Refer to Set up Google Cloud Authentication to access SOAR.
- Provide the Google Cloud project ID in the Google form in the in-product notification and confirm the migration date and time slot before you submit the form.
- Accept the invitation email to the "Get Google Security Operations page" and complete the set up (if deploying a new Google SecOps instance). Make sure your region information is accurate.
- Validate that the preceding steps have been set up correctly by consulting the Pre-migration validation guide.
After you complete the steps, Google performs the migration at your scheduled date and time. The migration requires approximately 2 hours of downtime for SOAR services. Upon completion, you will receive an email with the new URL to access the SOAR platform. The old URL remains functional until June 30, 2026, and redirects to the new URL.
Set up Google Cloud authentication to access SOAR
Depending on the type of identity you want to use, configure one of the following options. You might need assistance from your Google Cloud and identity or IdP administrator to complete these steps.
Option 1: Configure Cloud Identity Authentication in Google Cloud (Google Managed accounts)
This scenario is applicable if you manage user accounts directly within Cloud Identity using Google-managed usernames and passwords. It does not apply if you are using Cloud Identity for SSO with a third-party identity provider such as Okta or Azure AD.
Complete the following steps:
Set up Cloud Identity in Google Cloud.
You can skip this step if you already have Cloud Identity set up with Google-managed username and password.
Make sure all existing SOAR users are configured in the Cloud Identity Admin console.
Grant the required roles in IAM by following the role assignment format for Google accounts.
Assign the following predefined IAM roles in Google Cloud to the onboarding SME:
Assign one of the following predefined IAM roles to all existing SOAR users:
Complete the authentication setup in SOAR by mapping each user (including administrators) to an email user group.
- Go to SOAR Settings > Advanced > Group Mapping.
Click add Add and fill in the following information:
- IdP / User group: The name of the email user group (such as T1 analysts).
- Permission Groups: Select the permission groups.
- SOC Roles: Select the SOC roles.
- Environments: Select the environments (such as All Environments).
- Group Members: Enter the required user emails. Press Enter after adding each email.
Click Add.
Each time a user signs in to the platform, they are automatically added to SOAR Settings > Organization > User Management page. The migrated instance retains these mappings, which serve as the basis for determining user access to SOAR. You must make sure that every user is mapped in this page in order to access Google SecOps.
Option 2: Configure Workforce Identity Federation Authentication in Google Cloud
This scenario is applicable if you manage your user identities using third party IdPs such as Microsoft Azure Active Directory, Okta, Ping Identity and AD FS.
- Set up Workforce Identity Federation in Google Cloud You can skip this step if it was already set up.
- Make sure all the existing users in SOAR are part of the workforce pool groups set up in the Workforce Identity Federation.
Grant the required roles in IAM by following the role assignment format for Workforce Identities.
Assign all of the following predefined IAM roles to the onboarding SME.
Assign one of the following roles in IAM to all existing SOAR users:
Complete the authentication setup in SOAR by mapping all the IdP groups that need access to SOAR.
Make sure the existing users are mapped to at least one of the IdP groups.
- Go to SOAR Settings > Advanced > Group Mapping.
- Click add Add and fill in the following information:
- IdP / User group: Enter the group name from your IdP.
- Permission Groups: Select the permission groups.
- SOC Roles: Select the SOC roles.
- Environments: Select the environments (such as All Environments).
- Make sure you have added the Admin IdP group with Admin permissions for permission groups, SOC Roles and select All Environments.
- If you have any existing IdP group mappings in the External Authentication page, you should leave it as is in order not to override your existing SOAR authentication. For the new Google Cloud authentication to access SOAR, you must still set up IdP Group Mapping in Settings > SOAR Settings > Advanced > Group Mapping page.
- Click Add. Each time a user signs in to the platform, they are automatically added to Settings > Organization > User Management page. The migrated instance retains these mappings, which serve as the basis for determining user access to SOAR. You must make sure that every user is mapped in this page in order to access Google SecOps.
Stage 2 migration for all customers
Important: You must complete Stage 1 before you begin the Stage 2 migration.
Stage 2 migration is generally available to all customers from January 26, 2026. Once Stage 1 is complete, you can migrate the Stage 2 components in any order at your own pace before their respective deadlines.
The final deadline to complete the Stage 2 transition to IAM roles is November 30, 2026. The API migration deadline is extended until March 31, 2027.
Migrate SOAR permission groups to Google Cloud IAM
Migrate the SOAR permission groups and permissions to IAM through a single-click of the migration script in Google Cloud. The script creates new custom roles for each permission group and assigns them to users for Cloud Identity customers or IdP groups for Workforce Identity Federation customers. You can also migrate the SOAR permissions using Terraform.
For full details of the migration script and Terraform commands, see Migrate SOAR permissions to Google Cloud IAM.
For more information about how to set up permissions, see Configure feature access.
After the migration of the permissions, the following happens:
- SOAR Settings > Organization > Permissions page is still available until March 31, 2027 (for backwards compatibility with legacy APIs). Don't make any changes to this page. The permissions are all managed through IAM.
- The Permission Group column on the Group Mapping page is displayed for backwards compatibility with legacy SOAR API. Don't delete these assignments. The column will be automatically removed by March 31, 2027 without any customer impact.
- The restricted actions section in the Permissions page will move to the Group Mapping page.
Migrate SOAR APIs to Chronicle API
If you call the SOAR API programmatically from external scripts, custom integrations, or custom actions, migrate those calls to the Chronicle API.
Update external scripts and custom Python code that manually constructs HTTP requests to legacy SOAR APIs (such as calls using siemplify.API_ROOT and siemplify.api_key) to use Chronicle API endpoints and OAuth 2.0 authentication. Custom Python code that uses standard built-in Siemplify SDK methods requires no code changes; see Migrate custom API calls to the Chronicle API. Out-of-the-box commercial integrations from Content Hub also don't require code changes; see Update out-of-the-box Content Hub integrations.
The legacy SOAR API and API keys remain available until March 31, 2027, after which they stop functioning. For more information, see Migrate to Chronicle API.
Update out-of-the-box Content Hub integrations
If an installed commercial integration still calls legacy SOAR APIs, update the integration package before March 31, 2027:
- Content Hub integrations: Open Content Hub in Google SecOps and update any outdated commercial integrations to their latest versions. For more information, see Content Hub overview.
- Chronicle SOAR Add-on for Splunk: If you use the Chronicle SOAR Add-on for Splunk, upgrade the
TA-Siemplifyadd-on in Splunk to a version that supports the Chronicle API. After upgrading, reconfigure the add-on to use your regional Chronicle API endpoint and Google Cloud service account credentials.
Migrate webhooks
You need to migrate SOAR webhooks to the Chronicle API by doing the following before March 31, 2027:
Update the webhook URL on the client side by replacing the legacy siemplify-soar.com domain with the new googleapis.com domain using the new request format. The legacy siemplify-soar.com domain will continue to function until March 31, 2027.
For example, a webhook defined on: https://zzzz.siemplify-soar.com/api/external/v1/webhooks/{webhook_id}?api_key={api_key}
will need to be updated to: https://us-chronicle.googleapis.com/v1alpha/projects/{project_id}/locations/{location}/instances/{instance_id}/webhooks/{webhook_id}:ingest?apiKey={api_key}
The authentication for webhooks remains unchanged. Webhooks continue to use the API key that was initially created alongside the webhook link. After you click Enable IAM in Stage 2, the Webhooks page in Google SecOps displays the updated chronicle.googleapis.com webhook URLs.
Migrate Remote Agent Authentication Infrastructure
The following steps detail how to migrate the authentication infrastructure of your Remote Agents to Google Cloud Service Account authentication. This process does not require migrating or replacing the Remote Agent instances or hosts.
- Create a Service Account instead of an API key for the remote agent.
- Perform a major version upgrade of the remote agent.
Existing Remote Agents will be available until March 31, 2027, after which they will no longer function. For detailed instructions, see Migrate Remote Agents to Google Cloud.
Impact on SOAR operational logs and Cloud Audit Logs
- SOAR operational logs (
chronicle-soarnamespace in Cloud Logging): Available in your Google Cloud project after completing Stage 1 (Google.com), including playbook, Python, ETL, and legacy API deprecation (labels.auth_deprecation="true") warning logs. Log collection is enabled automatically for unified Google SecOps instances and configured using a Logs Writer service account for SOAR standalone instances. For setup and query instructions, see Collect SOAR platform logs. - Cloud Audit Logs (
cloudaudit.googleapis.com): After Stage 1, audit logs remain stored on the Audit page in the SOAR platform. Audit logs for SOAR user and API actions become available in Cloud Audit Logs in your Google Cloud project after completing Stage 2 (enabling Google Cloud IAM and routing API calls throughchronicle.googleapis.com). Any calls made to the legacysiemplify-soar.comAPI until March 31, 2027 continue to be recorded on the internal SOAR Audit page and emitlabels.auth_deprecation="true"warning logs in Logging.
Further changes post migration:
License type: The license type is now determined by the user's assigned permissions in IAM.
Landing page: The landing page will move from the Permissions page to the User Preferences menu, accessible from your avatar.
What's Next
- SOAR migration pre-validation guide
- Migrate a SOAR standalone instance of an MSSP
- Migrate SOAR endpoints to the Chronicle API
- Migrate remote agents authentication infrastructure
- Migrate SOAR permissions to Google Cloud IAM
- Frequently asked questions
Need more help? Get answers from Community members and Google SecOps professionals.