La federación de identidades de personal federará tu organización de Google Cloud con un proveedor de identidad (IdP) externo para habilitar el inicio de sesión único (SSO).
Puedes aplicar estas prácticas recomendadas para usar la federación de identidades del personal de manera eficaz y minimizar los riesgos de seguridad.
Elige la arquitectura adecuada
En las siguientes secciones, se describen los factores clave para elegir una arquitectura de federación que se ajuste a tus requisitos.
Consideraciones sobre la arquitectura:
Elige un patrón de arquitectura de federación.Particiona el uso de la federación por servicio, no por usuario.
Elige un patrón de arquitectura de federación
En los siguientes cuatro patrones, se describen formas comunes de federar una organización de Google Cloud con un IdP externo:
- Federación de Cloud Identity
- Federación de identidades de personal, sin sincronización
- Federación de identidades de personal con el Sistema para la administración de identidades entre dominios (SCIM)
- Identidad de nube híbrida y federación de identidades de personal
Antes de federar, considera las ventajas y limitaciones de cada patrón y elige el que coincida con tus requisitos. Para obtener más información, consulta los patrones de arquitectura para la federación de identidades.
Uso de la federación de particiones por servicio
En general, te recomendamos que particiones el uso de la federación por servicio, en lugar de por usuario. En general, la partición del uso por servicio tiene menos desventajas.
Para reducir la complejidad, te recomendamos que uses Cloud Identity o la federación de identidades de personal. Sin embargo, según tus requisitos, es posible que necesites ambos en paralelo, como se describe en el patrón híbrido.
Si usas la federación de Cloud Identity y la federación de identidades de personal en paralelo, puedes particionar su uso de las siguientes maneras:
Partición por usuario: Divide a tus usuarios en dos cohortes: una que use la federación de identidades de personal y otra que use la federación de Cloud Identity.
- Ventaja: Cada usuario tiene una sola identidad en los servicios de Google y un método de acceso.
Desventajas: La partición por usuarios tiene varias desventajas, incluidas las siguientes:
Administrar grupos de acceso puede ser complejo, ya que las políticas de permisos de IAM deben contener una combinación de tipos de principales y no puedes usar los mismos grupos para los usuarios de Cloud Identity y de la federación de identidades de personal.
Los usuarios de diferentes cohortes no pueden compartir vínculos entre sí porque la consola de Google Cloud , Gemini Enterprise y otras herramientas usan diferentes URLs según cómo accedan los usuarios.
Los usuarios de diferentes cohortes pueden tener acceso a diferentes conjuntos de atributos.
Partición por servicio: Configura cada servicio, como Google Cloud o Gemini Enterprise, para que otorgue acceso de forma exclusiva a los usuarios de la federación de identidades de personal o a los usuarios de Cloud Identity, pero nunca a ambos.
- Ventaja: Simplifica la administración y garantiza un conjunto de funciones coherente para los diferentes usuarios.
- Desventaja: Es posible que algunos empleados deban tener asignadas dos identidades: una que use la federación de identidades de personal y otra que use Cloud Identity.
Te recomendamos que realices la partición por servicio, específicamente, que separes Gemini Enterprise y Gemini Notebook para empresas de otros servicios. Gemini Enterprise y la consola de Google Cloud son herramientas independientes diseñadas para tareas diferentes. Las diferencias en sus procesos de acceso deberían tener un impacto mínimo en la experiencia general del usuario.
Para ayudar a aplicar esta partición, usa las restricciones de las políticas de la organización.
Reforzar la administración del grupo
Debes administrar el acceso con grupos y establecer procesos claros para controlar esos grupos y usar la federación de identidades de personal de manera eficaz.
Los permisos de un usuario para acceder a los recursos no se determinan durante la autenticación. En cambio, el acceso se evalúa cuando el usuario intenta acceder al recurso en función de las políticas adjuntas a ese recurso específico. Estas políticas pueden incluir lo siguiente:
- Una o más políticas de permisos
- Cero o más políticas de denegación
- Cero o más políticas de límite de acceso de las principales
Las políticas definen el acceso para principales individuales o conjuntos de principales:
Principal: Es un usuario autenticado que se identifica con un identificador principal. Un identificador de principal de personal es similar al siguiente:
principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECTEl identificador de la principal contiene lo siguiente:
POOL_ID: Identifica de forma única un grupo de identidades de personal.SUBJECT: Identifica de forma inequívoca a un usuario específico. El valor y el formato dependen de tu IdP y de la asignación de atributos.
Conjunto de principales: Usuarios que cumplen con criterios específicos. La federación de identidades de personal admite tres conjuntos de principales: basados en grupos (miembros de un grupo), basados en atributos y comodines (todos los usuarios).
Otorgar acceso a principales individuales puede ser útil en situaciones específicas, pero suele escalar de forma deficiente debido a los siguientes problemas:
- Agregar principales una por una hace que las políticas de permisos crezcan y se vuelvan cada vez más difíciles de administrar.
- La administración de acceso individual requiere cambios frecuentes en las políticas de permisos.
- Las políticas podrían volverse cada vez más incoherentes con el tiempo.
Para una administración de acceso escalable y eficaz, el uso de conjuntos de principales basados en grupos proporciona estas ventajas:
- Puedes administrar el acceso agregando o quitando miembros de los grupos con tus herramientas y procesos de identidad existentes.
- Reduce el tamaño y la complejidad de las políticas de permiso.
- Asegúrate de que los usuarios con el mismo rol tengan el mismo acceso a los recursos.
Para usar grupos con el objetivo de administrar el acceso, debes configurar tu IdP externo de ciertas maneras y tener en cuenta las limitaciones que el IdP impone a los grupos.
En las siguientes secciones, se describen las prácticas recomendadas para usar grupos de manera eficaz y evitar los límites del IdP.
Recomendaciones:
Distinguir diferentes tipos de grupos.Usa grupos de acceso para otorgar acceso a los recursos.
Usa grupos de aplicación de políticas para restringir el acceso a los recursos.
No uses grupos organizativos y de colaboración para administrar el acceso.
Usa grupos organizativos y de colaboración solo para Gemini Enterprise.
Distinguir diferentes tipos de grupos
En la siguiente lista, se describen cuatro tipos de grupos que se suelen encontrar en las organizaciones:
- Grupos de acceso: Se usan solo para otorgar acceso a los servicios o recursos de Google Cloud . Representan funciones laborales y simplifican la asignación de los roles que se necesitan para realizar estas funciones.
- Grupos organizacionales: Estos grupos representan subconjuntos de la estructura de una organización y, por lo general, se obtienen de los datos de recursos humanos. Pueden basarse en el departamento, la estructura de informes, la ubicación geográfica o cualquier otra agrupación organizativa.
- Grupos de colaboración: Estos grupos representan grupos de trabajo, miembros de proyectos o usuarios que quieren colaborar en un proyecto o debatir sobre un tema específico, y se pueden usar para la distribución de correos electrónicos. Los grupos de colaboración suelen crearse de forma ad hoc y de autoservicio.
- Grupos de aplicación de políticas: Los grupos de aplicación de políticas, también llamados grupos de políticas, se usan para restringir el acceso, a diferencia de los grupos de acceso, que se usan para otorgar acceso. Por ejemplo, límites de acceso de la entidad, políticas de denegación o aplicación de la autenticación de varios factores. Los grupos de acceso pueden permitir que los miembros abandonen un grupo de forma voluntaria. Sin embargo, la membresía de un grupo de aplicación de medidas por incumplimiento no es voluntaria.
Los grupos que necesitas federar dependen de los siguientes servicios que uses:
- Para Google Cloud, solo necesitas grupos de acceso y grupos de aplicación de políticas.
- Para Gemini Enterprise, necesitas grupos de acceso, grupos de aplicación de políticas y, si usas conectores basados en la transferencia de datos, ciertos grupos organizacionales y de colaboración.
Cuando configures la federación de identidades de personal, excluye los tipos de grupos irrelevantes para evitar los límites de tokens con tu IdP. Este enfoque te ayuda a reducir el riesgo de exceder las limitaciones impuestas por tu IdP y garantizar un uso más coherente de los grupos.
Otorga acceso a los recursos con grupos de acceso
Para administrar el acceso de manera eficaz, te recomendamos que uses conjuntos de principales que se asignen a grupos de acceso. Los grupos de acceso existen solo para proporcionar acceso. Representan funciones de trabajo y simplifican la asignación de los roles necesarios para realizar esas funciones.
Para configurar grupos de acceso, haz lo siguiente:
- En tu IdP, crea grupos de acceso que representen funciones de trabajo.
- Asigna los grupos de acceso a los conjuntos de principales para usarlos en IAM.
- Crea vinculaciones de políticas para otorgar a los conjuntos de principales acceso a los recursos que se necesitan para cada función de trabajo.
- En el IdP externo, agrega o quita usuarios de los grupos según sus funciones laborales.
Usa grupos de acceso para las políticas que otorgan acceso, incluidas las siguientes:
- Políticas de permisos de IAM
- Reglas de entrada de los Controles del servicio de VPC
Asegúrate de que los grupos de acceso sean lo suficientemente detallados. Por ejemplo, los siguientes grupos representan grupos de acceso efectivo:
widget-sales-dashboard-readers: Otorga acceso de lectura a un conjunto de datos de BigQuery específico y al panel asociado.dev-ssh-users: otorga acceso de Acceso al SO a las VMs de Compute Engine en el entorno de desarrollo.Por el contrario, los siguientes tipos de grupos no suelen ser adecuados para usarse como grupos de acceso:
Los grupos de administradores amplios, como
cloud-admins, suelen carecer de especificidad en cuanto a las cargas de trabajo o los entornos que se aplican.Los grupos organizacionales, como
australia-fte, representan grupos como equipos o por ubicación, en lugar de por función laboral.Los grupos de comunicación, como
security-discuss, están diseñados para listas de correo electrónico o colaboración, en lugar de un grupo de acceso.
Para mantener los grupos de acceso detallados, crea un conjunto nuevo de grupos de acceso para cada carga de trabajo o proyecto que incorpores a Google Cloud. De esta manera, puedes escalar la cantidad de grupos de acceso a la cantidad de cargas de trabajo que ejecutas en Google Cloud.
Restringe el acceso a los recursos con grupos de aplicación de políticas
Los grupos de aplicación de políticas son similares a los grupos de acceso, pero suelen diferir en los siguientes aspectos:
- No permiten que los miembros abandonen el grupo de forma voluntaria.
- No son específicos de una carga de trabajo.
Usa grupos de aplicación de políticas para las políticas que reducen el acceso, incluidas las siguientes:
- Políticas de denegación de IAM
- Límites de acceso de la entidad principal
- Políticas de la organización
Algunos ejemplos de grupos de aplicación de políticas son users-in-restricted-locations,
fedramp-low y mfa-users. La cantidad de grupos de aplicación de políticas suele ser
pequeña y es poco probable que afecte la cantidad total de membresías de un usuario.
No uses grupos organizativos y de colaboración para administrar el acceso
Para administrar el acceso de manera eficaz, puedes usar grupos de acceso y grupos de aplicación de políticas en lugar de grupos organizativos o de colaboración.
Los grupos organizacionales representan equipos o subconjuntos de la estructura de una organización y, por lo general, se obtienen de los datos de recursos humanos. Estos grupos no son adecuados para administrar el acceso a los recursos de Google Cloud por los siguientes motivos:
- Las responsabilidades y la composición del equipo pueden cambiar con el tiempo. Por ejemplo, un equipo puede entregar una carga de trabajo a otro equipo, o bien dos equipos pueden fusionarse. La administración del acceso con grupos organizacionales puede requerir una cascada de cambios en las políticas durante estas transiciones.
- Los miembros de un grupo de la organización rara vez necesitan un acceso idéntico a los recursos. Otorgar acceso a un grupo de la organización suele darles a algunos miembros más acceso del que necesitan.
Por lo general, los grupos de colaboración se autoadministran, lo que permite que los miembros se unan con la aprobación de otro miembro o sin ella. Puedes usar grupos de colaboración para otorgar acceso, lo que puede generar un exceso de permisos y una elevación de privilegios.
Para evitar que los grupos de organización y colaboración se usen en la administración de accesos, configura tu IdP para que excluya estas membresías de grupos en los tokens o aserciones que se usan para la federación de identidades de personal.
Usa grupos organizativos y de colaboración solo para Gemini Enterprise
Aunque los grupos organizativos y de colaboración no son adecuados para administrar el acceso a los recursos de Google Cloud , es posible que los necesites para Gemini Enterprise:
- Evaluación de LCA: Cuando usas conectores basados en la ingesta de datos para integrar Gemini Enterprise con Microsoft 365, es posible que encuentres documentos con listas de control de acceso (LCA) que hagan referencia a grupos de organización y colaboración. Si Gemini Enterprise no tiene acceso a las membresías de un usuario en estos grupos, es posible que no evalúe correctamente si el usuario tiene autorización para acceder a esos documentos.
- Uso compartido de cuadernos: Gemini Notebook para empresas permite que los usuarios compartan cuadernos. Permitir que los usuarios compartan notebooks con grupos de colaboración suele ser más conveniente que restringir el uso compartido a usuarios individuales.
Para asegurarte de que los grupos organizacionales y de colaboración solo estén disponibles para Gemini Enterprise, puedes configurar tu IdP de la siguiente manera:
- Usa SCIM para aprovisionar grupos de organización y colaboración, y sus membresías.
- Excluye las membresías de grupos de organización y colaboración en los tokens o las aserciones que se usan para la federación de identidades de personal.
Administra grupos de identidades de personal
Un grupo de identidades de personal define un espacio de nombres para los identificadores de principales y funciona como un contenedor para tu configuración de federación. A diferencia de un directorio de usuarios, un grupo no almacena información sobre usuarios o grupos.
Recomendaciones:
Usa un solo grupo por IdP.Elige un nombre único y significativo para el grupo.
Trata los grupos como recursos con privilegios elevados.
Considera los riesgos cuando extiendas la federación a los socios.
Supervisa tu cuota de intercambio de tokens.
Usa un solo grupo por IdP
Los grupos de identidades de personal son un recurso a nivel de la organización, no a nivel del proyecto. Este diseño refleja que los grupos de identidades de personal administran la autenticación en una organización de Google Cloud , en lugar de un proyecto o una carga de trabajo individuales.
En la mayoría de las organizaciones, la cantidad de grupos de Workforce Identity debe coincidir con la cantidad de IdP:
- Si tu organización usa un solo IdP para administrar la autenticación, usa un solo grupo de identidades de personal.
- Si tu organización usa varios IdP, por ejemplo, debido a una adquisición, usa un grupo de Workforce Identity por IdP.
Limitar la cantidad de grupos de Workforce Identity te ayuda a garantizar lo siguiente:
- No es necesario crear ni modificar grupos de Workforce Identity cuando se incorporan nuevas cargas de trabajo a Google Cloud.
- Puedes usar la IAM para controlar a qué proyectos y recursos dentro de Google Cloud pueden acceder los usuarios individuales.
Elige un nombre único y significativo para el grupo.
Para que los identificadores de principal sean únicos a nivel global, la identidad del personal codifica el nombre del grupo de identidades del personal en el identificador de principal. Cuando elijas un nombre para un grupo de identidades de personal, ten en cuenta las siguientes restricciones:
- Singularidad: Elige un nombre que sea único en Google Cloud y que no haya sido reclamado por otra organización.
- Inmutabilidad: No puedes cambiar el nombre de un grupo de Workforce Identity. Elige un nombre que siga siendo significativo con el tiempo y evita los nombres de iniciativas temporales.
- Experiencia del usuario: Según la configuración de acceso, es posible que los usuarios deban ingresar el nombre del grupo durante el acceso. Elige un nombre corto que sea fácil de recordar.
Trata los grupos como recursos con privilegios elevados
El grupo de identidades de personal y el proveedor determinan cómo acceden los usuarios y controlan cómo se derivan las identidades y las membresías de grupos del IdP externo. Debido a que estos componentes controlan la lógica de autenticación, son fundamentales para la seguridad de tu organización de Google Cloud . Si estos componentes se ven comprometidos, es posible que los agentes maliciosos puedan realizar ataques de spoofing.
Para realizar un ataque de falsificación de identidad, los agentes maliciosos pueden intentar las siguientes acciones:
- Modificar las asignaciones de atributos: Modificar las asignaciones de atributos puede permitir que un actor malicioso se autentique como otra persona y obtenga acceso privilegiado no autorizado.
- Agregar un proveedor malicioso: Agregar un proveedor puede permitir que una persona que actúa de mala fe omita el IdP de tu organización y se autentique con un IdP diferente que controle.
Los grupos y proveedores de Workforce Identity son recursos fundamentales para la seguridad que requieren la siguiente protección:
- Restringe el acceso a los usuarios no federados: Limita el acceso de administrador a una pequeña cantidad de usuarios de Cloud Identity o Google Workspace, incluido al menos un usuario con acceso de emergencia.
- Protege a los usuarios administradores: Exige la verificación en dos pasos para todos los usuarios administradores y de acceso de emergencia.
- Acceso justo a tiempo: Usa Privileged Access Manager (PAM) para otorgar acceso de administrador justo a tiempo en lugar de otorgar acceso permanente.
Considera los riesgos cuando extiendas la federación a los socios
La federación de Google Cloud con un IdP externo mediante la federación de identidades de personal establece una relación de confianza. Con la federación, confías en el IdP externo para realizar las siguientes acciones:
- Realiza la autenticación de varios factores (MFA) que cumpla con tus requisitos de seguridad.
- Realizar aserciones precisas sobre las identidades de los usuarios y las membresías de los grupos
- Sigue los procesos de administración de identidades que garanticen que los usuarios se den de baja con rapidez y que las membresías de los grupos reflejen con precisión los roles actuales.
La federación de identidades de personal proporciona mecanismos limitados para validar las declaraciones que hace un IdP externo. Específicamente, la federación de identidades de personal no admite la MFA posterior al SSO de la misma manera que Cloud Identity.
Antes de usar la federación de identidades de personal para permitir que socios o contratistas externos accedan a tus recursos de Google Cloud , determina si este nivel de confianza es adecuado. No uses la federación de identidades de personal para el acceso de socios, a menos que confíes en el socio y en su IdP para cumplir de forma coherente con tus estándares de seguridad.
Supervisa tu cuota de intercambio de tokens
El intercambio de tokens de la federación de identidades de personal está limitado por la métrica de cuota
sts.googleapis.com/workforce_requests, que se establece de forma predeterminada en
1,000 solicitudes por
minuto y se aplica por organización. La cuota se comparte entre todos los grupos de personal, proveedores, usuarios y cargas de trabajo de la organización. Los grupos separados
no reciben cuotas separadas. Para conocer el valor actual, consulta
Cuotas y límites.
Debido a que la cuota es para toda la organización, un solo cliente de alta frecuencia puede
agotar la cuota y causar errores 429 RESOURCE_EXHAUSTED para todos los demás usuarios de
tu organización, incluidos los administradores.
Te recomendamos que hagas lo siguiente:
- Reserva la federación de identidades de personal para el acceso de personas. Enruta las cargas de trabajo automatizadas, las canalizaciones de CI/CD y los agentes a la federación de identidades para cargas de trabajo, que está diseñada para el tráfico de máquina a máquina.
- Retrocede cuando se limite la velocidad. Vuelve a intentar las respuestas
429 RESOURCE_EXHAUSTEDcon retirada exponencial y jitter. Los bucles de reintentos ajustados aumentan la saturación y extienden la interrupción para todos los miembros de tu organización. - Solicita más cuota antes de que la necesites. Si tu organización tiene una necesidad legítima y sostenida por encima del valor predeterminado, solicita un aumento de cuota en lugar de operar al límite.
- Recibe una alerta antes de alcanzar el límite de cuota. Crea una alerta de Cloud Monitoring que se active
cuando el uso alcance el 80% de tu límite. Para ello, compara
serviceruntime.googleapis.com/quota/rate/net_usageconserviceruntime.googleapis.com/quota/limit, filtrado pormetric.label.quota_metric="sts.googleapis.com/workforce_requests". - Mantén el acceso de emergencia. Asegúrate de que al menos un administrador pueda comunicarse con tu organización sin la federación de identidades de personal para que puedas seguir actuando si se limita el intercambio de tokens.
Para ver tu uso y límite actuales, ve a la
página Cuotas en la consola de Google Cloud y
selecciona tu organización como el recurso. Luego, filtra por
Workforce Pool token exchange requests.
Administra proveedores de grupos de Workload Identity
Un proveedor de grupos de Workforce Identity define una relación de federación con un IdP externo y contiene la configuración para lo siguiente:
- Es el IdP que se usará para el inicio de sesión único.
- Es la asignación de atributos que se usará para derivar identificadores de principales a partir de tokens o aserciones que proporcione el IdP.
- Opcional: Es el usuario de SCIM que se usará para buscar información de pertenencia a grupos.
Recomendaciones:
Elige un nombre de proveedor significativo.Usa el portal de aplicaciones de tu IdP para exponer servicios individuales.
Usa un solo proveedor por grupo para evitar colisiones de sujetos.
Usa el mismo grupo y proveedor para la consola de Google Cloud y Gemini Enterprise.
Usa un URI de entidad emisora específico del usuario.
Evita usar el flujo implícito de OpenID Connect (OIDC).
Elige un nombre de proveedor significativo
Cuando creas un proveedor de grupos de Workforce Identity, debes asignarle un nombre.
A diferencia de los nombres de los grupos de Workload Identity, este nombre no necesita ser único a nivel global
y no se codifica en los identificadores de las principales. Sin embargo, según
tu configuración de acceso, es posible que los usuarios deban ingresar el nombre del proveedor durante
el acceso. Para mejorar la experiencia del usuario, elige un nombre significativo y fácil de recordar, por ejemplo, entra o staff.
Evita usar nombres como oidc o saml, ya que es posible que los usuarios no conozcan
estas siglas.
Cómo mostrar servicios individuales en el portal de aplicaciones de tu IdP
Los proveedores de identidad, como Microsoft Entra ID y Okta, proporcionan un portal de aplicaciones que permite a los usuarios descubrir sus aplicaciones asignadas y acceder a ellas. Usa el portal para optimizar la experiencia del usuario de la siguiente manera:
- Configura el portal para que muestre los servicios de Google pertinentes de forma individual en lugar de mostrar un solo vínculo de Google Cloud .
- Configura vínculos para que el usuario acceda automáticamente.
En la siguiente tabla, se enumeran los servicios de Google comunes que admiten la federación de identidades de personal y las URLs para el acceso automático:
| Aplicación | URL |
|---|---|
| Google Cloud Consola de la federación de identidades de personal, también conocida como la consola (federada) | https://auth.cloud.google/signin/locations/global/workforcePools/POOL/providers/PROVIDER?continueUrl=https%3A%2F%2Fconsole.cloud.google |
| Gemini Enterprise | https://auth.cloud.google/signin/locations/global/workforcePools/POOL/providers/PROVIDER?continueUrl=https%3A%2F%2Fvertexaisearch.cloud.google%2Fhome%2Fcid%2FWEBAPP_ID |
| Gemini Notebook para empresas | https://auth.cloud.google/signin/locations/global/workforcePools/POOL/providers/PROVIDER?continueUrl=https%3A%2F%2Fnotebooklm.cloud.google%2Fglobal%2F%3Fproject%3DPROJECT_NUMBER |
| Apps web de IAP | URL de la app, como https://iap.example.com/ |
Reemplaza lo siguiente:
POOL: Es el nombre del grupo de identidades de personal.PROVIDER: el nombre del proveedor del grupo.WEBAPP_ID: Es el ID de la app web de Gemini Enterprise.PROJECT_NUMBER: Es el número de proyecto de Gemini Notebook para empresas.
Usa un solo proveedor por grupo para evitar colisiones de sujetos
Puedes usar la federación de identidades de personal para agregar varios proveedores a un grupo de personal. Agregar un segundo proveedor es útil durante las migraciones en las que permites temporalmente que los usuarios se autentiquen con diferentes IdP. Más allá de las situaciones temporales, evita usar varios proveedores por los siguientes motivos:
- Colisiones de sujetos: El uso de varios proveedores presenta un riesgo de
colisiones de sujetos. En estas colisiones, la asignación de atributos
google.subjectpara un proveedor devuelve el mismo valor que otro proveedor. Esta colisión asigna varias identidades externas a la misma principal de IAM, lo que las hace indistinguibles en los Registros de auditoría de Cloud. - Compatibilidad con IAP: IAP requiere que los grupos de identidades de personal tengan un solo proveedor para redireccionar a los usuarios no autenticados al IdP automáticamente. Si agregas un proveedor adicional, IAP no podrá autenticar a los usuarios.
Si necesitas federar con varios proveedores, crea varios grupos de personal y configura un proveedor para cada grupo.
Usa el mismo grupo y proveedor para la consola de Google Cloud y Gemini Enterprise
Si usas la federación de identidades de personal para Gemini Enterprise y Google Cloud, usa un solo proveedor para garantizar que los usuarios puedan acceder a ambos servicios de forma simultánea sin volver a acceder. Si usas proveedores independientes con diferentes asignaciones de atributos, los usuarios podrían encontrarse con situaciones en las que su acceso a los recursos difiera según el proveedor con el que accedan.
Usa un URI de entidad emisora específico del usuario
Cuando configuras un proveedor, especificas un URI de emisor para identificar de forma única
tu IdP. Sin embargo, según la configuración de tu IdP, es posible que el URI de la entidad emisora no sea único para el usuario de tu organización. Por ejemplo, si usas un URI de entidad emisora genérico o compartido,
como el extremo común de Microsoft Entra ID
(https://login.microsoftonline.com/common/v2.0), es posible que, sin darte cuenta,
permitas que los usuarios de otras organizaciones se autentiquen en tu organización de
Google Cloud.
Para ayudar a evitar el acceso no deseado entre usuarios, usa un URI de entidad emisora específico del usuario. Si tu IdP no proporciona un URI de emisor específico del usuario, configura una condición de atributo para limitar el acceso a tu usuario específico.
Evita usar el flujo implícito de OpenID Connect (OIDC)
Cuando configures un proveedor de OIDC, prefiere el flujo de código de autorización por sobre el flujo implícito. El flujo implícito dejó de estar disponible en la versión 2.1 de la especificación de OAuth porque es vulnerable a la filtración y la inserción de tokens. El uso del flujo de código de autorización ayuda a reducir el riesgo de intercepción de tokens.
Administra usuarios
Puedes administrar usuarios con la federación de identidades del personal. La federación de identidades de personal deriva el identificador principal de un usuario a partir de su token o aserción con los siguientes pasos:
- Determina el identificador de asunto aplicando la asignación de atributos para
google.subject. El identificador de sujeto debe identificar de forma única a un usuario dentro de un grupo de identidades de personal, pero no es necesario que sea único en Google Cloud. Deriva el identificador de la principal agregando el identificador del sujeto a un prefijo que identifique el grupo de identidades de personal. El identificador de la principal resultante es único en Google Cloud y tiene el siguiente formato:
principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/\ subject/SUBJECT
Cuando un usuario que se autenticó con la federación de identidades de personal accede a un recurso, IAM usa el identificador de principal para evaluar las vinculaciones de roles en las políticas de permisos y lo registra en los Registros de auditoría de Cloud.
Recomendaciones:
Usa un identificador de sujeto inmutable.No reutilices los identificadores de sujeto.
Microsoft Entra ID: usa el UPN como identificador de asunto.
Usa un identificador de asunto inmutable
Cuando cambia el identificador de sujeto de un usuario, cambia su identificador de principal. Como resultado, Google Cloud ya no los reconoce como el mismo usuario:
- El usuario no puede acceder a los recursos a los que se le otorgó acceso anteriormente porque su nuevo identificador de principal ya no coincide con los identificadores de principal que se indican en las políticas de permisos.
- Las entradas de registro de los Registros de auditoría de Cloud solo contienen el identificador de entidad nuevo y ya no se pueden correlacionar con los registros que usaban el identificador de entidad anterior.
Para mantener estable el identificador principal de un usuario, usa una asignación de atributos que
genere un valor estable para google.subject.
Muchos IdP generan automáticamente un identificador numérico único o con formato UUID
para los usuarios. Estos identificadores son únicos y estables, lo que los convierte en buenos candidatos para google.subject. Sin embargo, usar estos identificadores como google.subject puede generar identificadores de principal largos y crípticos con los que puede ser difícil trabajar.
Para ayudarte a elegir un identificador para google.subject, ten en cuenta los siguientes
requisitos en orden de prioridad descendente:
- Unicidad: El valor identifica de forma inequívoca a un usuario en tu IdP.
- Usabilidad: El valor es significativo o, al menos, se puede buscar con facilidad en el directorio de usuarios de tu IdP.
- Inmutabilidad: El valor es inmutable o, al menos, solo los administradores pueden modificarlo.
No reutilices los identificadores de sujetos
Muchos IdP aplican restricciones de unicidad en ciertos identificadores de usuario, pero permiten
que se reutilicen. Por ejemplo, es posible que un IdP no te permita crear dos
usuarios con el mismo nombre de usuario bob. Sin embargo, una vez que borres la cuenta de usuario
bob, es posible que el IdP te permita crear una cuenta de usuario nueva y asignarle el
nombre de usuario bob de nuevo.
Si la asignación de atributos de tu proveedor para google.subject hace referencia a un identificador de usuario
que permite la reutilización, es posible que se produzcan colisiones de sujetos:
La federación de identidades de personal no puede distinguir entre un usuario antiguo y uno
nuevo si su google.subject es el mismo. Como resultado, el usuario nuevo podría
obtener acceso a recursos destinados solo al usuario anterior.
Para evitar colisiones de asuntos, realiza una de las siguientes acciones o ambas:
- Asigna
google.subjecta un identificador de usuario que tu IdP no permita reutilizar. - Cuando borres un usuario en tu IdP, usa la
API de
locations.workforcePools.subjects.deletepara borrar los datos del usuario en Google Cloud y bloquear el mismo identificador de usuario para que no se use en los accesos hasta que se hayan borrado todos los datos.
ID de Microsoft Entra: Usa el UPN como identificador de asunto
Esta práctica recomendada solo se aplica si usas Microsoft Entra ID como IdP.
Si usas Microsoft Entra ID, los identificadores que puedes usar como identificador de sujeto incluyen los siguientes:
- Nombre de principal del usuario (
upn) - ID del objeto (
oid) - Dirección de correo electrónico (la dirección principal en
proxyAddresses)
Entre estas opciones, te recomendamos que uses el nombre de usuario principal como identificador del sujeto por los siguientes motivos:
- Todos los usuarios tienen un nombre de usuario principal.
- Los nombres principales de usuario identifican de forma única a un usuario.
- Los nombres de las principales de usuario suelen ser significativos y fáciles de usar.
- Los nombres principales de usuario incorporan un nombre de dominio, que identifica de forma inequívoca al usuario de Microsoft Entra ID con el que está asociado el usuario.
- Es posible que tu organización tenga una política que prohíba o rija la reutilización de los identificadores de principales de usuario.
En cambio, el ID de objeto y la dirección de correo electrónico de un usuario son menos adecuados por los siguientes motivos:
- Un ID de objeto (
oid) es inmutable, pero tiene el formato de un GUID. Este formato hace que sea difícil trabajar con ellos y que no sean significativos para los humanos. - La dirección de correo electrónico no es un atributo obligatorio y es posible que no se complete para todos los usuarios.
Independientemente del identificador que elijas, te recomendamos que evites aplicar transformaciones, como forzar los identificadores a minúsculas.
Administrar grupos
La federación de identidades de personal puede determinar la membresía de un usuario en un grupo a partir de las siguientes fuentes:
- La aserción de SAML o el token de ID que proporciona el IdP.
- La API de Microsoft Graph, si usas Microsoft Entra ID como IdP.
- Es el usuario de SCIM asociado al proveedor de grupos de Workforce Identity.
De forma predeterminada, la federación de identidades de personal usa solo la aserción de SAML o el token de ID:
| Fuente | Google Cloud | Gemini Enterprise |
|---|---|---|
| SAML o token de ID | ||
| API de Microsoft Graph | - | - |
| usuario de SCIM | - | - |
Si usas Microsoft Entra ID como IdP, puedes habilitar la función de atributos adicionales. Luego, la federación de identidades de personal usa solo la API de Microsoft Graph como fuente para las membresías de grupos:
| Fuente | Google Cloud | Gemini Enterprise |
|---|---|---|
| SAML o token de ID | - | - |
| API de Microsoft Graph | ||
| usuario de SCIM | - | - |
Si usas Gemini Enterprise, puedes configurar la federación de identidades de personal para usar un inquilino de SCIM, lo que cambia el comportamiento de la siguiente manera:
- Gemini Enterprise usa las membresías de grupos del usuario de SCIM y, además, ignora la información de membresía de grupos de la aserción de SAML o el token de ID.
- Google Cloud usa la información de pertenencia a grupos de la aserción de SAML o el token de ID, y omite la información de pertenencia a grupos del usuario de SCIM.
| Fuente | Google Cloud | Gemini Enterprise |
|---|---|---|
| SAML o token de ID | - | |
| API de Microsoft Graph | - | - |
| usuario de SCIM | - |
Para cada membresía de grupo, la federación de identidades de personal deriva un identificador de principal siguiendo estos pasos:
- Determina el identificador del grupo con una de las siguientes opciones:
- Aserción de SAML o token de ID: Aplica la asignación de atributos para
google.groups. - Usuario de SCIM: Aplica la asignación de reclamaciones para
google.group. - API de Microsoft Graph: Sigue
extra-attributes-typeen la configuración del proveedor.
- Aserción de SAML o token de ID: Aplica la asignación de atributos para
Deriva el identificador de la principal agregando el identificador del grupo a un prefijo que identifique el grupo de Workforce Identity. El identificador de la principal resultante es único en Google Cloud y tiene el siguiente formato:
principalSet://iam.googleapis.com/locations/global/workforcePools/\ POOL_ID/group/GROUP_ID
Cuando un usuario que se autenticó con la federación de identidades de personal accede a un recurso, IAM usa estos identificadores de principal para evaluar las vinculaciones de roles en las políticas de permisos.
Recomendaciones:
Usa un identificador de grupo inmutable.Reduce las membresías de grupos en aserciones o tokens.
Microsoft Entra ID: Usa el ID de objeto como identificador del grupo.
Usa un identificador de grupo inmutable
Todas las políticas de IAM hacen referencia a los grupos por su identificador de principal. Cuando cambias el nombre de un grupo en tu IdP para que cambie su identificador, Google Cloud ya no lo reconoce como el mismo grupo:
- Las vinculaciones de roles de IAM existentes siguen haciendo referencia al identificador de principal antiguo y dejan de ser efectivas.
- Los miembros del grupo que cambió de nombre pierden el acceso porque el nuevo identificador de principal del grupo ya no coincide con ninguna vinculación de rol de IAM.
Para evitar estas interrupciones, configura la asignación de atributos y reclamaciones para usar un valor estable e inmutable, como un ID único generado por el IdP. Evita usar nombres visibles o direcciones de correo electrónico como identificadores de grupo, ya que estos pueden cambiar durante los cambios organizacionales.
Reduce las membresías a grupos en aserciones o tokens
De forma predeterminada, tu IdP puede incluir más membresías de grupos en las aserciones de SAML o los tokens de ID de los que necesitas para administrar el acceso a Gemini Enterprise y los recursos de Google Cloud . Incluir membresías de grupos innecesarias crea varios riesgos:
- Pérdida parcial de acceso: Muchos IdP imponen límites a la cantidad de membresías de grupo que pueden incluir en un token o una aserción. Cuando un usuario supera este límite (exceso de grupos), el IdP puede quitar algunas membresías de grupos, lo que hace que el usuario pierda el acceso a ciertos recursos.
- Errores de acceso: La federación de identidades de personal
limita el tamaño y la cantidad de membresías de grupos que puede producir la asignación de atributos
google.groups. Los usuarios que superen uno de estos límites no podrán acceder. - Uso incoherente de grupos: Si expones grupos a Google Cloud, los propietarios de proyectos podrían decidir usar esos grupos para administrar el acceso a los recursos, incluso si nunca tuviste la intención de que ciertos grupos se usaran en Google Cloud.
Los siguientes enfoques pueden ayudarte a mitigar estos riesgos y reducir la cantidad de membresías de grupo en aserciones o tokens:
Filtrar por tipo de grupo: Algunos IdP, incluido Microsoft Entra ID, te permiten configurar un filtro que determine qué grupos incluir en las aserciones o los tokens. Puedes configurar un filtro para excluir los tipos de grupos que no sean pertinentes según tu configuración y los servicios que planeas usar.
En la siguiente tabla, se indican los tipos de grupos que tal vez debas incluir en las aserciones o los tokens, según los servicios que planees usar:
Tipo de grupo Google Cloud Gemini (sin sincronización) Gemini (SCIM) Grupos de acceso - Grupos de aplicación de medidas por incumplimiento - Grupos organizativos No son necesarios * - Grupos de colaboración No son necesarios * - * Solo se requiere si se usan conectores basados en la transferencia de datos.
- Para administrar el acceso a Google Cloud, debes incluir grupos de acceso y grupos de aplicación de políticas.
- El filtro necesario para administrar el acceso a Gemini Enterprise depende de si usas SCIM. Si usas SCIM, Gemini Enterprise ignora las membresías de grupos incluidas en las aserciones o los tokens, por lo que no necesitas incluir ningún grupo específico de Gemini Enterprise. Si no usas SCIM, debes incluir los grupos de acceso y de aplicación de políticas necesarios para Gemini Enterprise. Según si planeas usar conectores basados en la transferencia de datos, es posible que también debas incluir ciertos grupos de organización y colaboración.
Asignación: Algunos IdP, incluido Microsoft Entra ID, te permiten restringir las membresías de grupos en tokens y aserciones a los grupos asignados, que son los grupos que asignas de forma explícita a la configuración de la parte de confianza.
Filtro de atributos adicionales: Si usas Microsoft Entra ID y habilitaste la función de atributos adicionales, puedes especificar un filtro con la marca
--extra-attributes-filter. La federación de identidades de personal pasa este filtro a la API de Microsoft Graph cuando solicita membresías de grupos.
Para probar o solucionar problemas de los filtros, usa la herramienta Depurar token de IdP en la consola de Google Cloud o habilita el registro de auditoría detallado.
Microsoft Entra ID: Usa el ID de objeto como identificador del grupo
Esta práctica recomendada solo se aplica si usas Microsoft Entra ID como IdP.
Si usas Microsoft Entra ID, los identificadores que puedes usar como identificador de grupo incluyen los siguientes:
- ID del objeto (
oid) - Dirección de correo electrónico
- Nombre visible
Entre estas opciones, te recomendamos que uses el ID de objeto (oid) como identificador del grupo
por los siguientes motivos:
- Todos los grupos tienen un ID de objeto. En cambio, la dirección de correo electrónico es un campo opcional que solo se puede completar para los grupos de Microsoft 365.
- El ID de objeto es único e inmutable. En cambio, el nombre visible de un grupo puede cambiar y podría no ser único.
Independientemente del identificador que elijas, te recomendamos que evites aplicar transformaciones, como forzar los identificadores a minúsculas.
Administrar acceso
Prácticas recomendadas para los límites de acceso y la administración justo a tiempo (JIT)
Recomendaciones:
Usa usuarios de Cloud Identity para el acceso de emergencia.Usa Cloud Identity para el acceso con privilegios elevados.
Usa restricciones de las políticas de la organización para controlar la federación.
No otorgues acceso a todos los miembros de un grupo.
Limita la duración de la sesión.
Alinea la duración de la sesión con los requisitos de acceso JIT.
Usa usuarios de Cloud Identity para el acceso de emergencia
Para garantizar el acceso continuo a tus entornos de Google Cloud , crea usuarios con acceso de emergencia para cada entorno.
Los usuarios con acceso de emergencia proporcionan acceso a tu entorno de Google Cloud cuando los servicios están mal configurados, comprometidos o no funcionan con normalidad. Los usuarios con acceso de emergencia tienen muchos privilegios. Confiar en la federación de identidades de personal para autenticar a los usuarios con acceso de emergencia presenta los siguientes riesgos:
- Un error en la configuración del proveedor del grupo de identidades de personal puede hacer que te bloquees.
- Una interrupción del servicio que afecte al IdP externo puede impedir que uses un usuario de acceso de emergencia cuando más lo necesites.
- Si se vulnera el IdP externo, los agentes maliciosos pueden autenticarse como un usuario con acceso de emergencia y obtener un acceso amplio a tus recursos de Google Cloud.
Para mitigar estos riesgos, usa Cloud Identity o Google Workspace para los usuarios con acceso de emergencia, incluso si usas la federación de identidades de personal para otros usuarios:
- Crea usuarios con acceso de emergencia en Cloud Identity.
- Excluye a estos usuarios del inicio de sesión único y permite que se autentiquen con un nombre de usuario y una contraseña.
- Protege a estos usuarios inscribiéndolos en la verificación en dos pasos con una llave de seguridad.
Para obtener más información sobre los usuarios con acceso de emergencia, consulta Prácticas recomendadas para el acceso continuo a Google Cloud.
Usa Cloud Identity para el acceso con privilegios elevados
Los usuarios con privilegios elevados tienen un acceso amplio a tu entorno de Google Cloud. Estos son algunos ejemplos de estos usuarios:
- Usuarios con el rol de Administrador de la organización
(
roles/resourcemanager.organizationAdmin) - Usuarios con el rol de administrador de seguridad (
roles/iam.securityAdmin) o un rol similar que pueda modificar las políticas de permisos en partes significativas de tu jerarquía de recursos de Google Cloud
Si usas la federación de identidades de personal para usuarios con privilegios elevados, cualquier error de configuración o vulneración en tu IdP externo puede afectar la seguridad de tus recursos de Google Cloud . En particular, un compromiso del IdP externo puede permitir que los agentes de amenazas se autentiquen como usuarios con privilegios elevados y obtengan un acceso amplio a tus recursos de Google Cloud .
Para mitigar estos riesgos, usa Cloud Identity para los usuarios con privilegios elevados:
- Crea usuarios con privilegios elevados en Cloud Identity.
- Protege a estos usuarios inscribiéndolos en la verificación en dos pasos con una llave de seguridad.
- Si federaste Cloud Identity con un IdP externo, habilita las verificaciones de SSO adicionales y la verificación en dos pasos para estos usuarios.
Las verificaciones de SSO adicionales pueden parecer redundantes si tu IdP ya aplica la autenticación de varios factores, pero este parámetro de configuración ayuda a proteger a los usuarios si el IdP se ve comprometido. Las verificaciones de SSO adicionales son una función compatible con Cloud Identity, pero no están disponibles para la federación de identidades de personal.
Usa restricciones de las políticas de la organización para controlar la federación
Si usas Cloud Identity para fines que no sean de emergencia o de acceso con privilegios elevados, divide el uso de la federación de Cloud Identity y la federación de identidades de personal por servicio. Para aplicar esta práctica, usa restricciones de políticas de la organización personalizadas para restringir qué tipos de principales se permiten en proyectos específicos.
Por ejemplo, puedes limitar la federación de identidades de personal a Gemini Enterprise de la siguiente manera:
- Aplica una restricción de política de la organización personalizada a tu
proyecto de Gemini Enterprise que use la
función
MemberTypeMatchespara limitar los tipos de principales permitidos aiam.googleapis.com/WorkforcePoolPrincipalyiam.googleapis.com/WorkforcePoolPrincipalSet. Estos son los tipos de principales que usa la federación de identidades del personal. - Para todos los demás proyectos, aplica una restricción que permita todos los tipos de principales,
excepto
iam.googleapis.com/WorkforcePoolPrincipalyiam.googleapis.com/WorkforcePoolPrincipalSet.
El uso de restricciones de políticas de la organización personalizadas te ayuda a garantizar la coherencia y a evitar el uso accidental de tipos de principales incorrectos.
No otorgues acceso a todos los miembros de un grupo
La federación de identidades de personal admite un identificador de principal comodín que usa el siguiente formato:
principalSet://iam.googleapis.com/locations/global/workforcePools/
POOL_ID/*
Este identificador coincide con todos los usuarios que tu IdP permite autenticar en Google Cloud.
No uses este identificador comodín para otorgar permisos. A medida que crece la base de usuarios de tu IdP, otorgar acceso con el identificador de principal comodín genera un exceso de permisos.
En su lugar, crea grupos de acceso en tu IdP y úsalos para administrar el acceso a los recursos. Este enfoque ayuda a garantizar que el acceso se rija por la pertenencia intencional a un grupo, en lugar de por una autenticación exitosa, lo que reduce el riesgo de otorgar permisos excesivos.
Limita la duración de las sesiones
Cuando un usuario accede, la federación de identidades del personal inicia una sesión. La sesión permite que un usuario realice las siguientes acciones:
- Usar la consola (federada), Gemini Enterprise o otros portales que admitan la federación de identidades de personal, y navegar entre ellos
- Usar aplicaciones web protegidas con IAP
- Obtén tokens de actualización federados y tokens de acceso federados, por ejemplo,
ejecutando
gcloud auth login.
Una sesión sigue siendo válida hasta que ocurre una de las siguientes situaciones:
- La duración de la sesión alcanza el límite definido por el grupo de identidades de personal.
- La duración de la sesión alcanza el límite definido en el atributo
SessionNotOnOrAfteren la aserción de SAML del usuario, si está presente. - El usuario sale de su cuenta.
- Un administrador revoca las sesiones del usuario.
Permitir que las sesiones sigan siendo válidas durante períodos prolongados aumenta el riesgo de robo de tokens y puede hacer que la información de la membresía del grupo quede desactualizada:
- Es posible que los usuarios conserven el acceso durante más tiempo del previsto si se revocan los permisos en el IdP.
- Es posible que los usuarios no puedan ejercer el acceso otorgado recientemente hasta que vuelvan a autenticarse y establezcan una sesión nueva.
Para mitigar estos riesgos, limita la duración de la sesión de modo que los usuarios deban volver a acceder al menos una vez al día.
Alinea la duración de la sesión con los requisitos de acceso JIT
Para administrar el acceso con privilegios, tus IdP pueden admitir grupos justo a tiempo (JIT) que los miembros pueden activar de forma temporal. Usar grupos de acceso inmediato para administrar el acceso con privilegios a Google Cloud o Gemini Enterprise puede introducir los siguientes riesgos:
- Activación retrasada: Si un usuario tiene una sesión activa de la federación de identidades de personal mientras activa su membresía de grupo justo a tiempo, el cambio de membresía no se aplicará hasta que el usuario salga de su cuenta y vuelva a acceder. Como alternativa, si el proveedor del grupo de identidades de personal usa SCIM, el cambio de membresía no se aplicará hasta que se aprovisione el cambio de membresía del grupo.
- Revocación retrasada: Si vence una membresía de grupo, el usuario no pierde el acceso con privilegios hasta que salga y vuelva a acceder, o hasta que se aprovisione el cambio de membresía de grupo con SCIM. Según la duración de la sesión, esta demora puede socavar el propósito del vencimiento de la membresía.
Para mitigar estos riesgos, configura la duración de la sesión del grupo de identidades de personal para que sea lo suficientemente corta.
Supervisar la actividad
Cada vez que observes una actividad sospechosa que afecte a un recurso en Google Cloud, los Registros de auditoría de Cloud proporcionan información fundamental para determinar cuándo ocurrió la actividad y qué usuarios participaron.
Habilita los registros de acceso a los datos
La federación de identidades de personal puede generar registros que te permiten hacer un seguimiento de las actividades de acceso y de intercambio de tokens. La API del servicio de tokens de seguridad escribe estos registros, que incluyen los siguientes métodos:
google.identity.sts.SecurityTokenService.WebSignIngoogle.identity.sts.SecurityTokenService.WebSignOutgoogle.identity.sts.v1.SecurityTokenService.ExchangeTokengoogle.identity.sts.v1beta.SecurityTokenService.ExchangeToken
Todos los registros relacionados con las actividades de acceso y de intercambio de tokens se clasifican como registros de acceso a los datos y están inhabilitados de forma predeterminada. Para capturar estos registros, habilita los registros de acceso a los datos de la API de Security Token Service en toda tu organización deGoogle Cloud . Para aumentar aún más la verbosidad de los registros de acceso, habilita el registro de auditoría detallado.
Para hacer un seguimiento de otras actividades relacionadas con la autenticación, te recomendamos que habilites y uses los siguientes registros:
- Registros de auditoría de SCIM de IAM
- Registros de auditoría de las credenciales de cuenta de servicio
- Registros de auditoría de acceso de Cloud Identity y Google Workspace
¿Qué sigue?
- Revisa la descripción general de la federación de identidades de personal.
- Obtén más información para administrar grupos y proveedores.
- Obtén más información para revocar las sesiones de usuario de la federación de identidades de personal.