Creazione e gestione dei criteri dell'organizzazione personalizzati

Google Cloud Organization Policy offre un controllo centralizzato e programmatico sulle risorse dell'organizzazione. In qualità di amministratore dei criteri dell'organizzazione, puoi definire un criterio dell'organizzazione, ovvero un insieme di limitazioni chiamate vincoli che si applicano alle risorse Google Cloud e ai discendenti di queste risorse nella gerarchia delle risorse di Google Cloud. Puoi applicare i criteri dell'organizzazione a livello di organizzazione, cartella o progetto.

Criterio dell'organizzazione fornisce vincoli predefiniti per vari servizi Google Cloud. Tuttavia, per ottenere un maggiore controllo dai criteri dell'organizzazione, puoi creare criteri dell'organizzazione personalizzati.

Questa pagina descrive come visualizzare, creare e gestire i criteri dell'organizzazione personalizzati. I criteri dell'organizzazione personalizzati vengono creati dagli amministratori per fornire un controllo più granulare e personalizzabile sui campi specifici limitati dai criteri dell'organizzazione.

Prima di iniziare

Per ulteriori informazioni su cosa sono i criteri e i vincoli dell'organizzazione e sul loro funzionamento, consulta l'introduzione al servizio Criteri dell'organizzazione.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i criteri dell'organizzazione, chiedi all'amministratore di concederti il ruolo IAM Amministratore criteri organizzazione (roles/orgpolicy.policyAdmin) per l'organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per gestire i criteri dell'organizzazione. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per gestire i criteri dell'organizzazione sono necessarie le seguenti autorizzazioni:

• orgpolicy.constraints.list
• orgpolicy.policies.create
• orgpolicy.policies.delete
• orgpolicy.policies.list
• orgpolicy.policies.update
• orgpolicy.policy.get
• orgpolicy.policy.set

Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.

Vincoli personalizzati

In un file YAML viene creato un vincolo personalizzato che specifica le risorse, i metodi, le condizioni e le azioni soggette al vincolo. Sono specifici per il servizio su cui viene applicato il criterio dell'organizzazione. Le condizioni del vincolo personalizzato vengono definite utilizzando il linguaggio CEL (Common Expression Language).

Configura un vincolo personalizzato

Puoi creare un vincolo personalizzato e configurarlo per l'utilizzo nei criteri dell'organizzazione utilizzando la console Google Cloud o Google Cloud CLI.

Console

1. Nella console Google Cloud, vai alla pagina Criteri dell'organizzazione.

   Vai a Criteri dell'organizzazione

2. Seleziona il selettore di progetti nella parte superiore della pagina.

3. Dal selettore del progetto, scegli la risorsa per cui vuoi impostare il criterio dell'organizzazione.

4. Fai clic su Vincolo personalizzato.

5. Nella casella Nome visualizzato, inserisci un nome intuitivo per il vincolo. Questo campo ha una lunghezza massima di 200 caratteri. Non utilizzare PII o dati sensibili nei nomi visualizzati, perché potrebbero essere esposti nei messaggi di errore.

6. Nella casella ID vincolo, inserisci il nome desiderato per il nuovo vincolo personalizzato. Un vincolo personalizzato deve iniziare con custom. e può includere solo lettere maiuscole, lettere minuscole o numeri, ad esempio custom.disableGkeAutoUpgrade. La lunghezza massima di questo campo è 70 caratteri, senza contare il prefisso, ad esempio organizations/123456789/customConstraints/custom.. Non includere PII o dati sensibili nell'ID vincolo, perché potrebbero essere esposti nei messaggi di errore.

7. Nella casella Descrizione, inserisci una descrizione intuitiva del vincolo da visualizzare come messaggio di errore in caso di violazione del criterio. Questo campo ha una lunghezza massima di 2000 caratteri. Non includere PII o dati sensibili nella descrizione, perché potrebbero essere esposti nei messaggi di errore.

8. Nella casella Tipo di risorsa, seleziona il nome della risorsa REST Google Cloud contenente l'oggetto e il campo che vuoi limitare, ad esempio container.googleapis.com/NodePool. Esiste un massimo di 20 vincoli personalizzati per tipo di risorsa. Se provi a creare un vincolo personalizzato per un tipo di risorsa che ha già 20 vincoli personalizzati, l'operazione non va a buon fine.

9. In Metodo di applicazione, scegli se applicare il vincolo a un metodo CREATE REST o a entrambi i metodi CREATE e UPDATE. Non tutti i servizi Google Cloud supportano entrambi i metodi. Per visualizzare i metodi supportati per ciascun servizio, trova il servizio in Servizi supportati.

10. Per definire una condizione, fai clic su Modifica condizione.

    1. Nel riquadro Aggiungi condizione, crea una condizione CEL che faccia riferimento a una risorsa di servizio supportata, ad esempio resource.management.autoUpgrade == false. Questo campo ha una lunghezza massima di 1000 caratteri. Per dettagli sull'utilizzo della tecnologia CEL, consulta la sezione Common Expression Language. Per ulteriori informazioni sulle risorse di servizio che puoi utilizzare nei vincoli personalizzati, consulta Servizi supportati da vincoli personalizzati.

    2. Fai clic su Salva.

11. In Azione, scegli se consentire o negare il metodo valutato se la condizione precedente è soddisfatta.

    L'azione di negazione significa che l'operazione di creazione o aggiornamento della risorsa viene bloccata se la condizione restituisce true.

    L'azione allow indica che l'operazione di creazione o aggiornamento della risorsa è consentita solo se la condizione è true. Tutti gli altri casi, ad eccezione di quelli esplicitamente elencati nella condizione, vengono bloccati.

12. Fai clic su Crea vincolo.

Dopo aver inserito un valore in ogni campo, la configurazione YAML equivalente per questo vincolo personalizzato viene visualizzata a destra.

gcloud

Per creare un vincolo personalizzato utilizzando Google Cloud CLI, crea un file YAML per il vincolo personalizzato:

name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes:
- RESOURCE_NAME
methodTypes:
- METHOD1
- METHOD2
condition: "CONDITION"
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID organizzazione, ad esempio 123456789.

• CONSTRAINT_NAME: il nome del nuovo vincolo personalizzato. Un vincolo personalizzato deve iniziare con custom. e può includere solo lettere maiuscole, lettere minuscole o numeri, ad esempio custom.disableGkeAutoUpgrade. La lunghezza massima di questo campo è 70 caratteri, senza contare il prefisso, ad esempio organizations/123456789/customConstraints/custom..

• RESOURCE_NAME: il nome completo della risorsa REST Google Cloud contenente l'oggetto e il campo che vuoi limitare. Ad esempio, container.googleapis.com/NodePool. È previsto un massimo di 20 vincoli personalizzati per tipo di risorsa. Se provi a creare un vincolo personalizzato per un tipo di risorsa che ha già 20 vincoli personalizzati, l'operazione non va a buon fine. Per ulteriori informazioni sulle risorse di servizio che puoi utilizzare nei vincoli personalizzati, consulta Servizi supportati dai vincoli personalizzati.

• METHOD1,METHOD2: un elenco di metodi RESTful per cui applicare il vincolo. Può essere CREATE o CREATE e UPDATE. Non tutti i servizi Google Cloud supportano entrambi i metodi. Per visualizzare i metodi supportati per ciascun servizio, trova il servizio in Servizi supportati.

• CONDITION: una condizione CEL che fa riferimento a una risorsa di servizio supportata, ad esempio "resource.management.autoUpgrade == false". Questo campo ha una lunghezza massima di 1000 caratteri. Per dettagli sull'utilizzo della tecnologia CEL, consulta la sezione Common Expression Language.

• ACTION: l'azione da eseguire se condition viene soddisfatto. Il valore può essere ALLOW o DENY.

  L'azione di negazione significa che se la condizione restituisce true, l'operazione per creare o aggiornare la risorsa viene bloccata.

  L'azione allow significa che se la condizione restituisce true, l'operazione per creare o aggiornare la risorsa è consentita. Ciò significa anche che vengono bloccati tutti gli altri casi, ad eccezione di quello esplicitamente elencato nella condizione.

• DISPLAY_NAME: un nome intuitivo per il vincolo. Questo campo ha una lunghezza massima di 200 caratteri.

• DESCRIPTION: una descrizione intuitiva del vincolo da mostrare come messaggio di errore quando viene violata la norma. Questo campo ha una lunghezza massima di 2000 caratteri.

Dopo aver creato un nuovo vincolo personalizzato utilizzando Google Cloud CLI, devi configurarlo per renderlo disponibile per i criteri dell'organizzazione nella tua organizzazione. Per configurare un vincolo personalizzato, utilizza il comando gcloud org-policies set-custom-constraint:

gcloud org-policies set-custom-constraint CONSTRAINT_PATH

Sostituisci CONSTRAINT_PATH con il percorso completo del file del vincolo personalizzato. Ad esempio: /home/user/customconstraint.yaml. Al termine, troverai i vincoli personalizzati come criteri dell'organizzazione disponibili nell'elenco dei criteri dell'organizzazione di Google Cloud. Per verificare l'esistenza del vincolo personalizzato, utilizza il comando gcloud org-policies list-custom-constraints:

gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID

Sostituisci ORGANIZATION_ID con l'ID della risorsa dell'organizzazione. Per maggiori informazioni, vedi Visualizzare i criteri dell'organizzazione.

Aggiorna un vincolo personalizzato

Puoi aggiornare un vincolo personalizzato modificandolo nella console Google Cloud o creando un nuovo file YAML e utilizzando di nuovo il comando gcloud CLI set-custom-constraint. Non esiste il controllo delle versioni dei vincoli personalizzati, quindi questo sovrascrive il vincolo personalizzato esistente. Se è già applicato in modo forzato, il vincolo personalizzato aggiornato ha effetto immediato.

Console

1. Nella console Google Cloud, vai alla pagina Criteri dell'organizzazione.

   Vai a Criteri dell'organizzazione

2. Seleziona il selettore di progetti nella parte superiore della pagina.

3. Dal selettore dei progetti, scegli la risorsa per cui vuoi aggiornare il criterio dell'organizzazione.

4. Seleziona il vincolo da modificare dall'elenco nella pagina Criteri dell'organizzazione. Dovrebbe essere visualizzata la pagina Dettagli criterio relativa al vincolo.

5. Fai clic su Modifica vincolo.

6. Apporta modifiche al nome visualizzato, alla descrizione, al metodo di applicazione, alla condizione e all'azione. Non puoi modificare l'ID o il tipo di risorsa dopo aver creato il vincolo.

7. Fai clic su Salva modifiche.

gcloud

Per modificare un vincolo personalizzato esistente utilizzando Google Cloud CLI, crea un nuovo file YAML contenente le modifiche che vuoi apportare:

name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes:
- RESOURCE_NAME
methodTypes:
- METHOD1
- METHOD2
condition: "CONDITION"
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID organizzazione, ad esempio 123456789.

• CONSTRAINT_NAME: il nome del nuovo vincolo personalizzato. Un vincolo personalizzato deve iniziare con custom. e può includere solo lettere maiuscole, lettere minuscole o numeri, ad esempio custom.disableGkeAutoUpgrade. La lunghezza massima di questo campo è 70 caratteri, senza contare il prefisso, ad esempio organizations/123456789/customConstraints/custom..

• RESOURCE_NAME: il nome completo della risorsa REST Google Cloud contenente l'oggetto e il campo che vuoi limitare. Ad esempio, container.googleapis.com/NodePool. Per ulteriori informazioni sulle risorse di servizio che puoi utilizzare nei vincoli personalizzati, consulta Servizi supportati da vincoli personalizzati.

• METHOD1,METHOD2: un elenco di metodi RESTful per cui applicare il vincolo. Può essere CREATE o CREATE e UPDATE. Non tutti i servizi Google Cloud supportano entrambi i metodi. Per visualizzare i metodi supportati per ciascun servizio, trova il servizio in Servizi supportati.

• CONDITION: una condizione CEL che fa riferimento a una risorsa di servizio supportata, ad esempio "resource.management.autoUpgrade == false". Questo campo ha una lunghezza massima di 1000 caratteri. Per dettagli sull'utilizzo della tecnologia CEL, consulta la sezione Common Expression Language.

• ACTION: l'azione da eseguire se condition viene soddisfatto. Il valore può essere ALLOW o DENY.

• DISPLAY_NAME: un nome intuitivo per il vincolo. Questo campo ha una lunghezza massima di 200 caratteri.

• DESCRIPTION: una descrizione intuitiva del vincolo da mostrare come messaggio di errore quando viene violata la norma. Questo campo ha una lunghezza massima di 2000 caratteri.

Dopo aver creato un nuovo vincolo personalizzato utilizzando Google Cloud CLI, devi configurarlo per renderlo disponibile per i criteri dell'organizzazione nella tua organizzazione. Per configurare un vincolo personalizzato, utilizza il comando gcloud org-policies set-custom-constraint:

gcloud org-policies set-custom-constraint CONSTRAINT_PATH

Sostituisci CONSTRAINT_PATH con il percorso completo del file del vincolo personalizzato. Ad esempio: /home/user/customconstraint.yaml. Al termine, troverai i vincoli personalizzati come criteri dell'organizzazione disponibili nell'elenco dei criteri dell'organizzazione di Google Cloud. Per verificare l'esistenza del vincolo personalizzato, utilizza il comando gcloud org-policies list-custom-constraints:

gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID

Sostituisci ORGANIZATION_ID con l'ID della risorsa dell'organizzazione. Per maggiori informazioni, vedi Visualizzare i criteri dell'organizzazione.

Elimina un vincolo personalizzato

Puoi eliminare un vincolo personalizzato utilizzando la console Google Cloud o Google Cloud CLI.

Console

1. Nella console Google Cloud, vai alla pagina Criteri dell'organizzazione.

   Vai a Criteri dell'organizzazione

2. Seleziona il selettore di progetti nella parte superiore della pagina.

3. Dal selettore dei progetti, scegli la risorsa per cui vuoi eliminare il criterio dell'organizzazione.

4. Seleziona il vincolo da eliminare dall'elenco nella pagina Criteri dell'organizzazione. Dovrebbe essere visualizzata la pagina Dettagli criterio relativa al vincolo.

5. Fai clic su Elimina.

6. Per confermare l'eliminazione del vincolo, fai clic su Elimina.

gcloud

Per eliminare un vincolo personalizzato, utilizza il comando org-policies delete-custom-constraint gcloud CLI:

gcloud org-policies delete-custom-constraint custom.CONSTRAINT_NAME \
  --organization=ORGANIZATION_ID

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID organizzazione, ad esempio 123456789.

• CONSTRAINT_NAME: il nome del vincolo personalizzato. Ad esempio, custom.disableGkeAutoUpgrade.

L'output è simile al seguente:

Deleted custom constraint [organizations/123456789/customConstraints/custom.disableGkeAutoUpgrade]

Se elimini un vincolo personalizzato, tutti i criteri creati utilizzando questo vincolo continuano a esistere, ma vengono ignorati. Non puoi creare un altro vincolo personalizzato con lo stesso nome di un vincolo personalizzato eliminato.

Testare e analizzare le modifiche ai criteri dell'organizzazione

Ti consigliamo di testare ed eseguire tutte le modifiche ai criteri dell'organizzazione per comprendere meglio lo stato del tuo ambiente e in che modo le modifiche lo influenzano.

Policy Simulator per i criteri dell'organizzazione ti aiuta a comprendere l'effetto di un vincolo e di un criterio dell'organizzazione sul tuo ambiente attuale. Con questo strumento, puoi esaminare tutte le configurazioni delle risorse per vedere dove si verificano le violazioni prima che vengano applicate nell'ambiente di produzione. Per istruzioni dettagliate, consulta Testare le modifiche ai criteri dell'organizzazione con Policy Simulator.

Una volta compreso l'effetto attuale, puoi creare un criterio dell'organizzazione in modalità di prova per comprendere l'impatto e le potenziali violazioni di un criterio nei prossimi 30 giorni. Un criterio dell'organizzazione in modalità di prova è un tipo di criterio dell'organizzazione in cui le violazioni del criterio vengono registrate, ma le azioni in violazione non vengono rifiutate. Puoi creare un criterio dell'organizzazione in modalità di prova da un vincolo personalizzato utilizzando la console Google Cloud o Google Cloud CLI. Per istruzioni dettagliate, consulta Creare un criterio dell'organizzazione in modalità di prova.

Applicare un criterio dell'organizzazione personalizzato

Una volta impostato, un vincolo personalizzato funziona in modo identico ai vincoli booleani predefiniti. Google Cloud controlla prima i vincoli personalizzati durante la valutazione dell'autorizzazione di una richiesta dell'utente. Se uno o più criteri personalizzati dell'organizzazione rifiutano la richiesta, questa viene rifiutata. Quindi, Google Cloud verifica la presenza di criteri predefiniti dell'organizzazione applicati alla risorsa.

Puoi applicare un vincolo booleano creando un criterio dell'organizzazione che vi faccia riferimento e applicando questo criterio a una risorsa Google Cloud.

Console

Per applicare un vincolo booleano:

1. Nella console Google Cloud, vai alla pagina Criteri dell'organizzazione.

   Vai a Criteri dell'organizzazione

2. Seleziona il selettore di progetti nella parte superiore della pagina.
3. Dal selettore dei progetti, scegli il progetto per cui vuoi impostare il criterio dell'organizzazione.
4. Seleziona il vincolo dall'elenco nella pagina Criteri dell'organizzazione. Viene visualizzata la pagina Dettagli criterio per tale vincolo.
5. Per configurare il criterio dell'organizzazione per questa risorsa, fai clic su Gestisci criterio.
6. Nella pagina Modifica criterio, seleziona Sostituisci criterio del padre.
7. Fai clic su Aggiungi una regola.
8. In Applicazione, scegli se l'applicazione di questo criterio dell'organizzazione deve essere attivata o disattivata.
9. Facoltativamente, per rendere condizionale il criterio dell'organizzazione a un tag, fai clic su Aggiungi condizione. Tieni presente che se aggiungi una regola condizionale a un criterio dell'organizzazione, devi aggiungere almeno una regola senza condizioni, altrimenti il criterio non potrà essere salvato. Per maggiori dettagli, consulta Configurare un criterio dell'organizzazione con tag.
10. Se si tratta di un vincolo personalizzato, puoi fare clic su Testa modifiche per simulare l'effetto di questo criterio dell'organizzazione. Per maggiori informazioni, consulta Testare le modifiche ai criteri dell'organizzazione con Policy Simulator.
11. Per completare e applicare il criterio dell'organizzazione, fai clic su Imposta criterio. L'applicazione del criterio richiederà fino a 15 minuti.

gcloud

Per creare un criterio dell'organizzazione che applichi un vincolo booleano, crea un file YAML del criterio che faccia riferimento al vincolo:

      name: projects/PROJECT_ID/policies/CONSTRAINT_NAME
      spec:
        rules:
        - enforce: true
    

Sostituisci quanto segue:

• PROJECT_ID: il progetto a cui vuoi applicare il vincolo.
• CONSTRAINT_NAME: il nome definito per il vincolo personalizzato. Ad esempio, custom.disableGkeAutoUpgrade.

Per applicare il criterio dell'organizzazione contenente il vincolo, esegui questo comando:

    gcloud org-policies set-policy POLICY_PATH
    

Sostituisci POLICY_PATH con il percorso completo del file YAML dei criteri dell'organizzazione. L'applicazione del criterio richiederà fino a 15 minuti.

Vincolo di esempio

Puoi definire vincoli personalizzati simili ai vincoli predefiniti forniti da Google. Un tipico file YAML di vincoli personalizzati è simile al seguente:

name: organizations/1234567890123/customConstraints/custom.disableGkeAutoUpgrade
resourceTypes:
- container.googleapis.com/NodePool
methodTypes:
- CREATE
- UPDATE
condition: "resource.management.autoUpgrade == false"
actionType: ALLOW
displayName: Disable GKE auto upgrade
description: Only allow GKE NodePool resource to be created or updated if AutoUpgrade is not enabled where this custom constraint is enforced.

Common Expression Language

Il servizio criteri dell'organizzazione utilizza il linguaggio CEL (Common Expression Language) per valutare le condizioni dei vincoli personalizzati. Il CEL è un linguaggio completo open source non Turing che implementa una semantica comune per la valutazione delle espressioni.

Ogni servizio che supporta vincoli personalizzati rende disponibile un determinato insieme di risorse e campi di queste risorse. I campi disponibili sono di tipo forte e possono fare riferimento direttamente a vincoli personalizzati.

Puoi creare condizioni CEL che fanno riferimento ai campi delle risorse del servizio in base al tipo di campo. Il servizio criteri dell'organizzazione supporta un sottoinsieme di tipi di dati, espressioni e macro CEL. Le sezioni seguenti elencano i tipi di dati disponibili e le espressioni e le macro comuni che li utilizzano.

• Numero intero
• Stringa
• Booleano
• Elenca
• Mappa

Per i dettagli su quali espressioni e macro sono disponibili per ogni servizio, consulta Servizi supportati da vincoli personalizzati.

Il seguente esempio JSON mostra ciascuno dei potenziali tipi di campo a cui puoi fare riferimento utilizzando vincoli personalizzati:

{
  integerValue: 1
  stringValue: "A text string"
  booleanValue: true
  nestedValue: {
    nestedStringValue: "Another text string"
  }
  listValue: [foo, bar]
  mapValue["costCenter"] == "123"
}

Per ogni espressione CEL, il vincolo personalizzato viene applicato quando la condizione restituisce true. Puoi combinare espressioni con e (&&) e o (||) per creare una query complessa. Quando crei il file YAML o JSON per il vincolo personalizzato, racchiudi la query completa tra virgolette doppie (").

Numero intero

I campi interi, come integerValue nell'esempio precedente, consentono di utilizzare gli operatori di confronto nelle condizioni. Ad esempio:

resource.integerValue == 1
resource.integerValue > 5
resource.integerValue < 10

Stringa

I campi stringa, come stringValue nell'esempio precedente, possono essere valutati utilizzando un valore letterale stringa, un'espressione regolare o un'espressione CEL. Ad esempio:

resource.stringValue == "abc"
// stringValue is exactly "abc".

resource.stringValue.matches("dev$")
// stringValue matches a regular expression, which specifies the string ends
// with the word "dev".

resource.stringValue.startsWith("startValue")
// stringValue starts with "startValue".

resource.stringValue.endsWith("endValue")
// stringValue ends with "endValue".

resource.stringValue.contains("fooBar")
// stringValue contains "fooBar".

Ai campi nidificati come nestedStringValue nell'esempio precedente deve essere fatto riferimento al percorso completo. Ad esempio:

resource.nestedValue.nestedStringValue == "foo"
// nestedValue contains the object nestedStringValue, which has a value of "foo".

Booleano

I campi booleani, come booleanValue nell'esempio precedente, contengono un valore booleano, ovvero true o false.

Elenco

I campi elenco, come listValue nell'esempio precedente, possono essere valutati in base alle dimensioni dell'elenco, ai contenuti dell'elenco e all'eventuale presenza di un determinato elemento in qualsiasi punto dell'elenco.

Ad esempio:

resource.listValue.size() >= 1 && resource.listValue[0] == "bar"
// listValue has size greater than or equal to one, and the first element is "bar".

resource.listValue.exists(value, value == "foo")
// listValue has at least one element that is exactly "foo".

resource.listValue.all(value, value.contains("foo"))
// listValue is a list of values that are all exactly "foo".

Avviso: l'esecuzione di una query su un valore di un elenco inesistente restituisce un errore BAD_CONDITION. Questo errore blocca la creazione della risorsa specificata in cui viene applicato il criterio dell'organizzazione personalizzato. Per evitare questo errore, utilizza i metodi all(), any() o exists(). Se vuoi eseguire una query su un determinato indice, verifica innanzitutto che l'indice esista utilizzando il metodo size(). Ad esempio, listValue.size() >= 1 && resource.listValue[0] == "bar".

Mappa

I campi mappa, come mapValue nell'esempio precedente, sono coppie chiave-valore valutabili in base all'esistenza e al valore di determinati elementi.

Ad esempio:

has(resource.mapValue.foo) && resource.mapValue.foo == "bar"
// mapValue contains the key "foo", and that key has the value "bar".

Avviso: l'esecuzione di query su un valore mappa inesistente restituisce un errore BAD_CONDITION. Questo errore blocca la creazione della risorsa specificata in cui viene applicato il criterio dell'organizzazione personalizzato. Per evitare questo errore, verifica sempre che il valore esista prima utilizzando il metodo has(). Ad esempio, has(map.key) && map.key == "value".

Risoluzione dei problemi relativi agli errori CEL

Una condizione creata con espressioni non valide o errate corrispondenze di tipo restituisce un errore quando tenti di configurare il vincolo personalizzato. Ad esempio, considerato il seguente vincolo personalizzato non valido, che confronta una stringa con un numero intero:

name: organizations/1234567890123/customConstraints/custom.badConfig
resourceTypes:
- dataproc.googleapis.com/Cluster
methodTypes:
- CREATE
- UPDATE
condition: "resource.config.masterConfig.numInstances == 'mismatch'"
actionType: ALLOW
displayName: Number of instances is a string
description: Demonstrate that type mismatches cause an error.

Se provi a configurare il vincolo utilizzando Google Cloud CLI, viene generato un errore:

ERROR: (gcloud.org-policies.set-custom-constraint) INVALID_ARGUMENT: Custom constraint condition [resource.config.masterConfig.numInstances == "mismatch"] is invalid. Error: ERROR: <input>:1:15: found no matching overload for '_==_' applied to '(int, string)' (candidates: (%A0, %A0))
 | resource.config.masterConfig.numInstances == "mismatch"
 | ..........................................^.

Nella console Google Cloud, gli errori di sintassi CEL non validi verranno contrassegnati con un'icona Errore . Se evidenzia questa icona viene visualizzata una descrizione comando contenente ulteriori informazioni sull'errore di sintassi.

Il servizio criteri dell'organizzazione compila e convalida le condizioni che hai creato, restituendo un errore se la condizione non è sintatticamente corretta. Tuttavia, esistono alcune condizioni che si compilano, ma generano un errore quando Google Cloud tenta di applicare i vincoli. Ad esempio, se configuri un vincolo con una condizione che tenta di accedere a un indice dell'elenco o a una chiave di mappa inesistente, il vincolo ha esito negativo e restituisce un errore al momento dell'applicazione, e blocca qualsiasi tentativo di creare la risorsa.

Quando crei condizioni che dipendono da elementi elenco o della mappa, ti consigliamo di iniziare la condizione con un controllo che garantisca che sia valida in tutti i casi. Ad esempio, seleziona list.size() prima di fare riferimento a un particolare elemento dell'elenco o usa has() prima di fare riferimento a un elemento della mappa.

Servizi supportati

Ogni servizio definisce l'insieme di campi di vincoli personalizzati che possono essere utilizzati per applicare i criteri dell'organizzazione alle risorse di servizio. Per un elenco dei servizi che supportano i vincoli personalizzati, consulta Servizi supportati per i vincoli personalizzati.

Per ulteriori informazioni sulla configurazione di uno scanner dei criteri dell'organizzazione, consulta Risultati di vulnerabilità dei criteri dell'organizzazione.

Passaggi successivi

• Scopri di più sui vincoli in dettaglio.
• Scopri le opzioni aggiuntive che puoi utilizzare per personalizzare le norme.
• Scopri come impostare i criteri dell'organizzazione basati sui tag.
• Scopri di più sulla convalida e sul monitoraggio dei criteri dell'organizzazione con lo strumento di convalida della configurazione.