Cómo quitar las políticas de Límite de Acceso de las Entidades

Las políticas de límite de acceso de las entidades (PAB) te permiten establecer límites a los recursos a los que puede acceder un conjunto de entidades. Si ya no quieres que se aplique una Política de Límite de Acceso de las Entidades a un conjunto de principales, puedes borrar la vinculación de la política que la vincula al conjunto de principales. Si quieres quitar una Política de Límite de Acceso de las Principales de todos los conjuntos de principales a los que está vinculada, puedes borrar la política.

Quitar una Política de Límite de Acceso de las Entidades de un conjunto de principales tiene uno de los siguientes efectos:

  • Si las entidades del conjunto de entidades no están sujetas a ninguna otra política de límite de acceso de las entidades, podrán acceder a todos los recursosGoogle Cloud .
  • Si las entidades del conjunto de entidades están sujetas a otras políticas de límite de acceso de las entidades, solo podrán acceder a los recursos de esas políticas.

Antes de comenzar

  • Configura la autenticación.

    Selecciona la pestaña según cómo planeas usar las muestras de esta página:

    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 .

  • Lee la descripción general de las Políticas de Límite de Acceso de las Entidades.

Roles necesarios para borrar Políticas de Límite de Acceso de las Entidades

Para obtener el permiso que necesitas para borrar las políticas de Límite de Acceso de las Entidades, pídele a tu administrador que te otorgue el rol de IAM de Administrador de límites de acceso principal (roles/iam.principalAccessBoundaryAdmin) 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 iam.principalaccessboundarypolicies.delete permiso, que se requiere para borrar las políticas de límite de acceso de las entidades.

También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.

Roles necesarios para borrar vinculaciones de Políticas de Límite de Acceso de las Principales

Los permisos que necesitas para borrar vinculaciones de Políticas de Límite de Acceso de las Principales dependen del conjunto de principales vinculado a la política.

Para obtener los permisos que necesitas para borrar vinculaciones de políticas para las políticas de límite de acceso de las principales, pídele a tu administrador que te otorgue los siguientes roles de IAM:

  • Usuario del límite de acceso de la entidad (roles/iam.principalAccessBoundaryUser) en tu organización
  • Borra las vinculaciones de políticas de las Políticas de Límite de Acceso de las Entidades vinculadas a los grupos de identidades de personal: Administrador de grupos de trabajadores de IAM (roles/iam.workforcePoolAdmin) en el grupo de identidades de personal de destino
  • Borra las vinculaciones de políticas para las Políticas de Límite de Acceso de las Entidades vinculadas a los grupos de identidades para cargas de trabajo: Administrador de grupos de identidades para cargas de trabajo de IAM (roles/iam.workloadIdentityPoolAdmin) en el proyecto al que pertenece el grupo de identidades para cargas de trabajo de destino
  • Obtén el estado de una operación de larga duración para borrar una vinculación que hace referencia a un grupo de identidades para cargas de trabajo: Visualizador de operaciones de IAM (roles/iam.operationViewer) en el proyecto al que pertenece el grupo de identidades para cargas de trabajo de destino
  • Borrar vinculaciones de políticas para las Políticas de Límite de Acceso de las Entidades vinculadas a un dominio de Google Workspace: Administrador de IAM de grupos de espacios de trabajo (roles/iam.workspacePoolAdmin) en la organización
  • Borra las vinculaciones de políticas para las políticas de límite de acceso de las entidades vinculadas al conjunto de entidades de un proyecto: Administrador de IAM del proyecto (roles/resourcemanager.projectIamAdmin) en el proyecto
  • Obtención del estado de una operación de larga duración para borrar una vinculación que hace referencia al conjunto de principales de un proyecto: Visualizador de operaciones de IAM (roles/iam.operationViewer) en el proyecto
  • Borra las vinculaciones de políticas para las políticas de límite de acceso de las entidades vinculadas al conjunto de entidades de una carpeta: Administrador de IAM de la carpeta (roles/resourcemanager.folderIamAdmin) en la carpeta
  • Borra las vinculaciones de políticas para las políticas de límite de acceso de las entidades vinculadas al conjunto de entidades de una organización: Administrador de la organización (roles/resourcemanager.organizationAdmin) en la organización.

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para borrar las vinculaciones de políticas de las Políticas de Límite de Acceso de las Entidades. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para borrar las vinculaciones de Políticas de Límite de Acceso de las Principales:

  • iam.principalaccessboundarypolicies.unbind en la organización
  • Borra las vinculaciones de políticas para las Políticas de Límite de Acceso de las Entidades vinculadas a los grupos de identidades de personal: iam.workforcePools.deletePolicyBinding en el grupo de identidades de personal de destino
  • Borra las vinculaciones de políticas para las políticas de límite de acceso de las entidades vinculadas a los grupos de identidades para cargas de trabajo: iam.workloadIdentityPools.deletePolicyBinding en el proyecto propietario del grupo de identidades para cargas de trabajo de destino
  • Obtén el estado de una operación de larga duración para borrar una vinculación que hace referencia a un grupo de identidades para cargas de trabajo: iam.operations.get en el proyecto al que pertenece el grupo de identidades para cargas de trabajo de destino
  • Borra las vinculaciones de políticas para las Políticas de Límite de Acceso de las Entidades vinculadas a un dominio de Google Workspace: iam.workspacePools.deletePolicyBinding en la organización
  • Borra las vinculaciones de políticas para las Políticas de Límite de Acceso de las Entidades vinculadas al conjunto de principales de un proyecto: resourcemanager.projects.deletePolicyBinding en el proyecto
  • Obtención del estado de una operación de larga duración para borrar una vinculación que hace referencia al conjunto de principales de un proyecto: iam.operations.get en el proyecto
  • Borra las vinculaciones de políticas para las Políticas de Límite de Acceso de las Entidades vinculadas al conjunto de principales de una carpeta: resourcemanager.folders.deletePolicyBinding en la carpeta
  • Borra las vinculaciones de políticas para las Políticas de Límite de Acceso de las Entidades vinculadas al conjunto de entidades de una organización: resourcemanager.organizations.deletePolicyBinding en la organización

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Prepárate para quitar una Política de Límite de Acceso de las Entidades

Antes de quitar una política de límite de acceso de las entidades, decide cuál de los siguientes objetivos quieres lograr:

  • Hacer que las principales de un conjunto de principales sean aptas para acceder a todos los recursos
  • Reduce la cantidad de recursos a los que pueden acceder las principales de un conjunto de principales

En las siguientes secciones, se describen los pasos que debes seguir para alcanzar cada uno de estos objetivos.

Cómo hacer que las principales sean aptas para acceder a todos los recursos

Si quieres que las principales de un conjunto de principales sean aptas para acceder a todos los recursos, haz lo siguiente:

  1. Identifica todas las políticas de límite de acceso de las entidades vinculadas al conjunto de entidades.
  2. Quita todas las Políticas de Límite de Acceso de las Entidades vinculadas al conjunto de principales borrando las vinculaciones de políticas pertinentes.

Si una entidad no está sujeta a ninguna Política de Límite de Acceso de las Entidades, entonces es apta para acceder a todos los recursos de Google Cloud .

Ser apto para acceder a un recurso no significa necesariamente que un usuario pueda acceder a él. Para obtener más información, consulta Evaluación de políticas.

Reduce los recursos a los que pueden acceder las principales

Si las entidades de un conjunto de entidades están sujetas a varias políticas de límite de acceso de las entidades, puedes reducir la cantidad de recursos a los que pueden acceder quitando una o más de las políticas de límite de acceso de las entidades a las que están sujetas. Sin embargo, no quites, en ningún momento, todas las políticas de Límite de Acceso de las Entidades a las que están sujetas las entidades, ya que, si lo haces, estas podrán acceder a todos los recursos de Google Cloud .

Para quitar una política de Límite de Acceso de las Entidades y, al mismo tiempo, garantizar que las entidades de un conjunto de entidades siempre estén sujetas a, al menos, una política de Límite de Acceso de las Entidades, sigue estos pasos:

  1. Identifica todas las políticas de límite de acceso de las entidades vinculadas al conjunto de entidades.
  2. Identifica las Políticas de Límite de Acceso de las Entidades que contienen solo los recursos a los que quieres que puedan acceder las entidades del conjunto de entidades. Estas son las políticas que no quitarás del conjunto de principales.

    Si no tienes ninguna de estas políticas, crea una nueva Política de Límite de Acceso de las Entidades solo con los recursos a los que quieres que puedan acceder las entidades. Luego, adjunta la política al conjunto de principales.

  3. Identifica las Políticas de Límite de Acceso de las Entidades que contienen recursos a los que no quieres que accedan las entidades del conjunto de entidades. Luego, quita esas Políticas de Límite de Acceso de las Entidades borrando la vinculación de la política pertinente.

    Si deseas reducir el acceso de principales específicas, agrega una condición a la vinculación de la política en lugar de borrarla.

Si quieres reducir la cantidad de recursos a los que puede acceder una principal, pero no quieres quitar ninguna Política de Límite de Acceso de las Entidades, puedes modificar las Políticas de Límite de Acceso de las Entidades a las que está sujeta la principal. Para obtener información sobre cómo modificar las Políticas de Límite de Acceso de las Entidades, consulta Edita las Políticas de Límite de Acceso de las Entidades.

Prueba la eliminación de una política o vinculación de límite de acceso de las entidades

Antes de confirmar la eliminación de una política o vinculación de límite de acceso de las principales, te recomendamos que pruebes cómo el cambio podría afectar el acceso de tus principales. Puedes usar Policy Simulator para simular una eliminación y ayudarte a comprender el impacto potencial de esta.

Para probar una eliminación, consulta los siguientes procedimientos en la documentación de Policy Intelligence:

Para obtener más información sobre cómo probar las políticas de límite de acceso de las entidades con Policy Simulator, consulta Policy Simulator para las políticas de límite de acceso de las entidades.

Quita una Política de Límite de Acceso de las Entidades de un conjunto de principales

Antes de quitar una Política de Límite de Acceso de las Entidades de un conjunto de principales, primero prepárate para quitar la política. Luego, quita la política borrando la vinculación de la política que la vincula al conjunto de principales.

Puedes borrar una vinculación de políticas con la consola de Google Cloud , gcloud CLI o la API de REST de IAM.

Console

  1. En la consola de Google Cloud , ve a la página Políticas de límite de acceso de las principales.

    Ir a Políticas de Límite de Acceso de las Principales

  2. Selecciona la organización propietaria de la Política de Límite de Acceso de las Entidades cuya vinculación quieres borrar.

  3. Haz clic en el ID de la Política de Límite de Acceso de las Entidades cuyas vinculaciones deseas borrar.

  4. Haz clic en la pestaña Vinculaciones.

  5. Busca el ID de la vinculación que deseas borrar. En la fila de esa vinculación, haz clic en Acciones y, luego, en Borrar vinculación.

  6. En el diálogo de confirmación, haz clic en Borrar.

gcloud

El comando gcloud iam policy-bindings delete borra una vinculación de políticas.

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • BINDING_ID: Es el ID de la vinculación de políticas que deseas borrar, por ejemplo, example-binding.
  • RESOURCE_TYPE: Es el tipo de recurso de Resource Manager (proyecto, carpeta u organización) del que es un elemento secundario la vinculación de políticas. Usa el valor project, folder o organization.

    El tipo de recurso depende del principal establecido en la vinculación de políticas. Para ver qué tipo de recurso usar, consulta Tipos de principales compatibles.

  • RESOURCE_ID: El ID del proyecto, la carpeta o la organización de la que es elemento secundario la vinculación de políticas. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam policy-bindings delete BINDING_ID \
    --RESOURCE_TYPE=RESOURCE_ID --location=global

Windows (PowerShell)

gcloud iam policy-bindings delete BINDING_ID `
    --RESOURCE_TYPE=RESOURCE_ID --location=global

Windows (cmd.exe)

gcloud iam policy-bindings delete BINDING_ID ^
    --RESOURCE_TYPE=RESOURCE_ID --location=global

La respuesta contiene una operación de larga duración que representa tu solicitud. Para aprender a obtener el estado de una operación de larga duración, consulta Verifica el estado de una operación de larga duración en esta página.

Delete request issued for: [example-binding]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done.
Deleted policyBinding [example-binding].

REST

El método policyBindings.delete borra una vinculación de políticas.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • RESOURCE_TYPE: Es el tipo de recurso de Resource Manager (proyecto, carpeta u organización) del que es un elemento secundario la vinculación de políticas. Usa el valor projects, folders o organizations.

    El tipo de recurso depende del principal establecido en la vinculación de políticas. Para ver qué tipo de recurso usar, consulta Tipos de principales compatibles.

  • RESOURCE_ID: El ID del proyecto, la carpeta o la organización de la que es elemento secundario la vinculación de políticas. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • BINDING_ID: Es el ID de la vinculación de políticas que deseas borrar, por ejemplo, example-binding.

Método HTTP y URL:

DELETE https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una operación de larga duración que representa tu solicitud. Para aprender a obtener el estado de una operación de larga duración, consulta Verifica el estado de una operación de larga duración en esta página.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-05-10T20:33:11.165728913Z",
    "target": "organizations/123456789012/locations/global/policyBindings/example-binding",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Borra una Política de Límite de Acceso de las Entidades

Antes de borrar una de estas políticas, te recomendamos que identifiques y borres todas las vinculaciones de políticas de límite de acceso de las principales que hagan referencia a la política de límite de acceso de las principales.

Si borras una Política de Límite de Acceso de las Entidades con vinculaciones de políticas existentes, esas vinculaciones se borrarán con el tiempo. Sin embargo, hasta que se borren, las vinculaciones de políticas seguirán contando para el límite de 10 vinculaciones que pueden hacer referencia a un solo conjunto de principales.

Puedes borrar una política de límite de acceso de las principales con la consola de Google Cloud , gcloud CLI o la API de REST de IAM.

Console

  1. En la consola de Google Cloud , ve a la página Políticas de límite de acceso de las principales.

    Ir a Políticas de Límite de Acceso de las Principales

  2. Selecciona la organización propietaria de la Política de Límite de Acceso de las Entidades que quieres borrar.

  3. Busca el ID de la política que quieres borrar. En la fila de esa política, haz clic en Acciones y, luego, en Borrar política.

  4. En el diálogo de confirmación, confirma que deseas borrar la política:

    • Para borrar la política solo si no tiene vinculaciones asociadas, haz clic en Borrar.
    • Para borrar la política y todas las vinculaciones asociadas, selecciona la casilla de verificación Forzar la eliminación de la política y, luego, haz clic en Borrar.

gcloud

El comando gcloud iam gcloud iam principal-access-boundary-policies delete borra una Política de Límite de Acceso de las Entidades y todas las vinculaciones asociadas.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PAB_POLICY_ID: Es el ID de la Política de Límite de Acceso de las Entidades que deseas borrar, por ejemplo, example-policy.
  • ORG_ID: Es el ID de la organización propietaria de la Política de Límite de Acceso de las Entidades. Los IDs de organización son numéricos, como 123456789012.
  • FORCE_FLAG: Opcional Para forzar que el comando borre una política, incluso si se hace referencia a ella en vinculaciones de políticas existentes, usa la marca --force. Si no se establece esta marca y se hace referencia a la política en vinculaciones de políticas existentes, el comando falla.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID \
    --organization=ORG_ID --location=global FORCE_FLAG

Windows (PowerShell)

gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID `
    --organization=ORG_ID --location=global FORCE_FLAG

Windows (cmd.exe)

gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID ^
    --organization=ORG_ID --location=global FORCE_FLAG

La respuesta contiene una operación de larga duración que representa tu solicitud. Para aprender a obtener el estado de una operación de larga duración, consulta Verifica el estado de una operación de larga duración en esta página.

Delete request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done.
Deleted principalAccessBoundaryPolicy [example-policy].

REST

El método principalAccessBoundaryPolicies.delete borra una Política de Límite de Acceso de las Entidades y todas las vinculaciones asociadas.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • ORG_ID: Es el ID de la organización propietaria de la Política de Límite de Acceso de las Entidades. Los IDs de organización son numéricos, como 123456789012.
  • PAB_POLICY_ID: Es el ID de la Política de Límite de Acceso de las Entidades que deseas borrar, por ejemplo, example-policy.
  • FORCE_DELETE: Opcional Para forzar la solicitud de borrar la política, incluso si se hace referencia a ella en vinculaciones de políticas existentes, agrega el parámetro de consulta force=true. Si no se establece este parámetro de consulta y se hace referencia a la política en vinculaciones de políticas existentes, la solicitud falla.

Método HTTP y URL:

DELETE https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID?FORCE_DELETE

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una operación de larga duración que representa tu solicitud. Para aprender a obtener el estado de una operación de larga duración, consulta Verifica el estado de una operación de larga duración en esta página.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-05-10T20:33:11.165728913Z",
    "target": "organizations/123456789012/locations/global/policyBindings/example-policy",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Revisa el estado de una operación de larga duración

Cuando usas la API de REST o las bibliotecas cliente, cualquier método que cambie una política o vinculación devuelve una operación de larga duración (LRO). La operación de larga duración realiza un seguimiento del estado de la solicitud y también indica si se completó el cambio en la política o la vinculación.

REST

El método operations.get muestra el estado de una operación de larga duración.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • OPERATION_NAME: Es el nombre completo de la operación. Recibirás este nombre en la respuesta a tu solicitud original.

    El nombre de la operación tiene el siguiente formato:

    RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
        

Método HTTP y URL:

GET https://iam.googleapis.com/v3/OPERATION_NAME

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": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-11-28T00:05:12.006289686Z",
    "endTime": "2024-11-28T00:05:12.192141801Z",
    "target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": true,
  "response": {
    POLICY
  }
}

Si el campo done de la operación no está presente, sigue supervisando su estado obteniendo la operación de forma repetida. Usa la retirada exponencial truncada para introducir un retraso entre cada solicitud. Cuando el campo done se establece como true, la operación está completa, y puedes dejar de obtener la operación.

¿Qué sigue?