Creazione e gestione dei tag

Questa guida descrive come creare e gestire i tag per le risorse del service account.

Informazioni sui tag

Un tag è una coppia chiave-valore che può essere collegata a una risorsa all'interno di Cloud de Confiance by S3NS. Puoi utilizzare i tag per consentire o negare in modo condizionale i criteri a seconda che una risorsa abbia un tag specifico. Ad esempio, puoi concedere in modo condizionale i ruoli IAM (Identity and Access Management) a seconda che una risorsa abbia un tag specifico. Per saperne di più sui tag, consulta la panoramica dei tag.

I tag vengono collegati alle risorse creando una risorsa di associazione tag che collega il valore alla risorsa Cloud de Confiance by S3NS .

Autorizzazioni obbligatorie

Per ottenere le autorizzazioni necessarie per gestire i tag, chiedi all'amministratore di concederti i seguenti ruoli IAM sul account di servizio:

  • Visualizzatore tag (roles/resourcemanager.tagViewer): le risorse a cui sono collegati i tag
  • Visualizza e gestisci i tag a livello di organizzazione: Visualizzatore organizzazione (roles/resourcemanager.organizationViewer): l'organizzazione
  • Crea, aggiorna ed elimina definizioni di tag: Amministratore tag (roles/resourcemanager.tagAdmin): la risorsa per cui stai creando, aggiornando o eliminando tag
  • Associa e rimuovi tag dalle risorse: Utente tag (roles/resourcemanager.tagUser): il valore del tag e le risorse a cui stai associando o rimuovendo il valore del tag

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per ottenere le autorizzazioni necessarie per collegare i tag ai service account, chiedi all'amministratore di concederti il ruolo IAM Service Account Admin (roles/iam.ServiceAccountAdmin) sul account di servizio. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Creare chiavi e valori dei tag

Prima di poter allegare un tag, devi crearne uno e configurarne il valore. Per creare chiavi e valori tag, consulta Creazione di un tag e Aggiunta di un valore tag.

Aggiungere tag alle risorse esistenti

Per aggiungere un tag agli account di servizio esistenti:

gcloud

Per collegare un tag a un account di servizio, devi creare una risorsa di associazione tag utilizzando il comando gcloud resource-manager tags bindings create:

      gcloud resource-manager tags bindings create \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID
      

Sostituisci quanto segue:

  • TAGVALUE_NAME: l'ID permanente o il nome con spazio dei nomi del valore del tag allegato, ad esempio tagValues/567890123456.
  • RESOURCE_ID: l'ID univoco o l'email del account di servizio incluso il nome di dominio dell'API (//iam.googleapis.com/). Ad esempio, l'ID completo di un account di servizio con ID univoco 1029384756 nel progetto test-project è //iam.googleapis.com/projects/test-project/serviceAccounts/1029384756.

Elenca i tag collegati alle risorse

Puoi visualizzare un elenco di associazioni di tag direttamente collegate o ereditate dall'account di servizio.

gcloud

Per ottenere un elenco di associazioni di tag collegate a una risorsa, utilizza il comando gcloud resource-manager tags bindings list:

      gcloud resource-manager tags bindings list \
          --parent=RESOURCE_ID
      

Sostituisci quanto segue:

  • RESOURCE_ID: l'ID univoco o l'email del account di servizio incluso il nome di dominio dell'API (//iam.googleapis.com/). Ad esempio, l'ID completo di un account di servizio con ID univoco 1029384756 nel progetto test-project è //iam.googleapis.com/projects/test-project/serviceAccounts/1029384756.

Dovresti ricevere una risposta simile alla seguente:

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: //iam.googleapis.com/projects/test-project/serviceAccounts/1029384756
      

Scollegare i tag dalle risorse

Puoi scollegare i tag che sono stati collegati direttamente a unaccount di serviziot. I tag ereditati possono essere sostituiti collegando un tag con la stessa chiave e un valore diverso, ma non possono essere scollegati.

gcloud

Per eliminare un'associazione di tag, utilizza il comando gcloud resource-manager tags bindings delete:

      gcloud resource-manager tags bindings delete \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID
      

Sostituisci quanto segue:

  • TAGVALUE_NAME: l'ID permanente o il nome con spazio dei nomi del valore del tag allegato, ad esempio tagValues/567890123456.
  • RESOURCE_ID: l'ID univoco o l'email del account di servizio incluso il nome di dominio dell'API (//iam.googleapis.com/). Ad esempio, l'ID completo di un account di servizio con ID univoco 1029384756 nel progetto test-project è //iam.googleapis.com/projects/test-project/serviceAccounts/1029384756.

Eliminare chiavi e valori dei tag

Quando rimuovi una definizione di chiave o valore tag, assicurati che il tag sia scollegato dal account di serviziot. Prima di eliminare la definizione del tag, devi eliminare gli allegati esistenti, chiamati associazioni di tag. Per eliminare chiavi tag e valori tag, consulta la sezione Eliminare i tag.

Condizioni e tag di Identity and Access Management

Puoi utilizzare i tag e le condizioni IAM per concedere in modo condizionale le associazioni di ruoli agli utenti della gerarchia. La modifica o l'eliminazione del tag associato a una risorsa può rimuovere l'accesso utente a quella risorsa se è stata applicata una policy IAM con associazioni di ruoli condizionali. Per maggiori informazioni, consulta Condizioni e tag di Identity and Access Management.

Passaggi successivi