Rechazar los permisos que permiten a los usuarios otorgar acceso te ayuda a evitar la elevación de privilegios no autorizada y a reforzar tus controles de seguridad. En este documento, se describe cómo identificar estos permisos y crear una política de denegación que los bloquee para la mayoría de los usuarios, a la vez que se permiten excepciones para las principales de confianza.
Antes de comenzar
Habilita la API de IAM si aún no está habilitada.
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el permiso
serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.Configura la autenticación.
Selecciona la pestaña según cómo planeas usar las muestras de esta página:
Console
Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.
gcloud
En la consola de Google Cloud , activa Cloud Shell.
En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.
REST
Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.
Instala Google Cloud CLI.
Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .
Opcional: Lee la descripción general de las políticas de denegación.
Roles obligatorios
Para obtener el permiso que
necesitas para crear una política de denegación,
pídele a tu administrador que te otorgue el rol de IAM de
Administrador de denegaciones (roles/iam.denyAdmin) en tu organización.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene el permiso
iam.denypolicies.create,
que se requiere para
crear una política de denegación.
También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.
Identifica los permisos que permiten a los usuarios otorgar acceso
Antes de crear una política de denegación para evitar que los usuarios otorguen acceso, determina qué permisos deseas denegar.
Los siguientes permisos permiten que los usuarios otorguen acceso:
Los permisos finalizarán en
setIamPolicy. Los permisos más amplios de estos son los de los recursos de Resource Manager, ya que las políticas de permisos de esos recursos se heredan en todos los recursos subordinados. Estos permisos son los siguientes:cloudresourcemanager.googleapis.com/projects.setIamPolicycloudresourcemanager.googleapis.com/folders.setIamPolicycloudresourcemanager.googleapis.com/organizations.setIamPolicy
Otros recursos también tienen permisos
setIamPolicy; por ejemplo, las instancias de Compute Engine tienen el permisocompute.googleapis.com/instances.setIamPolicy. Para evitar que los usuarios modifiquen las políticas de permisos de estos recursos, agrega estos permisos a tu política de denegación.Para obtener una lista completa de los permisos denegables que terminan en
setIamPolicy, ve a Permisos compatibles con las políticas de denegación y buscasetIamPolicy.El permiso
iam.googleapis.com/roles.update, que permite a los usuarios modificar roles personalizados. Los usuarios con este permiso pueden agregar permisos a los roles personalizados, lo que les otorga esos permisos a ellos mismos o a otros usuarios.
Permisos para modificar las políticas de acceso unificado (UAP) y vincularlas a los recursos. Estos permisos son los siguientes:
- El permiso
iam.googleapis.com/accesspolicies.update, que permite a los usuarios actualizar las UAP existentes. - Los permisos finalizarán en
createPolicyBinding. Estos permisos existen para cada recurso al que puedes vincular UAP. Para los proyectos, las carpetas y las organizaciones, estos permisos son los siguientes:cloudresourcemanager.googleapis.com/projects.createPolicyBindingcloudresourcemanager.googleapis.com/folders.createPolicyBindingcloudresourcemanager.googleapis.com/organizations.createPolicyBinding
Como alternativa, puedes evitar que todos los usuarios vinculen UAP a recursos aplicando la restricción de la política de la organización
iam.managed.disableAccessPolicyBindingen tu organización. Sin embargo, esta política de la organización no impide que los usuarios modifiquen las UAP existentes que ya están vinculadas a recursos.- El permiso
Rechaza los permisos de cambio de acceso
Después de determinar qué permisos deseas denegar, crea una política de denegación para tu organización que deniegue estos permisos.
Console
En la consola de Google Cloud , ve a la pestaña Denegar en la página IAM.
Selecciona tu organización.
Haz clic en Crear política de denegación.
En la sección Nombre de la política, define el ID de la política haciendo una de las siguientes acciones:
- En el campo Nombre visible, ingresa un nombre visible para la política. Si completas este campo, se completará automáticamente el campo ID. Si quieres cambiar el ID de la política, actualiza el texto en el campo ID.
- En el campo ID, escribe un ID para la política.
En la sección Reglas de denegación, agrega una regla de denegación que bloquee los permisos de cambio de acceso:
En el campo Principales rechazados, agrega las principales a las que deseas denegar el acceso. Para denegar los permisos de cambio de acceso a todos los usuarios, usa el valor
principalSet://goog/public:all. Para obtener una lista completa de los valores que puedes usar, consulta Identificadores de principal para las políticas de denegación.En el campo Principales de excepción, agrega las principales de confianza a las que deseas otorgar acceso. Para obtener una lista completa de los valores que puedes usar, consulta Identificadores de principal para las políticas de denegación.
En la sección Permisos denegados, agrega los permisos que identificaste en Identifica los permisos que permiten a los usuarios otorgar acceso.
Opcional: Agrega una condición de denegación que especifique qué recursos se ven afectados por esta regla. Por ejemplo, puedes agregar una condición para asegurarte de que la política se aplique solo a los recursos con el valor de etiqueta
prod. Para obtener más información sobre las condiciones de denegación, consulta Condiciones en las políticas de denegación.
Haz clic en Crear.
gcloud
El comando
gcloud iam policies create
crea una política de denegación para un recurso.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
POLICY_ID: Es un identificador para la política de denegación.-
ORG_ID: Es el ID numérico de la organización en la que deseas crear la política de denegación. -
POLICY_FILE: Es un archivo que contiene la política de denegación que quieres establecer. Usa el siguiente formato para la política de denegación:{ "displayName": "POLICY_NAME", "rules": [ { "denyRule": { "deniedPrincipals": [ DENIED_PRINCIPALS ], "exceptionPrincipals": [ EXCEPTION_PRINCIPALS ], "deniedPermissions": [ ACCESS_CHANGE_PERMISSIONS ], DENIAL_CONDITION } } ] }
Reemplaza los siguientes valores:
POLICY_NAME: Es el nombre visible de la política de denegación.-
DENIED_PRINCIPALS: Son las principales a las que se les denegará el acceso. Para denegar los permisos de cambio de acceso a todos los usuarios, usa el valor"principalSet://goog/public:all". Para obtener una lista completa de los valores que puedes usar, consulta Identificadores de principal para políticas de denegación. -
EXCEPTION_PRINCIPALS: Son las principales de confianza a las que deseas permitir que otorguen acceso. Para obtener una lista completa de los valores que puedes usar, consulta Identificadores de principal para las políticas de denegación. -
ACCESS_CHANGE_PERMISSIONS: Son los permisos que identificaste en Identifica los permisos que permiten a los usuarios otorgar acceso. -
DENIAL_CONDITION: Opcional Una condición de denegación que especifica qué recursos se ven afectados por esta regla. Por ejemplo, puedes agregar una condición para asegurarte de que la regla se aplique solo a los recursos con el valor de etiquetaprod. Para obtener más información sobre las condiciones de denegación, consulta Condiciones en las políticas de denegación.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud iam policies create POLICY_ID \ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID \ --kind=denypolicies \ --policy-file=POLICY_FILE
Windows (PowerShell)
gcloud iam policies create POLICY_ID ` --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ` --kind=denypolicies ` --policy-file=POLICY_FILE
Windows (cmd.exe)
gcloud iam policies create POLICY_ID ^ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ^ --kind=denypolicies ^ --policy-file=POLICY_FILE
Si se ejecuta de forma correcta, este comando no devuelve ningún resultado. Para imprimir una respuesta detallada,
usa la marca --format=json.
REST
El
método
policies.createPolicy
crea una política de denegación para un recurso.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
-
ORG_ID: Es el ID numérico de la organización en la que deseas crear la política de denegación. POLICY_ID: Es un identificador para la política de denegación.POLICY_NAME: Es el nombre visible de la política de denegación.-
DENIED_PRINCIPALS: Son las principales a las que se les denegará el acceso. Para denegar los permisos de cambio de acceso a todos los usuarios, usa el valor"principalSet://goog/public:all". Para obtener una lista completa de los valores que puedes usar, consulta Identificadores de principal para las políticas de denegación. -
EXCEPTION_PRINCIPALS: Son las principales de confianza a las que deseas permitir que otorguen acceso. Para obtener una lista completa de los valores que puedes usar, consulta Identificadores de principales para las políticas de denegación. -
ACCESS_CHANGE_PERMISSIONS: Son los permisos que identificaste en Identifica los permisos que permiten a los usuarios otorgar acceso. -
DENIAL_CONDITION: Opcional Es una condición de denegación que especifica qué recursos se ven afectados por esta regla. Por ejemplo, puedes agregar una condición para asegurarte de que la regla se aplique solo a los recursos con el valor de etiquetaprod. Para obtener más información sobre las condiciones de denegación, consulta Condiciones en las políticas de denegación.
Método HTTP y URL:
POST https://iam.googleapis.com/v2/policies/cloudresourcemanager.googleapis.com%2Forganizations%2FORG_ID/denypolicies?policyId=POLICY_ID
Cuerpo JSON de la solicitud:
{
"displayName": "POLICY_NAME",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
DENIED_PRINCIPALS
],
"exceptionPrincipals": [
EXCEPTION_PRINCIPALS
],
"deniedPermissions": [
ACCESS_CHANGE_PERMISSIONS
],
DENIAL_CONDITION
}
}
]
}
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting/operations/89cb3e508bf1ff01",
"metadata": {
"@type": "type.googleapis.com/google.iam.v2.PolicyOperationMetadata",
"createTime": "2026-10-31T19:06:12.455151Z"
},
"response": {
"@type": "type.googleapis.com/google.iam.v2.Policy",
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting",
"uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
"kind": "DenyPolicy",
"displayName": "Deny access change permissions.",
"etag": "MTc3NDU4KjM4OZ0MzU5MjQ5OTI=",
"createTime": "2026-10-31T19:06:12.455151Z",
"updateTime": "2026-10-31T22:26:21.968687Z",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principalSet://goog/public:all"
],
"exceptionPrincipals": [
"principalSet://cloudresourcemanager.googleapis.com/organizations/1234567890123/type/ServiceAgent",
"principalSet://goog/group/iam-admins@example.com"
],
"deniedPermissions": [
"cloudresourcemanager.googleapis.com/projects.setIamPolicy",
"cloudresourcemanager.googleapis.com/folders.setIamPolicy",
"cloudresourcemanager.googleapis.com/organizations.setIamPolicy",
"iam.googleapis.com/accesspolicies.update",
"cloudresourcemanager.googleapis.com/projects.createPolicyBinding",
"cloudresourcemanager.googleapis.com/folders.createPolicyBinding",
"cloudresourcemanager.googleapis.com/organizations.createPolicyBinding"
],
"denialCondition": {
"title": "Only for prod resources",
"expression": "resource.matchTag('12345678/env', 'prod')"
}
}
}
]
}
}
La respuesta identifica una operación de larga duración. Puedes supervisar el estado de la operación de larga duración para saber cuándo se completó. Para obtener más información, consulta Revisa el estado de una operación de larga duración.
¿Qué sigue?
- Descubre cómo solucionar problemas de acceso con políticas de denegación.
- Obtén más información sobre cómo denegar el acceso a las principales.