Descripción general de la migración de SOAR

Compatible con:

En este documento, se describen el proceso y los plazos para migrar la infraestructura de SOAR a Google Cloud. El objetivo de la migración es modernizar la infraestructura y mejorar su integración con los servicios de Google Cloud , lo que beneficiará tanto a los clientes unificados de Google Security Operations como a los usuarios independientes de SOAR que realicen la transición a Google Cloud.

Esta migración es necesaria para proporcionar actualizaciones de infraestructura críticas, como mayor confiabilidad, mejor seguridad, mayor cumplimiento y control de acceso más detallado. También permite el acceso a las capacidades de IA de agentes a través de la integración del Protocolo de contexto del modelo (MCP) y los mejores servicios de su clase, incluidos IAM para el control de acceso, Cloud Monitoring y los Registros de auditoría de Cloud.

La migración se lleva a cabo en dos etapas: la etapa 1 y la etapa 2.

La etapa 1 incluye las siguientes migraciones:

  • Migración de tu proyecto de SOAR propiedad de Google a la infraestructura de Google Cloud . Google realiza esta acción
  • Migración de la autenticación de SOAR a Google Cloud (solo se aplica a los clientes independientes de SOAR)

La etapa 2 incluye las siguientes migraciones:

  • Migración de permisos y grupos de permisos de SOAR a IAM de Google Cloud .
  • Migración de las APIs de SOAR a la API unificada de Chronicle para secuencias de comandos y, también, integraciones personalizadas
  • Actualizaciones de versiones para integraciones comerciales listas para usar en Content Hub, sin necesidad de cambiar el código
  • Migración de webhooks
  • Migración de la infraestructura de autenticación de agentes remotos.

Verifica que la migración se haya realizado correctamente

  • Para comprobar que la etapa 1 se completó correctamente, ve a Configuración de SOAR > Administración de licencias y verifica que diga Google.com después del número de versión del sistema.

  • Para verificar que se haya completado correctamente la etapa 2 de la migración de los permisos de SOAR a los roles de IAM, ve a Configuración de SOAR > Administración de licencias y verifica que diga Google.com y CloudIAM habilitado después del número de versión del sistema.

  • Confirma que se completó por completo la etapa 2 de extremo a extremo. Para ello, verifica en el Explorador de registros de Cloud Logging que la consulta de registros operativos de SOAR resource.labels.namespace_name="chronicle-soar" AND labels.auth_deprecation="true" no devuelva entradas de registro durante 30 días consecutivos. Para obtener consultas y pasos de verificación a nivel de componente, consulta las Preguntas frecuentes sobre la migración de SOAR.

Etapa 1 de la migración para clientes unificados de Google SecOps

Revisa la notificación en el producto para conocer la fecha de migración de la etapa 1 y el formulario de Google incluido para confirmar el horario. La etapa 1 incluye las siguientes migraciones.

  • Migra el proyecto SOAR propiedad de Google a Google Cloud.

La migración implica un tiempo de inactividad de hasta 90 minutos en el que no se puede acceder a la plataforma de Google SecOps. Durante este tiempo de inactividad, tus servicios de SIEM seguirán funcionando en segundo plano, mientras que los servicios de SOAR se pausarán temporalmente. Después del tiempo de inactividad, se podrá acceder a la plataforma y los servicios de SOAR reanudarán el procesamiento de las alertas generadas o transferidas durante el tiempo de inactividad.

Cuando se complete la migración, te enviaremos un correo electrónico.

Etapa 1 de la migración para clientes independientes de SOAR

Según tus necesidades y casos de uso, puedes elegir una de las siguientes opciones de migración:

  • Opción 1 (recomendada): Unifica tu instancia de SOAR con una instancia de SIEM existente: si tienes una instancia de SIEM existente que no tiene SOAR habilitado, te recomendamos unificar tu instancia de SOAR en tu implementación de SIEM existente siempre que sea posible. Esta opción usa el proyecto de Google Cloud asociado con tu instancia de SIEM existente y unifica ambos productos en una sola interfaz de Google SecOps con autenticación, control de acceso y registro de auditoría compartidos.

  • Opción 2: Implementa una instancia nueva de Google SecOps: Como alternativa, si no tienes una instancia de SIEM existente o necesitas mantener separadas tus implementaciones de SOAR y SIEM, puedes implementar una instancia nueva de Google SecOps en un proyecto de Google Cloud dedicado.

Recibirás un mensaje de notificación en el producto cuando tengamos todo listo para iniciar la etapa 1. Asegúrate de hacer lo siguiente:

  1. Identifica o configura tu proyecto de Google Cloud según la opción de migración que elijas:
    • Opción 1 (unificar con una SIEM existente): Usa el proyecto de Google Cloud existente vinculado a tu instancia de SIEM.
    • Opción 2 (implementar una nueva instancia de Google SecOps): configura un proyecto de Google Cloud . También puedes usar un proyecto de Google Cloud que se haya configurado para acceder al equipo de asistencia de Google SecOps, pero que aún no tenga una instancia de Google Security Operations.
  2. Habilita la API de Chronicle en el proyecto de Google Cloud (si aún no está habilitada).
  3. Configura la autenticación de Google Cloud para acceder a SOAR. Consulta Configura la autenticación de Google Cloud para acceder a SOAR.
  4. Proporciona el ID del proyecto de Google Cloud en el formulario de Google que se muestra en la notificación del producto y confirma la fecha y el horario de la migración antes de enviar el formulario.
  5. Acepta el correo electrónico de invitación a la página "Obtener Google Security Operations" y completa la configuración (si implementas una instancia nueva de Google SecOps). Asegúrate de que la información de tu región sea correcta.
  6. Consulta la guía de validación previa a la migración para verificar que los pasos anteriores se hayan configurado correctamente.

Después de que completes los pasos, Google realizará la migración en la fecha y hora que programaste. La migración requiere aproximadamente 2 horas de tiempo de inactividad para los servicios de SOAR. Cuando se complete, recibirás un correo electrónico con la nueva URL para acceder a la plataforma de SOAR. La URL anterior seguirá funcionando hasta el 30 de junio de 2026 y redireccionará a la nueva.

Configura la autenticación de Google Cloud para acceder a SOAR

Según el tipo de identidad que quieras usar, configura una de las siguientes opciones. Es posible que necesites la ayuda de tu administrador de Google Cloud y de identidades o IdP para completar estos pasos.

Opción 1: Configura la autenticación de Cloud Identity en Google Cloud (cuentas administradas por Google)

Este caso es aplicable si administras las cuentas de usuario directamente en Cloud Identity con nombres de usuario y contraseñas administrados por Google. No se aplica si usas Cloud Identity para el SSO con un proveedor de identidad externo, como Okta o Azure AD.

Completa los siguientes pasos:

  1. Configura Cloud Identity en Google Cloud.

    Puedes omitir este paso si ya configuraste Cloud Identity con un nombre de usuario y una contraseña administrados por Google.

  2. Asegúrate de que todos los usuarios existentes de SOAR estén configurados en la Consola del administrador de Cloud Identity.

  3. Otorga los roles necesarios en IAM siguiendo el formato de asignación de roles para las Cuentas de Google.

    1. Asigna los siguientes roles predefinidos de IAM en Google Cloud al SME de incorporación:

    2. Asigna uno de los siguientes roles predefinidos de IAM a todos los usuarios de SOAR existentes:

  4. Completa la configuración de la autenticación en SOAR asignando cada usuario (incluidos los administradores) a un grupo de usuarios de correo electrónico.

    1. Ve a Configuración de SOAR > Avanzada > Asignación de grupos.
    2. Haz clic en add Agregar y completa la siguiente información:

      • IdP/Grupo de usuarios: Es el nombre del grupo de usuarios de correo electrónico (como Analistas del T1).
      • Grupos de permisos: Selecciona los grupos de permisos.
      • Roles del SOC: Selecciona los roles del SOC.
      • Entornos: Selecciona los entornos (como Todos los entornos).
      • Miembros del grupo: Ingresa los correos electrónicos de los usuarios requeridos. Presiona Intro después de agregar cada correo electrónico.
    3. Haz clic en Agregar.

      Cada vez que un usuario accede a la plataforma, se agrega automáticamente a la página Configuración de SOAR > Organización > Administración de usuarios. La instancia migrada conserva estas asignaciones, que sirven como base para determinar el acceso de los usuarios a SOAR. Debes asegurarte de que todos los usuarios estén asignados en esta página para acceder a Google SecOps.

Opción 2: Configura la autenticación de la federación de identidades de personal en Google Cloud

Este caso de uso se aplica si administras las identidades de usuario con IdP externos, como Microsoft Azure Active Directory, Okta, Ping Identity y AD FS.

  1. Configura la federación de identidades de personal en Google Cloud Puedes omitir este paso si ya se configuró.
  2. Asegúrate de que todos los usuarios existentes en SOAR formen parte de los grupos de grupos de personal configurados en la federación de identidades de personal.
  3. Otorga los roles necesarios en IAM siguiendo el formato de asignación de roles para identidades de personal.

    1. Asigna todos los siguientes roles de IAM predefinidos al experto en la materia de incorporación.

    2. Asigna uno de los siguientes roles en IAM a todos los usuarios existentes de SOAR:

  4. Completa la configuración de la autenticación en SOAR asignando todos los grupos de IdP que necesitan acceso a SOAR.

    Asegúrate de que los usuarios existentes estén asignados a, al menos, uno de los grupos de IdP.

    1. Ve a Configuración de SOAR > Avanzada > Asignación de grupos.
    2. Haz clic en add Agregar y completa la siguiente información:
      • IdP/Grupo de usuarios: Ingresa el nombre del grupo de tu IdP.
      • Grupos de permisos: Selecciona los grupos de permisos.
      • Roles del SOC: Selecciona los roles del SOC.
      • Entornos: Selecciona los entornos (como Todos los entornos).
    3. Asegúrate de haber agregado el grupo de IdP de administrador con permisos de administrador para los grupos de permisos y los roles de SOC, y selecciona Todos los entornos.
    4. Si tienes alguna asignación de grupos de IdP existente en la página de autenticación externa, debes dejarla como está para no anular la autenticación de SOAR existente. Para la nueva autenticación de Google Cloud para acceder a SOAR, debes configurar la asignación de grupos de IdP en la página Configuración > Configuración de SOAR > Avanzada > Asignación de grupos.
    5. Haz clic en Agregar. Cada vez que un usuario accede a la plataforma, se agrega automáticamente a la página Configuración > Organización > Administración de usuarios. La instancia migrada conserva estas asignaciones, que sirven como base para determinar el acceso de los usuarios a SOAR. Debes asegurarte de que todos los usuarios estén asignados en esta página para acceder a Google SecOps.

Migración de la etapa 2 para todos los clientes

Importante: Debes completar la etapa 1 antes de comenzar la migración de la etapa 2.

La migración de la etapa 2 estará disponible de forma general para todos los clientes a partir del 26 de enero de 2026. Una vez que se complete la etapa 1, podrás migrar los componentes de la etapa 2 en cualquier orden y a tu propio ritmo antes de las fechas límite respectivas.

La fecha límite final para completar la transición a la etapa 2 de los roles de IAM es el 30 de noviembre de 2026. La fecha límite para la migración de la API se extendió hasta el 31 de marzo de 2027.

Migra los grupos de permisos de SOAR a IAM de Google Cloud

Migra los grupos de permisos y permisos de SOAR a IAM con un solo clic en la secuencia de comandos de migración en Google Cloud. La secuencia de comandos crea roles personalizados nuevos para cada grupo de permisos y los asigna a los usuarios para los clientes de Cloud Identity o a los grupos de IdP para los clientes de la federación de identidades de personal. También puedes migrar los permisos de SOAR con Terraform.

Para obtener todos los detalles de la secuencia de comandos de migración y los comandos de Terraform, consulta Migra los permisos de SOAR a IAM de Google Cloud .

Para obtener más información sobre cómo configurar los permisos, consulta Configura el acceso a las funciones.

Después de la migración de los permisos, ocurre lo siguiente:

  • La página Configuración de SOAR > Organización > Permisos seguirá disponible hasta el 31 de marzo de 2027 (para mantener la retrocompatibilidad con las APIs heredadas). No realices ningún cambio en esta página. Todos los permisos se administran a través de IAM.
  • La columna Grupo de permisos de la página Asignación de grupos se muestra para ofrecer retrocompatibilidad con la API de SOAR heredada. No borres estas asignaciones. La columna se quitará automáticamente antes del 31 de marzo de 2027 sin que esto afecte a los clientes.
  • La sección de acciones restringidas de la página Permisos se moverá a la página Asignación de grupos.

Migra las APIs de SOAR a la API de Chronicle

Si llamas a la API de SOAR de manera programática desde secuencias de comandos externas, integraciones personalizadas o acciones personalizadas, migra esas llamadas a la API de Chronicle.

Actualiza las secuencias de comandos externas y el código de Python personalizado que construyen manualmente solicitudes HTTP a las APIs de SOAR heredadas (como las llamadas que usan siemplify.API_ROOT y siemplify.api_key) para usar los endpoints de API de Chronicle y la autenticación de OAuth 2.0. El código de Python personalizado que usa métodos de SDK de Siemplify integrados estándar no requiere cambios de código. Consulta Migra llamadas a la API personalizadas a la API de Chronicle. Las integraciones comerciales listas para usar de Content Hub tampoco requieren cambios en el código. Consulta Actualiza las integraciones listas para usar de Content Hub.

La API heredada de SOAR y las claves de API seguirán estando disponibles hasta el 31 de marzo de 2027, después de lo cual dejarán de funcionar. Para obtener más información, consulta Migra a la API de Chronicle.

Actualiza las integraciones listas para usar de Content Hub

Si una integración comercial instalada aún llama a las APIs de SOAR heredadas, actualiza el paquete de integración antes del 31 de marzo de 2027:

  • Integraciones de Content Hub: Abre Content Hub en Google SecOps y actualiza las integraciones comerciales obsoletas a sus versiones más recientes. Para obtener más información, consulta la descripción general de Content Hub.
  • Complemento de Chronicle SOAR para Splunk: Si usas el complemento de Chronicle SOAR para Splunk, actualiza el complemento TA-Siemplify en Splunk a una versión que admita la API de Chronicle. Después de la actualización, vuelve a configurar el complemento para usar el endpoint de API de Chronicle regional y las credenciales de cuenta de servicio de Google Cloud .

Migra webhooks

Debes migrar los webhooks de SOAR a la API de Chronicle. Para ello, sigue estos pasos antes del 31 de marzo de 2027:

Actualiza la URL de webhook en el cliente reemplazando el dominio heredado siemplify-soar.com por el nuevo dominio googleapis.com con el nuevo formato de solicitud. El dominio heredado siemplify-soar.com seguirá funcionando hasta el 31 de marzo de 2027.

Por ejemplo, un webhook definido en https://zzzz.siemplify-soar.com/api/external/v1/webhooks/{webhook_id}?api_key={api_key}

se deberá actualizar a https://us-chronicle.googleapis.com/v1alpha/projects/{project_id}/locations/{location}/instances/{instance_id}/webhooks/{webhook_id}:ingest?apiKey={api_key}

La autenticación para webhooks no se modifica. Los webhooks siguen usando la clave de API que se creó inicialmente junto con el vínculo del webhook. Después de hacer clic en Habilitar IAM en la etapa 2, en la página Webhooks de Google SecOps, se muestran las URLs de webhook de chronicle.googleapis.com actualizadas.

Migra la infraestructura de autenticación de agentes remotos

En los siguientes pasos, se detalla cómo migrar la infraestructura de autenticación de tus agentes remotos a la autenticación de cuentas de servicio de Google Cloud . Este proceso no requiere migrar ni reemplazar las instancias o los hosts del agente remoto.

  1. Crea una cuenta de servicio en lugar de una clave de API para el agente remoto.
  2. Realiza una actualización de la versión principal del agente remoto.

Los agentes remotos existentes estarán disponibles hasta el 31 de marzo de 2027, después de lo cual dejarán de funcionar. Para obtener instrucciones detalladas, consulta Migra agentes remotos a Google Cloud.

Impacto en los registros operativos de SOAR y los Registros de auditoría de Cloud

  • Registros operativos de SOAR (espacio de nombres chronicle-soar en Cloud Logging): Están disponibles en tu proyecto de Google Cloud después de completar la etapa 1 (Google.com), incluidos los registros de advertencia de baja de la API heredada (labels.auth_deprecation="true"), ETL, Python y la guía. La recopilación de registros se habilita automáticamente para las instancias unificadas de Google SecOps y se configura con una cuenta de servicio de escritor de registros para las instancias independientes de SOAR. Para obtener instrucciones de configuración y consulta, consulta Recopila registros de la plataforma de SOAR.
  • Registros de auditoría de Cloud (cloudaudit.googleapis.com): Después de la etapa 1, los registros de auditoría permanecen almacenados en la página Auditoría de la plataforma de SOAR. Los registros de auditoría de las acciones de los usuarios y de la API de SOAR estarán disponibles en los Registros de auditoría de Cloud en tu Google Cloud proyecto después de completar la etapa 2 (habilitar Google Cloud IAM y enrutar las llamadas a la API a través de la chronicle.googleapis.comAPI de Routes). Todas las llamadas realizadas a la API siemplify-soar.comheredada hasta el 31 de marzo de 2027 se seguirán registrando en la página interna de auditoría de SOAR y emitirán registros de labels.auth_deprecation="true"advertencia en Logging.

Cambios adicionales después de la migración:

Tipo de licencia: El tipo de licencia ahora se determina según los permisos asignados al usuario en IAM.

Página de destino: La página de destino se moverá de la página Permisos al menú Preferencias del usuario, al que se puede acceder desde tu avatar.

Pasos siguientes

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.