Creazione e gestione di criteri dell'organizzazione personalizzati

I criteri dell'organizzazione Google Cloud ti offrono un controllo centralizzato e programmatico sulle risorse della tua 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 relativi discendenti nella gerarchia delle risorse Google Cloud. Puoi applicare i criteri dell'organizzazione a livello di organizzazione, cartella o progetto.

I criteri dell'organizzazione forniscono vincoli predefiniti per vari servizi Google Cloud. Tuttavia, se vuoi un maggiore controllo dei criteri dell'organizzazione, puoi creare criteri personalizzati per l'organizzazione.

Questa pagina descrive come visualizzare, creare e gestire le policy personalizzate dell'organizzazione. 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 saperne di più su cosa sono i vincoli e i criteri dell'organizzazione e su come funzionano, consulta la Introduzione al servizio di criteri dell'organizzazione.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire le norme dell'organizzazione, chiedi all'amministratore di concederti il ruolo IAM Amministratore delle norme dell'organizzazione (roles/orgpolicy.policyAdmin) nell'organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

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

Autorizzazioni obbligatorie

Per gestire le norme 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 ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Vincoli personalizzati

Un vincolo personalizzato viene creato in un file YAML che specifica le risorse, i metodi, le condizioni e le azioni soggette al vincolo. Questi sono specifici per il servizio su cui stai applicando i criteri dell'organizzazione. Le condizioni per il vincolo personalizzato vengono definite utilizzando il linguaggio Common Expression Language (CEL).

Configurare un vincolo personalizzato

Puoi creare una limitazione personalizzata e configurarla 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 Norme dell'organizzazione.

    Vai a Criteri dell'organizzazione

  2. Seleziona il selettore del progetto nella parte superiore della pagina.

  3. Dal selettore di progetti, seleziona la risorsa per cui vuoi impostare il criterio dell'organizzazione.

  4. Fai clic su Vincolo personalizzato.

  5. Nella casella Nome visualizzato, inserisci un nome facile da ricordare 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 che vuoi assegnare al nuovo vincolo personalizzato. Una limitazione personalizzata deve iniziare con custom. e può includere solo lettere maiuscole, lettere minuscole o numeri, ad esempio custom.disableGkeAutoUpgrade. La lunghezza massima di questo campo è di 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 chiara 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 di Google Cloud contenente l'oggetto e il campo che vuoi limitare, ad esempio container.googleapis.com/NodePool. Esistono un massimo di 20 vincoli personalizzati per tipo di risorsa. Se tenti di 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 la limitazione su un metodo REST CREATE o su entrambi i metodi CREATE e UPDATE. Non tutti i servizi Google Cloud supportano entrambi i metodi. Per visualizzare i metodi supportati per ogni servizio, individua il servizio nella sezione Servizi supportati.

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

    1. Nel riquadro Aggiungi condizione, crea una condizione CEL che fa riferimento a una risorsa di servizio supportata, ad esempioresource.management.autoUpgrade == false. Questo campo ha una lunghezza massima di 1000 caratteri. Per informazioni dettagliate sull'utilizzo di CEL, consulta Common Expression Language. Per ulteriori informazioni sulle risorse di servizio che puoi utilizzare nei vincoli personalizzati, consulta Servizi supportati dai vincoli personalizzati.

    2. Fai clic su Salva.

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

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

    L'azione consenti indica che l'operazione di creazione o aggiornamento della risorsa è consentita solo se la condizione ha valore true. Tutti gli altri casi, tranne quelli elencati esplicitamente nella condizione, sono bloccati.

  12. Fai clic su Crea vincolo.

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

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 della tua organizzazione, ad esempio 123456789.

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

  • RESOURCE_NAME: il nome completamente qualificato della risorsa REST di Google Cloud contenente l'oggetto e il campo che vuoi limitare. Ad esempio, container.googleapis.com/NodePool. È possibile definire 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 saperne di più sulle risorse di servizio che puoi utilizzare nei vincoli personalizzati, consulta Servizi supportati dai vincoli personalizzati.

  • METHOD1,METHOD2: un elenco di metodi RESTful per i quali applicare la limitazione. Può essere CREATE o CREATE e UPDATE. Non tutti i servizi Google Cloud supportano entrambi i metodi. Per visualizzare i metodi supportati per ogni servizio, individua 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 informazioni dettagliate sull'utilizzo di CEL, consulta Common Expression Language.

  • ACTION: l'azione da intraprendere se viene soddisfatto il criterio condition. Può essere ALLOW o DENY.

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

    L'azione allow indica che se la condizione restituisce true, l'operazione di creazione o aggiornamento della risorsa è consentita. Ciò significa anche che tutti gli altri casi, tranne quello elencato esplicitamente nella condizione, sono bloccati.

  • DISPLAY_NAME: un nome facile da ricordare per la limitazione. Questo campo ha una lunghezza massima di 200 caratteri.

  • DESCRIPTION: una descrizione comprensibile del vincolo da visualizzare come messaggio di errore in caso di violazione del criterio. Questo campo ha una lunghezza massima di 2000 caratteri.

Dopo aver creato il file YAML per un nuovo vincolo personalizzato, devi configurarlo per renderlo disponibile per i criteri dell'organizzazione nella tua organizzazione. Per impostare 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 delle limitazioni personalizzate. Ad esempio: /home/user/customconstraint.yaml. Al termine, i vincoli personalizzati sono disponibili come criteri dell'organizzazione nell'elenco dei criteri dell'organizzazione di Google Cloud. Per verificare che la limitazione personalizzata esista, 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 della tua organizzazione. Per ulteriori informazioni, consulta Visualizzare i criteri dell'organizzazione.

Aggiornare un vincolo personalizzato

Puoi aggiornare una limitazione personalizzata modificandola nella console Google Cloud o creando un nuovo file YAML e utilizzando di nuovo il comando set-custom-constraint gcloud CLI. Non è prevista la gestione delle versioni dei vincoli personalizzati, pertanto il vincolo personalizzato esistente viene sovrascritto. Se il vincolo personalizzato è già applicato, il vincolo personalizzato aggiornato ha effetto immediato.

Console

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

    Vai a Criteri dell'organizzazione

  2. Seleziona il selettore del progetto nella parte superiore della pagina.

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

  4. Seleziona il vincolo da modificare dall'elenco nella pagina Criteri organizzazione. Dovrebbe essere visualizzata la pagina Dettagli norme 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 vincolo o il tipo di risorsa una volta 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 della tua organizzazione, ad esempio 123456789.

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

  • RESOURCE_NAME: il nome completamente qualificato della risorsa REST di 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 dai vincoli personalizzati.

  • METHOD1,METHOD2: un elenco di metodi RESTful per i quali applicare la limitazione. Può essere CREATE o CREATE e UPDATE. Non tutti i servizi Google Cloud supportano entrambi i metodi. Per visualizzare i metodi supportati per ogni servizio, individua 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 informazioni dettagliate sull'utilizzo di CEL, consulta Common Expression Language.

  • ACTION: l'azione da intraprendere se viene soddisfatto il criterio condition. Può essere ALLOW o DENY.

  • DISPLAY_NAME: un nome facile da ricordare per la limitazione. Questo campo ha una lunghezza massima di 200 caratteri.

  • DESCRIPTION: una descrizione comprensibile del vincolo da visualizzare come messaggio di errore in caso di violazione del criterio. Questo campo ha una lunghezza massima di 2000 caratteri.

Dopo aver creato il file YAML per un nuovo vincolo personalizzato, devi configurarlo per renderlo disponibile per i criteri dell'organizzazione nella tua organizzazione. Per impostare 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 delle limitazioni personalizzate. Ad esempio: /home/user/customconstraint.yaml. Al termine, i vincoli personalizzati sono disponibili come criteri dell'organizzazione nell'elenco dei criteri dell'organizzazione di Google Cloud. Per verificare che la limitazione personalizzata esista, 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 della tua organizzazione. Per ulteriori informazioni, consulta Visualizzare i criteri dell'organizzazione.

Eliminare un vincolo personalizzato

Puoi eliminare una limitazione personalizzata utilizzando la console Google Cloud o Google Cloud CLI.

Console

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

    Vai a Criteri dell'organizzazione

  2. Seleziona il selettore del progetto nella parte superiore della pagina.

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

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

  5. Fai clic su Elimina.

  6. Per confermare di voler eliminare la limitazione, fai clic su Elimina.

gcloud

Per eliminare una limitazione personalizzata, 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 della tua 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, i criteri creati utilizzando quel 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 e eseguire prove di tutte le modifiche ai criteri della tua 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 nel tuo 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 durante il controllo, ma le azioni in violazione non vengono negate. 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 configurato, un vincolo personalizzato funziona in modo identico ai vincoli booleani predefiniti. Google Cloud controlla prima i vincoli personalizzati quando valuta se una richiesta dell'utente è consentita. Se una delle norme dell'organizzazione personalizzata nega la richiesta, questa viene rifiutata. Google Cloud controlla quindi la presenza di criteri dell'organizzazione predefiniti applicati a quella risorsa.

Puoi applicare un vincolo booleano creando un criterio dell'organizzazione che lo richiami e poi applicando questo criterio dell'organizzazione a una risorsa Google Cloud.

Console

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

    Vai a Criteri dell'organizzazione

  2. Nel selettore di progetti, seleziona il progetto per cui vuoi impostare il criterio dell'organizzazione.
  3. Nell'elenco della pagina Criteri organizzazione, seleziona il vincolo per visualizzare la pagina Dettagli criterio relativa al vincolo in questione.
  4. Per configurare il criterio dell'organizzazione per questa risorsa, fai clic su Gestisci criterio.
  5. Nella pagina Modifica criterio, seleziona Ignora criterio della risorsa padre.
  6. Fai clic su Aggiungi una regola.
  7. Nella sezione Applicazione, seleziona se l'applicazione di questo criterio dell'organizzazione è attivata o disattivata.
  8. (Facoltativo) Per rendere il criterio dell'organizzazione condizionale su 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 non condizionale, altrimenti il criterio non può essere salvato. Per ulteriori informazioni, consulta Impostare un criterio dell'organizzazione con tag.
  9. Se si tratta di un vincolo personalizzato, puoi fare clic su Prova modifiche per simulare l'effetto di questo criterio dell'organizzazione. Per ulteriori informazioni, consulta Testare le modifiche ai criteri dell'organizzazione con Policy Simulator.
  10. Per completare e applicare il criterio dell'organizzazione, fai clic su Imposta criterio. L'applicazione del criterio può richiedere 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 su 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 la limitazione, esegui il seguente comando: 

    gcloud org-policies set-policy POLICY_PATH

Sostituisci POLICY_PATH con il percorso completo del file YAML del criterio dell'organizzazione. L'applicazione del criterio può richiedere fino a 15 minuti.

Vincolo di esempio

Puoi definire vincoli personalizzati simili a quelli predefiniti forniti da Google. Un tipico file YAML vincolo personalizzato ha il seguente aspetto:

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 Common Expression Language (CEL) per valutare le condizioni relative ai vincoli personalizzati. CEL è un linguaggio open source non Turing completo che implementa la semantica comune per la valutazione delle espressioni.

Ogni servizio che supporta i vincoli personalizzati rende disponibile un determinato insieme di risorse e i campi di queste risorse. I campi disponibili sono fortemente tipizzati e possono essere richiamati direttamente dai vincoli personalizzati.

Puoi creare condizioni CEL che fanno riferimento ai campi delle risorse di servizio in base al tipo di campo. Organization Policy Service supporta un sottoinsieme di tipi di dati, espressioni e macro CEL. Le sezioni seguenti elencano i tipi di dati disponibili, nonché le espressioni e le macro comuni che funzionano con questi tipi di dati.

Per informazioni dettagliate sulle espressioni e sulle macro disponibili per ciascun servizio, consulta Servizi supportati dai vincoli personalizzati.

L'esempio JSON seguente mostra ciascuno dei potenziali tipi di campi a cui puoi fare riferimento utilizzando i 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 viene valutata come true. Puoi combinare le espressioni con and (&&) e or (||) 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 di stringa, come stringValue nell'esempio precedente, possono essere valutati utilizzando un valore letterale di 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".

I campi nidificati, come nestedStringValue nell'esempio precedente, devono essere riferito con il 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, true o false.

Elenco

I campi di elenco, come listValue nell'esempio precedente, possono essere valutati in base alle dimensioni dell'elenco, ai contenuti dell'elenco e all'esistenza di un determinato elemento all'interno 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".

Mappa

I campi mappa, come mapValue nell'esempio precedente, sono coppie chiave-valore che possono essere valutate 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".

Risolvere i problemi relativi agli errori CEL

Una condizione creata con espressioni non valide o mancate corrispondenze di tipo restituisce un errore quando provi a configurare il vincolo personalizzato. Ad esempio, dato il seguente vincolo personalizzato non valido, che confronta una stringa con un 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 impostare questa limitazione 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 segnalati con un'icona Errore. Se evidenzi questa icona, viene visualizzata una descrizione comando contenente ulteriori informazioni sull'errore di sintassi.

Il servizio Organization Policy compila e convalida le condizioni che crei, restituendo un errore se la condizione non è sintatticamente corretta. Tuttavia, esistono determinate condizioni che vengono compilate, ma generano un errore quando Google Cloud tenta di applicare le limitazioni. Ad esempio, se configuri una limitazione con una condizione che tenta di accedere a un indice di elenco o a una chiave mappa non esistente, la limitazione non va a buon fine e restituisce un errore al momento dell'applicazione, bloccando qualsiasi tentativo di creare la risorsa.

Quando crei condizioni che dipendono da elementi di elenchi o mappe, ti consigliamo di iniziare la condizione con un controllo che ne garantisca la validità in tutti i casi. Ad esempio, controlla list.size() prima di fare riferimento a un determinato elemento dell'elenco o utilizza has() prima di fare riferimento a un elemento della mappa.

Servizi supportati

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

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

Passaggi successivi