En este documento, se muestra cómo configurar la federación de identidades de personal con el proveedor de identidad (IdP) de Microsoft Entra ID y administrar el acceso aGoogle Cloud. Luego, los usuarios federados pueden acceder a los Google Cloud servicios que admiten la federación de identidades de personal. Puedes usar el protocolo OIDC o el protocolo SAML 2.0 para federar identidades.
Antes de comenzar
- Asegúrate de tener una Google Cloud organización configurada.
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- En Microsoft Entra ID, asegúrate de que los tokens de ID estén habilitados para el flujo implícito. Para obtener más información, consulta Habilita el otorgamiento implícito de tokens de ID.
- Para el acceso, tu IdP debe proporcionar información de autenticación firmada: los IdP de OIDC deben proporcionar un JWT y las respuestas del IdP de SAML deben estar firmadas.
- Para recibir información importante sobre los cambios en tu organización o productos deGoogle Cloud , debes proporcionar Contactos esenciales. Para obtener más información, consulta la descripción general de la federación de identidades de personal.
Roles obligatorios
Para obtener los permisos que necesitas para configurar la federación de identidades de personal, pídele a tu administrador que te otorgue el rol de IAM Administrador de grupos de trabajadores de IAM (roles/iam.workforcePoolAdmin
) en la organización.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
Si configuras permisos en un entorno de desarrollo o de prueba, pero no en un
entorno de producción, puedes otorgar el rol básico de propietario
de IAM (roles/owner
), que también incluye permisos para la
federación de identidades de personal.
Crea una aplicación de Microsoft Entra ID
En esta sección, se muestra cómo crear una aplicación de Microsoft Entra ID con el Portal de administración de Microsoft Entra. Como alternativa, puedes actualizar tu aplicación existente. Para obtener más detalles, consulta Cómo establecer aplicaciones en el ecosistema de Microsoft Entra ID.Los grupos de identidades de personal admiten la federación mediante el uso de protocolos OIDC y SAML.
OIDC
Para crear un registro de la aplicación de Microsoft Entra ID que use el protocolo OIDC, haz lo siguiente:
Accede al portal de administración de Microsoft Entra.
Ve a Identidad > Aplicaciones > Registros de apps.
Para comenzar a configurar el registro de la aplicación, haz lo siguiente:
Haz clic en Registro nuevo.
Ingresa un nombre para tu aplicación.
En Tipos de cuentas compatibles, selecciona una opción.
En la sección URI de redireccionamiento, en la lista desplegable Seleccionar una plataforma, selecciona Web.
En el campo de texto, ingresa una URL de redireccionamiento. Se redirecciona a tus usuarios a esta URL después de que acceden de forma correcta. Si configuras el acceso a la consola (federada), usa el siguiente formato de URL:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
Reemplaza lo siguiente:
WORKFORCE_POOL_ID
: Un ID de grupo de identidades de personal que usarás cuando crees el grupo de identidades de personal más adelante en este documento; por ejemplo:entra-id-oidc-pool
WORKFORCE_PROVIDER_ID
: Un ID de proveedor de grupos de identidades de personal que usarás cuando crees el proveedor de grupos de identidades de personal más adelante en este documento; por ejemplo:entra-id-oidc-pool-provider
Para obtener información sobre el formato del ID, consulta la sección Parámetros de consulta en la documentación de la API.
Para crear el registro de la aplicación, haz clic en Registrar.
Para usar la asignación de atributos de ejemplo que se proporciona más adelante en este documento, debes crear un atributo
department
personalizado.
Opción recomendada: Como práctica recomendada de seguridad, te recomendamos que configures una reclamación de grupo. Para ello, sigue estos pasos:
Ve al registro de la aplicación de Microsoft Entra ID.
Haz clic en Configuración del token.
Haz clic en Agregar reclamación de grupo.
Selecciona los tipos de grupos que se mostrarán. Para obtener más detalles, consulta Configura reclamaciones opcionales de grupos.
SAML
Para crear un registro de la aplicación de Microsoft Entra ID que use el protocolo SAML, haz lo siguiente:
Accede al portal de administración de Microsoft Entra.
Ve a Identidad > Aplicaciones > Registros de apps.
Para comenzar a configurar la aplicación empresarial, haz lo siguiente:
Haz clic en Nueva aplicación > Crear tu nueva aplicación.
Ingresa un nombre para tu aplicación.
Haz clic en Crear.
Ve a Inicio de sesión único > SAML.
Actualiza la Configuración básica del SAML de la siguiente manera:
En el campo Identificador (ID de entidad), ingresa el siguiente valor:
https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
Reemplaza lo siguiente:
WORKFORCE_POOL_ID
: Un ID de grupo de identidades de personal que usarás cuando crees el grupo de identidades de personal más adelante en este documento; por ejemplo:entra-id-saml-pool
WORKFORCE_PROVIDER_ID
: Un ID de proveedor de identidades de personal que usarás cuando crees el proveedor de identidades de personal más adelante en este documento; por ejemplo:entra-id-saml-pool-provider
Para obtener información sobre el formato del ID, consulta la sección Parámetros de consulta en la documentación de la API.
En el campo URL de respuesta (URL del servicio de confirmación de consumidores), ingresa una URL de redireccionamiento. Se redirecciona a tus usuarios a esta URL después de que acceden de forma correcta. Si configuras el acceso a la consola (federada), usa el siguiente formato de URL:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
Reemplaza lo siguiente:
WORKFORCE_POOL_ID
: El ID del grupo de identidades de personalWORKFORCE_PROVIDER_ID
: El ID del proveedor de identidades de personal
Para habilitar el inicio de sesión iniciado por IdP, establece el campo Estado de retransmisión en el siguiente valor:
https://console.cloud.google/
Para guardar la configuración de la aplicación de SAML, haz clic en Guardar.
Para usar la asignación de atributos de ejemplo que se proporciona más adelante en este documento, debes crear un atributo
department
personalizado.
Opción recomendada: Como práctica recomendada de seguridad, te recomendamos que configures una reclamación de grupo. Para ello, sigue estos pasos:
Ve a tu aplicación de Microsoft Entra ID.
Haz clic en Inicio de sesión único.
En la sección Atributos y reclamaciones, haz clic en Editar.
Haz clic en Agregar una reclamación de grupo.
Selecciona el tipo de grupo que se mostrará. Para obtener más detalles, consulta Agrega reclamaciones de grupos a tokens para aplicaciones de SAML mediante la configuración de SSO.
Crea un grupo de Workforce 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 identidad del personal. Los grupos de identidades de Workforce 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.
La duración de la sesión se establece de forma predeterminada. Para ingresar una duración de la sesión personalizada, haz clic en Editar. La duración de la sesión determina el tiempo de acceso a los tokens de acceso de Google Cloud, las sesiones de acceso de la consola (federada) y las sesiones de acceso de la gcloud CLI de este grupo de personal son válidas. La duración debe ser superior a 15 minutos (900 s) y menor a 12 horas (43200 s). Si la duración de la sesión no se establece, el valor predeterminado es de una hora (3,600 s).
Para crear el grupo en el estado habilitado, asegúrate de que la opción Grupo habilitado esté activada.
Para crear el grupo de identidades de personal, haz clic en Siguiente.
gcloud
Para crear el grupo de identidades de personal, ejecuta el siguiente comando:
gcloud iam workforce-pools create WORKFORCE_POOL_ID \
--organization=ORGANIZATION_ID \
--display-name="DISPLAY_NAME" \
--description="DESCRIPTION" \
--session-duration=SESSION_DURATION \
--location=global
Reemplaza lo siguiente:
WORKFORCE_POOL_ID
: Es un ID que elijas para representar el Google Cloud grupo de personal. Para obtener información sobre el formato del ID, consulta la sección Parámetros de consulta en la documentación de la API.ORGANIZATION_ID
: El ID numérico de la organización de tu Google Cloud organización para el grupo de identidades de personal. Los grupos de identidad del personal están disponibles en todos los proyectos y carpetas de la organización.DISPLAY_NAME
: Opcional Un nombre visible para tu grupo de identidad del personal.DESCRIPTION
: Opcional Una descripción del grupo de identidad del personal.SESSION_DURATION
: Opcional La duración de la sesión, que determina el tiempo de acceso a los tokens de acceso de Google Cloud, las sesiones de acceso de la consola (federada) y las sesiones de acceso de la gcloud CLI de este grupo de personal son válidas. La duración debe ser superior a 15 minutos (900 s) y menor a 12 horas (43200 s). Si la duración de la sesión no se establece, el valor predeterminado es de una hora (3,600 s).
Crea el proveedor de grupos de identidades de personal de Microsoft Entra ID
En esta sección, se describe cómo crear un proveedor de grupos de identidades de personal para permitir que los usuarios de tu IdP accedan a Google Cloud. Puedes configurar el proveedor para que use el protocolo OIDC o SAML.
Crea un proveedor de grupos de identidad de trabajadores de OIDC
Para crear un proveedor de grupos de identidades de personal para tu integración de la aplicación de Microsoft Entra ID mediante el protocolo OIDC, haz lo siguiente:
Para obtener el URI de la entidad emisora de tu aplicación de Microsoft Entra ID, haz lo siguiente:
- Ve al registro de la aplicación de Microsoft Entra ID.
- Haz clic en Extremos.
- Abre el documento de metadatos de OpenID Connect en una pestaña nueva.
- En el archivo JSON, copia el valor de
issuer
.
Para obtener el ID de cliente de tu aplicación de Microsoft Entra ID, haz lo siguiente:
- Ve al registro de la aplicación de Microsoft Entra ID.
- En ID de la aplicación (cliente), copia el valor.
Para crear un proveedor de grupos de Workforce Identity de OIDC para el acceso basado en la Web, haz lo siguiente:
Console
Flujo de código
Para crear un proveedor de OIDC que use el flujo de código de autorización para el acceso basado en la Web, haz lo siguiente:
Para obtener el secreto del cliente de Microsoft Entra ID, haz lo siguiente:
Ve al registro de la app de Microsoft Entra ID.
En Certificados y secretos, haz clic en la pestaña Secretos del cliente.
Para agregar un secreto del cliente, haz clic en + Nuevo secreto del cliente.
En el cuadro de diálogo Agregar un secreto del cliente, ingresa la información, según sea necesario.
Para crear el secreto del cliente, haz clic en Agregar.
En la pestaña Secretos del cliente, busca el secreto del cliente nuevo.
En la columna Valor de tu secreto de cliente nuevo, haz clic en content_copy Copiar.
En la consola de Google Cloud, para crear un proveedor de OIDC que use el flujo de código de autorización, 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 tabla Proveedores, haz clic en Agregar proveedor.
En Seleccionar un protocolo, selecciona Open ID Connect (OIDC).
En Crear un proveedor de grupos, haz lo siguiente:
- En Nombre, ingresa el nombre del proveedor.
- En Emisor (URL), ingresa el URI de la entidad emisora. El URI de la entidad emisora de OIDC debe tener un formato de URI válido y comenzar con
https
; por ejemplo,https://example.com/oidc
. - Ingresa el ID de cliente, el ID de cliente de OIDC que está registrado con el IdP de OIDC; el ID debe coincidir con la reclamación
aud
del JWT que emite el IdP. - Para crear un proveedor habilitado, asegúrate de que la opción Enabled Provider esté activada.
- Haz clic en Continuar.
En Tipo de flujo, haz lo siguiente: El tipo de flujo solo se usa para un flujo de inicio de sesión único basado en la Web.
- En Tipo de flujo, selecciona Código.
- En Secreto de cliente, ingresa el secreto de cliente de tu IdP.
En Comportamiento de los reclamos de aserciones, selecciona una de las siguientes opciones:
- Información del usuario y token de ID
- Solo token de ID
Haz clic en Continuar.
En Configurar proveedor, puedes configurar una asignación de atributos y una condición de atributo. Para crear una asignación de atributos, haz lo siguiente: Puedes proporcionar el nombre del campo del IdP o una expresión con formato CEL que devuelva una cadena.
Obligatorio: En OIDC 1, ingresa el asunto del IdP, por ejemplo,
assertion.sub
.Para Microsoft Entra ID con autenticación de OIDC, te recomendamos las siguientes asignaciones de atributos:
google.subject=assertion.sub, google.groups=assertion.groups, google.display_name=assertion.preferred_username
En este ejemplo, se asignan los atributos de IdP
subject
,groups
ypreferred_username
a los atributos Google Cloudgoogle.subject
,google.groups
ygoogle.display_name
, respectivamente.Opcional: Para agregar asignaciones de atributos adicionales, haz lo siguiente:
- Haz clic en Agregar asignación.
- En Google n, donde n es un número, ingresa una de las claves compatibles conGoogle Cloud.
- En el campo OIDC n correspondiente, ingresa el nombre del campo específico de la IdP que deseas asignar, en formato CEL.
Para crear una condición de atributo, haz lo siguiente:
- Haz clic en Agregar condición:
- En Condiciones del atributo, ingresa una condición en formato CEL. Por ejemplo, para limitar el atributo
ipaddr
a un rango de IP determinado que puedes establecer la condiciónassertion.ipaddr.startsWith('98.11.12.')
.
Para crear el proveedor, haz clic en Enviar.
Flujo implícito
Para crear un proveedor de OIDC que use el flujo implícito para el acceso basado en la Web, 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 tabla Proveedores, haz clic en Agregar proveedor.
En Seleccionar un protocolo, selecciona Open ID Connect (OIDC).
En Crear un proveedor de grupos, haz lo siguiente:
- En Nombre del proveedor, ingresa un nombre para el proveedor.
- En Emisor (URL), ingresa el URI de la entidad emisora. El URI de la entidad emisora de OIDC debe tener un formato de URI válido y comenzar con
https
; por ejemplo,https://example.com/oidc
. - Ingresa el ID de cliente, el ID de cliente de OIDC que está registrado con el IdP de OIDC; el ID debe coincidir con la reclamación
aud
del JWT que emite el IdP. - Para crear un proveedor habilitado, asegúrate de que la opción Enabled Provider esté activada.
- Haz clic en Continuar.
En Tipo de flujo, haz lo siguiente: El tipo de flujo solo se usa para un flujo de inicio de sesión único basado en la Web.
- En Tipo de flujo, selecciona Token de ID.
- Haz clic en Continuar.
En Configurar proveedor, puedes configurar una asignación de atributos y una condición de atributo. Para crear una asignación de atributos, haz lo siguiente: Puedes proporcionar el nombre del campo del IdP o una expresión con formato CEL que devuelva una cadena.
Obligatorio: En OIDC 1, ingresa el asunto del IdP, por ejemplo,
assertion.sub
.Para Microsoft Entra ID con autenticación de OIDC, te recomendamos las siguientes asignaciones de atributos:
google.subject=assertion.sub, google.groups=assertion.groups, google.display_name=assertion.preferred_username
En este ejemplo, se asignan los atributos de IdP
subject
,groups
ypreferred_username
a los atributos Google Cloudgoogle.subject
,google.groups
ygoogle.display_name
, respectivamente.Opcional: Para agregar asignaciones de atributos adicionales, haz lo siguiente:
- Haz clic en Agregar asignación.
- En Google n, donde n es un número, ingresa una de las claves compatibles conGoogle Cloud.
- En el campo OIDC n correspondiente, ingresa el nombre del campo específico de la IdP que deseas asignar, en formato CEL.
Para crear una condición de atributo, haz lo siguiente:
- Haz clic en Agregar condición:
En Condiciones del atributo, ingresa una condición en formato CEL. Por ejemplo, para limitar el atributo
ipaddr
a un rango de IP determinado que puedes establecer la condiciónassertion.ipaddr.startsWith('98.11.12.')
.
Para crear el proveedor, haz clic en Enviar.
gcloud
Para crear un proveedor que admita el protocolo OIDC, haz lo siguiente:
Flujo de código
Para crear un proveedor de OIDC que use el flujo de código de autorización para el acceso basado en la Web, haz lo siguiente:
En tu aplicación de Microsoft Entra ID, para obtener el secreto del cliente, haz lo siguiente:
Ve al registro de la app de Microsoft Entra ID.
En Certificados y secretos, haz clic en la pestaña Secretos del cliente.
Para agregar un secreto del cliente, haz clic en + Nuevo secreto del cliente.
En el cuadro de diálogo Agregar un secreto del cliente, ingresa la información, según sea necesario.
Para crear el secreto del cliente, haz clic en Agregar.
En la pestaña Secretos del cliente, busca el secreto del cliente nuevo.
En la columna Valor de tu secreto de cliente nuevo, haz clic en content_copy Copiar.
En la consola de Google Cloud, para crear un proveedor de OIDC que use el flujo de código, haz lo siguiente:
gcloud iam workforce-pools providers create-oidc WORKFORCE_PROVIDER_ID \ --workforce-pool=WORKFORCE_POOL_ID \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION" \ --issuer-uri="ISSUER_URI" \ --client-id="OIDC_CLIENT_ID" \
--client-secret-value="OIDC_CLIENT_SECRET" \ --web-sso-response-type="code" \ --web-sso-assertion-claims-behavior="merge-user-info-over-id-token-claims" \ --web-sso-additional-scopes="WEB_SSO_ADDITIONAL_SCOPES" \ --attribute-mapping="ATTRIBUTE_MAPPING" \ --attribute-condition="ATTRIBUTE_CONDITION" \ --jwk-json-path="JWK_JSON_PATH" \ --location=globalReemplaza lo siguiente:
WORKFORCE_PROVIDER_ID
: Un ID de proveedor de grupos de identidades de personal único. El prefijogcp-
está reservado y no se puede usar en un grupo de identidad de personal ni en el ID de proveedor del grupo de identidad de personal.WORKFORCE_POOL_ID
: El ID del grupo de identidades de personal al que se conecta el IdP.DISPLAY_NAME
: un nombre visible opcional, fácil de usar para el proveedor, por ejemplo,idp-eu-employees
.DESCRIPTION
: una descripción opcional del proveedor de personal, por ejemplo,IdP for Partner Example Organization employees
.ISSUER_URI
: El URI de la entidad emisora de OIDC, en un formato de URI válido, que comienza conhttps
; por ejemplo:https://example.com/oidc
. Nota: Por motivos de seguridad,ISSUER_URI
debe usar el esquema HTTPS.OIDC_CLIENT_ID
: El ID de cliente de OIDC que está registrado con el IdP de OIDC. El ID debe coincidir con la reclamaciónaud
del JWT que emite el IdP.OIDC_CLIENT_SECRET
: El secreto del cliente de OIDC.WEB_SSO_ADDITIONAL_SCOPES
: Permisos adicionales opcionales así enviarle al IdP de OIDC para la consola (federada) o el acceso basado en el navegador de la gcloud CLI.ATTRIBUTE_MAPPING
: Una asignación de atributos. Para Microsoft Entra ID con autenticación de OIDC, te recomendamos las siguientes asignaciones de atributos:google.subject=assertion.sub, google.groups=assertion.groups, google.display_name=assertion.preferred_username
En este ejemplo, se asignan los atributos de IdP
subject
,groups
ypreferred_username
a los atributos Google Cloudgoogle.subject
,google.groups
ygoogle.display_name
, respectivamente.ATTRIBUTE_CONDITION
: Una condición de atributos, por ejemplo, para limitar el atributoipaddr
a un rango de IP determinado, puedes establecer la condiciónassertion.ipaddr.startsWith('98.11.12.')
.JWK_JSON_PATH
: Una ruta de acceso opcional a un JWK de OIDC subido de forma local. Si no se proporciona este parámetro, Google Cloud en su lugar, usa la ruta de acceso/.well-known/openid-configuration
de tu IdP para obtener los JWK que contienen las claves públicas. Para obtener más información sobre los JWK de OIDC subidos de forma local, consulta Administra los JWK de OIDC.
locations/global/workforcePools/enterprise-example-organization-employees
.
Flujo implícito
A fin de crear un proveedor de OIDC que use el flujo implícito para el acceso web, haz lo siguiente:
Para habilitar el token de ID en tu aplicación de Microsoft Entra ID, haz lo siguiente:
- Ve al registro de la aplicación de Microsoft Entra ID.
- En Autenticación, selecciona la casilla de verificación Token de ID.
- Haz clic en Guardar.
Para crear la política, ejecuta el siguiente comando:
gcloud iam workforce-pools providers create-oidc WORKFORCE_PROVIDER_ID \ --workforce-pool=WORKFORCE_POOL_ID \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION" \ --issuer-uri="ISSUER_URI" \ --client-id="OIDC_CLIENT_ID" \ --web-sso-response-type="id-token" \ --web-sso-assertion-claims-behavior="only-id-token-claims" \ --web-sso-additional-scopes="WEB_SSO_ADDITIONAL_SCOPES" \ --attribute-mapping="ATTRIBUTE_MAPPING" \ --attribute-condition="ATTRIBUTE_CONDITION" \ --jwk-json-path="JWK_JSON_PATH" \ --location=global
Reemplaza lo siguiente:
WORKFORCE_PROVIDER_ID
: Un ID de proveedor de grupos de identidades de personal único. El prefijogcp-
está reservado y no se puede usar en un grupo de identidad de personal ni en el ID de proveedor del grupo de identidad de personal.WORKFORCE_POOL_ID
: El ID del grupo de identidades de personal al que se conecta el IdP.DISPLAY_NAME
: un nombre visible opcional, fácil de usar para el proveedor, por ejemplo,idp-eu-employees
.DESCRIPTION
: una descripción opcional del proveedor de personal, por ejemplo,IdP for Partner Example Organization employees
.ISSUER_URI
: El URI de la entidad emisora de OIDC, en un formato de URI válido, que comienza conhttps
; por ejemplo:https://example.com/oidc
. Nota: Por motivos de seguridad,ISSUER_URI
debe usar el esquema HTTPS.OIDC_CLIENT_ID
: El ID de cliente de OIDC que está registrado con el IdP de OIDC. El ID debe coincidir con la reclamaciónaud
del JWT que emite el IdP.WEB_SSO_ADDITIONAL_SCOPES
: Permisos adicionales opcionales así enviarle al IdP de OIDC para la consola (federada) o el acceso basado en el navegador de la gcloud CLI.ATTRIBUTE_MAPPING
: Una asignación de atributos. Para Microsoft Entra ID con autenticación de OIDC, te recomendamos las siguientes asignaciones de atributos:google.subject=assertion.sub, google.groups=assertion.groups, google.display_name=assertion.preferred_username
En este ejemplo, se asignan los atributos de IdP
subject
,groups
ypreferred_username
a los atributos Google Cloudgoogle.subject
,google.groups
ygoogle.display_name
, respectivamente.ATTRIBUTE_CONDITION
: Una condición de atributos, por ejemplo, para limitar el atributoipaddr
a un rango de IP determinado, puedes establecer la condiciónassertion.ipaddr.startsWith('98.11.12.')
.JWK_JSON_PATH
: Una ruta de acceso opcional a un JWK de OIDC subido de forma local. Si no se proporciona este parámetro, Google Cloud en su lugar, usa la ruta de acceso/.well-known/openid-configuration
de tu IdP para obtener los JWK que contienen las claves públicas. Para obtener más información sobre los JWK de OIDC subidos de forma local, consulta Administra los JWK de OIDC.
locations/global/workforcePools/enterprise-example-organization-employees
.
Crea un proveedor de grupos de identidades de personal de SAML 2.0
En tu IdP de SAML, registra una aplicación nueva para la federación de identidades de personal de Google Cloud.
Configura el público para las aserciones de SAML. Por lo general, es el campo
SP Entity ID
en la configuración de IdP. Debes configurarla en la siguiente URL:https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
Si planeas configurar el acceso de usuario a la consola, en tu IdP de SAML, configura la URL de redireccionamiento o el campo de URL del servicio de confirmación de consumidores (ACS) en la siguiente URL:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
Reemplaza lo siguiente:
WORKFORCE_POOL_ID
: el ID del grupo de la identidad de personalWORKFORCE_PROVIDER_ID
: El ID del proveedor del grupo de identidades de personal que crearás más adelante en este documento.
Consulta Configura el acceso de usuario a la consola para obtener más detalles sobre la configuración del acceso a la consola.
En Google Cloud, crea un proveedor de grupos de identidad de trabajadores de SAML mediante el documento de metadatos de SAML de tu IdP. Puedes descargar el documento XML de metadatos de SAML desde tu IdP. El documento debe incluir al menos lo siguiente:
- Un ID de entidad de SAML para tu IdP.
- La URL de inicio de sesión único para tu IdP.
- Al menos una clave pública de firma. Consulta los requisitos de las claves más adelante en esta guía para obtener información sobre las claves de firma.
Console
Para configurar el proveedor de SAML con la consola de Google Cloud, 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 tabla Proveedores, haz clic en Agregar proveedor.
En Selecciona un protocolo, selecciona SAML.
En Crea un proveedor de grupos, 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 Proveedor habilitado esté habilitada.
Haz clic en Continuar.
En Configurar proveedor, haz lo siguiente:
En Asignación de atributos, ingresa una expresión CEL para
google.subject
.Opcional: Para ingresar otras asignaciones, haz clic en Agregar asignación y, luego, ingresa otras asignaciones:
En este ejemplo, se asignan los atributos de IdPgoogle.subject=assertion.subject, google.groups=assertion.attributes['https://example.com/aliases'], attribute.costcenter=assertion.attributes.costcenter[0]
assertion.subject
,assertion.attributes['https://example.com/aliases']
yassertion.attributes.costcenter[0]
a los atributos Google Cloudgoogle.subject
,google.groups
ygoogle.costcenter
, respectivamente.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
ipaddr
a 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 mediante este proveedor de personal.Haga clic en Continuar.
Para crear el proveedor, haz clic en Enviar.
gcloud
Para guardar los metadatos de SAML de tu aplicación de Microsoft Entra ID, haz lo siguiente:
- Ve a tu aplicación de Microsoft Entra ID.
- Haz clic en Inicio de sesión único.
- En la sección Certificados SAML, descarga el XML de metadatos de la federación.
- Guarda los metadatos como un archivo XML local.
Para crear el proveedor de grupos de identidades de personal de SAML, ejecuta el siguiente comando:
gcloud iam workforce-pools providers create-saml WORKFORCE_PROVIDER_ID \
--workforce-pool="WORKFORCE_POOL_ID" \
--display-name="DISPLAY_NAME" \
--description="DESCRIPTION" \
--idp-metadata-path="XML_METADATA_PATH" \
--attribute-mapping="ATTRIBUTE_MAPPING" \
--attribute-condition="ATTRIBUTE_CONDITION" \
--location=global
Reemplaza lo siguiente:
WORKFORCE_PROVIDER_ID
: Un ID de proveedor.WORKFORCE_POOL_ID
: El ID del grupo de identidades de personal.DISPLAY_NAME
: Es un nombre visible.DESCRIPTION
: Una descripción.XML_METADATA_PATH
: La ruta de acceso al archivo de metadatos con formato XML con metadatos de configuración para el proveedor de identidad SAML.ATTRIBUTE_MAPPING
: Es la asignación de atributos; por ejemplo: En este ejemplo, se asignan los atributos de IdPgoogle.subject=assertion.subject, google.groups=assertion.attributes['https://example.com/aliases'], attribute.costcenter=assertion.attributes.costcenter[0]
assertion.subject
,assertion.attributes['https://example.com/aliases']
yassertion.attributes.costcenter[0]
a los atributos Google Cloudgoogle.subject
,google.groups
ygoogle.costcenter
, respectivamente.Para obtener más información, consulta Asignación de atributos.
ATTRIBUTE_CONDITION
: Es una condición de atributo opcional. Por ejemplo, para limitar el atributoipaddr
a 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 mediante este proveedor de personal.
Opcional: Acepta las aserciones de SAML encriptadas de tu IdP
Para permitir que tu IdP de SAML 2.0 produzca aserciones de SAML encriptadas que la federación de identidades de personal pueda aceptar, haz lo siguiente:
- En la federación de identidades de personal, haz lo siguiente:
- Crea un par de claves asimétricas para tu proveedor de grupos de identidades de personal.
- Descargar un archivo de certificado que contenga la clave pública
- Configura tu IdP de SAML para usar la clave pública a fin de encriptar las aserciones de SAML que emite.
- En el IdP, haz lo siguiente:
- Habilita la encriptación de aserciones, también conocida como encriptación de tokens.
- Sube la clave pública que creaste en la federación de identidades de personal.
- Confirma que tu IdP produzca aserciones de SAML encriptadas.
Crea claves de encriptación de aserciones de SAML de la federación de identidades de personal
En esta sección, se explica cómo crear un par de claves asimétricas que permite que la federación de identidades de personal acepte aserciones de SAML encriptadas.
Google Cloud usa la clave privada para desencriptar las aserciones de SAML que emite tu IdP. Para crear un par de claves asimétricas que se usarán con la encriptación SAML, ejecuta el siguiente comando. Para obtener más información, consulta Algoritmos de encriptación de SAML compatibles.
gcloud iam workforce-pools providers keys create KEY_ID \ --workforce-pool WORKFORCE_POOL_ID \ --provider WORKFORCE_PROVIDER_ID \ --location global \ --use encryption \ --spec KEY_SPECIFICATION
Reemplaza lo siguiente:
KEY_ID
: un nombre de clave que elijasWORKFORCE_POOL_ID
: el ID del grupoWORKFORCE_PROVIDER_ID
: El ID del proveedor del grupo de identidades de personal-
KEY_SPECIFICATION
: la especificación de clave, que puede serrsa-2048
,rsa-3072
yrsa-4096
.
Después de crear el par de claves, ejecuta el siguiente comando para descargar la clave pública en un archivo de certificado. Solo la federación de identidades de personal tiene acceso a la clave privada.
gcloud iam workforce-pools providers keys describe KEY_ID \ --workforce-pool WORKFORCE_POOL_ID \ --provider WORKFORCE_PROVIDER_ID \ --location global \ --format "value(keyData.key)" \ > CERTIFICATE_PATH
Reemplaza lo siguiente:
KEY_ID
: el nombre de la claveWORKFORCE_POOL_ID
: el ID del grupoWORKFORCE_PROVIDER_ID
: El ID del proveedor del grupo de identidades de personalCERTIFICATE_PATH
: la ruta en la que se escribe el certificado, por ejemplo,saml-certificate.cer
osaml-certificate.pem
Configura tu IdP compatible con SAML 2.0 para emitir aserciones de SAML encriptadas
Si deseas configurar Microsoft Entra ID para encriptar tokens de SAML, consulta Configura la encriptación de tokens de SAML de Azure Active Directory.
Después de configurar tu IdP para encriptar las aserciones de SAML, te recomendamos que te asegures de que las aserciones que genera en realidad estén encriptadas. Incluso con la encriptación de aserciones de SAML configurada, la federación de identidades de personal puede procesar aserciones de texto simple.
Borra claves de encriptación de la federación de identidades de personal
Para borrar claves de encriptación de SAML, ejecuta el siguiente comando:gcloud iam workforce-pools providers keys delete KEY_ID \ --workforce-pool WORKFORCE_POOL_ID \ --provider WORKFORCE_PROVIDER_ID \ --location global
Reemplaza lo siguiente:
KEY_ID
: el nombre de la claveWORKFORCE_POOL_ID
: el ID del grupoWORKFORCE_PROVIDER_ID
: El ID del proveedor del grupo de identidades de personal
Algoritmos de encriptación SAML compatibles
La federación de identidades de personal admite los siguientes algoritmos de transporte de claves:
- http://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p
- http://www.w3.org/2009/xmlenc11#rsa-oaep"
- http://www.w3.org/2001/04/xmlenc#rsa-1_5"
La federación de identidades de personal admite los siguientes algoritmos de encriptación de bloques:
Administra el acceso a los recursos de Google Cloud
En esta sección, se proporciona un ejemplo en el que se muestra cómo administrar el acceso a los recursos deGoogle Cloud mediante los usuarios de la federación de identidades de personal.
En este ejemplo, otorgas un rol de Identity and Access Management (IAM) en un proyecto de muestra. Luego, los usuarios pueden acceder y usar este proyecto para acceder a los productos de Google Cloud .
Puedes administrar los roles de IAM para identidades individuales, un grupo de identidades o un grupo completo. Para obtener más información, consulta Representa a los usuarios del grupo de la identidad de personal en políticas del IAM.
Usa grupos asignados
Para otorgar el rol de administrador de almacenamiento (roles/storage.admin
) a todas las identidades dentro del grupo GROUP_ID
en el proyecto TEST_PROJECT_ID
, ejecuta el siguiente comando:
gcloud projects add-iam-policy-binding TEST_PROJECT_ID \
--role="roles/storage.admin" \
--member="principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID"
Reemplaza lo siguiente:
TEST_PROJECT_ID
: El ID del proyecto de pruebaWORKFORCE_POOL_ID
: El ID del grupo de Workforce IdentityGROUP_ID
: un grupo en la reclamacióngoogle.groups
asignada.
Para la identidad única
Para otorgar el rol de administrador de almacenamiento (roles/storage.admin
) a una sola identidad para el proyecto TEST_PROJECT_ID
, ejecuta el siguiente comando:
gcloud projects add-iam-policy-binding TEST_PROJECT_ID \
--role="roles/storage.admin" \
--member="principal://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/subject/SUBJECT_VALUE"
Reemplaza lo siguiente:
TEST_PROJECT_ID
: El ID del proyecto de pruebaWORKFORCE_POOL_ID
: El ID del grupo de identidades de personalSUBJECT_VALUE
: La identidad del usuario
Usa el atributo de departamento asignado
Para otorgar el rol de administrador de almacenamiento (roles/storage.admin
) a todas las identidades dentro de un departamento específico para el proyecto TEST_PROJECT_ID
, ejecuta el siguiente comando:
gcloud projects add-iam-policy-binding TEST_PROJECT_ID \
--role="roles/storage.admin" \
--member="principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/attribute.department/DEPARTMENT_VALUE"
Reemplaza lo siguiente:
TEST_PROJECT_ID
: El ID del proyecto de pruebaWORKFORCE_POOL_ID
: El ID del grupo de Workforce IdentityDEPARTMENT_VALUE
: el valorattribute.department
asignado
Accede y prueba el acceso
En esta sección, accederás como un usuario del grupo de identidades de la fuerza laboral y probarás que tienes acceso a los recursos de Google Cloud .
Acceder
En esta sección, se muestra cómo acceder como un usuario federado y acceder a los recursos deGoogle Cloud .
Acceso a la consola (federada)
Para acceder a la Google Cloud consola de la federación de identidades de personal, también conocida como la consola (federada), haz lo siguiente:
-
Ve a la página de acceso de la consola (federada).
-
Ingresa el nombre del proveedor, que tiene el siguiente formato:
locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
Si se te solicita, ingresa las credenciales de usuario en Microsoft Entra ID.
Si inicias un acceso iniciado por IdP, usa lo siguiente para la URL de retransmisión: https://console.cloud.google/
.
Acceso con el navegador de la gcloud CLI
Para acceder a la gcloud CLI con un flujo de acceso basado en el navegador, haz lo siguiente:
Crea un archivo de configuración
Para crear el archivo de configuración de acceso, ejecuta el siguiente comando. De manera opcional, puedes activar el archivo como predeterminado para la CLI de gcloud agregando la marca --activate
.
Luego, puedes ejecutar gcloud auth login
sin especificar la ruta de acceso del archivo de configuración cada vez.
gcloud iam workforce-pools create-login-config \ locations/global/workforcePools/WORKFORCE_POOL_ID/providers/PROVIDER_ID \ --output-file=LOGIN_CONFIG_FILE_PATH
Reemplaza lo siguiente:
WORKFORCE_POOL_ID
: el ID del grupo de personalPROVIDER_ID
: el ID del proveedorLOGIN_CONFIG_FILE_PATH
: La ruta de acceso a un archivo de configuración que especifiques, por ejemplo,login.json
El archivo contiene los extremos que usa la gcloud CLI para habilitar el flujo de autenticación basado en el navegador y establecer el público en el IdP que se configuró en el proveedor del grupo de identidad de personal. El archivo no contiene información confidencial.
El resultado es similar al siguiente:
{ "type": "external_account_authorized_user_login_config", "audience": "//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID", "auth_url": "https://auth.cloud.google/authorize", "token_url": "https://sts.googleapis.com/v1/oauthtoken", "token_info_url": "https://googleapis.com/v1/introspect", }
Para evitar que
gcloud auth login
use este archivo de configuración automáticamente, puedes ejecutar gcloud config unset auth/login_config_file
para anular la configuración.
Accede con autenticación basada en el navegador
Para autenticar con la autenticación de acceso basada en el navegador, puedes usar uno de los siguientes métodos:
-
Si usaste la marca
--activate
cuando creaste el archivo de configuración o si activaste el archivo de configuración congcloud config set auth/login_config_file
, gcloud CLI usa el archivo de configuración de forma automática:gcloud auth login
-
Para acceder mediante la especificación de la ubicación del archivo de configuración, ejecuta el siguiente comando:
gcloud auth login --login-config=LOGIN_CONFIG_FILE_PATH
-
Para usar una variable de entorno a fin de especificar la ubicación del archivo de configuración, establece
CLOUDSDK_AUTH_LOGIN_CONFIG_FILE
en la ruta de configuración.
Inhabilita el acceso basado en el navegador
Para dejar de usar el archivo de configuración de acceso, haz lo siguiente:
-
Si usaste la marca
--activate
cuando creaste el archivo de configuración o si activaste el archivo de configuración congcloud config set auth/login_config_file
, debes ejecutar el siguiente comando para anularlo:gcloud config unset auth/login_config_file
-
Borra la variable de entorno
CLOUDSDK_AUTH_LOGIN_CONFIG_FILE
, si está configurada.
Acceso sin interfaz gráfica de la gcloud CLI
Para acceder a Microsoft Entra ID con la gcloud CLI, haz lo siguiente:
OIDC
Sigue los pasos de la página Envía la solicitud de acceso. Permite que el usuario acceda a tu aplicación con Microsoft Entra ID mediante OIDC.
Copia el token de ID del parámetro
id_token
de la URL de redireccionamiento y guárdalo en un archivo en una ubicación segura de tu máquina local. En el paso posterior, debes configurar PATH_TO_OIDC_ID_TOKEN en la ruta de acceso a este archivo.Genera un archivo de configuración similar al ejemplo que se muestra más adelante en este paso mediante la ejecución del siguiente comando:
gcloud iam workforce-pools create-cred-config \ locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID \ --subject-token-type=urn:ietf:params:oauth:token-type:id_token \ --credential-source-file=PATH_TO_OIDC_ID_TOKEN \ --workforce-pool-user-project=WORKFORCE_POOL_USER_PROJECT \ --output-file=config.json
Reemplaza lo siguiente:
WORKFORCE_POOL_ID
: El ID del grupo de la identidad de personal.WORKFORCE_PROVIDER_ID
: El ID del proveedor del grupo de identidades de personal.PATH_TO_OIDC_ID_TOKEN
: la ruta a la ubicación del archivo en la que se almacena el token de IdP.WORKFORCE_POOL_USER_PROJECT
: El número o ID del proyecto que se usa para la cuota y la facturación. La principal debe tener el permisoserviceusage.services.use
en este proyecto.
Cuando se completa el comando, Microsoft Entra ID crea el siguiente archivo de configuración:
{ "type": "external_account", "audience": "//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID", "subject_token_type": "urn:ietf:params:oauth:token-type:id_token", "token_url": "https://sts.googleapis.com/v1/token", "workforce_pool_user_project": "WORKFORCE_POOL_USER_PROJECT", "credential_source": { "file": "PATH_TO_OIDC_CREDENTIALS" } }
Abre la gcloud CLI y ejecuta el siguiente comando:
gcloud auth login --cred-file=PATH_TO_OIDC_CREDENTIALS
Reemplaza PATH_TO_OIDC_CREDENTIALS por la ruta de acceso al archivo de salida de un paso anterior.
La gcloud CLI publica las credenciales con transparencia en el extremo del servicio de tokens de seguridad. En el extremo, se intercambia por tokens de acceso temporales de Google Cloud .
Ahora puedes ejecutar comandos de la CLI de gcloud enGoogle Cloud.
SAML
Haz que un usuario acceda a tu aplicación de Microsoft Entra ID y obtén la respuesta de SAML.
Guarda la respuesta SAML que muestra Microsoft Entra ID en una ubicación segura de tu máquina local y, luego, almacena la ruta de acceso de la siguiente manera:
SAML_ASSERTION_PATH=SAML_ASSERTION_PATH
Para generar un archivo de configuración de credenciales, ejecuta el siguiente comando:
gcloud iam workforce-pools create-cred-config \ locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID \ --subject-token-type=urn:ietf:params:oauth:token-type:saml2 \ --credential-source-file=SAML_ASSERTION_PATH \ --workforce-pool-user-project=PROJECT_ID \ --output-file=config.json
Reemplaza lo siguiente:
WORKFORCE_PROVIDER_ID
: El ID del proveedor del grupo de identidades de personal que creaste antes en esta guía.WORKFORCE_POOL_ID
: el ID del grupo de identidad del personal que creaste antes en esta guía.SAML_ASSERTION_PATH
: la ruta de acceso del archivo de aserción de SAMLPROJECT_ID
: El ID del proyecto
El archivo de configuración que se genera es similar al siguiente:
{ "type": "external_account", "audience": "//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID", "subject_token_type": "urn:ietf:params:oauth:token-type:saml2", "token_url": "https://sts.googleapis.com/v1/token", "credential_source": { "file": "SAML_ASSERTION_PATH" }, "workforce_pool_user_project": "PROJECT_ID" }
Para acceder a la CLI de gcloud con el intercambio de tokens de la federación de identidades de personal, ejecuta el siguiente comando:
gcloud auth login --cred-file=config.json
Luego, la CLI de gcloud intercambia de manera transparente tus credenciales de Microsoft Entra ID por tokens de acceso temporales de Google Cloud . Los tokens de acceso te permiten acceder a Google Cloud.
Verás un resultado similar al siguiente:
Authenticated with external account user credentials for: [principal://iam.googleapis.com/locations/global/workforcePools/
WORKFORCE_POOL_ID
/subject/USER_ID
].Para enumerar las cuentas con credenciales y tu cuenta activa, ejecuta el siguiente comando:
gcloud auth list
Pruebe el acceso
Ahora tienes acceso a los Google Cloud productos que admiten la federación de identidades de personal y a los que se te otorga acceso. Anteriormente en este documento, otorgaste el rol de administrador de almacenamiento (roles/storage.admin
) a todas las identidades dentro del identificador de grupo que especificaste en gcloud projects add-iam-policy-binding
para el proyecto TEST_PROJECT_ID
.
Para probar que tienes acceso, enumera los buckets de Cloud Storage.
Consola (federada)
Para probar que tienes acceso mediante la consola (federada), haz lo siguiente:
Ve a la página de Cloud Storage
Verifica que puedas ver una lista de los buckets existentes para
TEST_PROJECT_ID
.
gcloud CLI
Para probar que tienes acceso con la CLI de gcloud, puedes enumerar los buckets y objetos de Cloud Storage del proyecto al que tienes acceso. Para hacer esto, ejecuta el siguiente comando. La principal debe tener el permiso serviceusage.services.use
en el proyecto especificado.
gcloud storage ls --project="TEST_PROJECT_ID"
Borrar usuarios
La federación de identidades de personal crea metadatos y recursos de usuario para identidades de usuario federadas. Si eliges borrar usuarios en tu IdP, también debes borrar de forma explícita estos recursos en Google Cloud. Para hacerlo, consulta Borra los usuarios de la federación de identidades de personal y sus datos.
Es posible que veas que los recursos siguen asociados con un usuario que se borró. Esto se debe a que para borrar metadatos y recursos del usuario se requiere una operación de larga duración. Después de iniciar la eliminación de la identidad de un usuario, los procesos que este inició antes de la eliminación pueden seguir ejecutándose hasta que se completen o se cancelen los procesos.
¿Qué sigue?
- Borra los usuarios de la federación de identidades de personal y sus datos
- Obtén información sobre qué Google Cloud productos admiten la federación de Workforce Identity.
- Configura el acceso de usuario a la consola (federada)