Las políticas de acceso unificado (UAP) te permiten otorgar y denegar el acceso a los recursos deGoogle Cloud . A diferencia de las políticas de permiso y denegación, las UAP te permiten otorgar y denegar el acceso en la misma política, lo que simplifica la administración de políticas. Las UAP también son reutilizables, lo que significa que puedes aplicar la misma UAP a varios recursos.
Cómo funcionan las políticas de acceso unificado
Para otorgar o denegar el acceso en IAM, debes especificar quién debe tener permitido o no hacer qué en qué recurso.
En las UAP, especificas quién debe tener permitido o no hacer qué creando reglas de UAP. Cada regla enumera un conjunto de principales, un conjunto de roles y permisos, y un efecto. El efecto (permitir o denegar) especifica si a las principales enumeradas se les otorgan los roles y permisos de la regla o si se les impide usar los permisos de la regla. Puedes tener hasta 100 reglas en una sola UAP.
Para especificar a qué recurso controla el acceso una UAP, usas una vinculación de UAP para vincular la UAP a un recurso. Puedes vincular una sola UAP a un máximo de 5 recursos. Un solo recurso puede tener hasta 5 políticas vinculadas.
Casos de uso
En IAM, existen varios tipos de políticas que puedes usar para permitir y denegar el acceso:
- Para permitir el acceso, puedes usar políticas de permisos o reglas de permisos de UAP.
- Para denegar el acceso, puedes usar políticas de denegación o reglas de denegación de UAP.
Si ya usas políticas de permiso o denegación para controlar el acceso, te recomendamos que sigas usándolas. Estos tipos de políticas también se admiten en el Solucionador de problemas de políticas, lo que facilita la comprensión de la causa raíz de los errores de acceso.
Usa los UAP en las siguientes circunstancias:
- Estás configurando una organización nueva y planeas usar UAP para controlar el acceso en toda tu organización.
- Quieres configurar el control de acceso detallado con las condiciones de UAP.
Reglas de la Política de acceso unificado
Las UAP se componen de reglas de permiso y denegación. Estas reglas contienen los siguientes componentes:
Un efecto: Indica si la regla otorga o rechaza el acceso. Las reglas que otorgan acceso se denominan reglas de permiso. Las reglas que deniegan el acceso se denominan reglas de denegación.
Un conjunto de principales: Las principales, por ejemplo, usuarios, grupos o cuentas de servicio, que deseas incluir en la regla. En las reglas de permiso, se les otorga acceso a estas principales. En las reglas de denegación, se les deniega el acceso a estas principales.
Una lista de roles y permisos: Son los roles y permisos que deseas incluir en la regla. En las reglas de permiso, se otorgan estos permisos. En las reglas de denegación, se rechazan estos permisos.
Opcional: Una expresión de condición: Es una expresión de condiciones de IAM que especifica las condiciones que deben ser verdaderas para que se aplique la regla. Para obtener más información, consulta Condiciones en las UAP en esta página.
Principales en las reglas de la Política de acceso unificado
Para especificar las principales que deseas incluir en la regla, define lo siguiente:
- Principales incluidas: Son las principales que deseas incluir en la regla.
- Principales excluidas: Son las principales que deseas excluir de la regla, incluso si están en un grupo de la lista de principales incluidas.
Con estas dos listas, puedes especificar de forma concisa qué principales deseas
incluir en la regla. Por ejemplo, imagina que creas una regla de permiso para otorgar
acceso a los usuarios en example.com. Si quisieras otorgar acceso a todos los miembros del
grupo all@example.com, excepto al usuario reduced-access@example.com,
agregarías all@example.com a la lista de principales incluidos y
reduced-access@example.com a la lista de principales excluidos.
Roles y permisos en las reglas de la Política de acceso unificado
Para crear una lista exacta de los permisos que deseas incluir en la regla, define lo siguiente:
- Permisos incluidos: Son los permisos que deseas incluir en la regla.
- Permisos excluidos: Son los permisos que no deseas incluir en la regla, incluso si están en un rol o grupo de permisos de la lista de permisos incluidos.
Para agregar permisos a la lista de permisos incluidos o excluidos, puedes hacer referencia a cualquiera de los siguientes elementos:
Permisos: Son nombres de permisos individuales en el formato de nombre de dominio completamente calificado (FQDN). Por ejemplo,
cloudresourcemanager.googleapis.com/projects.get.Roles (solo reglas de permiso): Son nombres de roles predefinidos, como
roles/logging.logsViewer. Si incluyes un nombre de rol en una regla, esta incluirá todos los permisos de ese rol. Para ver todos los permisos de un rol, consulta la referencia de roles y permisos.En el JSON de UAP, estos nombres siempre tienen el prefijo
role:, por ejemplo,role:roles/logging.logsViewer.Los roles solo se permiten en las reglas de permiso. Los roles personalizados no se admiten en ninguna regla.
Grupos de permisos: Son conjuntos de permisos, como
aiplatform.googleapis.com/*.*. Los grupos de permisos son conjuntos de permisos que coinciden con un patrón especificado. Existen algunas restricciones en los grupos de permisos a los que puedes hacer referencia y los permisos incluidos en esos grupos. Para obtener más información, consulta Grupos de permisos en esta página.
Grupos de permisos
Los grupos de permisos son conjuntos de permisos que coinciden con un patrón especificado. Puedes usar un grupo de permisos para otorgar o denegar conjuntos de permisos relacionados, por ejemplo, puedes denegar todos los permisos de un solo servicio o conceder todos los permisos que terminan en un verbo determinado.
Los grupos de permisos funcionan de manera diferente en las reglas de permiso y denegación. En las siguientes secciones, se explica cómo usar los grupos de permisos en cada tipo de regla.
Grupos de permisos en las reglas de permiso
Para identificar un grupo de permisos en una regla de permiso, reemplaza una o más secciones de
un nombre de permiso por un carácter comodín (*). Los permisos que incluye cada
grupo dependen de la posición del comodín:
SERVICE_FQDN/RESOURCE.*: Incluye todos los permisos para el recurso especificado.SERVICE_FQDN/*.*: Incluye todos los permisos para el servicio especificado.SERVICE_FQDN/*.VERB: Incluye todos los permisos para un servicio que termina en el verbo especificado.*/*.VERB: Incluye todos los permisos que terminan en el verbo especificado.*: Incluye todos los permisos. Este valor solo se permite cuando se enumeran los permisos incluidos, no los excluidos.
Los grupos de permisos solo incluyen los permisos que se admiten en los roles personalizados. No se incluyen otros permisos, incluso si coinciden con el formato especificado.
Para saber qué permisos se admiten en los roles personalizados, consulta Niveles de compatibilidad para los permisos en roles personalizados.
Los permisos que se indican en esa página no usan el mismo formato que los permisos en las UAP:
- Los roles personalizados usan el formato
v1para los nombres de los permisos, que esSERVICE_ID.RESOURCE.VERB. - Los UAP usan el formato de nombre de dominio completamente calificado
para los nombres de permisos, que es
SERVICE_FQDN/RESOURCE.VERB.
Sin embargo, los valores de SERVICE_ID y
SERVICE_FQDN suelen ser similares. En la mayoría de los casos, el
valor de SERVICE_FQDN es el valor de
SERVICE_ID de la API de v1, seguido de
.googleapis.com. Por ejemplo, el permiso para borrar un rol se puede escribir
de las siguientes maneras:
- Formato de
v1:iam.roles.delete - Formato de nombre de dominio completamente calificado:
iam.googleapis.com/roles.delete
Puedes usar esta similitud para traducir entre los dos formatos cuando revises los grupos de permisos para las reglas de permiso.
Existen algunas excepciones a esta regla. Para ver estas excepciones, revisa
la lista de permisos admitidos en las políticas de denegación
y busca IAM v1 API en el campo de filtro.
Grupos de permisos en las reglas de denegación
Las reglas de denegación solo admiten ciertos grupos de permisos. Los grupos de permisos compatibles
se enumeran en Permisos compatibles con las políticas de denegación. Los identificadores de los grupos de permisos
admitidos reemplazan una o más secciones de un nombre de permiso por un
carácter comodín (*). Los permisos que incluye cada grupo dependen de la
posición del comodín:
SERVICE_FQDN/RESOURCE.*: Rechaza todos los permisos para el recurso especificado.SERVICE_FQDN/*.*: Rechaza todos los permisos para el servicio especificado.SERVICE_FQDN/*.VERB: Rechaza todos los permisos para un servicio que termina en el verbo especificado.
Los grupos de permisos incluyen todos los permisos actuales y futuros que coinciden con el patrón especificado. Por ejemplo, imagina que usas el grupo de permisos example.googleapis.com/exampleResource.* a fin de denegar a un usuario todos los permisos para el tipo de recurso exampleResource. Si example.googleapis.com agrega un permiso nuevo para el tipo de recurso exampleResource, como example.googleapis.com/exampleResource.newPermission, se le denegará automáticamente el permiso nuevo.
Solo puedes usar comodines en los grupos de permisos admitidos. No se admite el uso de comodines en otros nombres de permisos en las reglas de denegación.
Crea políticas de acceso unificado
Puedes crear UAP en un proyecto, una carpeta o una organización. El recurso en el que creas la UAP se convierte en el recurso superior de la UAP. Sin embargo, la UAP no tiene ningún efecto hasta que la apliques.
El superior del UAP aparece en el nombre del UAP. Los nombres de las políticas tienen el formato
RESOURCE_TYPE/RESOURCE_ID/locations/global/accessPolicies/POLICY_ID,
en el que los marcadores de posición representan lo siguiente:
RESOURCE_TYPE: Es el tipo de recurso en el que se creó la UAP. Este valor esprojects,foldersoorganizations.RESOURCE_ID: Es el ID del recurso en el que se creó la UAP.POLICY_ID: Es el ID alfanumérico del UAP.
Por ejemplo, si creas una UAP example-policy en el
proyecto example-project, el recurso superior de esa UAP
es example-project y el nombre de la UAP es
projects/example-project/locations/global/accessPolicies/example-policy.
Dónde crear políticas de acceso unificado
El elemento superior de una UAP no afecta los recursos a los que puedes aplicar la UAP. Sin embargo, sí afecta quién tiene permiso para ver y editar el UAP. Para garantizar que los usuarios adecuados tengan permiso para ver y editar las UAP correspondientes, te recomendamos que elijas un recurso superior que refleje mejor el alcance de la UAP.
Por ejemplo, si deseas aplicar una UAP a tu organización, te recomendamos que la crees en la organización.
Aplica políticas a los recursos
Para aplicar una UAP, debes crear una vinculación. Cada vinculación especifica un UAP y un recurso al que se vinculará el UAP. Después de crear la vinculación, las reglas de la UAP se aplican a ese recurso, así como a cualquiera de los descendientes de ese recurso.
Por ejemplo, imagina que tienes una UAP,
compute-access-management. Esta
UAP otorga el rol de editor de Compute
(roles/compute.editor) al grupo compute-users@example.com y deniega los
permisos compute.googleapis.com/instances.* a todos los usuarios, excepto
a compute-users@example.com.
Sin vinculaciones, esta UAP no tiene efecto.
Quieres que esta UAP se aplique a todos los recursos de tu
organización example.com, por lo que creas una vinculación que adjunta la
UAP compute-access-management a example.com. Después
de crear la vinculación, la UAP tiene los siguientes
efectos:
- Los miembros de
compute-users@example.compueden usar los permisos del rol de editor de Compute para acceder a los recursos deexample.com. - Se impide que todos los usuarios que no son miembros de
compute-users@example.comusen permisos relacionados con la instancia para acceder a los recursos enexample.com.
Recursos admitidos
En la siguiente tabla, se enumeran los recursos a los que puedes vincular las UAP. Cada fila contiene lo siguiente:
- El tipo de recurso.
- El formato de los IDs de ese recurso
- Es el recurso de Resource Manager (proyecto, carpeta u organización) que vincula los elementos superiores para ese tipo de recurso.
| Recurso | ID de recurso | Recurso superior de las vinculaciones |
|---|---|---|
| Proyectos de Resource Manager | //cloudresourcemanager.googleapis.com/projects/PROJECT_ID |
El proyecto en la vinculación |
| Carpetas de Resource Manager | //cloudresourcemanager.googleapis.com/folders/FOLDER_ID |
La carpeta en la vinculación |
| Organizaciones de Resource Manager | //cloudresourcemanager.googleapis.com/organizations/ORG_ID |
La organización en la vinculación |
| Aplicaciones de IA de Agent Registry | //agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION/aiApplications/APPLICATION_ID |
El proyecto superior de la aplicación |
| Agent Gateways de la API de Network Services | //networkservices.googleapis.com/projects/PROJECT_ID/locations/LOCATION/agentGateways/GATEWAY_ID |
El proyecto superior de la puerta de enlace |
Inhabilitar la creación de vinculaciones
Si deseas inhabilitar la creación de vinculaciones en tu organización, puedes aplicar de manera forzosa la restricción de la política de la organización iam.managed.disableAccessPolicyBinding en tu organización. Esta
restricción impide que las principales de tu organización creen vinculaciones para
UAP.
Para aprender a habilitar o inhabilitar esta restricción, consulta Usa restricciones administradas en una política de la organización.
Herencia de políticas
Si vinculas una UAP a un proyecto, una carpeta o una organización, esa UAP se hereda a través de la jerarquía de recursos.
La jerarquía de recursos consta de la organización (raíz) en la parte superior, seguida de carpetas (opcionales) para agrupar y, luego, proyectos, que contienen recursos específicos del servicio, como máquinas virtuales de Compute Engine y buckets de Cloud Storage.
En esta jerarquía, los proyectos, las carpetas y las organizaciones son recursos superiores. En otras palabras, son recursos que contienen otros recursos:
- Los proyectos contienen recursos específicos del servicio.
- Las carpetas contienen otras carpetas, proyectos y los recursos de los proyectos.
- Las organizaciones contienen carpetas, proyectos y los recursos de los proyectos.
Los recursos que contiene un recurso superior son los descendientes de ese recurso.
Cuando vinculas una UAP a un recurso superior, esa UAP se aplica al recurso superior y a todos los recursos subordinados de ese recurso. En otras palabras, los descendientes del recurso heredan la UAP.
La herencia de políticas te permite aplicar políticas a grandes conjuntos de recursos con una
sola vinculación. Por ejemplo, imagina que creas una UAP
que otorga a taylor@example.com el rol de administrador de Compute Engine
(roles/compute.admin). La UAP también deniega
a noam@example.com el permiso compute.googleapis.com/instances.delete.
Quieres que esta UAP sea efectiva para todos los recursos de
tu organización, example.com. Para lograrlo, vincula esta
UAP al recurso de tu organización. Después de vincular la
UAP a la organización, todos los recursos de esa organización
heredan la UAP.
Vincular el UAP a la organización tiene los siguientes efectos:
taylor@example.compuede usar los permisos del rol de administrador de Compute Engine para acceder a cualquier recurso enexample.com.noam@example.comno puede usar el permisocompute.googleapis.com/instances.deleteen ningún recurso deexample.com, incluso si una UAP en un recurso descendiente le otorga acceso.
Si deseas que una UAP se aplique a menos recursos, puedes vincularla a un nivel inferior de la jerarquía de recursos, por ejemplo, a un proyecto o a un recurso específico del servicio compatible.
Vinculaciones entre organizaciones
No puedes crear una vinculación entre organizaciones para un UAP. Una vinculación entre organizaciones es una vinculación que vincula un UAP de una organización a un recurso de otra organización.
La IAM borra de forma periódica las vinculaciones entre organizaciones existentes. Las vinculaciones 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. - Creas un UAP en el proyecto
example-projecty lo vinculas aexample-project. - Mueves
example-projectdeexample.comacymbalgroup.com.
En esta situación, mover el proyecto crea una vinculación entre organizaciones. Esto se debe a que la UAP en example.com está
vinculada a un recurso 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
todos los UAP vinculados a los recursos de su organización.
Vinculaciones para las políticas de acceso unificado borradas
Por lo general, debes borrar las vinculaciones de una UAP antes de borrarla. Si intentas borrar una UAP que tiene vinculaciones existentes, se producirá un error.
Sin embargo, si quieres borrar una UAP sin borrar las vinculaciones existentes, puedes borrarla de forma forzosa.
Si borras de forma forzosa una UAP, se quitará de todos los recursos a los que está vinculada. Las vinculaciones que hagan referencia a la UAP se borrarán con el tiempo. Sin embargo, hasta que se borren, las vinculaciones seguirán contando para el límite de la cantidad de vinculaciones que pueden hacer referencia a un solo recurso.
Condiciones en las políticas de acceso unificado
Las condiciones de IAM te permiten definir y aplicar el control de acceso condicional basado en atributos para los recursos de Google Cloud . En las UAP, puedes agregar condiciones a reglas individuales para controlar cuándo se aplica esa regla. No puedes agregar condiciones a las vinculaciones de UAP.
Las condiciones se componen de un título, una descripción y una expresión booleana. Si
la expresión se evalúa como true para la solicitud, la regla se aplica a
la solicitud. Si se evalúa como false, la regla no se aplica a la
solicitud.
Los diferentes servicios ofrecen distintos atributos y funciones que puedes usar para escribir expresiones de condición. Cuando agregas condiciones a una regla, siempre debes anteponer a la condición el nombre del servicio cuyos atributos y funciones estás usando. Puedes agregar varias condiciones a una regla, pero una sola condición no puede mezclar atributos de diferentes servicios.
Por ejemplo, si agregas una condición que usa un atributo proporcionado por
IAM, debes anteponer iam.googleapis.com a la condición:
"conditions": {
"iam.googleapis.com": {
"title": "CONDITION_TITLE",
"description": "CONDITION_DESCRIPTION",
"expression": "CONDITION_EXPRESSION"
}
}
Para aprender a crear reglas de UAP con condiciones, consulta Crea y aplica UAP.
Permisos aplicables para los atributos de condición
Algunos atributos específicos del servicio solo se aplican a las solicitudes que involucran ciertos
permisos. Por ejemplo, el atributo message.id de eventarc.googleapis.com
solo se aplica a las solicitudes que requieren el
permiso eventarc.googleapis.com/messageBuses.publish.
Solo puedes usar estos atributos en reglas que incluyan el permiso correspondiente. Si intentas usar el atributo en una regla sin el permiso correspondiente, fallará la creación de la UAP.
Atributos de condición compatibles
Los siguientes atributos son compatibles con las reglas de UAP:
| Servicio | Atributo | Permisos aplicables | Más información |
|---|---|---|---|
iam.googleapis.com (Vista previa) |
Etiquetas de recursos | Cualquiera | Atributo de etiquetas de recursos |
eventarc.googleapis.com (Vista previa) |
Mensajes | eventarc.googleapis.com/messageBuses.publish |
Atributos de mensajes de Eventarc |
iap.googleapis.com (GA) |
Destinos | iap.googleapis.com/resources.egressViaIAP |
Atributos de destinos de Identity-Aware Proxy |
¿Qué sigue?
- Obtén más información para crear y aplicar UAP.
- Obtén más información para ver los UAP existentes.