Cloud Key Management Service offre la possibilità di aggiungere etichette alle tue chiavi Cloud KMS. Le etichette sono coppie chiave-valore che puoi utilizzare per raggruppare le chiavi Cloud KMS correlate e archiviare i metadati di una chiave Cloud KMS.
Le etichette sono incluse nella fattura, pertanto puoi vedere come sono distribuiti i costi nelle varie etichette.
Puoi aggiungere, aggiornare e rimuovere le etichette delle chiavi utilizzando Google Cloud CLI e l'API REST di Cloud KMS.
Puoi utilizzare le etichette con altre risorse Google Cloud , ad esempio risorse di macchine virtuali e bucket di archiviazione. Per saperne di più sull'utilizzo delle etichette in Google Cloud, vedi Creare e gestire le etichette.
Cosa sono le etichette?
Un'etichetta è una coppia chiave-valore che puoi assegnare alle chiavi Cloud KMS. Google Cloud Ti aiutano a organizzare queste risorse e a gestire i costi su larga scala, con la granularità di cui hai bisogno. Puoi collegare un'etichetta a ogni risorsa, quindi filtrare le risorse in base alle etichette. Le informazioni relative alle etichette vengono inoltrate al sistema di fatturazione che ti consente di suddividere gli addebiti fatturati per etichetta. Con i report sulla fatturazione integrati, puoi filtrare e raggruppare i costi in base alle etichette delle risorse. Puoi anche utilizzare le etichette per interrogare le esportazioni dei dati di fatturazione.
Requisiti per le etichette
Le etichette applicate a una risorsa devono soddisfare i seguenti requisiti:
- Ogni risorsa può avere fino a 64 etichette.
- Ogni etichetta deve essere una coppia chiave-valore.
- Le chiavi hanno una lunghezza minima di 1 carattere e una lunghezza massima di 63 caratteri e non possono essere vuote. I valori possono essere vuoti e avere una lunghezza massima di 63 caratteri.
- Le chiavi e i valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Tutti i caratteri devono utilizzare la codifica UTF-8 e sono consentiti i caratteri internazionali. Le chiavi devono iniziare con una lettera minuscola o un carattere internazionale.
- La parte della chiave di un'etichetta deve essere univoca all'interno di una singola risorsa. Tuttavia, puoi utilizzare la stessa chiave con più risorse.
Questi limiti si applicano alla chiave e al valore di ogni etichetta e alle singole risorse Google Cloud che hanno etichette. Non esiste un limite al numero di etichette che puoi applicare a tutte le risorse all'interno di un progetto.
Utilizzi comuni delle etichette
Ecco alcuni casi d'uso comuni per le etichette:
Etichette di team o centro di costo: aggiungi etichette basate su team o centro di costo per distinguere le chiavi Cloud KMS di proprietà di team diversi (ad esempio,
team:research
eteam:analytics
). Puoi utilizzare questo tipo di etichetta per la contabilità dei costi o la definizione del budget.Etichette dei componenti: ad esempio,
component:redis
,component:frontend
,component:ingest
ecomponent:dashboard
.Etichette di ambiente o fase: ad esempio,
environment:production
eenvironment:test
.Etichette di stato: ad esempio,
state:active
,state:readytodelete
estate:archive
.Etichette di proprietà: utilizzate per identificare i team responsabili delle operazioni, ad esempio:
team:shopping-cart
.
Non è consigliabile creare un numero elevato di etichette uniche, ad esempio per timestamp o valori individuali per ogni chiamata API. Il problema di questo approccio è che quando i valori cambiano frequentemente o con chiavi che ingombrano il catalogo, diventa difficile filtrare e generare report in modo efficace sulle risorse.
Etichette e tag
Le etichette possono essere utilizzate come annotazioni interrogabili per le risorse, ma non possono essere utilizzate per impostare condizioni per i criteri. I tag forniscono un modo per consentire o negare in modo condizionale i criteri a seconda che una risorsa abbia un tag specifico, fornendo un controllo granulare sui criteri. Per ulteriori informazioni, consulta la panoramica dei tag.
Creazione di una chiave con etichette
Quando crei una chiave, puoi aggiungere etichette fornendo una o più coppie chiave-valore come etichette.
Console
Nella console Google Cloud , vai alla pagina Key Management.
Fai clic sul nome del keyring per cui vuoi creare una chiave.
Fai clic su Crea chiave.
In Nome chiave, inserisci un nome per la chiave.
Configura la chiave in base alle tue esigenze.
Fai clic su Impostazioni aggiuntive.
Per ogni etichetta da aggiungere, fai clic su Aggiungi etichetta e poi inserisci la chiave e il valore.
Fai clic su Crea.
gcloud
Per utilizzare Cloud KMS dalla riga di comando, devi prima installare o eseguire l'upgrade all'ultima versione di Google Cloud CLI.
Questo esempio mostra come creare una nuova chiave e assegnarle etichette. Puoi anche aggiungere etichette a una chiave esistente.
gcloud kms keys create KEY_NAME \ --keyring KEY_RING \ --location LOCATION \ --purpose PURPOSE \ --labels "LABEL_LIST"
Sostituisci quanto segue:
KEY_NAME
: il nome della chiave.KEY_RING
: il portachiavi in cui vuoi creare la chiave.LOCATION
: la posizione del portachiavi, ad esempioglobal
.PURPOSE
: lo scopo della chiave, ad esempioencryption
.LABEL_LIST
: un elenco separato da virgole di coppie chiave-valore, in cui ogni coppia è formattata comeLABEL_KEY=LABEL_VALUE
. Ad esempioenv=prod,team=research
. Ogni chiave dell'etichetta può essere utilizzata una sola volta su una chiave Cloud Key Management Service. Se una chiave di etichetta viene specificata più volte con valori diversi, ogni nuovo valore sovrascrive il precedente.
Per informazioni su tutti i flag e i valori possibili, esegui il comando con il flag
--help
.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C# Cloud KMS.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Cloud KMS.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java Cloud KMS.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Cloud KMS.
PHP
Per eseguire questo codice, scopri innanzitutto come utilizzare PHP su Google Cloud e installa l'SDK PHP di Cloud KMS.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Cloud KMS.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Cloud KMS.
API
Aggiungi etichette quando crei una nuova chiave utilizzando il metodo CryptoKeys.create
e includi la proprietà labels
nel corpo della richiesta. Ad esempio:
{
"purpose": "ENCRYPT_DECRYPT",
"labels": [
{
"key": "LABEL_KEY",
"value": "LABEL_VALUE"
}
]
}
Sostituisci quanto segue:
LABEL_KEY
: la chiave dell'etichetta, ad esempioenv
.LABEL_VALUE
: il valore dell'etichetta, ad esempioprod
.
Puoi aggiungere più chiavi di etichetta, ciascuna con il proprio valore. Ogni chiave di etichetta può essere utilizzata una sola volta su una chiave di Cloud Key Management Service. Se una chiave di etichetta viene specificata più volte con valori diversi, ogni nuovo valore sovrascrive il precedente.
Visualizzazione delle etichette su una chiave
Console
Nella console Google Cloud , vai alla pagina Key Management.
Fai clic sul nome del keyring per la chiave che vuoi ispezionare.
Nell'intestazione, fai clic su Mostra riquadro informazioni.
Nel riquadro, scegli la scheda Etichette.
gcloud
Per utilizzare Cloud KMS dalla riga di comando, devi prima installare o eseguire l'upgrade all'ultima versione di Google Cloud CLI.
gcloud kms keys describe KEY_NAME \ --keyring KEY_RING \ --location LOCATION
Sostituisci quanto segue:
KEY_NAME
: il nome della chiave per cui vuoi visualizzare le etichette.KEY_RING
: il nome delle chiavi automatizzate che contengono la chiave.LOCATION
: la posizione del portachiavi.
Per informazioni su tutti i flag e i valori possibili, esegui il comando con il flag
--help
.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C# Cloud KMS.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Cloud KMS.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java Cloud KMS.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Cloud KMS.
PHP
Per eseguire questo codice, scopri innanzitutto come utilizzare PHP su Google Cloud e installa l'SDK PHP di Cloud KMS.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Cloud KMS.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Cloud KMS.
API
Questi esempi utilizzano curl come client HTTP per dimostrare l'utilizzo dell'API. Per saperne di più sul controllo dell'accesso, consulta Accesso all'API Cloud KMS.
Per visualizzare le etichette applicate al tasto, utilizza il metodo
CryptoKeys.get
:
curl "https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME" \ --request "GET" \ --header "authorization: Bearer TOKEN" \ --header "content-type: application/json" \ --header "x-goog-user-project: PROJECT_ID"
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto che contiene il portachiavi.KEY_NAME
: il nome della chiave per cui vuoi visualizzare le etichette.KEY_RING
: il nome delle chiavi automatizzate che contengono la chiave.LOCATION
: la posizione del portachiavi.
Aggiunta o aggiornamento di etichette
Console
Nella console Google Cloud , vai alla pagina Key Management.
Fai clic sul nome del keyring per la chiave che vuoi ispezionare.
Nell'intestazione, fai clic su Mostra riquadro informazioni.
Nel riquadro, scegli la scheda Etichette.
Modifica il valore di un'etichetta direttamente nel campo di testo corrispondente.
Modifica la chiave di un'etichetta aggiungendo una nuova etichetta con il nome della chiave che preferisci ed elimina la vecchia etichetta facendo clic su Elimina
accanto all'etichetta che vuoi eliminare.Fai clic su Salva.
gcloud
Per utilizzare Cloud KMS dalla riga di comando, devi prima installare o eseguire l'upgrade all'ultima versione di Google Cloud CLI.
gcloud kms keys update KEY_NAME \ --keyring KEY_RING \ --location LOCATION \ --update-labels "LABEL_LIST"
KEY_NAME
: il nome della chiave.KEY_RING
: le chiavi automatizzate che contengono la chiave.LOCATION
: la posizione del portachiavi.LABEL_LIST
: un elenco separato da virgole di coppie chiave-valore, in cui ogni coppia è formattata comeLABEL_KEY=LABEL_VALUE
. Ad esempioenv=prod,team=research
. Ogni chiave dell'etichetta può essere utilizzata una sola volta su una chiave Cloud Key Management Service. Se una chiave di etichetta viene specificata più volte con valori diversi, ogni nuovo valore sovrascrive il precedente.
Per informazioni su tutti i flag e i valori possibili, esegui il comando con il flag
--help
.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C# Cloud KMS.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Cloud KMS.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java Cloud KMS.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Cloud KMS.
PHP
Per eseguire questo codice, scopri innanzitutto come utilizzare PHP su Google Cloud e installa l'SDK PHP di Cloud KMS.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Cloud KMS.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Cloud KMS.
API
Questi esempi utilizzano curl come client HTTP per dimostrare l'utilizzo dell'API. Per saperne di più sul controllo dell'accesso, consulta Accesso all'API Cloud KMS.
Aggiungi o aggiorna le etichette di una chiave esistente utilizzando il metodo
CryptoKeys.patch
e includi la proprietà labels
nel corpo della richiesta. Ad esempio:
{
"labels": [
{
"key": "LABEL_KEY",
"value": "LABEL_VALUE"
}
]
}
Rimozione di etichette
Console
Nella console Google Cloud , vai alla pagina Key Management.
Fai clic sul nome del keyring per la chiave che vuoi ispezionare.
Nell'intestazione, fai clic su Mostra riquadro informazioni.
Nel riquadro, scegli la scheda Etichette.
Fai clic sull'icona Elimina
accanto alle etichette da eliminare.Fai clic su Salva.
gcloud
Per utilizzare Cloud KMS dalla riga di comando, devi prima installare o eseguire l'upgrade all'ultima versione di Google Cloud CLI.
gcloud kms keys update KEY_NAME \ --keyring KEY_RING \ --location LOCATION \ --remove-labels "LABEL_KEYS"
KEY_NAME
: il nome della chiave.KEY_RING
: le chiavi automatizzate che contengono la chiave.LOCATION
: la posizione del portachiavi.LABEL_LIST
: un elenco separato da virgole di chiavi di etichette che vuoi rimuovere dalla chiave, ad esempioenv,team
.
Per informazioni su tutti i flag e i valori possibili, esegui il comando con il flag
--help
.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C# Cloud KMS.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Cloud KMS.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java Cloud KMS.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Cloud KMS.
PHP
Per eseguire questo codice, scopri innanzitutto come utilizzare PHP su Google Cloud e installa l'SDK PHP di Cloud KMS.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Cloud KMS.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Cloud KMS.
API
Questi esempi utilizzano curl come client HTTP per dimostrare l'utilizzo dell'API. Per saperne di più sul controllo dell'accesso, consulta Accesso all'API Cloud KMS.
Rimuovi le etichette da una chiave esistente utilizzando il metodo
CryptoKeys.patch e includi la proprietà labels
come array vuoto nel corpo della richiesta. Ad esempio:
{
"labels": []
}
Audit logging
Cloud Audit Logs per Cloud KMS può essere utilizzato per registrare le informazioni sulle etichette quando le chiavi vengono create o aggiornate. La creazione e gli aggiornamenti delle chiavi sono entrambe attività amministrative e le modifiche alle etichette vengono annotate nel log attività amministrative.