Soluciona problemas de permisos de IAM

El solucionador de problemas de políticas te ayuda a comprender si un principal puede acceder a un recurso. Con una entidad, un recurso y un permiso, el Solucionador de problemas de políticas examina las políticas de permiso, de denegación y de límite de acceso de la entidad (PAB) que afectan el acceso de la entidad. Luego, te indica si, en función de esas políticas, el principal puede usar el permiso especificado para acceder al recurso. También, se enumeran las políticas relevantes y se explica cómo afectan el acceso de la principal.

Puedes acceder al Solucionador de problemas de políticas con la consola deGoogle Cloud , Google Cloud CLI o la API de REST. Para consultas básicas, el uso de la consola de Google Cloud suele ser más rápido. Para situaciones más complejas, considera usar gcloud CLI o la API de REST.

Antes de comenzar

  • Habilita la API del Solucionador de problemas de políticas 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

Permisos necesarios

Para solucionar por completo los problemas de acceso de tus principales, necesitas los siguientes permisos.

Permisos para solucionar problemas de acceso de principales individuales

El Solucionador de problemas de políticas analiza el acceso de una entidad a un recurso en función de las políticas de permiso, de denegación, las políticas de límite de acceso de las entidades y los roles que tienes permiso para ver. Si no tienes permiso para ver la política que se aplica a un recurso o si no tienes permiso para ver un rol personalizado, es posible que no puedas saber si una principal tiene acceso.

Permisos para solucionar problemas de las políticas de permiso y denegación

Para solucionar problemas de las políticas de permisos y denegación, necesitas permisos en la organización que contiene el recurso del que quieres solucionar problemas. Estos permisos te permiten ver las políticas de permiso y denegación que controlan el acceso al recurso.

Para obtener los permisos que necesitas para solucionar problemas de acceso de una principal, pídele a tu administrador que te otorgue los siguientes roles de IAM en la organización que contiene el recurso para el que deseas solucionar problemas de acceso:

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

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Si no tienes permiso para ver las políticas de permisos y denegación de un recurso, los resultados de acceso de esas políticas de permisos y denegación son Unknown.

Permisos para solucionar problemas de las políticas de Límite de Acceso de las Entidades

Para solucionar problemas de las Políticas de Límite de Acceso de las Entidades, necesitas permisos en la organización cuyo conjunto de entidades incluye la entidad. La forma en que identificas esta organización depende del tipo de principal:

  • Cuentas de Google y Grupos de Google: La organización asociada con el dominio de Google Workspace que incluye la entidad principal
  • Identidades federadas (identidades en grupos de identidades de personal o grupos de identidades para cargas de trabajo): Es la organización que contiene el grupo de identidades que incluye a la principal.
  • Cuentas de servicio: Es la organización que contiene el proyecto en el que se creó la cuenta de servicio.
  • Identidades de agentes: la organización que contiene el proyecto en el que se creó el agente

Estos permisos te permiten ver las Políticas de Límite de Acceso de las Entidades que controlan a qué puede acceder la entidad.

Para obtener los permisos que necesitas para solucionar problemas de acceso de una principal, pídele a tu administrador que te otorgue los siguientes roles de IAM en la organización correspondiente:

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

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Si no tienes permiso para ver las políticas de Límite de Acceso de las Entidades que se aplican a una principal, los resultados de acceso para las políticas de Límite de Acceso de las Entidades son Unknown.

Permisos para solucionar problemas de acceso de los miembros del grupo

Si tus políticas de permiso y denegación incluyen grupos, necesitas el permiso groups.read de la API de Admin de Google Workspace para solucionar problemas de acceso de miembros individuales del grupo. Los administradores de grupo y los administradores avanzados tienen este permiso automáticamente. Para otorgar a un usuario que no es administrador avanzado ni administrador de grupo este permiso, crea un rol de administrador de Google Workspace personalizado que contenga el privilegio groups.read (ubicado en Privilegios de la API de administrador) y otórgaselo al usuario.

Si no tienes estos permisos, las vinculaciones de roles y las reglas de denegación que contienen grupos o dominios tienen un resultado de acceso Desconocido, a menos que la vinculación de roles o la regla de denegación también incluyan de forma explícita la principal.

Permisos para solucionar problemas de acceso de los miembros del dominio

Si tus políticas de permiso y denegación incluyen una cuenta de Google Workspace o un dominio de Cloud Identity, debes ser administrador de dominio para solucionar problemas de acceso de miembros individuales del dominio.

Si no tienes estos permisos, las vinculaciones de roles y las reglas de denegación que contienen grupos o dominios tienen un resultado de acceso Desconocido, a menos que la vinculación de roles o la regla de denegación también incluyan de forma explícita la principal.

Soluciona problemas de acceso

Para solucionar problemas de acceso, necesitas la principal, el recurso y el permiso que quieres verificar. Esta información se puede proporcionar con un ID de error:

  • ID de error: Es un identificador único para un mensaje de error de permiso. El ID de error proporciona contexto para el error, incluidos la principal, el recurso, el permiso y las condiciones de IAM admitidas. Un ID de error relacionado con una identidad de agente proporciona contexto para la identidad del agente y sus reclamaciones, como la plataforma y el contenedor.

    Las condiciones de IAM admitidas incluyen principal.type y principal.subject.

Si no tienes un ID de error, puedes solucionar los problemas de acceso con la siguiente información:

  • Principal: Es la identidad que se debe verificar. Puedes ingresar una de las siguientes opciones:

    • Una dirección de correo electrónico: Debe hacer referencia a un usuario, una sola cuenta de servicio o un conjunto de principales de cuentas de servicio.

    • Un identificador de identidad del agente: Debe seguir este formato: TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH.

      Ejemplo: agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent

      El Solucionador de problemas de políticas extrae los atributos del contenedor de recursos y de la plataforma de la cadena de asunto del agente con el patrón estándar resources/{platform}/projects/{project_number}/.... Si un agente usa un formato de asunto no estándar, el Solucionador de problemas de políticas no puede derivar sus atributos, y las vinculaciones de conjuntos de principales basadas en atributos se evalúan como Unknown.

      Si una principal no tiene vinculaciones de permisos que otorguen acceso, el Solucionador de problemas de políticas devuelve un estado de acceso de UNKNOWN_INFO en lugar de NOT_GRANTED.

      Los identificadores usan lo siguiente:

      • TRUST_DOMAIN: Es el dominio de confianza de tu organización (por ejemplo, agents.global.org-123456789012.system.id.goog).

      • SERVICE: Es el nombre corto del servicio de Google Cloud(por ejemplo, aiplatform o discoveryengine).

      • RESOURCE_PATH: Es la ruta de acceso completa al recurso que aloja el agente.

    No se admiten otros tipos de principales, incluidos los grupos, los dominios, las identidades de personal y las Workload Identity.

  • Recurso: Es el nombre completo del recurso para el que deseas solucionar problemas de acceso. Por ejemplo, para solucionar problemas de acceso al proyecto my-project, ingresa //cloudresourcemanager.googleapis.com/projects/my-project. Para otros tipos de recursos, consulta los ejemplos de nombres completos de recursos.

  • Permiso: El permiso que se debe verificar. Si usas la consola deGoogle Cloud , se muestra una lista de sugerencias a medida que escribes.

    Para solucionar problemas con un permiso, este debe ser aplicable al recurso de la solicitud. En otras palabras, debe ser posible usar ese permiso para acceder al recurso de alguna manera. Si el permiso no es aplicable al recurso, la solicitud fallará. Por ejemplo, si intentas solucionar problemas del permiso compute.instances.get para un clúster de Google Kubernetes Engine, la solicitud falla porque el permiso compute.instance.get no se puede usar para acceder a los clústeres de Google Kubernetes Engine.

    Para obtener una lista completa de los permisos, consulta la referencia de permisos.

Console

Para solucionar problemas de acceso, sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página Solucionador de problemas de políticas.

    Ir al solucionador de problemas de políticas

  2. Si tienes un ID de error, selecciona ID de error y, luego, ingrésalo.

  3. Si no tienes un ID de error, selecciona Manual.

    1. Ingresa la dirección de correo electrónico de la principal o el identificador de la identidad del agente cuyo acceso quieres verificar.

    2. Ingresa el nombre completo del recurso que deseas verificar.

      Si no conoces el nombre completo del recurso, realiza una de las siguientes acciones:

      • Si estás solucionando problemas de acceso para un proyecto, una carpeta o una organización, comienza a escribir para ver las opciones de autocompletado.
      • Si estás solucionando problemas de acceso para otro tipo de recurso, haz clic en Explorar para abrir el diálogo de búsqueda de recursos y, luego, busca el recurso:

        1. En el cuadro Seleccionar alcance, selecciona un proyecto, una carpeta o una organización en la que quieras buscar.
        2. En el cuadro Tipo de recurso, selecciona los tipos de recursos que deseas buscar.
        3. En el cuadro Buscar recursos, ingresa una parte del nombre del recurso.
        4. En la sección de resultados, selecciona el recurso que quieres verificar.
        5. Haz clic en Seleccionar para elegir el recurso y cerrar el diálogo.
    3. Ingresa el permiso que se debe verificar.

      Si no conoces el nombre completo del permiso, comienza a escribir para ver las opciones de autocompletado.

    4. Opcional: Para comprobar varios recursos y permisos, selecciona Agregar otro par y repite el paso anterior.

  4. Haz clic en Verificar acceso.

gcloud

Para averiguar por qué una principal tiene o no un permiso de IAM, usa el comando gcloud beta policy-troubleshoot iam.

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

  • VERSION: Opcional Es la versión del comando que se usará. Para solucionar problemas de acceso basados solo en políticas de permiso y denegación, no especifiques una versión. Para solucionar problemas de acceso en función de las políticas de permiso, denegación y Política de Límite de Acceso de las Entidades, usa la versión beta.
  • EMAIL: La dirección de correo electrónico del principal al que pertenecen los permisos con problemas que deseas solucionar. En el caso de una identidad de agente, debes proporcionar el identificador de la principal.
  • RESOURCE: El recurso en el que se otorga el permiso.
  • PERMISSION: El permiso con los problemas que deseas solucionar.

Ejecuta el comando gcloud beta policy-troubleshoot iam:

Linux, macOS o Cloud Shell

gcloud VERSION policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL \
    --permission=PERMISSION

Windows (PowerShell)

gcloud VERSION policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL `
    --permission=PERMISSION

Windows (cmd.exe)

gcloud VERSION policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL ^
    --permission=PERMISSION

Deberías recibir una respuesta similar a la que figura a continuación:

Respuesta

{
  "accessTuple": {
    "conditionContext": {
      "destination": {},
      "effectiveTags": [
        {
          "namespacedTagKey": "project-1/tag-key-1",
          "namespacedTagValue": "project-1/tag-key-1/tag-value-1",
          "tagKey": "tagKeys/123456789012",
          "tagKeyParentName": "projects/123456789012",
          "tagValue": "tagValues/123456789012"
        },
      ],
      "request": {},
      "resource": {}
    },
    "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/project-1",
    "permission": "bigtable.instances.create",
    "permissionFqdn": "bigtable.googleapis.com/instances.create",
    "principal": "service-account-3@project-1."
  },
  "allowPolicyExplanation": {
    "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
    "explainedPolicies": [
      {
        "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
        "bindingExplanations": [
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "condition": {
              "expression": "resource.type == \"cloudresourcemanager.googleapis.com/Project\"",
              "title": "Resource-based condition"
            },
            "conditionExplanation": {
              "evaluationStates": [
                {
                  "end": 62,
                  "value": false
                }
              ],
              "value": false
            },
            "memberships": {
              "serviceAccount:service-account-1@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/bigquery.admin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "condition": {
              "expression": "resource.matchTag(\"project-1/tag-key-1\", \"tag-value-1\")",
              "title": "Tag-based condition"
            },
            "conditionExplanation": {
              "evaluationStates": [
                {
                  "end": 73,
                  "value": true
                }
              ],
              "value": true
            },
            "memberships": {
              "serviceAccount:service-account-2@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/bigquery.admin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "user:user-2@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/compute.admin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "user:user-1@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              },
              "user:user-3@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/iam.serviceAccountTokenCreator",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "user:user-2@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              },
              "user:user-1@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_HIGH",
            "role": "roles/owner",
            "rolePermission": "ROLE_PERMISSION_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_HIGH"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "serviceAccount:service-account-3@project-1.": {
                "membership": "MEMBERSHIP_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              },
              "serviceAccount:service-account-4@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/resourcemanager.projectIamAdmin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "serviceAccount:service-account-4@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/resourcemanager.tagViewer",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          }
        ],
        "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/project-1",
        "policy": {
          "bindings": [
            {
              "condition": {
                "expression": "resource.type == \"cloudresourcemanager.googleapis.com/Project\"",
                "title": "Resource-based condition"
              },
              "members": [
                "serviceAccount:service-account-1@project-1."
              ],
              "role": "roles/bigquery.admin"
            },
            {
              "condition": {
                "expression": "resource.matchTag(\"project-1/tag-key-1\", \"tag-value-1\")",
                "title": "Tag-based condition"
              },
              "members": [
                "serviceAccount:service-account-2@project-1."
              ],
              "role": "roles/bigquery.admin"
            },
            {
              "members": [
                "user:user-2@example.com"
              ],
              "role": "roles/compute.admin"
            },
            {
              "members": [
                "user:user-1@example.com",
                "user:user-3@example.com"
              ],
              "role": "roles/iam.serviceAccountTokenCreator"
            },
            {
              "members": [
                "user:user-2@example.com",
                "user:user-1@example.com"
              ],
              "role": "roles/owner"
            },
            {
              "members": [
                "serviceAccount:service-account-3@project-1.",
                "serviceAccount:service-account-4@project-1."
              ],
              "role": "roles/resourcemanager.projectIamAdmin"
            },
            {
              "members": [
                "serviceAccount:service-account-4@project-1."
              ],
              "role": "roles/resourcemanager.tagViewer"
            }
          ],
          "etag": "BwYY6ttEMEY=",
          "version": 3
        },
        "relevance": "HEURISTIC_RELEVANCE_HIGH"
      },
    ],
    "relevance": "HEURISTIC_RELEVANCE_HIGH"
  },
  "denyPolicyExplanation": {
    "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
    "explainedResources": [
      {
        "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
        "explainedPolicies": [
          {
            "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
            "policy": {
              "createTime": "2024-04-09T23:28:24.103203Z",
              "displayName": "Troubleshooter v3 prober non-tag deny policy",
              "etag": "MTgyMzk3MDY4OTY4MDE0ODg4OTY=",
              "kind": "DenyPolicy",
              "name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F546942305807/denypolicies/deny-policy-1",
              "rules": [
                {
                  "denyRule": {
                    "deniedPermissions": [
                      "bigquery.googleapis.com/datasets.create"
                    ],
                    "deniedPrincipals": [
                      "principal://iam.googleapis.com/projects/-/serviceAccounts/service-account-1@project-1."
                    ]
                  }
                }
              ],
              "uid": "fab63b4d-ecfb-5f06-8a6d-602bf1be5062",
              "updateTime": "2024-05-20T23:29:38.428095Z"
            },
            "relevance": "HEURISTIC_RELEVANCE_HIGH",
            "ruleExplanations": [
              {
                "combinedDeniedPermission": {
                  "permissionMatchingState": "PERMISSION_PATTERN_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_HIGH"
                },
                "combinedDeniedPrincipal": {
                  "membership": "MEMBERSHIP_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_HIGH"
                },
                "combinedExceptionPermission": {
                  "permissionMatchingState": "PERMISSION_PATTERN_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_NORMAL"
                },
                "combinedExceptionPrincipal": {
                  "membership": "MEMBERSHIP_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_NORMAL"
                },
                "deniedPermissions": {
                  "bigquery.googleapis.com/datasets.create": {
                    "permissionMatchingState": "PERMISSION_PATTERN_NOT_MATCHED",
                    "relevance": "HEURISTIC_RELEVANCE_HIGH"
                  }
                },
                "deniedPrincipals": {
                  "principal://iam.googleapis.com/projects/-/serviceAccounts/service-account-1@project-1.": {
                    "membership": "MEMBERSHIP_NOT_MATCHED",
                    "relevance": "HEURISTIC_RELEVANCE_HIGH"
                  }
                },
                "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
                "relevance": "HEURISTIC_RELEVANCE_HIGH"
              }
            ]
          },
        ],
        "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/123456789012",
        "relevance": "HEURISTIC_RELEVANCE_HIGH"
      }
    ],
    "permissionDeniable": true,
    "relevance": "HEURISTIC_RELEVANCE_NORMAL"
  },
  "overallAccessState": "CANNOT_ACCESS",
  "pabPolicyExplanation": {
    "explainedBindingsAndPolicies": [
      {
        "bindingAndPolicyAccessState": "PAB_ACCESS_STATE_NOT_ENFORCED",
        "explainedPolicy": {
          "explainedRules": [
            {
              "combinedResourceInclusionState": "RESOURCE_INCLUSION_STATE_NOT_INCLUDED",
              "effect": "ALLOW",
              "explainedResources": [
                {
                  "relevance": "HEURISTIC_RELEVANCE_NORMAL",
                  "resource": "//cloudresourcemanager.googleapis.com/projects/project-2",
                  "resourceInclusionState": "RESOURCE_INCLUSION_STATE_NOT_INCLUDED"
                }
              ],
              "relevance": "HEURISTIC_RELEVANCE_NORMAL",
              "ruleAccessState": "PAB_ACCESS_STATE_NOT_ALLOWED"
            }
          ],
          "policy": {
            "createTime": "2024-04-09T17:40:51.627668Z",
            "details": {
              "enforcementVersion": "1",
              "rules": [
                {
                  "effect": "ALLOW",
                  "resources": [
                    "//cloudresourcemanager.googleapis.com/projects/project-2"
                  ]
                }
              ]
            },
            "displayName": "Troubleshooter v3 PAB Policy",
            "etag": "m64s4IgR80eDJDywuVA2DA==",
            "name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
            "uid": "puid_11875429267422576641",
            "updateTime": "2024-04-09T17:40:51.627668Z"
          },
          "policyAccessState": "PAB_ACCESS_STATE_NOT_ENFORCED",
          "policyVersion": {
            "enforcementState": "PAB_POLICY_ENFORCEMENT_STATE_NOT_ENFORCED",
            "version": 1
          },
          "relevance": "HEURISTIC_RELEVANCE_NORMAL"
        },
        "explainedPolicyBinding": {
          "conditionExplanation": {
            "evaluationStates": [
              {
                "end": 53,
                "value": true
              },
              {
                "end": 153,
                "start": 58,
                "value": false
              },
              {
                "end": 248,
                "start": 157,
                "value": false
              }
            ],
            "value": false
          },
          "policyBinding": {
            "condition": {
              "expression": "principal.type == 'iam.googleapis.com/ServiceAccount' && (principal.subject=='service-account-1@project-1.' || principal.subject=='service-account-2@project-1.')"
            },
            "createTime": "2024-04-09T17:51:13.504418Z",
            "displayName": "PAB Policy Binding on project-1 project",
            "etag": "W/\"hz9IKzHsIqvopqDRcVYDxQ==\"",
            "name": "projects/123456789012/locations/global/policyBindings/example-policy-binding",
            "policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
            "policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
            "policyUid": "puid_11875429267422576641",
            "target": {
              "principalSet": "//cloudresourcemanager.googleapis.com/projects/project-1"
            },
            "uid": "buid_1012746966204940289", 
            "updateTime": "2024-05-09T23:08:56.846355Z"
          },
          "policyBindingState": "POLICY_BINDING_STATE_NOT_ENFORCED",
          "relevance": "HEURISTIC_RELEVANCE_NORMAL"
        },
        "relevance": "HEURISTIC_RELEVANCE_NORMAL"
      }
    ],
    "principalAccessBoundaryAccessState": "PAB_ACCESS_STATE_NOT_ENFORCED",
    "relevance": "HEURISTIC_RELEVANCE_NORMAL"
  }
}

REST

Para averiguar por qué una principal tiene o no un permiso de IAM, usa el método iam.troubleshoot de la API del Solucionador de problemas de políticas.

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

  • VERSION: Es la versión de la API que se usará para esta solicitud. Para solucionar problemas de acceso basados solo en políticas de permiso y denegación, usa v3. Para solucionar problemas de acceso según las políticas de permiso, denegación y Política de Límite de Acceso de las Entidades, usa v3beta.
  • EMAIL: La dirección de correo electrónico del principal al que pertenecen los permisos con problemas que deseas solucionar. En el caso de una identidad de agente, debes proporcionar el identificador de la principal.
  • RESOURCE: El recurso en el que se otorga el permiso.
  • PERMISSION: El permiso con los problemas que deseas solucionar.
  • PROJECT_ID: Es el ID del proyecto que deseas usar para realizar la solicitud. Los ID de proyecto son strings alfanuméricas, como my-project.

Método HTTP y URL:

POST https://policytroubleshooter.googleapis.com/VERSION/iam:troubleshoot

Cuerpo JSON de la solicitud:

{
  "accessTuple": {
    "principal": "EMAIL",
    "fullResourceName": "RESOURCE",
    "permission": "PERMISSION"
  }
}

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Comprende los resultados del Solucionador de problemas

Console

La página de resultados contiene la siguiente información:

Detalles de la evaluación

La sección Detalles de la evaluación contiene un resumen del acceso para el que estás solucionando problemas, incluidos la principal, el recurso y el permiso especificados. Si solucionas problemas de varios pares de permisos de recursos, puedes usar la lista Evaluación de acceso para alternar entre ellos.

Detalles de la política

La sección Detalles de la política contiene detalles sobre cómo las políticas de permiso, denegación y Política de Límite de Acceso de las Entidades pertinentes afectan el acceso de la entidad.

Las Políticas de Límite de Acceso de las Entidades pertinentes incluyen todas las Políticas de Límite de Acceso de las Entidades que están vinculadas a un conjunto de entidades que incluye la entidad.

Las políticas de permiso y denegación relevantes incluyen lo siguiente:

  • La política de permiso del recurso
  • Las políticas de denegación del recurso, si las hay
  • Las políticas de permiso del proyecto superior, la carpeta y la organización del recurso, si las hay
  • Las políticas de denegación del proyecto superior, la carpeta y la organización del recurso, si las hay

Las políticas de permiso y denegación de los proyectos superiores, las carpetas y las organizaciones son relevantes debido a la herencia de políticas. Cuando adjuntas una política de permiso o denegación a un proyecto, una organización o una carpeta, esa política también se aplica a todos los recursos dentro de ese proyecto, organización o carpeta.

Por ejemplo, si una política de denegación para una organización indica que una principal no puede usar un permiso específico, la principal no puede usar ese permiso en ningún recurso dentro de la organización. Esta regla se aplica incluso si las carpetas y proyectos dentro de esa organización tienen políticas de denegación más permisivas o políticas de permiso que otorgan permiso a la principal.

Del mismo modo, si una política de permisos para un proyecto le da a una principal un permiso específico, la principal tiene ese permiso para cualquier recurso dentro del proyecto, siempre que no se le deniegue ese permiso.

La sección Detalles de la política contiene las siguientes secciones:

Accede al estado

En la sección Estado de acceso, se resumen los resultados de cada tipo de política (políticas de límite de acceso de las entidades, políticas de denegación y políticas de permisos) y se indica el resultado general. El resultado indica si la principal puede usar el permiso para acceder al recurso, según las políticas pertinentes.

Para que un usuario pueda usar el permiso de acceso al recurso, todos los tipos de políticas deben permitir el acceso. Para obtener más información, consulta Evaluación de políticas.

Política de Límite de Acceso de las Principales

En la sección Política de Límite de Acceso de las Entidades, puedes ver todas las políticas de Límite de Acceso de las Entidades a las que está sujeta la entidad y las vinculaciones de políticas que vinculan estas políticas a la entidad.

En el panel Políticas, se enumeran todas las políticas vinculadas a un conjunto de principales que incluye la principal. Junto a cada política, hay un ícono que indica cómo afecta el acceso de la principal.

Las políticas de Límite de Acceso de las Entidades pueden afectar el acceso de una entidad de las siguientes maneras:

  • La principal es apta para acceder al recurso: La política de Límite de Acceso de las Principales se aplica a la principal, y una de sus reglas contiene el recurso consultado.
  • La principal no es apta para acceder al recurso: La Política de Límite de Acceso de las Principales se aplica a la principal, pero el recurso consultado no está en las reglas de esa política.
  • No se aplica: Las políticas de límite de acceso de las entidades no se aplican en las siguientes situaciones:

    • IAM no aplica el permiso especificado en la versión de aplicación de la política de límite de acceso de la entidad. Como resultado, la Política de Límite de Acceso de las Entidades no puede bloquear el acceso.
    • Debido a una condición en la vinculación de la política, la política o vinculación de Límite de acceso de las principales no se aplica a la principal.
    • Una Política de Límite de Acceso de las Entidades no tiene reglas.

    Si no se aplica una política de límite de acceso de las principales, no puede afectar si la principal puede acceder al recurso.

Para ver las reglas y vinculaciones asociadas con una Política de Límite de Acceso de las Entidades, haz clic en el nombre de la política. En el panel adyacente al panel Políticas, se muestran los detalles de la política.

Para ver las reglas de la política, haz clic en la pestaña Reglas de límite. En esta pestaña, se muestra una tabla de las reglas de la Política de Límite de Acceso de las Entidades pertinentes.

Una regla de límite de acceso de la entidad es relevante si afecta el resultado general de la consulta del Solucionador de problemas de políticas. Como resultado, las reglas pertinentes varían según los resultados del Solucionador de problemas de políticas. Por ejemplo, considera las siguientes situaciones:

  • El Solucionador de problemas de políticas indica que la principal puede acceder al recurso. Como resultado, las reglas relevantes son las que hacen que la principal sea apta para acceder al recurso.
  • El Solucionador de problemas de políticas indica que la principal no puede acceder al recurso. Sin embargo, según las políticas de límite de acceso de las entidades pertinentes, la entidad es apta para acceder al recurso. Por lo tanto, no hay reglas pertinentes, ya que las políticas de límite de acceso de las entidades no son el motivo por el que la entidad no puede acceder al recurso.
  • El Solucionador de problemas de políticas indica que la principal no puede acceder al recurso. Además, según las políticas de límite de acceso de las principales pertinentes, la principal no es apta para acceder al recurso. Como resultado, las reglas relevantes son aquellas que no hacen que la principal sea apta para acceder al recurso.

Para ver todas las reglas de límite de acceso de la entidad en una política, desmarca la casilla de verificación Mostrar solo las reglas y vinculaciones relevantes.

La columna Hallazgos de la tabla de reglas de límite indica si la regla de límite de acceso de la entidad contiene el recurso consultado. Para ver más detalles sobre la regla, haz clic en Ver detalles de la regla.

Para ver las vinculaciones de la política, haz clic en la pestaña Vinculaciones. En esta pestaña, se muestra una tabla de las vinculaciones de políticas relevantes para la política de Límite de Acceso de las Entidades seleccionada.

Una vinculación de política es relevante si aplica de manera efectiva la Política de Límite de Acceso de las Entidades a la entidad consultada. Para que una vinculación de política aplique una Política de Límite de Acceso de las Entidades a una entidad, se debe cumplir lo siguiente:

  • El conjunto de principales en la vinculación de políticas debe incluir la principal consultada
  • Cualquier condición en la vinculación de políticas debe evaluarse como true para el principal consultado.

Para ver todas las vinculaciones de políticas con conjuntos de principales que incluyan la principal consultada, sin importar si esta cumple con la condición de la vinculación, desmarca la casilla de verificación Mostrar solo reglas y vinculaciones relevantes.

Para las identidades de agentes, el Solucionador de problemas de políticas evalúa las políticas de límite de acceso de las entidades asociadas con la jerarquía de recursos del proyecto o contenedor de hosting del agente, y evalúa las condiciones que coinciden con el tipo de identidad del agente (principal.type == 'iam.googleapis.com/AgentPoolIdentity') y el patrón de asunto (principal.subject.startsWith(...)).

La columna Hallazgos de la tabla de vinculaciones indica si la vinculación se aplica de manera forzosa para la principal consultada. Para ver más detalles sobre la vinculación de la política, haz clic en Ver detalles de la vinculación.

Política de denegación

En la sección Política de denegación, puedes ver todas las políticas de denegación pertinentes, identificar las reglas de denegación que rechazan el acceso a la principal y comprender por qué una regla de denegación rechaza o no el permiso de la principal.

En el panel Recursos con políticas de denegación, se enumeran todas las políticas de denegación relevantes, organizadas por los recursos a los que están adjuntas. Junto a cada política de denegación, hay una evaluación de acceso. Esta evaluación solo se aplica a esa política de denegación; no refleja ningún acceso de las políticas heredadas. Si no tienes permiso para ver la política de denegación de un recurso, la lista de recursos no incluye ese recurso ni sus políticas de denegación.

Para ver las reglas de denegación pertinentes en estas políticas de denegación, haz clic en una política de denegación. Para ver todas las reglas de denegación en las políticas de denegación de un recurso, haz clic en un recurso. Las reglas de denegación aparecen en el panel Reglas de denegación. Este panel contiene una tabla de todas las reglas de denegación con la principal o el permiso consultados para el recurso o la política de denegación que seleccionaste.

La columna Acceso indica si la regla de denegación le niega el permiso a la principal. Para ver más detalles sobre la regla de denegación, haz clic en Ver regla de denegación en la fila de esa regla.

Política de permisos

En la sección Política de permisos, puedes navegar por todas las políticas de permisos pertinentes, identificar las vinculaciones de roles que otorgan acceso a la principal y comprender por qué una vinculación de rol otorga o no el permiso a la principal.

En el panel Recursos, se enumeran el recurso especificado y sus principales. Junto a cada recurso, hay una evaluación de acceso. Esta evaluación solo se aplica a la política de permisos de ese recurso, no refleja ningún acceso de las políticas heredadas. Si no tienes permiso para ver la política de permisos de un recurso, la lista de recursos no lo incluirá.

Para ver las vinculaciones de roles relevantes en la política de permisos de un recurso y ver cómo otorgan o no el permiso a la principal, haz clic en el recurso. Las vinculaciones de roles de la política de permisos aparecen en el panel Vinculaciones de roles.

El panel Vinculaciones de roles contiene una tabla de vinculaciones de roles en la política de permisos del recurso seleccionado. De forma predeterminada, la tabla solo contiene vinculaciones de roles que incluyen un rol con el permiso especificado. Si la principal no tiene acceso, la tabla también muestra vinculaciones de roles con roles personalizados editables. Para ver todas las vinculaciones de roles, desmarca la casilla de verificación Mostrar solo las vinculaciones relevantes.

En la columna Acceso, se indica si la vinculación de rol otorga el permiso a la principal. Para ver más detalles sobre la vinculación de roles, haz clic en Ver detalles de la vinculación en la fila de esa vinculación de roles.

Cuando se evalúan las políticas de permisos para las identidades de agentes, el Solucionador de problemas de políticas verifica si el agente coincide con alguno de los siguientes identificadores de principal:

Identificador de principal Ejemplo
Identidades de agentes directos principal://TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH
Conjuntos de principales de dominios de confianza principalSet://TRUST_DOMAIN/*
Conjuntos de principales de plataforma principalSet://TRUST_DOMAIN/attribute.platform/SERVICE
Conjuntos de principales de contenedores de recursos principalSet://TRUST_DOMAIN/attribute.container/projects/PROJECT_NUMBER
Conjuntos de principales de contenedores de la plataforma principalSet://TRUST_DOMAIN/attribute.platformContainer/SERVICE/projects/PROJECT_NUMBER

Cuando solucionas problemas de acceso para una principal que no es un agente, como un usuario o una cuenta de servicio, las vinculaciones de roles para las identidades de agentes se evalúan como Not matched.

gcloud

La respuesta contiene cuatro secciones principales: una descripción de la tupla de acceso en la solicitud, los resultados de la evaluación de la política de permisos, los resultados de la evaluación de la política de denegación y el estado de acceso general.

  • accessTuple: Es una descripción de la tupla de acceso en la solicitud, incluido cualquier contexto de condición que hayas proporcionado. En esta sección, también se incluye un resumen de las etiquetas que se aplican al recurso.
  • allowPolicyExplanation: Es un resumen de si las políticas de permisos relevantes otorgan el permiso a la principal, seguido de una lista de políticas de permisos y sus vinculaciones de roles.

    Para cada política de permisos, la respuesta enumera todas las vinculaciones de roles en la política y las evalúa según los siguientes criterios:

    • Indica si la vinculación de rol incluye el permiso.
    • Indica si la vinculación de rol incluye la principal.
    • Si se cumplen las condiciones de la vinculación de roles, si las hay.

    Luego, la respuesta imprime el texto JSON completo de la política de permisos.

  • denyPolicyExplanation: Es un resumen de si las políticas de denegación pertinentes le deniegan el permiso a la principal, seguido de una lista de recursos con políticas de denegación. Para cada recurso, la respuesta enumera todas las políticas de denegación adjuntas al recurso.

    Para cada política de denegación, la respuesta imprime los metadatos de la política, enumera las reglas de denegación de la política y, luego, evalúa cada regla según los siguientes criterios:

    • Si la regla de denegación incluye el permiso.
    • Indica si el permiso aparece como una excepción en la regla de denegación.
    • Si la regla de denegación incluye la principal.
    • Indica si la principal aparece como una excepción en la regla de denegación.
    • Si se cumplen las condiciones de la regla de denegación, si las hay.
  • overallAccessState: Indica si la entidad puede usar el permiso especificado para acceder al recurso especificado según las políticas de permiso, de denegación y la Política de Límite de Acceso de las Entidades pertinentes.

    Las Políticas de Límite de Acceso de las Entidades pertinentes incluyen todas las Políticas de Límite de Acceso de las Entidades que están vinculadas a un conjunto de entidades que incluye la entidad.

    Las políticas de permiso y denegación relevantes incluyen lo siguiente:

    • La política de permiso del recurso
    • Las políticas de denegación del recurso, si las hay
    • Las políticas de permiso del proyecto superior, la carpeta y la organización del recurso, si las hay
    • Las políticas de denegación del proyecto superior, la carpeta y la organización del recurso, si las hay

    Las políticas de permiso y denegación de los proyectos superiores, las carpetas y las organizaciones son relevantes debido a la herencia de políticas. Cuando adjuntas una política de permiso o denegación a un proyecto, una organización o una carpeta, esa política también se aplica a todos los recursos dentro de ese proyecto, organización o carpeta.

    Por ejemplo, si una política de denegación para una organización indica que una principal no puede usar un permiso específico, la principal no puede usar ese permiso en ningún recurso dentro de la organización. Esta regla se aplica incluso si las carpetas y proyectos dentro de esa organización tienen políticas de denegación más permisivas o políticas de permiso que otorgan permiso a la principal.

    Del mismo modo, si una política de permisos para un proyecto le da a una principal un permiso específico, la principal tiene ese permiso para cualquier recurso dentro del proyecto, siempre que no se le deniegue ese permiso.

    Para que un usuario pueda usar el permiso para acceder al recurso, todos los tipos de políticas deben permitir el acceso. Para obtener más información, consulta Evaluación de políticas.

  • pabPolicyExplanation: Es un resumen de si las políticas de límite de acceso de las entidades pertinentes permiten que la entidad acceda al recurso, seguido de las vinculaciones de políticas de límite de acceso de las entidades y las políticas de límite de acceso de las entidades pertinentes.

    Las políticas de Límite de Acceso de las Entidades pueden permitir el acceso, no permitirlo o no aplicarse. Las políticas de límite de acceso de las entidades no se aplican en las siguientes situaciones:

    • IAM no aplica el permiso especificado en la versión de aplicación de la política de límite de acceso de la entidad. Como resultado, la Política de Límite de Acceso de las Entidades no puede bloquear el acceso.
    • Debido a una condición en la vinculación de la política, la política o vinculación de Límite de acceso de las principales no se aplica a la principal.
    • Una Política de Límite de Acceso de las Entidades no tiene reglas.

    Si no se aplica una política de límite de acceso de las principales, no puede afectar si la principal puede acceder al recurso.

    La respuesta también enumera todas las vinculaciones de políticas que incluyen la principal y los detalles de la Política de Límite de Acceso de las Entidades en cada una de esas vinculaciones de políticas:

    • Para cada vinculación de Política de Límite de Acceso de las Entidades, la respuesta imprime si la vinculación de política se aplica a la entidad y, luego, imprime el texto de la vinculación de política. Una vinculación de política se aplica si el conjunto de principales en la vinculación incluye la principal consultada y si la condición en la vinculación de política se evalúa como true para la principal consultada. Si no se aplica la vinculación de políticas, la política no puede afectar si la principal puede acceder al recurso.
    • Para cada política de límite de acceso de las principales, la respuesta imprime lo siguiente:

      • Indica si la política permite el acceso, no lo permite o no se aplica de manera forzosa.
      • Es la versión de aplicación forzosa de la política. Este número de versión determina si IAM aplica esta Política de Límite de Acceso de las Entidades para el permiso consultado. Si no se aplica el permiso, la política no puede afectar si la principal puede acceder al recurso.
      • Las reglas de la Política de Límite de Acceso de las Entidades y si cada regla permite el acceso. Para cada regla, la respuesta indica si el recurso consultado se incluye en la regla.

        Un recurso se incluye en una regla si se cumple una de las siguientes condiciones:

        • El recurso aparece en la regla. Solo los recursos de Resource Manager (proyectos, carpetas y organizaciones) se pueden incluir directamente en las reglas de límite de acceso de la entidad.
        • Uno de los principales del recurso (es decir, un proyecto, una carpeta o una organización por encima del recurso en la jerarquía de recursos) aparece en la regla.

Muchos objetos de la respuesta también tienen un campo relevance. El valor de este campo indica cuánto contribuye ese objeto al estado de acceso general. El campo relevance puede tener los siguientes valores:

  • HEURISTIC_RELEVANCE_HIGH: Indica que el objeto tiene un impacto fuerte en el resultado. En otras palabras, quitar el objeto probablemente cambiará el estado de acceso general. Por ejemplo, una vinculación de rol que otorga a la principal el permiso especificado tendría este valor de relevancia.

  • HEURISTIC_RELEVANCE_NORMAL: Indica que el objeto tiene un impacto limitado en el resultado. En otras palabras, es poco probable que quitar el objeto cambie el estado de acceso general. Por ejemplo, una regla de denegación que no contenga el permiso o la principal tendría este valor de relevancia.

REST

La respuesta contiene cuatro secciones principales: el estado de acceso general, una descripción de la tupla de acceso en la solicitud, los resultados de la evaluación de la política de permisos y los resultados de la evaluación de la política de denegación.

  • overallAccessState: Indica si la entidad puede usar el permiso especificado para acceder al recurso especificado según las políticas de permiso, de denegación y la Política de Límite de Acceso de las Entidades pertinentes.

    Las Políticas de Límite de Acceso de las Entidades pertinentes incluyen todas las Políticas de Límite de Acceso de las Entidades que están vinculadas a un conjunto de entidades que incluye la entidad.

    Las políticas de permiso y denegación relevantes incluyen lo siguiente:

    • La política de permiso del recurso
    • Las políticas de denegación del recurso, si las hay
    • Las políticas de permiso del proyecto superior, la carpeta y la organización del recurso, si las hay
    • Las políticas de denegación del proyecto superior, la carpeta y la organización del recurso, si las hay

    Las políticas de permiso y denegación de los proyectos superiores, las carpetas y las organizaciones son relevantes debido a la herencia de políticas. Cuando adjuntas una política de permiso o denegación a un proyecto, una organización o una carpeta, esa política también se aplica a todos los recursos dentro de ese proyecto, organización o carpeta.

    Por ejemplo, si una política de denegación para una organización indica que una principal no puede usar un permiso específico, la principal no puede usar ese permiso en ningún recurso dentro de la organización. Esta regla se aplica incluso si las carpetas y proyectos dentro de esa organización tienen políticas de denegación más permisivas o políticas de permiso que otorgan permiso a la principal.

    Del mismo modo, si una política de permisos para un proyecto le da a una principal un permiso específico, la principal tiene ese permiso para cualquier recurso dentro del proyecto, siempre que no se le deniegue ese permiso.

    Para que un usuario pueda usar el permiso para acceder al recurso, todos los tipos de políticas deben permitir el acceso. Para obtener más información, consulta Evaluación de políticas.

  • accessTuple: Es una descripción de la tupla de acceso en la solicitud, incluido cualquier contexto de condición que hayas proporcionado. En esta sección, también se incluye un resumen de las etiquetas que se aplican al recurso.
  • allowPolicyExplanation: Es un resumen de si las políticas de permisos relevantes otorgan el permiso a la principal, seguido de una lista de políticas de permisos y sus vinculaciones de roles.

    Para cada política de permisos, la respuesta enumera todas las vinculaciones de roles en la política y las evalúa según los siguientes criterios:

    • Indica si la vinculación de rol incluye el permiso.
    • Indica si la vinculación de rol incluye la principal.
    • Si se cumplen las condiciones de la vinculación de roles, si las hay.

    Luego, la respuesta imprime el texto JSON completo de la política de permisos.

  • denyPolicyExplanation: Es un resumen de si las políticas de denegación pertinentes le deniegan el permiso a la principal, seguido de una lista de recursos con políticas de denegación. Para cada recurso, la respuesta enumera todas las políticas de denegación adjuntas al recurso.

    Para cada política de denegación, la respuesta imprime los metadatos de la política, enumera las reglas de denegación de la política y, luego, evalúa cada regla según los siguientes criterios:

    • Si la regla de denegación incluye el permiso.
    • Indica si el permiso aparece como una excepción en la regla de denegación.
    • Si la regla de denegación incluye la principal.
    • Indica si la principal aparece como una excepción en la regla de denegación.
    • Si se cumplen las condiciones de la regla de denegación, si las hay.
  • pabPolicyExplanation: Es un resumen de si las políticas de límite de acceso de las entidades pertinentes permiten que la entidad acceda al recurso, seguido de las vinculaciones de políticas de límite de acceso de las entidades y las políticas de límite de acceso de las entidades pertinentes.

    Las políticas de Límite de Acceso de las Entidades pueden permitir el acceso, no permitirlo o no aplicarse. Las políticas de límite de acceso de las entidades no se aplican en las siguientes situaciones:

    • IAM no aplica el permiso especificado en la versión de aplicación de la política de límite de acceso de la entidad. Como resultado, la Política de Límite de Acceso de las Entidades no puede bloquear el acceso.
    • Debido a una condición en la vinculación de la política, la política o vinculación de Límite de acceso de las principales no se aplica a la principal.
    • Una Política de Límite de Acceso de las Entidades no tiene reglas.

    Si no se aplica una política de límite de acceso de las principales, no puede afectar si la principal puede acceder al recurso.

    La respuesta también enumera todas las vinculaciones de políticas que incluyen la principal y los detalles de la Política de Límite de Acceso de las Entidades en cada una de esas vinculaciones de políticas:

    • Para cada vinculación de Política de Límite de Acceso de las Entidades, la respuesta imprime si la vinculación de política se aplica a la entidad y, luego, imprime el texto de la vinculación de política. Una vinculación de política se aplica si el conjunto de principales en la vinculación incluye la principal consultada y si la condición en la vinculación de política se evalúa como true para la principal consultada. Si no se aplica la vinculación de políticas, la política no puede afectar si la principal puede acceder al recurso.
    • Para cada política de límite de acceso de las principales, la respuesta imprime lo siguiente:

      • Indica si la política permite el acceso, no lo permite o no se aplica de manera forzosa.
      • Es la versión de aplicación forzosa de la política. Este número de versión determina si IAM aplica esta Política de Límite de Acceso de las Entidades para el permiso consultado. Si no se aplica el permiso, la política no puede afectar si la principal puede acceder al recurso.
      • Las reglas de la Política de Límite de Acceso de las Entidades y si cada regla permite el acceso. Para cada regla, la respuesta indica si el recurso consultado se incluye en la regla.

        Un recurso se incluye en una regla si se cumple una de las siguientes condiciones:

        • El recurso aparece en la regla. Solo los recursos de Resource Manager (proyectos, carpetas y organizaciones) se pueden incluir directamente en las reglas de límite de acceso de la entidad.
        • Uno de los principales del recurso (es decir, un proyecto, una carpeta o una organización por encima del recurso en la jerarquía de recursos) aparece en la regla.

Muchos objetos de la respuesta también tienen un campo relevance. El valor de este campo indica cuánto contribuye ese objeto al estado de acceso general. El campo relevance puede tener los siguientes valores:

  • HEURISTIC_RELEVANCE_HIGH: Indica que el objeto tiene un impacto fuerte en el resultado. En otras palabras, quitar el objeto probablemente cambiará el estado de acceso general. Por ejemplo, una vinculación de rol que otorga a la principal el permiso especificado tendría este valor de relevancia.

  • HEURISTIC_RELEVANCE_NORMAL: Indica que el objeto tiene un impacto limitado en el resultado. En otras palabras, es poco probable que quitar el objeto cambie el estado de acceso general. Por ejemplo, una regla de denegación que no contenga el permiso o la principal tendría este valor de relevancia.

Soluciona problemas de vinculaciones de funciones condicionales

El Solucionador de problemas de políticas soluciona automáticamente los problemas de las vinculaciones de roles condicionales y las reglas de denegación basadas en etiquetas. También soluciona problemas de forma automática en las vinculaciones de políticas de Límite de acceso de las principales con condiciones basadas en principales.

Para solucionar problemas de otros tipos de vinculaciones de roles condicionales o reglas de denegación condicionales, el Solucionador de problemas de políticas necesita contexto adicional sobre la solicitud. Por ejemplo, para solucionar problemas de condiciones basadas en atributos de fecha y hora, el Solucionador de problemas de políticas necesita la hora de la solicitud.

En gcloud CLI y la API de REST, proporcionas este contexto adicional de forma manual.

En la consola de Google Cloud , puedes proporcionar este contexto adicional solucionando problemas directamente desde cualquier registro de auditoría de actividad del administrador o registro de auditoría de acceso a los datos. Cada entrada de registro de auditoría corresponde a una solicitud a una API deGoogle Cloud o a una acción que Google Cloud realiza en tu nombre. Cuando solucionas problemas desde un registro de auditoría, el Solucionador de problemas de políticas obtiene automáticamente información adicional sobre la solicitud, como la fecha y la hora, lo que permite que el Solucionador de problemas de políticas analice las vinculaciones de roles condicionales y las reglas de denegación.

Console

Para solucionar problemas de vinculaciones de roles condicionales y reglas de denegación, haz lo siguiente:

  1. En la consola de Google Cloud , accede a la página Explorador de registros.

    Ve al Explorador de registros.

  2. Si el título de la página es Visor de registros heredados, haz clic en la lista desplegable Actualizar y selecciona Actualizar al Explorador de registros nuevo.

  3. Para ver solo los registros de auditoría de actividad del administrador y acceso a los datos, ingresa la siguiente consulta en el compilador de consultas y, luego, haz clic en Ejecutar consulta:

    logName=("RESOURCE_TYPE/RESOURCE_ID/logs/cloudaudit.googleapis.com%2Factivity" OR "RESOURCE_TYPE/RESOURCE_ID/logs/cloudaudit.googleapis.com%2Fdata_access")
    

    Reemplaza los siguientes valores:

    • RESOURCE_TYPE: El tipo de recurso para el que creas una lista de registros de auditoría. Usa projects, folders o organizations.
    • RESOURCE_ID: El ID de tu recurso.
  4. Ubica la entrada de registro de auditoría que corresponda a la solicitud que deseas solucionar. Si quieres obtener información sobre cómo usar el explorador de registros para encontrar entradas de registro específicas, consulta Usa el explorador de registros.

  5. En la columna Resumen de la entrada de registro, haz clic en IAM y, luego, en Solucionar problemas de acceso.

    El Solucionador de problemas de políticas usa la información de la entrada de registro para solucionar problemas de acceso y, luego, te muestra los resultados. El contexto adicional se indica en los detalles de la evaluación en Contexto de la condición. Para ver los detalles del contexto, haz clic en Ver contexto de la condición. Para obtener más información sobre la página de resultados del Solucionador de problemas de políticas, consulta Información sobre los resultados del Solucionador de problemas en esta página.

  6. Opcional: Para solucionar problemas de otra solicitud que involucre vinculaciones de roles condicionales y reglas de denegación, regresa a la página del Explorador de registros y repite los pasos anteriores.

gcloud

Para solucionar problemas de vinculaciones de roles condicionales y reglas de denegación, usa el comando gcloud policy-troubleshoot iam.

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

  • EMAIL: Es la dirección de correo electrónico de la entidad cuyos permisos quieres solucionar problemas. Para una identidad de agente, debes proporcionar el identificador de la principal.
  • RESOURCE: Es el recurso en el que se otorga el permiso.
  • PERMISSION: Es el permiso para el que deseas solucionar problemas.
  • DESTINATION_IP: Opcional Es la dirección IP de destino de la solicitud que se usará cuando se verifiquen las vinculaciones de roles condicionales. Por ejemplo, 198.1.1.1.
  • DESTINATION_PORT: Opcional Es el puerto de destino de la solicitud que se usará cuando se verifiquen las vinculaciones de roles condicionales. Por ejemplo, "8080".
  • REQUEST_TIME: Opcional Es la marca de tiempo de la solicitud que se usará cuando se verifiquen las vinculaciones de roles condicionales. Usa una marca de tiempo en formato RFC 3339, por ejemplo, 2099-02-01T00:00:00Z.
  • RESOURCE_NAME: Opcional Es el valor del nombre del recurso que se usará cuando se verifiquen las vinculaciones de roles condicionales. Para obtener una lista de los formatos de nombre de recurso aceptados, consulta Formato de nombre de recurso.
  • RESOURCE_SERVICE: Opcional Es el valor del servicio de recursos que se usará cuando se verifiquen las vinculaciones de roles condicionales. Para obtener una lista de los nombres de servicios aceptados, consulta Valores de servicios de recursos.
  • RESOURCE_TYPE: Opcional Para obtener una lista de los tipos de recursos aceptados, consulta Valores de tipos de recursos.

Ejecuta el comando gcloud policy-troubleshoot iam:

Linux, macOS o Cloud Shell

gcloud policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL \
    --permission=PERMISSION --destination-ip=DESTINATION_IP \
    --destination-port=DESTINATION_PORT --request-time=REQUEST_TIME \
    --resource-name=RESOURCE_NAME --resource-service=RESOURCE_SERVICE \
    --resource-type=RESOURCE_TYPE

Windows (PowerShell)

gcloud policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL `
    --permission=PERMISSION --destination-ip=DESTINATION_IP `
    --destination-port=DESTINATION_PORT --request-time=REQUEST_TIME `
    --resource-name=RESOURCE_NAME --resource-service=RESOURCE_SERVICE `
    --resource-type=RESOURCE_TYPE

Windows (cmd.exe)

gcloud policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL ^
    --permission=PERMISSION --destination-ip=DESTINATION_IP ^
    --destination-port=DESTINATION_PORT --request-time=REQUEST_TIME ^
    --resource-name=RESOURCE_NAME --resource-service=RESOURCE_SERVICE ^
    --resource-type=RESOURCE_TYPE

La respuesta contiene una explicación del acceso del principal. Para cada vinculación de rol y regla de denegación con una condición, la respuesta incluye un campo conditionExplanation que describe si la condición se evalúa como verdadera o falsa según el contexto de la condición que proporcionaste.

Por ejemplo, la siguiente es una evaluación de una vinculación de rol con una condición que especifica el tipo de recurso y el servicio de recursos:

Respuesta

...
{
  "allowAccessState": "ALLOW_ACCESS_STATE_GRANTED",
  "combinedMembership": {
    "membership": "MEMBERSHIP_MATCHED",
    "relevance": "HEURISTIC_RELEVANCE_HIGH"
  },
  "condition": {
    "expression": " resource.type \u003d\u003d \"compute.googleapis.com/Instance\" \u0026\u0026 resource.service \u003d\u003d \"compute.googleapis.com\"",
    "title": "Compute instances only",
    "description": "Condition that limits permissions to only Compute instances"
  },
  "conditionExplanation": {
    "evaluationStates": [{
      "end": 51,
      "start": 1,
      "value": true
    }, {
      "end": 99,
      "start": 55,
      "value": true
    }],
    "value": true,
  },
  "memberships": {
    "user:my-user@example.com": {
      "membership": "MEMBERSHIP_MATCHED",
      "relevance": "HEURISTIC_RELEVANCE_HIGH"
    }
  },
  "relevance": "HEURISTIC_RELEVANCE_HIGH",
  "role": "roles/compute.viewer",
  "rolePermission": "ROLE_PERMISSION_INCLUDED",
  "rolePermissionRelevance": "HEURISTIC_RELEVANCE_HIGH"
}
...

REST

Para solucionar problemas de vinculaciones de roles condicionales y reglas de denegación, usa el método iam.troubleshoot de la API del Solucionador de problemas de políticas.

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

  • EMAIL: Es la dirección de correo electrónico de la entidad cuyos permisos quieres solucionar problemas. Para una identidad de agente, debes proporcionar el identificador de la principal.
  • RESOURCE: Es el recurso en el que se otorga el permiso.
  • PERMISSION: Es el permiso para el que deseas solucionar problemas.
  • DESTINATION_IP: Opcional Es la dirección IP de destino de la solicitud que se usará cuando se verifiquen las vinculaciones de roles condicionales. Por ejemplo, 198.1.1.1.
  • DESTINATION_PORT: Opcional Es el puerto de destino de la solicitud que se usará cuando se verifiquen las vinculaciones de roles condicionales. Por ejemplo, "8080".
  • REQUEST_TIME: Opcional Es la marca de tiempo de la solicitud que se usará cuando se verifiquen las vinculaciones de roles condicionales. Usa una marca de tiempo en formato RFC 3339, por ejemplo, 2099-02-01T00:00:00Z.
  • RESOURCE_NAME: Opcional Es el valor del nombre del recurso que se usará cuando se verifiquen las vinculaciones de roles condicionales. Para obtener una lista de los formatos de nombre de recurso aceptados, consulta Formato de nombre de recurso.
  • RESOURCE_SERVICE: Opcional Es el valor del servicio de recursos que se usará cuando se verifiquen las vinculaciones de roles condicionales. Para obtener una lista de los nombres de servicios aceptados, consulta Valores de servicios de recursos.
  • RESOURCE_TYPE: Opcional Para obtener una lista de los tipos de recursos aceptados, consulta Valores de tipos de recursos.

Método HTTP y URL:

POST https://policytroubleshooter.googleapis.com/v3/iam:troubleshoot

Cuerpo JSON de la solicitud:

{
  "accessTuple": {
    "principal": "EMAIL",
    "fullResourceName": "RESOURCE",
    "permission": "PERMISSION",
    "conditionContext": {
      "destination": {
        "ip": DESTINATION_IP,
        "port": DESTINATION_PORT
      },
      "request": {
        "receiveTime": REQUEST_TIME
      },
      "resource": {
        "name": RESOURCE_NAME,
        "service": RESOURCE_SERVICE,
        "type": RESOURCE_TYPE
      }
    }
  }
}

Para enviar tu solicitud, expande una de estas opciones:

La respuesta contiene una explicación del acceso del principal. Para cada vinculación de rol y regla de denegación con una condición, la respuesta incluye un campo conditionExplanation que describe si la condición se evalúa como verdadera o falsa según el contexto de la condición que proporcionaste.

Por ejemplo, la siguiente es una evaluación de una vinculación de rol con una condición que especifica el tipo de recurso y el servicio de recursos:

...
{
  "allowAccessState": "ALLOW_ACCESS_STATE_GRANTED",
  "role": "roles/compute.viewer",
  "rolePermission": "ROLE_PERMISSION_INCLUDED",
  "rolePermissionRelevance": "HEURISTIC_RELEVANCE_HIGH",
  "combinedMembership": {
    "membership": "MEMBERSHIP_MATCHED",
    "relevance": "HEURISTIC_RELEVANCE_HIGH"
  },
  "memberships": {
    "user:my-user@example.com": {
      "membership": "MEMBERSHIP_MATCHED",
      "relevance": "HEURISTIC_RELEVANCE_HIGH"
    }
  },
  "relevance": "HEURISTIC_RELEVANCE_HIGH",
  "condition": {
    "expression": " resource.type \u003d\u003d \"compute.googleapis.com/Instance\" \u0026\u0026 resource.service \u003d\u003d \"compute.googleapis.com\"",
    "title": "Compute instances only",
    "description": "Condition that limits permissions to only Compute instances"
  },
  "conditionExplanation": {
    "value": true,
    "evaluationStates": [{
      "start": 1,
      "end": 51,
      "value": true
    }, {
      "start": 55,
      "end": 99,
      "value": true
    }]
  }
}
...

¿Qué sigue?