Las políticas de límite de acceso de la entidad (PAB) te permiten definir los recursos a los que pueden acceder las entidades.
Otras políticas relacionadas con el acceso, como las políticas de permiso y denegación, se adjuntan a los recursos. Estas políticas definen quién tiene permiso para acceder al recurso al que están adjuntas. En cambio, las Políticas de Límite de Acceso de las Entidades se adjuntan a los conjuntos de entidades y controlan lo que pueden hacer las entidades en el conjunto de entidades.
Por ejemplo, puedes usar las políticas de límite de acceso de las entidades para evitar que tus entidades accedan a recursos de otras organizaciones, lo que puede ayudar a prevenir ataques de phishing o robo de datos.
Cómo funcionan las políticas de Límite de Acceso de las Entidades
De forma predeterminada, las principales son aptas para acceder a cualquier recurso de Google Cloud . Esto significa que, si una política de permiso otorga acceso a una principal a un recurso y ninguna política de denegación bloquea ese acceso, la principal puede acceder al recurso.
Con las políticas de límite de acceso de las entidades, puedes definir los recursos a los que puede acceder una entidad. Si una principal no es apta para acceder a un recurso, su acceso a ese recurso se limita, sin importar los roles que se le hayan otorgado. Para obtener más información sobre cómo usar las políticas de límite de acceso de las entidades para definir los recursos a los que puede acceder una entidad, consulta Define los recursos aptos.
Las políticas de Límite de Acceso de las Entidades solo bloquean los intentos de acceso que involucran permisos admitidos. Si una política de límite de acceso de las principales no puede bloquear un permiso, las principales pueden usar ese permiso para acceder a cualquier recurso, independientemente de las políticas a las que estén sujetas. Para obtener más información, consulta Permisos que pueden bloquear las políticas de límite de acceso de las entidades.
Casos de uso
Las políticas de Límite de Acceso de las Entidades son útiles en circunstancias como las siguientes:
- Evita que las principales accedan a recursos que no te pertenecen
- Mantener ciertos tipos de principales, como las cuentas de servicio, limitadas a ciertos proyectos
Para ver ejemplos detallados de cómo puedes usar las políticas de límite de acceso de las entidades en situaciones como estas, consulta Ejemplos de casos de uso para las políticas de límite de acceso de las entidades.
Componentes de la política de Límite de Acceso de las Entidades
Las Políticas de Límite de Acceso de las Entidades constan de reglas individuales. Cada regla define un conjunto de recursos a los que las principales pueden acceder. Cada política puede tener hasta 500 reglas.
Las políticas también contienen otra información, incluidos los metadatos y los detalles de configuración. Para obtener más información, consulta Estructura de una política de límite de acceso de las principales.
Después de crear una Política de Límite de Acceso de las Principales, debes aplicarla a conjuntos de principales creando vinculaciones de políticas. Todas las principales de esos conjuntos de principales están sujetas a esa política de límite de acceso de las principales, lo que significa que pueden acceder a los recursos que se indican en la política. Puedes vincular una Política de Límite de Acceso de las Entidades a cualquier cantidad de conjuntos de entidades.
Puedes crear hasta 1,000 políticas de límite de acceso de las principales en tu organización.
Permisos que bloquean las Políticas de Límite de Acceso de las Entidades
Las Políticas de Límite de Acceso de las Entidades pueden bloquear todos los permisos que se incluyen en la versión de aplicación de la política. Si una política de límite de acceso de las principales puede bloquear un permiso, puede impedir que las principales no aptas usen ese permiso para acceder a los recursos.
Debes especificar la versión de aplicación de una política cuando la creas. Cuando actualizas la versión de aplicación forzosa, se actualizan los permisos que la política puede bloquear. Para obtener una lista completa de los permisos que bloquea cada versión de aplicación forzosa, consulta la referencia de la versión de aplicación forzosa.
Si una Política de Límite de Acceso de las Entidades no puede bloquear un permiso, la política no tiene efecto en si las entidades pueden usar el permiso. En otras palabras, IAM no puede aplicar la política para los intentos de acceso que involucren ese permiso.
Por ejemplo, imagina que a un principal, Lee (lee@example.com), se le otorga el
rol de desarrollador de Dataflow (roles/dataflow.developer). Este rol incluye el
permiso dataflow.googleapis.com/jobs.snapshot, que le permite a Lee tomar
instantáneas de los trabajos de Dataflow. Lee también está sujeto a una política de límite de acceso de las principales
que lo hace no apto para acceder a recursos fuera de example.com.
Sin embargo, si esa política de límite de acceso de las principales no puede bloquear el
permiso dataflow.jobs.snapshot, Lee aún puede tomar instantáneas de
trabajos de Dataflow en organizaciones fuera de example.com.
Administra las versiones de aplicación de políticas
De forma periódica, IAM agrega nuevas versiones de aplicación forzosa que pueden bloquear permisos adicionales. Cada versión nueva también puede bloquear todos los permisos de la versión anterior.
Para bloquear los permisos en una nueva versión de aplicación forzosa, debes actualizar tus políticas de Límite de Acceso de las Entidades para usar la versión nueva.
Si deseas que la versión de aplicación de una política se actualice automáticamente a medida que se lanzan
versiones nuevas, puedes usar el valor latest cuando crees la política.
Sin embargo, no recomendamos usar este valor, ya que podría provocar que las principales
pierdan el acceso a los recursos de forma inesperada.
Las políticas que usan latest para el número de versión usan la versión de aplicación forzosa
predeterminada. La versión de aplicación forzosa predeterminada suele ser la más reciente.
Sin embargo, una versión nueva puede tardar hasta 4 semanas en convertirse en la versión de aplicación predeterminada. Para saber qué versión de aplicación forzosa es
la predeterminada, consulta la referencia de la versión de aplicación forzosa.
La versión de aplicación predeterminada también se usa para las nuevas políticas de límite de acceso de las entidades que no especifican un número de versión.
Define los recursos aptos
Las principales pueden verse afectadas por cualquier cantidad de políticas de límite de acceso de las principales o estar sujetas a ellas. En conjunto, estas políticas definen los recursos a los que puede acceder la principal.
Las políticas de límite de acceso de las entidades son aditivas. Esto significa que los recursos a los que puede acceder una entidad que cumple con los requisitos son la unión de todos los recursos en todas las políticas de límite de acceso de las entidades a las que está sujeta la entidad. En otras palabras, si una sola Política de Límite de Acceso de las Entidades hace que una entidad pueda acceder a un recurso, entonces puede acceder a él, independientemente de las otras Políticas de Límite de Acceso de las Entidades a las que esté sujeta.
Si una entidad no está sujeta a ninguna Política de Límite de Acceso de las Entidades, es apta para acceder a cualquier recurso de Google Cloud .
En las siguientes secciones, se describe cómo personalizar el conjunto de recursos al que un principal puede acceder.
Agrega recursos aptos
Existen varias formas de hacer que una principal sea apta para acceder a un recurso al que no puede acceder:
- Agrega el recurso a una Política de Límite de Acceso de las Entidades a la que esté sujeta la entidad.
- Crea una nueva Política de Límite de Acceso de las Entidades con el recurso adicional y vincula la política a un conjunto de principales que incluya la principal.
- Quita o borra todas las políticas de límite de acceso de las entidades principales a las que está sujeta la entidad principal. Esta acción hace que la principal sea apta para acceder a todos los recursos de Google Cloud .
Quita recursos aptos
Existen varias formas de hacer que una principal no sea apta para acceder a un recurso al que sí puede acceder.
Primero, busca todas las políticas de límite de acceso de las principales a las que está sujeta la principal y que incluyen el recurso. Según las políticas que encuentres, puedes realizar una de las siguientes acciones:
Si la entidad no está sujeta a ninguna Política de Límite de Acceso de las Entidades, crea una nueva Política de Límite de Acceso de las Entidades que incluya solo los recursos a los que deseas que la entidad pueda acceder. Luego, vincula esa política a un conjunto de principales que contenga la principal.
Después de aplicar la política, la principal pasa de ser apta para acceder a todos los recursos a solo ser apta para acceder a los recursos que se indican en la política.
Si la entidad ya está sujeta a una o más Políticas de Límite de Acceso de las Entidades, debes asegurarte de que ninguna de las Políticas de Límite de Acceso de las Entidades a las que está sujeta incluya el recurso. Para obtener instrucciones paso a paso, consulta Reduce los recursos a los que pueden acceder las principales.
Durante este proceso, debes asegurarte de que la principal siempre esté sujeta a al menos una política de límite de acceso de las principales. De lo contrario, la principal podría convertirse en apta para acceder a todos los recursos.
Políticas de Límite de Acceso de las Entidades y recursos almacenados en caché
Ciertos servicios de Google Cloud almacenan en caché recursos visibles de forma pública. Por ejemplo, Cloud Storage almacena en caché los objetos que son de lectura pública.
Si una política de límite de acceso de las principales puede impedir que las principales no aptas vean un recurso visible de forma pública, depende de si el recurso se almacena en caché:
- Si el recurso se almacena en caché, las políticas de límite de acceso de las entidades no pueden impedir que las entidades vean el recurso.
- Si el recurso no se almacena en caché, el límite de acceso de la entidad impide que las principales no aptas vean el recurso
En todos los casos, las políticas de Límite de Acceso de las Entidades siguen impidiendo que las entidades no aptas modifiquen o borren recursos visibles de forma pública.
Recursos propiedad de Google
Para permitir que los desarrolladores usen los servicios de Google Cloud , como
BigQuery y Cloud Workstations, Google Cloud proporciona
recursos públicos que pertenecen a Google. Por ejemplo, BigQuery proporciona
conjuntos de datos públicos que puedes integrar en tus
aplicaciones. Estos recursos públicos se alojan en una organización deGoogle Cloud
propiedad de Google con el ID 433637338589. Esta organización también
se usa para administrar proyectos de usuario para servicios como
Cloud Workstations.
Las entidades que están sujetas a las políticas de límite de acceso de las entidades perderán el acceso a estos recursos públicos, a menos que las habilites para acceder a los recursos de la organización de Google.
Para que las principales puedan acceder a los recursos de la organización propiedad de Google, agrega la siguiente regla a una Política de Límite de Acceso de las Principales que se aplique a las principales:
{
"description": "Make principals eligible to access Google-owned public resources",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/433637338589"
],
"effect": "ALLOW"
}
Como alternativa, puedes crear una nueva Política de Límite de Acceso de las Entidades con esta regla y vincularla al conjunto de entidades correspondiente.
Evaluación de la política de Límite de Acceso de las Entidades
Cuando una entidad intenta acceder a un recurso, IAM evalúa las políticas de límite de acceso de las entidades relevantes para determinar si se debe bloquear el intento de acceso. Una política es relevante si la principal que realiza el intento de acceso está sujeta a la política.
Las políticas de Límite de Acceso de las Entidades solo pueden bloquear o no bloquear el acceso, pero no pueden otorgarlo. Solo las políticas de permisos pueden otorgar acceso a los recursos a las principales. Para obtener información sobre cómo los diferentes tipos de políticas afectan el acceso de las principales a los recursos, consulta Tipos de políticas.
IAM no bloquea el acceso si se cumple alguna de las siguientes condiciones:
- La principal no está sujeta a ninguna política de Límite de Acceso de las Entidades
- Las políticas de límite de acceso de las entidades pertinentes no pueden bloquear el permiso en la solicitud.
- Una política de límite de acceso de las principales hace que la principal sea apta para acceder al recurso
IAM sí bloquea el acceso si la principal está sujeta a, al menos, una política de límite de acceso de las principales, pero ninguna de las políticas relevantes hace que la principal sea apta para acceder al recurso.
Evaluación de bloqueo ante errores
Las políticas de Límite de Acceso de las Entidades se bloquean ante errores. Esto significa que, si IAM encuentra un error cuando evalúa una política de límite de acceso de las principales, IAM impide que la principal acceda al recurso.
El motivo más común por el que IAM encuentra un error cuando evalúa las políticas de límite de acceso de las entidades es que los detalles de una entidad aún se están propagando por el sistema. Es más probable que esto ocurra con los usuarios recién creados. Para resolver este problema, haz que el principal nuevo espere y vuelva a intentar acceder al recurso más tarde.
Aplica políticas de Límite de Acceso de las Entidades a conjuntos de entidades
Para aplicar una Política de Límite de Acceso de las Entidades a un conjunto de entidades, crea una vinculación de política que especifique la Política de Límite de Acceso de las Entidades que deseas aplicar y el conjunto de entidades al que deseas aplicarla. Esta vinculación de política vincula la política al conjunto de principales.
Después de vincular una política a un conjunto de entidades, las entidades de ese conjunto solo pueden acceder a los recursos que se indican en las políticas de Límite de Acceso de las Entidades a las que están sujetas.
Puedes vincular una Política de Límite de Acceso de las Entidades a cualquier cantidad de conjuntos de entidades. Cada conjunto de entidades puede tener hasta 10 políticas de Límite de Acceso de las Entidades vinculadas a él.
Solo puedes crear vinculaciones para las Políticas de Límite de Acceso de las Entidades existentes. Si intentas crear una vinculación para una política de Límite de Acceso de las Entidades borrada, se producirá un error. Si borraste recientemente una política de límite de acceso de las principales, a veces puedes crear una vinculación con éxito, pero la vinculación no tendrá ningún efecto. IAM limpia estas vinculaciones automáticamente.
Para obtener información sobre cómo administrar las Políticas de Límite de Acceso de las Entidades, consulta Crea y aplica Políticas de Límite de Acceso de las Entidades.
Conjuntos de principales admitidos
En la siguiente tabla, se enumeran los tipos de conjuntos de entidades a los que puedes vincular las políticas de límite de acceso de las entidades. Cada fila contiene lo siguiente:
- El tipo de conjunto de principales
- Las principales en ese tipo de conjunto de principales
- El formato de los IDs para ese tipo de conjunto de principales
- El recurso de Resource Manager (proyecto, carpeta u organización) que es superior de las vinculaciones de políticas para ese tipo de conjunto de principales
| Conjunto principal | Detalles | Recurso superior de las vinculaciones de políticas |
|---|---|---|
| Grupo de identidad de trabajadores |
Contiene todas las identidades en el grupo de identidades de personal especificado.
Formato: |
La organización que contiene el grupo de identidades de personal |
| Grupo de identidades para cargas de trabajo |
Contiene todas las identidades en el grupo de identidades para cargas de trabajo especificado.
Formato: |
El proyecto que contiene el grupo de identidades para cargas de trabajo |
| Dominio de Google Workspace |
Contiene todas las identidades en el dominio de Google Workspace especificado.
Formato: Puedes encontrar tu ID de cliente con los siguientes métodos:
|
La organización asociada al dominio de Google Workspace |
| Conjunto de principales del proyecto |
Contiene todas las cuentas de servicio, los grupos de identidades para cargas de trabajo y las identidades de agentes en el proyecto especificado.
Formato: |
El proyecto |
| Conjunto de principales de la carpeta |
Contiene todas las cuentas de servicio, todos los grupos de identidades para cargas de trabajo y todas las identidades de agentes de cualquier proyecto en la carpeta especificada.
Formato: |
La carpeta |
| Conjunto principal de la organización |
Contiene las siguientes identidades:
Formato: |
La organización |
| Identidades de los agentes |
Todas las identidades de agente en el dominio de confianza del proyecto especificado. De forma predeterminada, el dominio de confianza de un proyecto contiene todas las identidades de agente del proyecto. Formatos:
|
El proyecto |
Herencia de políticas y conjuntos de principales
Las políticas de Límite de Acceso de las Entidades se adjuntan a conjuntos de entidades, no a recursos. Como resultado, no se heredan a través de la jerarquía de recursos de la misma manera que las políticas de permiso y denegación.
Sin embargo, los conjuntos de principales de las carpetas y las organizaciones siempre incluyen todos los principales de los conjuntos de principales de sus elementos subordinados. Por ejemplo, si una principal se incluye en el conjunto de principales de un proyecto, también se incluye en los conjuntos de principales de cualquier organización o carpeta superior.
Por ejemplo, considera una organización, example.com. Esta organización está
asociada con el dominio example.com y tiene los siguientes recursos:
- Una organización,
example.com - Un proyecto,
project-1, que es un elemento secundario de la organización - Una carpeta,
folder-a, que es un elemento secundario de la organización - Dos proyectos,
project-2yproject-3, que son elementos secundarios defolder-a
Los conjuntos de principales de estos recursos contienen las siguientes identidades:
| Conjunto principal | Identidades de Google Workspace en el dominio example.com |
Grupos de federación de identidades de personal en example.com |
Cuentas de servicio, grupos de identidades para cargas de trabajo e identidades de agentes en project-1 |
Cuentas de servicio, grupos de identidades para cargas de trabajo e identidades de agentes en project-2 |
Cuentas de servicio, grupos de identidades para cargas de trabajo e identidades de agentes en project-3 |
|---|---|---|---|---|---|
Conjunto de principales para example.com |
|||||
Conjunto de principales para folder-a |
|||||
Conjunto de principales para project-1 |
|||||
Conjunto de principales para project-2 |
|||||
Conjunto de principales para project-3 |
Como resultado, las siguientes entidades se ven afectadas por las siguientes Políticas de Límite de Acceso de las Entidades:
Una identidad de Google Workspace en el dominio
example.comse encuentra en el conjunto de principales paraexample.comy se verá afectada por las políticas de límite de acceso de las principales vinculadas a ese conjunto de principales.Una cuenta de servicio en
project-1se encuentra en los conjuntos de principales paraproject-1yexample.com, y se verá afectada por las políticas de Límite de acceso de las principales vinculadas a cualquiera de esos conjuntos de principales.Una identidad de agente en
project-3se encuentra en los conjuntos de principales paraproject-3,folder-ayexample.com, y se verá afectada por las políticas de Límite de acceso de las entidades vinculadas a cualquiera de esos conjuntos de principales.
Vinculaciones de políticas condicionales para las políticas de Límite de Acceso de las Entidades
Puedes usar expresiones de condición en las vinculaciones de políticas para las Políticas de Límite de Acceso de las Entidades con el objetivo de definir mejor a qué entidades se aplica la política.
Las expresiones de condición para las vinculaciones de políticas constan de una o más declaraciones
unidas por hasta 10 operadores
lógicos (&&, || o !). Cada declaración expresa una regla de control basada en atributos
que se aplica a la vinculación de la política y, en última instancia, determina
si se aplica la política.
Puedes usar los atributos principal.type y principal.subject en
las condiciones de las vinculaciones de políticas. No se admiten otros atributos.
El atributo
principal.typehace referencia al tipo de principal que realizó la solicitud, por ejemplo, una cuenta de servicio o una identidad de agente. Puedes usar condiciones con este atributo para controlar a qué tipos de principales se aplica una política de límite de acceso de las principales.Por ejemplo, si agregas la siguiente expresión de condición a una vinculación para una política de límite de acceso de las principales, la política solo se aplicará a las cuentas de servicio:
principal.type == 'iam.googleapis.com/ServiceAccount'El atributo
principal.subjecthace referencia a la identidad de la principal que realizó la solicitud, por ejemplo,cruz@example.com. Puedes usar condiciones con este atributo para controlar exactamente qué principales están sujetas a una política de límite de acceso de las principales.Por ejemplo, si agregas la siguiente expresión de condición a una vinculación para una política de límite de acceso de las principales, la política no se aplicará al usuario
special-admin@example.com:principal.subject != 'special-admin@example.com'
Para obtener más información sobre los valores que puedes usar para estas condiciones, consulta la referencia de atributos de condiciones.
Para ver un ejemplo de cómo usar estas condiciones en tus políticas de límite de acceso de las principales, consulta Permite que las cuentas de servicio accedan a los recursos de un solo proyecto.
Vinculaciones de políticas entre organizaciones
No puedes crear una vinculación de política entre organizaciones para una política de límite de acceso de las principales. Una vinculación de políticas entre organizaciones es una vinculación de políticas que vincula una política de una organización a un conjunto de principales de otra organización.
La IAM borra de forma periódica las vinculaciones de políticas entre organizaciones existentes. Las vinculaciones de políticas entre organizaciones pueden ocurrir cuando mueves un proyecto de una organización a otra. Por ejemplo, considera la siguiente situación:
- Tienes un proyecto,
example-project, en la organizaciónexample.com. - Quieres que las principales de
example-projectsean aptas para acceder a los recursos deexample.com. Para ello, crea una Política de Límite de Acceso de las Entidades enexample.comque permita que las entidades accedan a los recursos enexample.comy vincula esa política al conjunto de entidades paraexample-project. - Mueves
example-projectdeexample.comacymbalgroup.com.
En esta situación, mover el proyecto crea una vinculación de política entre organizaciones. Esto se debe a que la Política de Límite de Acceso de las Entidades en example.com está
vinculada a un conjunto de principales en cymbalgroup.com. Si no borras la vinculación
de forma manual, IAM la borrará automáticamente con el tiempo. Borrar
esta vinculación ayuda a garantizar que los administradores de cymbalgroup.com tengan acceso a
todas las políticas de Límite de Acceso de las Entidades vinculadas a sus principales.
Estructura de una Política de Límite de Acceso de las Entidades
Una política de Límite de Acceso de las Entidades es una colección de metadatos y detalles de la política de Límite de Acceso de las Entidades. Los metadatos proporcionan información como el nombre de la política y cuándo se creó. Los detalles de la política definen lo que hace, por ejemplo, los recursos a los que pueden acceder las principales afectadas.
Por ejemplo, la siguiente Política de Límite de Acceso de las Entidades hace que las entidades que
están sujetas a la política sean aptas para acceder a los recursos de la organización
con el ID 0123456789012.
{
"name": "organizations/0123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"uid": "puid_0123456789012345678",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"displayName": "Example policy",
"annotations": {
"example-key": "example-value"
},
"createTime": "2024-01-02T15:01:23Z",
"updateTime": "2024-01-02T15:01:23Z",
"details": {
"rules": [
{
"description": "Example principal access boundary policy rule",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/0123456789012"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
}
En las siguientes secciones, se describen los campos de los metadatos y los detalles de una política de límite de acceso de las entidades.
Metadatos
Las políticas de Límite de Acceso de las Entidades contienen los siguientes metadatos:
name: Es el nombre de la Política de Límite de Acceso de las Entidades. Este nombre tiene el formatoorganizations/ORGANIZATION_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID, en el queORGANIZATION_IDes el ID numérico de la organización en la que se creó la Política de Límite de Acceso de las Entidades yPAB_POLICY_IDes el ID alfanumérico de la Política de Límite de Acceso de las Entidades.uid: Es un ID único asignado a la Política de Límite de Acceso de las Entidades.etag: Es un identificador del estado actual de la política. Este valor cambia cuando actualizas la política. Para evitar actualizaciones en conflicto, el valoretagdebe coincidir con el valor almacenado en IAM. Si los valores deetagno coinciden, la solicitud falla.displayName: Es un nombre legible por humanos para la Política de Límite de Acceso de las Entidades.annotations: Opcional Es una lista de pares clave-valor definidos por el usuario. Puedes usar estas anotaciones para agregar metadatos adicionales a la política, por ejemplo, quién la creó o si se implementó mediante una canalización automatizada. Para obtener más información sobre las anotaciones, consulta Anotaciones.createTime: Es la hora en que se creó la política de límite de acceso de las principales.updateTime: Es la hora en la que se actualizó por última vez la política de límite de acceso de las principales.
Detalles
Cada política de Límite de Acceso de las Entidades contiene un campo details. Este campo contiene
las reglas de límite de acceso de la entidad y la versión de aplicación:
rules: Es una lista de reglas de límite de acceso de la entidad que definen los recursos a los que pueden acceder las entidades afectadas. Cada regla contiene los siguientes campos:description: Es una descripción legible por humanos para la regla.resources: Es una lista de recursos de Resource Manager (proyectos, carpetas y organizaciones) a los que deseas que los principales puedan acceder. Cualquier principal que esté sujeto a esta política es apto para acceder a estos recursos.Cada Política de Límite de Acceso de las Entidades puede hacer referencia a un máximo de 500 recursos en todas las reglas de la política.
effect: Es la relación que tienen las principales con los recursos que se indican en el camporesources. El único efecto que puedes especificar en las reglas de límite de acceso de la entidad es"ALLOW". Esta relación hace que las principales sean aptas para acceder a los recursos que se indican en la regla.
enforcementVersion: Es la versión de aplicación que usa IAM cuando aplica la política. La versión de la política de Límite de Acceso de las Entidades determina qué permisos puede bloquear la política de Límite de Acceso de las Entidades.Para obtener más información sobre cómo configurar y administrar las versiones de aplicación forzosa, consulta Administra las versiones de aplicación forzosa en esta página.
Estructura de una vinculación de política
Una vinculación de política para una Política de Límite de Acceso de las Entidades contiene el nombre de una política, el nombre del conjunto de principales al que se vinculará la política y los metadatos que describen la vinculación de la política. También puede contener condiciones que modifiquen las principales exactas a las que se aplica la política.
Por ejemplo, la siguiente vinculación de política vincula la política example-policy a
todas las principales de la organización example.com, que tiene el ID
0123456789012. La vinculación de la política también contiene una condición que evita que
la política se aplique a la principal super-admin@example.com.
{
"name": "organizations/0123456789012/locations/global/policyBindings/example-policy-binding",
"uid": "buid_01234567890123456789",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"displayName": "Example policy binding",
"annotations": {
"example-key": "example-value"
},
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/0123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/0123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"policyUid": "puid_0123456789012345678",
"condition": {
"title": "Exempt principal",
"description": "Don't enforce the policy for super-admin@example.com",
"expression": "principal.subject != 'super-admin@example.com'"
},
"createTime": "2024-01-02T17:00:16Z",
"updateTime": "2024-01-02T17:00:16Z"
}
Cada vinculación de política contiene los siguientes campos:
name: Es el nombre de la vinculación de la política. Este nombre tiene el formatoRESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID, en el queRESOURCE_TYPE/RESOURCE_IDes el tipo y el ID del recurso superior de la vinculación de política, yBINDING_IDes el ID alfanumérico de la vinculación de política.uid: Es un ID único asignado a la vinculación de la política.etag: Es un identificador del estado actual de la política. Este valor cambia cuando actualizas la política. Para evitar actualizaciones en conflicto, el valoretagdebe coincidir con el valor almacenado en IAM. Si los valores deetagno coinciden, la solicitud falla.displayName: Es un nombre legible por humanos para la vinculación de la política.annotations: Opcional Es una lista de pares clave-valor definidos por el usuario. Puedes usar estas anotaciones para agregar metadatos adicionales a la vinculación de la política, por ejemplo, quién creó la vinculación de la política o si una canalización automatizada implementó la vinculación de la política. Para obtener más información sobre las anotaciones, consulta Anotaciones.target: Es el conjunto de principales al que se vinculará la política. El valor tiene el formato{"principalSet": PRINCIPAL_SET}, en el quePRINCIPAL_SETes el ID del conjunto de principales al que deseas vincular la política.Cada destino puede tener hasta 10 políticas vinculadas a él.
policyKind: Es el tipo de política al que hace referencia la vinculación de políticas. En el caso de las vinculaciones de políticas para las Políticas de Límite de Acceso de las Entidades, este valor siempre esPRINCIPAL_ACCESS_BOUNDARY.policy: Es la Política de Límite de Acceso de las Entidades que se vinculará al conjunto de entidades de destino.policyUid: Es un ID único asignado a la política de límite de acceso de las principales a la que se hace referencia en el campopolicy.condition: Opcional Es una expresión lógica que afecta a qué principales IAM aplica la política. Si la condición se evalúa como verdadera o no se puede evaluar, Identity and Access Management aplica la política para la principal que realiza la solicitud. Si la condición se evalúa como falsa, Identity and Access Management no aplica la política para la principal. Para obtener más información, consulta Límite de acceso de la entidad y condiciones en esta página.createTime: Es la hora en la que se creó la vinculación de la política.updateTime: Es la hora en la que se actualizó por última vez la vinculación de la política.
¿Qué sigue?
- Obtén más información sobre los casos de uso de las políticas de límite de acceso de las principales.
- Obtén más información para crear y aplicar Políticas de Límite de Acceso de las Entidades.
- Revisa el permiso que bloquea cada versión de aplicación de la política de límite de acceso de las principales.