Risolvi i problemi relativi alle policy IAM

Questa pagina descrive come risolvere i problemi relativi alle policy di autorizzazione, di negazione, sul confine di accesso dell'entità e alle policy di accesso unificato (UAP) di Identity and Access Management (IAM).

Utilizza Policy Troubleshooter

Se devi risolvere i problemi di accesso per un'entità specifica, utilizza Policy Troubleshooter per IAM.

Policy Troubleshooter ti aiuta a capire se un'entità può accedere a una risorsa. Dati un'entità, una risorsa e un'autorizzazione, Policy Troubleshooter esamina le policy di autorizzazione, di negazione e sul confine di accesso dell'entità (PAB) che influiscono sull'accesso dell'entità. Poi, ti indica se, in base a queste policy, l'entità può utilizzare l'autorizzazione specificata per accedere alla risorsa. Inoltre, elenca le policy pertinenti e spiega in che modo influiscono sull'accesso dell'entità.

Policy Troubleshooter non supporta la risoluzione dei problemi delle policy di accesso unificato. Per scoprire come risolvere i problemi relativi alle UAP, consulta Risolvi i problemi manualmente in questa pagina.

Per scoprire come utilizzare Policy Troubleshooter per risolvere i problemi relativi alle policy di autorizzazione, di negazione e alle policy sul confine di accesso dell'entità, consulta Risolvi i problemi relativi alle autorizzazioni IAM.

Se devi trovare un'associazione di ruoli specifica in una policy di autorizzazione, puoi cercarla nella policy.

Cloud Asset Inventory ti consente di cercare le policy di autorizzazione per le associazioni di ruoli che corrispondono ai parametri specificati. Puoi utilizzare una serie di parametri di ricerca, tra cui:

  • Tipo di risorsa
  • Tipo di entità
  • Ruolo
  • Progetto
  • Cartella
  • Organizzazione

Per saperne di più, consulta Ricerca delle policy di autorizzazione IAM.

Risolvi i problemi manualmente

Per risolvere manualmente i problemi di accesso di un'entità a una risorsa, esamina tutte le policy che possono influire sull'accesso dell'entità.

Ruoli obbligatori

Per esaminare tutte le policy che influiscono sull'accesso di un'entità, devi disporre dell'autorizzazione per visualizzare le policy di autorizzazione, le policy di negazione, le associazioni UAP e le UAP.

Per ottenere le autorizzazioni necessarie per visualizzare tutte le policy di autorizzazione e di negazione, chiedi all'amministratore di concederti il ruolo IAM Revisore della sicurezza (roles/iam.securityReviewer) nell'organizzazione che contiene la risorsa.

Per ottenere le autorizzazioni necessarie per visualizzare tutte le associazioni UAP che interessano una risorsa di destinazione, chiedi all'amministratore di concederti i seguenti ruoli IAM nell'organizzazione che contiene la risorsa:

  • Organization Administrator (roles/resourcemanager.organizationAdmin)
  • Elenca le associazioni per le risorse specifiche del servizio: un ruolo con l'autorizzazione SERVICE.RESOURCE.searchPolicyBindings, dove RESOURCE è il tipo di risorsa e SERVICE è il servizio proprietario della risorsa.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per visualizzare tutte le associazioni UAP che interessano una risorsa di destinazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare tutte le associazioni UAP che interessano una risorsa di destinazione, sono necessarie le seguenti autorizzazioni:

  • Elenca le associazioni per le organizzazioni: resourcemanager.organizations.searchPolicyBindings
  • Elenca le associazioni per le cartelle: resourcemanager.folders.searchPolicyBindings
  • Elenca le associazioni per i progetti: resourcemanager.projects.searchPolicyBindings
  • Elenca le associazioni per le risorse specifiche del servizio: SERVICE.RESOURCE.searchPolicyBindings

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per ottenere le autorizzazioni necessarie per visualizzare tutte le associazioni UAP che interessano una risorsa di destinazione, chiedi all'amministratore di concederti ruoli che ti consentano di elencare le associazioni per quella risorsa e per i suoi predecessori. Questi ruoli devono includere l'autorizzazione SERVICE.RESOURCE.searchPolicyBindings, dove RESOURCE è il tipo di risorsa di destinazione e SERVICE è il servizio proprietario della risorsa.

Per ottenere le autorizzazioni necessarie per visualizzare tutti gli UAP, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore policy di accesso (roles/iam.accessPolicyViewer) nell'organizzazione che contiene la risorsa. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare tutti gli UAP. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare tutti gli UAP sono necessarie le seguenti autorizzazioni:

  • Elenca le associazioni per le organizzazioni: resourcemanager.organizations.searchPolicyBindings
  • Elenca le associazioni per le cartelle: resourcemanager.folders.searchPolicyBindings
  • Elenca le associazioni per i progetti: resourcemanager.projects.searchPolicyBindings
  • Elenca le associazioni per le risorse specifiche del servizio: SERVICE.RESOURCE.searchPolicyBindings

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Visualizza tutte le policy di autorizzazione e di negazione che si applicano a una risorsa

In Google Cloud, le seguenti policy di autorizzazione e di negazione influiscono sull'accesso a una risorsa:

  • La policy di autorizzazione della risorsa
  • Le policy di rifiuto della risorsa, se presenti
  • Le policy di autorizzazione del progetto, della cartella e dell'organizzazione padre della risorsa, se presenti
  • Le policy di negazione del progetto, della cartella e dell'organizzazione padre della risorsa, se presenti

Le policy di autorizzazione e di negazione di progetti, cartelle e organizzazioni principali influiscono sull'accesso a una risorsa a causa dell'ereditarietà delle policy. Quando colleghi una policy di autorizzazione o di negazione a un progetto, una cartella o un'organizzazione, la policy si applica anche a tutte le risorse all'interno del progetto, della cartella o dell'organizzazione.

Ad esempio, se una policy di negazione per un'organizzazione indica che un'entità non può utilizzare un'autorizzazione specifica, l'entità non può utilizzare l'autorizzazione per nessuna risorsa all'interno dell'organizzazione. Questa regola si applica anche se le cartelle e i progetti all'interno dell'organizzazione hanno policy di negazione più permissive o policy di autorizzazione che concedono l'autorizzazione all'entità.

Analogamente, se una policy di autorizzazione per un progetto concede a un'entità un'autorizzazione specifica, l'entità dispone di tale autorizzazione per qualsiasi risorsa all'interno del progetto, a condizione che non le venga negata.

L'unione di tutte queste policy è chiamata policy applicabile o policy effettiva per la risorsa.

In Google Cloud, puoi ottenere un elenco di tutte le policy di autorizzazione e di negazione che influiscono sull'accesso a un progetto utilizzando il comando gcloud beta projects get-ancestors-iam-policy con il flag --include-deny. Insieme, queste policy costituiscono la policy applicabile al progetto. Puoi esaminare ogni policy per vedere in che modo influisce sull'accesso dell'entità.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.

Esegui il comando gcloud beta projects get-ancestors-iam-policy:

Linux, macOS o Cloud Shell

gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json

Windows (PowerShell)

gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json

Windows (cmd.exe)

gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json

La risposta contiene le policy di autorizzazione e di negazione per il progetto, per tutte le cartelle che sono predecessori del progetto e per l'organizzazione. L'esempio seguente mostra le policy di autorizzazione per l'organizzazione 1234567890123 e il progetto my-project, nonché una policy di negazione per il progetto my-project:

[
  {
    "id": "1234567890123",
    "policy": {
      "bindings": [
        {
          "members": [
            "group:cloud-admins@example.com"
          ],
          "role": "roles/iam.denyAdmin"
        },
        {
          "members": [
            "user:raha@example.com"
          ],
          "role": "roles/iam.serviceAccountAdmin"
        }
      ],
      "etag": "BwXW6Eab7TI=",
      "version": 1
    },
    "type": "organization"
  },
  {
    "id": "my-project",
    "policy": {
      "bindings": [
        {
          "members": [
            "group:cloud-admins@example.com"
          ],
          "role": "roles/owner"
        }
      ],
      "etag": "BwXXjOM7L6M=",
      "type": "project"
    }
  },
  {
    "id": "my-project",
    "policy": {
      "createTime": "2022-02-14T21:46:35.865279Z",
      "displayName": "My deny policy",
      "etag": "MTgyMzg2ODcwNTEyMjMxMTM3Mjg=",
      "kind": "DenyPolicy",
      "name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F123456789012/denypolicies/my-deny-policy",
      "rules": [
        {
          "denyRule": {
            "deniedPermissions": [
              "iam.googleapis.com/serviceAccounts.create"
            ],
            "deniedPrincipals": [
              "user:raha@example.com"
            ]
          },
          "description": "Prevent service account creation"
        }
      ],
      "uid": "c83e3dc3-d8a6-6f51-4018-814e9f200b05",
      "updateTime": "2022-02-14T21:46:35.865279Z"
    },
    "type": "project"
  }
]

In questo esempio, a Raha viene concesso il ruolo Amministratore service account (roles/iam.serviceAccountAdmin) nell'organizzazione, ma il progetto ha una policy di negazione che impedisce a Raha di utilizzare l'autorizzazione iam.googleapis.com/serviceAccounts.create. Di conseguenza, se Raha tenta di creare un account di servizio nel progetto my-project, la richiesta verrà rifiutata.

In alcuni casi, potresti dover visualizzare solo la policy di autorizzazione effettiva per una risorsa, ad esempio se la tua organizzazione non utilizza policy di negazione. In questi casi, puoi utilizzare i seguenti metodi per visualizzare la policy di autorizzazione effettiva:

  • Visualizza la policy di autorizzazione IAM della risorsa nella consoleGoogle Cloud . La console Google Cloud mostra automaticamente la policy effettiva di ogni risorsa.

    Per scoprire come visualizzare la policy di autorizzazione IAM di una risorsa nella consoleGoogle Cloud , consulta Visualizza l'accesso corrente.

  • Utilizza l'API Cloud Asset per ottenere la policy di autorizzazione effettiva della risorsa. Per scoprire di più, consulta Visualizzazione delle policy IAM effettive.

Visualizza tutte le policy di accesso unificato che si applicano a una risorsa

Per visualizzare tutte le UAP che si applicano a una risorsa di destinazione, segui questi passaggi:

Console

  1. Identifica tutte le risorse padre della risorsa di destinazione. Le risorse principali sono tutti i progetti, le cartelle e le organizzazioni sopra la risorsa nella gerarchia delle risorse.
  2. Visualizza la UAP associata a ogni risorsa principale. Se la UAP menziona l'entità, potrebbe influire sull'accesso dell'entità alla risorsa di destinazione.

gcloud

  1. Identifica tutte le risorse padre della risorsa di destinazione. Le risorse principali sono tutti i progetti, le cartelle e le organizzazioni sopra la risorsa nella gerarchia delle risorse.
  2. Elenca le associazioni UAP per la risorsa di destinazione e per ciascuno dei suoi predecessori. Registra gli ID delle policy in ogni associazione.
  3. Visualizza ogni UAP in ogni associazione che hai recuperato. Se la UAP menziona l'entità, potrebbe influire sull'accesso dell'entità alla risorsa di destinazione.

REST

  1. Identifica tutte le risorse padre della risorsa di destinazione. Le risorse principali sono tutti i progetti, le cartelle e le organizzazioni sopra la risorsa nella gerarchia delle risorse.
  2. Elenca le associazioni UAP per la risorsa di destinazione e per ciascuno dei suoi predecessori. Registra gli ID delle policy in ogni associazione.
  3. Visualizza ogni UAP in ogni associazione che hai recuperato. Se la UAP menziona l'entità, potrebbe influire sull'accesso dell'entità alla risorsa di destinazione.