Cómo impedir que los usuarios otorguen acceso

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.

    Habilitar la API

  • 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.

    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.setIamPolicy
    • cloudresourcemanager.googleapis.com/folders.setIamPolicy
    • cloudresourcemanager.googleapis.com/organizations.setIamPolicy

    Otros recursos también tienen permisos setIamPolicy; por ejemplo, las instancias de Compute Engine tienen el permiso compute.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 busca setIamPolicy.

  • 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.createPolicyBinding
      • cloudresourcemanager.googleapis.com/folders.createPolicyBinding
      • cloudresourcemanager.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.disableAccessPolicyBinding en 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.

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

  1. En la consola de Google Cloud , ve a la pestaña Denegar en la página IAM.

    Ir a IAM

  2. Selecciona tu organización.

  3. Haz clic en Crear política de denegación.

  4. 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.
  5. En la sección Reglas de denegación, agrega una regla de denegación que bloquee los permisos de cambio de acceso:

    1. 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.

    2. 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.

    3. En la sección Permisos denegados, agrega los permisos que identificaste en Identifica los permisos que permiten a los usuarios otorgar acceso.

    4. 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.

  6. 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 etiqueta prod. 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 etiqueta prod. 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?