Configura la identidad de terceros
Esta guía está dirigida a los administradores de Google Security Operations que desean autenticar a su personal (usuarios y grupos) en Google SecOps con un proveedor de identidad (IdP) de terceros. Este proceso es posible gracias a la Google Cloud federación de identidades de personal.
La federación de identidades de personal admite cualquier IdP que use el lenguaje de marcado para confirmaciones de seguridad (SAML 2.0) o OpenID Connect (OIDC), como Okta, Microsoft Entra ID y Microsoft Active Directory Federation Services (AD FS).
En este documento, se describen los pasos de alto nivel para configurar la autenticación a través de un IdP basado en SAML o en OIDC con la federación de identidades de personal:
- Planifica los recursos necesarios. Decide los detalles del grupo de identidades de personal y del proveedor, y, luego, identifica los atributos y grupos de usuarios necesarios para configurar el acceso a las funciones en Google SecOps.
- Configura la aplicación de IdP de terceros. Crea una aplicación de IdP SAML o OIDC para integrarla en la federación de identidades de personal y Google SecOps.
- Configura la federación de identidades de personal. Configura tu grupo y proveedor de identidades de personal, y otorga roles de Identity and Access Management (IAM) de Google Cloud a los grupos y usuarios del IdP.
- Configura el inicio de sesión único (SSO) con el proveedor recién creado.
Después de completar estos pasos, puedes acceder a Google SecOps con tu proveedor de identidad y administrar el acceso de los usuarios a través del control de acceso basado en roles (RBAC) de las funciones con IAM.
Casos de uso habituales
Google SecOps requiere el uso de la federación de identidades de personal como el agente de SSO para un conjunto variado de casos de uso.
Cumple con estándares de seguridad estrictos
- Objetivo: Cumplir con estándares regulatorios estrictos para el acceso al sistema y a la nube.
- Valor: Ayuda a cumplir con los requisitos de cumplimiento de FedRAMP High (o superior) mediante la intermediación segura del SSO.
Administra el control de acceso empresarial
- Objetivo: Controlar el acceso a las funciones y los datos de forma centralizada en toda la organización.
- Valor: Habilita el RBAC de nivel empresarial en Google SecOps con IAM.
Terminología clave
- Grupo de personal: Es un recurso de Google Cloud único a nivel global que se define a nivel de la organización y que otorga acceso a Google SecOps a tu personal.
- Proveedor de personal: Es un recurso secundario del grupo de identidades de personal que almacena los detalles de configuración de un solo IdP externo.
- Asignación de atributos: Es el proceso de traducir los atributos de aserción que proporciona tu IdP en atributos de Google Cloud con Common Expression Language (CEL).
- URL del servicio de consumidor de aserciones (ACS): Es una URL específica (a veces, se denomina URL de inicio de sesión único, según el proveedor) que se usa para configurar una aplicación de SAML para que se comunique con Google SecOps.
- ID de la entidad: Es una URL de identificador único global que identifica una aplicación o un servicio específicos, como Google SecOps, y configura la aplicación de SAML dentro de tu IdP.
Descripción general del proceso
Google SecOps admite el SSO de SAML o de OIDC iniciado por el proveedor de servicios (iniciado por el SP). Con esta función, navegas directamente a Google SecOps. Google SecOps emite una solicitud al IdP de terceros a través de la federación de identidades de personal de IAM.
Después de que el IdP autentica la identidad del usuario, este vuelve a Google SecOps con una aserción de autenticación de SAML o un token de ID de OIDC. Google Cloud La federación de identidades de personal actúa como un intermediario en el flujo de autenticación.
Comunicación entre Google SecOps, la federación de identidades de personal de IAM y el IdP
En general, la comunicación es la siguiente:
- El usuario navega a Google SecOps.
- Google SecOps busca información del IdP en el grupo de identidades de personal de Google Cloud.
- Se envía una solicitud al IdP.
- La aserción de SAML o el token de ID de OIDC se envían al grupo de identidades de personal de Google Cloud .
- Si la autenticación se realiza de forma correcta, Google SecOps solo recibe los atributos de SAML o las reclamaciones de OIDC que se definieron cuando configuraste el proveedor de personal en el grupo de identidades del personal.
Como administrador de Google SecOps, creas grupos en tu proveedor de identidad, configuras la aplicación de SAML o de OIDC para pasar información de membresía de grupo en la aserción o el token de ID, y asocias usuarios y grupos con los roles predefinidos de IAM o los roles personalizados que creaste en Google SecOps.
Antes de comenzar
- Familiarízate con Cloud Shell,
el comando
gcloudy la consola de Google Cloud . - Configura un proyecto de Google Cloud para Google SecOps para configurar un proyecto que se vincule a Google SecOps.
- Revisa la federación de identidades de personal Google Cloud .
- Asegúrate de tener los permisos para realizar los pasos de este documento. Para obtener información sobre los permisos necesarios para cada fase del proceso de incorporación, consulta Roles obligatorios.
- Asegúrate de que la lista de entidades permitidas de tu firewall o proxy incluya los dominios de Google SecOps, la federación de identidades de personal y el IdP de terceros requeridos en el puerto TCP
443. Para obtener más información, consulta Acceso a la red y lista de dominios permitidos.
Planifica la implementación
En esta sección, se describen las decisiones que debes tomar y la información que debes definir antes de realizar los pasos de este documento.
Define el grupo de identidades de personal y el proveedor de personal
Para configurar la autenticación a través de un IdP, debes configurar la federación de identidades de personal como intermediario en el flujo de autenticación. Antes de configurar la federación de identidades de personal, define los siguientes recursos deGoogle Cloud :
- Grupo de personal: Un grupo de Workforce Identity otorga acceso a tu personal (como empleados) a Google SecOps.
- Proveedor de personal: Es un recurso secundario del grupo de Workforce Identity que almacena detalles sobre un solo IdP.
La relación entre el grupo de identidades de personal, los proveedores de personal y una instancia de Google SecOps, identificada por un único subdominio de cliente, es la siguiente:
- Un grupo de identidades de personal se define a nivel de la organización.
- Cada instancia de Google SecOps tiene un grupo de Workforce Identity configurado y asociado a ella.
- Un grupo de identidades de personal puede tener varios proveedores de personal.
Cada proveedor de personal integra un IdP de terceros con el grupo de identidades de personal.
El grupo de identidades de personal debe estar dedicado a Google SecOps. No puedes compartir el grupo que se crea para Google SecOps con otros fines.
Debes tener el grupo de identidades de personal en la misma organización deGoogle Cloud que contiene el proyecto vinculado a Google SecOps.
A continuación, se indican los lineamientos para definir los valores de los identificadores de clave del grupo de personal y del proveedor de personal:
- ID del grupo de personal (
WORKFORCE_POOL_ID): define un valor que indique el alcance o el propósito del grupo de identidades de personal. El valor debe cumplir con los siguientes requisitos:- Debe ser único a nivel global.
- Solo debe usar caracteres en minúscula [a-z], dígitos [0-9] y guiones [-].
- Debe comenzar con un carácter en minúscula [a-z].
- Debe terminar con un carácter en minúscula [a-z] o un dígito [0-9].
- Puede tener entre 4 y 61 caracteres.
- Nombre visible del grupo de personal (
WORKFORCE_POOL_DISPLAY_NAME): Define un nombre fácil de usar para el grupo de Workforce Identity. - Descripción del grupo de personal (
WORKFORCE_POOL_DESCRIPTION): Define una descripción detallada del grupo de identidades del personal. - ID del proveedor de personal (
WORKFORCE_PROVIDER_ID): Define un valor que indique el IdP que representa. El valor debe cumplir con los siguientes requisitos:- Solo debe usar caracteres en minúscula [a-z], dígitos [0-9] y guiones [-].
- Puede tener entre 4 y 32 caracteres.
- Nombre visible del proveedor de personal (
WORKFORCE_PROVIDER_DISPLAY_NAME): Define un nombre fácil de usar para el proveedor de personal. Debe tener menos de 32 caracteres. - Descripción del proveedor de personal (
WORKFORCE_PROVIDER_DESCRIPTION): Define una descripción detallada del proveedor de personal.
Define los atributos y grupos de usuarios en el IdP
Antes de crear la aplicación de SAML o de OIDC en el IdP, identifica los atributos de usuario o las reclamaciones y los grupos de OIDC necesarios para configurar el acceso a las funciones de Google SecOps. Los atributos de usuario típicos incluyen los siguientes:
- Asunto
- Correo electrónico
- Nombre
- Apellido
- Nombre visible
Necesitas la información sobre los grupos y atributos de usuarios o las reclamaciones de OIDC durante las siguientes fases de este proceso:
Cuando configuras la aplicación de SAML o de OIDC, creas los grupos definidos durante la planificación. Configuras la aplicación del IdP para que pase las membresías de grupos en la aserción de SAML o el token de ID de OIDC.
Cuando creas el proveedor de personal, asignas atributos de aserción de SAML o reclamaciones y grupos de OIDC a atributos deGoogle Cloud . Esta información se envía en la aserción o el token de ID como parte de la identidad de un usuario.
Configura la aplicación del IdP
En esta sección, solo se describe la configuración específica necesaria en una aplicación de IdP de SAML o de OIDC para integrarse en la federación de identidades de personal de Google Cloud y Google SecOps. Consulta la documentación de tu IdP para obtener pasos detallados.
Configura una aplicación de SAML en tu IdP
Crea grupos en tu IdP, si aún no los creaste.
Como práctica recomendada, usa grupos en lugar de cuentas de usuario individuales para administrar el acceso a tu instancia de Google SecOps. Google recomienda crear grupos en tu IdP que correspondan directamente a los roles predeterminados de Google SecOps.
Consulta el siguiente ejemplo:
Rol de Google SecOps Grupo de IdP (recomendado) Administrador de la API de Chronicle chronicle_secops_admins Editor de la API de Chronicle chronicle_secops_editor Visualizador de API de Chronicle chronicle_secops_viewer Crea una aplicación de SAML nueva en tu IdP.
Configura la aplicación con los siguientes parámetros:
Especifica la URL del Servicio de confirmación de aserciones (ACS), que también se conoce como URL de inicio de sesión único según el proveedor de servicios.
https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDReemplaza lo siguiente:
WORKFORCE_POOL_ID: Es el identificador que definiste para el grupo de identidades de personal.WORKFORCE_PROVIDER_ID: Es el identificador que definiste para el proveedor de personal.
Para obtener descripciones de los valores, consulta Define el grupo de identidades de personal y el proveedor de personal.
Especifica el siguiente ID de la entidad (también llamado ID de la entidad del SP).
https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDConfigura el identificador de nombre en tu IdP para asegurarte de que se devuelva el campo
NameIDen la respuesta de SAML.Puedes establecerlo en un valor que admita las políticas de tu organización, como la dirección de correo electrónico o el nombre de usuario. Consulta la documentación de tu IdP para obtener información sobre cómo configurar este valor. Para obtener más información sobre este requisito, consulta Soluciona problemas de la federación de identidades de personal.
Agrega las declaraciones de atributos que te permiten pasar información del usuario del IdP a tus integraciones de aplicaciones. Definiste los atributos cuando planificaste la implementación del IdP.
Por ejemplo, usa la siguiente tabla para asignar atributos en IdP de uso frecuente, como Okta, Microsoft AD FS o Entra ID:
Nombre del atributo Valor de Okta AD FS/Entra ID (atributo de origen) subjectuser.emailuser.mailouser.userprincipalnameemailaddressuser.emailuser.mailfirst_nameuser.firstNameuser.givennamelast_nameuser.lastNameuser.surnamedisplay_nameuser.displayNameuser.displaynamegroupsSe configura con un filtro de grupo en el IdP, como Coincide con regex con .*.Se toma de la asignación de grupos en el IdP. Si configuras una aplicación de IdP de Okta, asegúrate de seleccionar Sin especificar como formato cuando agregues los atributos. Deja el espacio de nombres en blanco cuando uses Microsoft AD FS o Entra ID como IdP.
Asigna los grupos y usuarios adecuados a la aplicación dentro de tu IdP.
Estos grupos y usuarios tendrán autorización para acceder a Google SecOps.
Descarga el archivo XML de metadatos de la aplicación.
En la siguiente sección, usarás este archivo de metadatos cuando configures tu proveedor de identidades de personal. Si usas Google Cloud CLI, debes subir este archivo desde tu sistema local al directorio principal de Google Cloud con Cloud Shell.
Configura una aplicación de OIDC en tu IdP
Para configurar una aplicación de OIDC en tu IdP y, así, integrarla en la federación de identidades de personal y Google SecOps, completa los siguientes pasos:
Si aún no creaste grupos, hazlo en tu IdP. Como práctica recomendada, usa grupos en lugar de cuentas de usuario individuales para administrar el acceso a tu instancia de Google SecOps.
Crea una aplicación de OIDC nueva en tu IdP y sigue los pasos de preparación del IdP en Crea un proveedor de grupos de personal de OIDC.
Configura la aplicación con los siguientes URIs de redireccionamiento, que algunos IdP denominan URLs de devolución de llamada o URIs de redireccionamiento de acceso:
Para acceder a Google SecOps:
https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDPara la validación de la asignación de atributos y tokens de la federación de identidades de personal:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
Reemplaza lo siguiente:
WORKFORCE_POOL_ID: Es el identificador que definiste para el grupo de identidades de personal.WORKFORCE_PROVIDER_ID: Es el identificador que definiste para el proveedor de personal.
Para obtener descripciones de los valores, consulta Define el grupo de identidades de personal y el proveedor de personal.
Selecciona el tipo de permiso en tu aplicación de IdP: el flujo de código de autorización recomendado o el flujo implícito. Si usas el flujo implícito, asegúrate de que la aplicación esté configurada para devolver el token de ID.
Configura tu aplicación de IdP para que devuelva la reclamación
suby las reclamaciones de usuario y grupo que identificaste cuando planificaste la implementación del IdP.Por ejemplo, usa la siguiente tabla para asignar reclamaciones en IdP de uso frecuente, como Okta, Microsoft AD FS o Entra ID:
Nombre de la solicitud Valor de Okta AD FS/Entra ID (atributo de origen) subuser.emailuser.mailouser.userprincipalnameemailuser.emailuser.mailgiven_nameuser.firstNameuser.givennamefamily_nameuser.lastNameuser.surnamenameuser.displayNameuser.displaynamegroupsSe configura con un filtro de grupo en el IdP, como Coincide con regex con .*.Se toma de la asignación de grupos en el IdP. Si configuras una aplicación de IdP de Okta o Entra ID, asegúrate de que se otorguen permisos estándar (como
openid,profileyemail) para pasar estas reclamaciones. Si usas Microsoft AD FS o Entra ID, configura las asignaciones de reclamaciones según corresponda.Si tu aplicación de OIDC de Okta usa un servidor de autorización de la organización, también debes pasar
groupscomo un permiso adicional cuando crees el proveedor de federación de identidades de personal para que Okta devuelva la reclamacióngroups. Para obtener más información, consulta Configura la federación de identidades de personal con Okta.Asigna los grupos y usuarios adecuados a la aplicación de OIDC en tu IdP.
Registra las siguientes credenciales de tu aplicación de IdP para usarlas cuando crees un proveedor de grupos de identidades de personal de OIDC:
- Flujo de código de autorización: ID de cliente, URI de la entidad emisora y secreto del cliente.
- Flujo implícito: ID de cliente y URI del emisor.
Configura la federación de identidades de personal
En esta sección, solo se describen los pasos específicos necesarios para configurar la federación de identidades de personal con la aplicación de SAML o de OIDC del IdP que creaste en la sección anterior. Para obtener más información sobre cómo administrar grupos de identidades de personal, consulta Administra proveedores de grupos de identidades de personal.
Configura el proyecto de facturación y cuota
Abre la consola de Google Cloud como el usuario con los permisos necesarios en el proyecto vinculado a Google SecOps. Identificaste o creaste este usuario antes. Consulta la sección Antes de comenzar.
Inicia una sesión de Cloud Shell.
Establece el proyecto de Google Cloud que se factura y al que se le cobra la cuota de las operaciones realizadas con gcloud CLI. Usa el siguiente comando
gcloudcomo ejemplo:gcloud config set billing/quota_project PROJECT_IDReemplaza
PROJECT_IDpor el ID del proyecto vinculado a Google SecOps que creaste en Configura un proyecto de Google Cloud para Google SecOps. Para obtener una descripción de los campos que identifican un proyecto, consulta Crea y administra proyectos.Para obtener información sobre las cuotas, consulta los siguientes documentos:
Si encuentras un error, consulta Soluciona errores de cuota.
Crea y configura un grupo de Workforce Identity
Puedes configurar un grupo de identidades de personal para que se integre en un proveedor de identidad (IdP) externo o en Google Workspace o Cloud Identity.
Console
Para crear el grupo de identidades de personal, haz lo siguiente:
En la consola de Google Cloud , ve a la página Grupos de identidades de personal:
Selecciona la organización para tu grupo de identidades de personal. Los grupos de identidades de personal están disponibles en todos los proyectos y carpetas de una organización.
Haz clic en Crear grupo y haz lo siguiente:
En el campo Nombre, ingresa el nombre visible del grupo. El ID del grupo se deriva automáticamente del nombre a medida que escribes y se muestra en el campo Nombre. Para actualizar el ID del grupo, haz clic en Editar junto a él.
Opcional: En Descripción, ingresa una descripción del grupo.
Haz clic en Siguiente.
La duración de la sesión del grupo de identidades del personal se establece de forma predeterminada en una hora. Esta duración determina la validez de los tokens de acceso de Google Cloud , la consola de la federación de identidades de personal deGoogle Cloud y las sesiones de acceso de gcloud CLI. Puedes actualizar el grupo para establecer una duración de la sesión personalizada de entre 15 minutos y 12 horas.
gcloud
Crea un grupo de Workforce Identity.
Usa el siguiente comando
gcloudcomo ejemplo:gcloud iam workforce-pools create WORKFORCE_POOL_ID\ --location="global" \ --organization=ORGANIZATION_ID \ --description="WORKFORCE_POOL_DESCRIPTION" \ --display-name="WORKFORCE_POOL_DISPLAY_NAME" \ --session-duration=SESSION_DURATIONReemplaza lo siguiente:
WORKFORCE_POOL_ID: Es el valor que definiste para el ID del grupo de identidades de personal.ORGANIZATION_ID: Es el ID de organización numérico.WORKFORCE_POOL_DESCRIPTION: Es una descripción opcional del grupo de Workforce Identity.WORKFORCE_POOL_DISPLAY_NAME: un nombre fácil de usar opcional para el grupo de Workforce Identity.SESSION_DURATION: Es un valor opcional para la duración de la sesión, expresado como un número cons, por ejemplo,3600s. Esta duración determina la validez de los tokens de acceso de Google Cloud, la consola de la federación de identidades de personal deGoogle Cloud y las sesiones de acceso de gcloud CLI. Puedes actualizar el grupo para establecer una duración de la sesión personalizada de entre 15 minutos y 12 horas.
Para usar Google Workspace o Cloud Identity para acceder a Google SecOps, agrega las marcas
--allowed-services domain=backstory.chronicle.securityy--disable-programmatic-signinal comando.gcloud iam workforce-pools create WORKFORCE_POOL_ID\ --location="global" \ --organization="ORGANIZATION_ID" \ --description="WORKFORCE_POOL_DESCRIPTION" \ --display-name="WORKFORCE_POOL_DISPLAY_NAME" \ --session-duration=SESSION_DURATION \ --allowed-services domain=backstory.chronicle.security \ --disable-programmatic-signinEste comando crea un grupo de identidades de personal que no admite el acceso a Google Cloud. Para habilitar la funcionalidad de acceso, debes usar las marcas adecuadas para cada situación.
Si se te solicita habilitar la API de Chronicle, ingresa
Yes.
Crea un proveedor de grupos de Workforce Identity
Un proveedor de grupos de identidad de personal describe una relación entre tu organización deGoogle Cloud y tu IdP. Elige la sección que coincida con tu protocolo de autenticación:
- Crea un proveedor de grupos de identidades de personal de SAML
- Crea un proveedor de grupos de Workforce Identity de OIDC
Crea un proveedor de grupos de Workforce Identity de SAML
Console
Para configurar el proveedor de grupos de identidades de personal, haz lo siguiente:
En la consola de Google Cloud , ve a la página Grupos de identidades de personal:
En la tabla grupos de identidad del personal, selecciona el grupo para el que deseas crear el proveedor.
En la sección Proveedores, haz clic en Agregar proveedor.
En Selecciona un proveedor, elige tu IdP.
Si tu IdP no aparece en la lista, selecciona Proveedor de identidad genérico.
En Selecciona un protocolo de autenticación, elige SAML.
En la sección Crea un proveedor, haz lo siguiente:
En Nombre del proveedor, ingresa un nombre para el proveedor.
Opcional: En Descripción, ingresa una descripción para el proveedor.
En Archivo de metadatos de IdP (XML), selecciona el archivo XML de metadatos que generaste antes en esta guía.
Asegúrate de que la opción Habilitar proveedor esté activada.
Haz clic en Continuar.
En la sección Comparte la información de tu proveedor, copia las URLs:
- Configura la primera URL (
https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) como el ID de la entidad en tu IdP. - La segunda URL (
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) se usa para la validación de tokens y asignaciones de la federación de identidades de personal (con la función Depurar token de IdP). Asegúrate de que tu IdP incluya esta URL y la URL de acceso de ACS de Google SecOps (https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) que configuraste en Configura una aplicación de SAML en tu IdP.
- Configura la primera URL (
Haz clic en Continuar.
En la sección Configurar proveedor, haz lo siguiente:
En Asignación de atributos, ingresa las asignaciones en los cuadros correspondientes. Por ejemplo:
Google X (donde X es un número) SAML X (donde X es un número) google.subjectassertion.subjectgoogle.groupsassertion.attributes.groupsgoogle.display_nameassertion.attributes.display_name[0]attribute.first_nameassertion.attributes.first_name[0]attribute.last_nameassertion.attributes.last_name[0]attribute.user_emailassertion.attributes.emailaddress[0]Si realizas esta configuración para Google Security Operations, que incluye Google Security Operations SIEM y Google SecOps SOAR, asigna los siguientes atributos que requiere Google SecOps SOAR:
attribute.first_nameattribute.last_nameattribute.user_emailgoogle.groupsgoogle.display_name
Opcional: Si seleccionaste Microsoft Entra ID como tu IdP, puedes aumentar la cantidad de grupos de la siguiente manera:
- Selecciona Usar atributos adicionales.
- En el campo URI de la entidad emisora de atributos adicionales, ingresa la URL de la entidad emisora.
- En el campo ID de cliente de atributos adicionales, ingresa el ID de cliente.
- En el campo Secreto del cliente de atributos adicionales, ingresa el secreto del cliente.
- En la lista Tipo de atributos adicionales, selecciona un tipo de atributo para los atributos adicionales.
- En el campo Filtro de atributos adicionales, ingresa una expresión de filtro que se use cuando se consulte la API de Microsoft Graph para grupos.
Opcional: Para agregar una condición de atributo, haz clic en Agregar condición y, luego, ingresa una expresión de CEL que represente una condición de atributo. Por ejemplo, para limitar el atributo
ipaddra un rango de IP determinado, puedes establecer la condiciónassertion.attributes.ipaddr.startsWith('98.11.12.'). Esta condición de ejemplo garantiza que solo los usuarios con una dirección IP que comienza con98.11.12.puedan acceder con este proveedor de personal.Para activar el registro de auditoría detallado, en Registro detallado, haz clic en el botón de activación Habilitar el registro de auditoría del valor de atributos.
Para crear el proveedor, haz clic en Enviar.
gcloud
Para configurar el proveedor de grupos de identidades de personal, haz lo siguiente:
Para subir el archivo de metadatos de la aplicación de SAML al directorio principal de Cloud Shell, haz clic en Más >. Los archivos solo se pueden subir al directorio principal. Para obtener más opciones de transferencia de archivos entre Cloud Shell y tu estación de trabajo local, consulta Sube y descarga archivos y carpetas desde Cloud Shell.
Toma nota de la ruta del directorio en el que subiste el archivo en formato XML de metadatos de la aplicación de SAML en Cloud Shell. Necesitarás esta ruta de acceso en el siguiente paso.
Crea un proveedor de grupos de identidades de personal y especifica los detalles del IdP.
Usa el siguiente comando
gcloudcomo ejemplo:gcloud iam workforce-pools providers create-saml WORKFORCE_PROVIDER_ID \ --workforce-pool="WORKFORCE_POOL_ID" \ --location="global" \ --display-name="WORKFORCE_PROVIDER_DISPLAY_NAME" \ --description="WORKFORCE_PROVIDER_DESCRIPTION" \ --idp-metadata-path=PATH_TO_METADATA_XML \ --attribute-mapping="ATTRIBUTE_MAPPINGS"Consulta Planifica la implementación para obtener descripciones de los valores.
Reemplaza lo siguiente:
WORKFORCE_PROVIDER_ID: el valor que definiste para el ID del proveedor de personal.WORKFORCE_POOL_ID: Es el valor que definiste para el ID del grupo de identidades de personal.WORKFORCE_PROVIDER_DISPLAY_NAME: Es un nombre opcional y fácil de usar para el proveedor de personal. Debe tener menos de 32 caracteres.WORKFORCE_PROVIDER_DESCRIPTION: Es una descripción opcional del proveedor de personal.PATH_TO_METADATA_XML: Es la ubicación del directorio de Cloud Shell del archivo en formato XML de metadatos de la aplicación que subiste con Cloud Shell, por ejemplo:/path/to/sso_metadata.xml.ATTRIBUTE_MAPPINGS: Es la definición de cómo asignar atributos de aserción a los atributos deGoogle Cloud . Se usa Common Expression Language para interpretar estas asignaciones. Por ejemplo:
google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.groupsEn el ejemplo anterior, se asignan los siguientes atributos:
assertion.subjectagoogle.subject. Este es un requisito mínimo.assertion.attributes.name[0]agoogle.display_name.assertion.attributes.groupsal atributogoogle.groups.
Si realizas esta configuración para Google Security Operations, que incluye Google Security Operations SIEM y Google SecOps SOAR, asigna los siguientes atributos que requiere Google SecOps SOAR:
attribute.first_nameattribute.last_nameattribute.user_emailgoogle.groupsgoogle.display_name
Por lo tanto, la asignación completa es la siguiente:
google.subject=assertion.subject,google.groups=assertion.attributes.groups,attribute.first_name=assertion.attributes.first_name[0],attribute.last_name=assertion.attributes.last_name[0],attribute.user_email=assertion.attributes.emailaddress[0],google.display_name=assertion.attributes.display_name[0]Para obtener más información, consulta Aprovisiona y asigna usuarios para Google SecOps SOAR.
Cuando configuras tu aplicación de SAML para pasar información de membresía de grupo, los nombres de atributos de grupo comunes incluyen
groups,idpGroupymemberOf. En la asignación de atributos de la federación de identidades de personal, asegúrate de que el nombre del atributo enassertion.attributes.ATTRIBUTE_NAMEcoincida con el nombre exacto que distingue mayúsculas de minúsculas configurado en tu IdP.En el siguiente ejemplo, se asignan varios grupos al atributo
google.groups:google.groups="(has(assertion.attributes.idpGroup) ? assertion.attributes.idpGroup : []) + (has(assertion.attributes.groups) ? assertion.attributes.groups : []) + (has(assertion.attributes.memberOf) ? assertion.attributes.memberOf : [])"En el siguiente ejemplo, se asigna el grupo
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/groupque contiene caracteres especiales agoogle.groups:google.groups="assertion.attributes['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"Para obtener más información sobre la asignación de atributos, consulta Asignaciones de atributos.
Crea un proveedor de grupos de Workforce Identity de OIDC
Para crear un proveedor de grupos de identidades de personal de OIDC con la consola deGoogle Cloud o gcloud CLI, completa los siguientes pasos:
Sigue las instrucciones que se indican en Crea un proveedor de grupos de trabajadores de OIDC para crear el proveedor en tu grupo de Workforce Identity.
Cuando configures el proveedor de OIDC, aplica los siguientes parámetros de configuración de Google SecOps:
URIs de redireccionamiento: Asegúrate de que tu aplicación de IdP de OIDC incluya los siguientes URIs de redireccionamiento, como se describe en Configura una aplicación de OIDC en tu IdP:
- URI de redireccionamiento de acceso de Google SecOps
(
https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) - URI de redireccionamiento de validación de la federación de identidades de personal
(
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
- URI de redireccionamiento de acceso de Google SecOps
(
Asignaciones de atributos: Asigna tus reclamaciones de OIDC a atributos deGoogle Cloud con Common Expression Language (CEL). Como mínimo, asigna
google.subjectaassertion.subygoogle.groupsaassertion.groupspara que el RBAC de Google SecOps funcione como se espera:google.subject=assertion.sub,google.groups=assertion.groupsSi configuras Google Security Operations, que incluye Google Security Operations SIEM y Google SecOps SOAR, también asigna los atributos que requiere Google SecOps SOAR. Por ejemplo:
google.subject=assertion.sub,google.groups=assertion.groups,attribute.first_name=assertion.given_name,attribute.last_name=assertion.family_name,attribute.user_email=assertion.email,google.display_name=assertion.nameEjemplos de asignación de grupos avanzada
Cuando configuras tu aplicación de OIDC para pasar información de membresía de grupos, los nombres comunes de las reclamaciones de grupos incluyen
groups,idpGroupymemberOf. En la asignación de atributos de la federación de identidades de personal, asegúrate de que el nombre de la reclamación enassertion.CLAIM_NAMEcoincida con el nombre exacto que distingue mayúsculas de minúsculas configurado en tu IdP.En el siguiente ejemplo, se asignan varios grupos al atributo
google.groups:google.groups="(has(assertion.idpGroup) ? assertion.idpGroup : []) + (has(assertion.groups) ? assertion.groups : []) + (has(assertion.memberOf) ? assertion.memberOf : [])"En el siguiente ejemplo, se asigna una reclamación de grupo que contiene caracteres especiales (como un esquema de URI) a
google.groups:google.groups="assertion['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"
Opcional: Crea una condición de atributo. Si tu IdP multiusuario tiene un solo URI de emisor, debes usar condiciones de atributo para garantizar que el acceso se restrinja al usuario correcto. Por ejemplo, puedes limitar el acceso a los usuarios con un rol o un dominio de correo electrónico específicos. Para obtener más información, consulta Usa condiciones de atributos cuando federes con proveedores de identidad multiusuario.
Después de crear el proveedor de personal de OIDC, te recomendamos que valides las asignaciones de tokens y atributos con Depura tu token de IdP y, luego, continúes con Otorga un rol para habilitar el acceso a Google SecOps para completar las secciones restantes de este documento.
Otorga un rol para habilitar el acceso a Google SecOps
En los siguientes pasos, se describe cómo otorgar un rol específico con IAM para que los grupos y usuarios de tu grupo de identidades de personal puedan acceder a Google SecOps. Realiza la configuración con el proyecto de Google Cloud vinculado a Google SecOps que creaste antes.
Console
En la consola de Google Cloud , dirígete a la página IAM.
Selecciona el proyecto de Google Cloud vinculado a Google SecOps.
En la pestaña Ver por principales, haz clic en Otorgar acceso.
En la sección Agregar principales, ingresa un identificador de principal en el campo Principales nuevas.
Por ejemplo:
Para agregar todas las identidades administradas con el grupo de identidades de personal y el proveedor de personal que creaste antes, ingresa lo siguiente:
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_IDPara agregar un grupo específico como principal, ingresa lo siguiente:
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID
Reemplaza lo siguiente:
WORKFORCE_POOL_ID: Es el valor que definiste para el ID del grupo de identidades de personal.GROUP_ID: un grupo en la reclamacióngoogle.groupsasignada. Debes tener este grupo creado en tu IdP.
En la sección Asignar roles, selecciona o busca un rol de la API de Chronicle aplicable, como Visualizador de la API de Chronicle (
roles/chronicle.viewer).Haz clic en Guardar.
Repite los pasos del 3 al 5 para cada principal a la que quieras otorgar roles.
gcloud
Otorga el rol Visualizador de la API de Chronicle (
roles/chronicle.viewer) a los usuarios o grupos que deben tener acceso a la aplicación de Google SecOps.- En el siguiente ejemplo, se otorga el rol de visualizador de la API de Chronicle a las identidades administradas con el grupo de identidades de personal y el proveedor de personal que creaste antes.
gcloud projects add-iam-policy-binding PROJECT_ID \ --role roles/chronicle.viewer \ --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*"Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto vinculado a Google SecOps que configuraste en Configura un proyecto de Google Cloud para Google SecOps. Para obtener una descripción de los campos que identifican un proyecto, consulta Crea y administra proyectos.WORKFORCE_POOL_ID: Es el valor que definiste para el ID del grupo de identidades de personal.Para otorgar el rol de visualizador de la API de Chronicle a un grupo específico, ejecuta el siguiente comando:
gcloud projects add-iam-policy-binding PROJECT_ID \ --role roles/chronicle.viewer \ --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID"Reemplaza
GROUP_IDpor un grupo en la reclamacióngoogle.groupsasignada. Debes tener este grupo creado en tu IdP.Configura políticas de IAM adicionales para cumplir con los requisitos de tu organización.
Obligatorio: Para completar la autenticación y habilitar el acceso de los usuarios a la plataforma de Google SecOps, debes configurar el acceso de los usuarios desde el lado de SOAR de Google SecOps. Para obtener más información, consulta Asigna usuarios en la plataforma de Google SecOps.
Repite los pasos anteriores para otorgar otros roles.
Configura el SSO en tu instancia de Google SecOps
La tarea final de integrar tu IdP de terceros con Google SecOps es configurar el SSO. Después de completar este paso, los usuarios podrán acceder a Google SecOps con sus credenciales de IdP.
A continuación, se indican los pasos para configurar el SSO:
- En la consola de Google Cloud , navega a la página Seguridad > Google SecOps.
- Haz clic en la pestaña Inicio de sesión único y, luego, selecciona Federación de identidades de personal.
- En la lista de proveedores disponibles, selecciona el proveedor de la federación de identidades de personal que creaste en Crea un proveedor de grupos de identidades de personal.
- Opcional: Para probar la configuración de SSO, haz clic en Probar configuración de SSO. Si la configuración se realiza correctamente, se te redireccionará a la pantalla de acceso de tu IdP.
- Haz clic en Guardar.
Administra la configuración de la federación de identidades de personal
En esta sección, se explica cómo actualizar la configuración del proveedor y verificar que los niveles de acceso de los usuarios estén configurados correctamente.
Verifica o configura el control de acceso a las funciones de Google SecOps
Si configuraste la federación de identidades de personal con atributos o grupos asignados
al atributo google.groups, esta información se pasa a Google SecOps
para que puedas configurar RBAC en las funciones de Google SecOps.
Si la instancia de Google SecOps tiene una configuración de RBAC existente, verifica que la configuración original funcione como se espera.
Si no configuraste el control de acceso antes, consulta Configura el control de acceso a las funciones con IAM para obtener información sobre cómo controlar el acceso a las funciones.
Modifica la configuración de la federación de identidades de personal
Si necesitas actualizar el grupo de Workforce Identity o el proveedor de personal, consulta Administra proveedores de grupos de Workforce Identity para obtener información sobre cómo actualizar la configuración.
En la sección Administración de claves de Crea un proveedor de grupos de personal de SAML, se describe cómo actualizar las claves de firma del IdP y, luego, actualizar la configuración del proveedor de personal con el archivo XML de metadatos de la aplicación más reciente. Para los proveedores de OIDC, consulta Actualiza un proveedor y Administra JWK de OIDC.
Console
Para actualizar un grupo de personal específico, haz lo siguiente:
Ve a la página federación de identidades de personal.
En la tabla, elige el grupo.
Actualiza los parámetros del grupo.
Haz clic en Guardar grupo.
Para actualizar un proveedor, haz lo siguiente:
Ve a la página federación de identidades de personal.
En la tabla, elige el grupo para el que deseas actualizar el proveedor.
En la tabla Proveedores, haz clic en Editar.
Actualiza los detalles del proveedor.
Para guardar los detalles actualizados del proveedor, haz clic en Guardar.
gcloud
A continuación, se muestra un comando gcloud de ejemplo que actualiza la configuración del proveedor de personal:
gcloud iam workforce-pools providers update-saml WORKFORCE_PROVIDER_ID \
--workforce-pool=WORKFORCE_POOL_ID \
--location="global" \
--display-name="WORKFORCE_PROVIDER_DISPLAY_NAME" \
--description="WORKFORCE_PROVIDER_DESCRIPTION" \
--idp-metadata-path=PATH_TO_METADATA_XML \
--attribute-mapping="ATTRIBUTE_MAPPINGS"
Reemplaza lo siguiente:
WORKFORCE_PROVIDER_ID: el valor que definiste para el ID del proveedor de personal.WORKFORCE_POOL_ID: Es el valor que definiste para el ID del grupo de identidades de personal.WORKFORCE_PROVIDER_DISPLAY_NAME: un nombre fácil de usar para el proveedor de personal. El valor debe tener menos de 32 caracteres.WORKFORCE_PROVIDER_DESCRIPTION: Es la descripción del proveedor de personal.PATH_TO_METADATA_XML: Es la ubicación del archivo XML de metadatos de la aplicación actualizado, por ejemplo:/path/to/sso_metadata_updated.xml.ATTRIBUTE_MAPPINGS: Son los atributos de aserción asignados a los atributos deGoogle Cloud . Por ejemplo:
google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.memberOf
Soluciona problemas de configuración
Si encuentras errores durante este proceso, consulta
Soluciona problemas de la federación de identidades de personal
para resolver problemas habituales. Si tu organización usa firewalls o proxies web,
verifica que la lista de entidades permitidas de tu red incluya los dominios de autenticación y
federación de identidades de personal requeridos, como
auth.backstory.chronicle.security, iam.googleapis.com,
accounts.google.com y dominios
accounts.google.ccTLD regionales. Para obtener más información, consulta
Acceso a la red y lista de dominios permitidos.
En la siguiente sección, se proporciona información sobre los problemas habituales
que se producen cuando se realizan los pasos de este documento.
Si los problemas persisten, comunícate con tu representante de Google SecOps y proporciona tu archivo de registros de red de Chrome.
No se encontró el comando
Cuando creas un proveedor de grupos de Workforce Identity y especificas los detalles del IdP, obtienes el siguiente error:
Error: bash: --attribute-mapping=google.subject=assertion.subject, google.display_name=assertion.attributes.name[0], google.groups=assertion.attributes.groups: command not found
Verifica que PATH_TO_METADATA_XML sea la ubicación en la que subiste el archivo en formato XML de metadatos de la aplicación de SAML a tu directorio principal de Cloud Shell.
El emisor no tiene permiso
Cuando ejecutas el comando
gcloud projects add-iam-policy-bindingpara otorgar roles a usuarios o grupos, recibes el siguiente error:ERROR: (gcloud.organizations.add-iam-policy-binding) User [ ] does not have permission to access organizations instance [538073083963:getIamPolicy] (or it may not exist): The caller does not have permission
Verifica que tengas los permisos necesarios. Para obtener más información, consulta las Funciones requeridas.
Error de verificación: Falta el ID de sesión en la solicitud
Cuando intentas autenticarte, aparece el siguiente error en el navegador:
Verification failure: missing session ID in request
Verifica que las URLs base del ACS y del ID de la entidad sean correctas. Para obtener más información, consulta Configura la aplicación del IdP.
Depura tu token de IdP
Puedes usar la función Depurar token de IdP en la federación de identidades de personal para verificar que tu proveedor de identidad pase los atributos y las reclamaciones correctos. Esto es muy recomendable antes de que los usuarios intenten acceder a Google SecOps, ya que puede ayudar a evitar errores de acceso y de asignación de atributos.
Para depurar tu token, haz lo siguiente:
- En la consola de Google Cloud , navega a Federación de identidades de personal.
- Selecciona tu grupo y, luego, tu proveedor.
- Haz clic en Depurar token de IdP.
Para obtener una explicación detallada sobre cómo usar esta función para validar tu configuración, consulta la guía de validación previa a la migración.
JWT de depuración superior a 4 KB
Si tienes problemas para acceder a Google SecOps, asegúrate de que tus tokens web JSON (JWT) no superen el límite de 4 KB para Google SecOps. Si un usuario recibe un error que indica "Authentication JWT larger than 4KB. Reduce los datos de membresía del grupo que se envían desde el IdP para resolver este error.", sigue estos pasos para solucionar el problema:
- Depura tu token: Puedes depurar tu token en la página de detalles del proveedor dentro de la federación de identidades de personal (navegando a Federación de identidades de personal > Grupos de personal > POOL_NAME > PROVIDER_NAME y haciendo clic en Depurar token de IdP). Para usar esta función, primero debes agregar la URL de Google Cloud a las URLs de redireccionamiento de tu proveedor de identidad. Esto se aplica a los protocolos SAML y OIDC. Para obtener más información, consulta Soluciona problemas de la federación de identidades de personal.
Filtrar reclamaciones de grupos: Si tu proveedor de identidad envía muchos grupos no relacionados con Google SecOps, filtra la reclamación de grupos a nivel del proveedor. Configurar tu proveedor externo para que envíe solo el conjunto mínimo de grupos necesarios para Google SecOps reduce el tamaño del JWT y evita errores de autenticación.
- Ejemplo (Microsoft Entra ID): Puedes usar el filtrado de grupos de Microsoft Entra para enviar solo un conjunto mínimo de grupos relevantes. En tu aplicación empresarial de Entra, en Single sign-on, edita la reclamación de Groups para aplicar un filtro (por ejemplo, con una coincidencia de prefijo) de modo que solo se envíen los grupos obligatorios a Google SecOps. Para obtener más información, consulta Filtrado de grupos de Microsoft Entra.
¿Qué sigue?
Después de completar los pasos de este documento, haz lo siguiente:
Sigue los pasos para vincular una instancia de Google SecOps a los servicios de Google Cloud .
Si aún no configuraste el registro de auditoría, continúa con la habilitación del registro de auditoría de Google SecOps.
Si estás configurando Google Security Operations, realiza pasos adicionales en Aprovisiona, autentica y asigna usuarios en Google Security Operations.
Para configurar el acceso a las funciones, realiza los pasos adicionales que se indican en Configura el control de acceso a las funciones con IAM y Permisos de Google SecOps en IAM.
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.