Il servizio Criteri dell'organizzazione offre un controllo centralizzato e programmatico sulle risorse della tua organizzazione. Come amministratore dei criteri dell'organizzazione, puoi definire un criterio dell'organizzazione, un insieme di restrizioni denominate vincoli che si applicano le risorse Google Cloud e i discendenti di queste risorse nel Gerarchia delle risorse di Google Cloud. Puoi applicare i criteri dell'organizzazione all'indirizzo a livello di organizzazione, cartella o progetto.
I criteri dell'organizzazione forniscono vincoli predefiniti per vari servizi Google Cloud. Tuttavia, se vuoi più granulare, personalizzabile controllo sui campi specifici con restrizioni nella tua organizzazione criteri, puoi anche creare vincoli personalizzati e applicarli dei vincoli in un criterio dell'organizzazione personalizzato.
Per Cloud Next Generation Firewall, puoi creare e applicare vincoli sui seguenti criteri firewall:
I vincoli personalizzati si applicano a tutte le regole del criterio firewall, incluse le regole predefinite aggiunte quando viene creato un criterio firewall. Per ulteriori informazioni sulle regole dei criteri firewall predefinite, consulta Regole predefinite.
Eredità dei criteri
Per impostazione predefinita, i criteri dell'organizzazione vengono ereditati dai discendenti delle risorse su cui applichi il criterio. Ad esempio, se applichi un criterio a una cartella, Google Cloud lo applica a tutti i progetti contenuti nella cartella. Per scoprire di più su questo comportamento e su come modificarlo, consulta Regole di valutazione della gerarchia.
Risorse supportate da Cloud NGFW
Per i criteri firewall, puoi impostare vincoli personalizzati su quanto segue risorse e campi.
- Criteri firewall:
compute.googleapis.com/FirewallPolicy
- Nome regola:
resource.rules[].ruleName
- Descrizione:
resource.rules[].description
- Priorità:
resource.rules[].priority
- Azione:
resource.rules[].action
- Direzione:
resource.rules[].direction
- Il logging è attivo:
resource.rules[].enableLogging
- Disattivato:
resource.rules[].disabled
- Gruppo di profili di sicurezza:
resource.rules[].securityProfileGroup
- L'ispezione TLS è abilitata:
resource.rules[].tlsInspect
- Account di servizio di destinazione:
resource.rules[].targetServiceAccounts[]
- Tag target sicuri:
resource.rules[].targetSecureTags[]
- Nome:
resource.rules[].targetSecureTags[].name
- Nome:
- Risorse di destinazione:
resource.rules[].targetResources
- Intervalli IP di origine:
resource.rules[].match.srcIpRanges[]
- Intervalli IP di destinazione:
resource.rules[].match.destIpRanges[]
- Layer4Config:
resource.rules[].match.layer4Configs[]
- Protocollo IP:
match.layer4Configs[].ipProtocol
- Porte:
resource.rules[].match.layer4Configs[].ports[]
- Protocollo IP:
- Tag protetti di origine:
resource.rules[].match.srcSecureTags[]
- Nome:
resource.rules[].match.srcSecureTags[].name
- Nome:
- Gruppi di indirizzi di origine:
resource.rules[].match.srcAddressGroups[]
- Gruppi di indirizzi di destinazione:
resource.rules[].match.destAddressGroups[]
- Nomi di dominio completi di origine:
resource.rules[].match.srcFqdns[]
- Nomi di dominio completi di destinazione:
resource.rules[].match.destFqdns[]
- Codici regione di origine:
resource.rules[].match.srcReigonCodes[]
- Codici regione di destinazione:
resource.rules[].match.destReigonCodes[]
- Elenchi di origine di Threat Intelligence di rete:
resource.rules[].match.srcThreatIntelligences[]
- Elenchi di Threat intelligence di rete di destinazione:
resource.rules[].match.destThreatIntelligences[]
- Nome regola:
Prima di iniziare
-
Se non l'hai già fatto, configura l'autenticazione.
L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione
Compute Engine selezionando una delle seguenti opzioni:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Assicurati di conoscere ID organizzazione.
-
Amministratore criteri dell'organizzazione (
roles/orgpolicy.policyAdmin
) nella risorsa dell'organizzazione -
Per testare le limitazioni:
-
Amministratore rete Compute (
roles/compute.networkAdmin
) del progetto -
Utente account di servizio (
roles/iam.serviceAccountUser
) del progetto
-
Amministratore rete Compute (
-
orgpolicy.constraints.list
-
orgpolicy.policies.create
-
orgpolicy.policies.delete
-
orgpolicy.policies.list
-
orgpolicy.policies.update
-
orgpolicy.policy.get
-
orgpolicy.policy.set
Nella console Google Cloud, vai alla pagina Criteri dell'organizzazione.
Seleziona il selettore di progetti nella parte superiore della pagina.
Nel Selettore di progetti, seleziona la risorsa per cui vuoi impostare il criterio dell'organizzazione.
Fai clic su
Vincolo personalizzato.Nella casella Nome visualizzato, inserisci un nome semplice per la di blocco. Questo campo ha una lunghezza massima di 200 caratteri. Non utilizzare PII o dati sensibili nei nomi dei vincoli, perché potrebbero essere essere esposti nei messaggi di errore.
Nella casella ID vincolo, inserisci il nome per il nuovo un vincolo personalizzato. Un vincolo personalizzato deve iniziare con
custom.
e può includere solo lettere maiuscole, lettere minuscole o numeri, per ad esempiocustom.createFirewallPolicy
. La lunghezza massima di questo campo è 70 senza contare il prefisso, ad esempioorganizations/123456789/customConstraints/custom.
.Nella casella Descrizione, inserisci una descrizione semplice per il del vincolo che viene visualizzato come messaggio di errore quando il criterio viene violato. Questo campo ha una lunghezza massima di 2000 caratteri.
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,
compute.googleapis.com/FirewallPolicy
.In Metodo di applicazione, scegli se applicare il vincolo solo sul metodo REST
CREATE
o sia sul metodo RESTCREATE
UPDATE
metodi.Per definire una condizione, fai clic su
Modifica condizione:Nel riquadro Aggiungi condizione, crea una condizione CEL che fa riferimento a una risorsa di servizio supportata. Questo campo ha un limite massimo di 1000 caratteri.
Fai clic su Salva.
In Azione, seleziona se consentire o negare il metodo valutato se viene soddisfatta la condizione precedente.
Fai clic su Crea vincolo.
ORGANIZATION_ID
: l'ID della tua organizzazione, ad esempio123456789
.CONSTRAINT_NAME
: il nome che vuoi assegnare al nuovo vincolo personalizzato. Un vincolo personalizzato deve iniziare concustom.
e può includere solo lettere maiuscole, lettere minuscole o numeri, ad esempiocustom.createFirewallPolicy
. La lunghezza massima di questo campo è di 70 caratteri, senza contare il prefisso, ad esempioorganizations/123456789/customConstraints/custom
.RESOURCE_NAME
: il nome (non l'URI) della risorsa REST dell'API Compute Engine contenente l'oggetto e il campo che vuoi limitare. Ad esempio,FirewallPolicy
.METHOD1,METHOD2,...
: un elenco di Metodi RESTful per cui applicare il vincolo. Può essereCREATE
oCREATE
eUPDATE
.CONDITION
: una condizione CEL scritta in base a una rappresentazione di una risorsa di servizio supportata. Questo campo ha una lunghezza massima di 1000 caratteri. Consulta: Risorse supportate per ulteriori informazioni sugli e risorse disponibili per scrivere le condizioni.ACTION
: l'azione da intraprendere se viene soddisfatto il criteriocondition
. Può essereALLOW
oDENY
.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.- Nella console Google Cloud, vai alla pagina Norme dell'organizzazione.
- Dal selettore di progetti, scegli il progetto per il quale vuoi impostare criterio dell'organizzazione.
- Nell'elenco della pagina Criteri dell'organizzazione, seleziona il vincolo per visualizzare la pagina Dettagli dei criteri relativa al vincolo in questione.
- Per configurare il criterio dell'organizzazione per questa risorsa, fai clic su Gestisci criterio.
- Nella pagina Modifica criterio, seleziona Sostituisci criterio della risorsa padre.
- Fai clic su Aggiungi una regola.
- Nella sezione Applicazione, seleziona se l'applicazione di questo criterio dell'organizzazione è attivata o disattivata.
- (Facoltativo) 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 non condizionale, altrimenti il criterio non può essere salvato. Per maggiori informazioni le informazioni, vedi Impostazione di un criterio dell'organizzazione con i tag.
- 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, vedi Testa le modifiche ai criteri dell'organizzazione con Policy Simulator.
- Per completare e applicare il criterio dell'organizzazione, fai clic su Imposta criterio. Le norme sono necessari fino a 15 minuti prima che le modifiche diventino effettive.
-
PROJECT_ID
: il progetto su cui vuoi applicare in modo forzato i tuoi di blocco. -
CONSTRAINT_NAME
: il nome definito per il vincolo personalizzato. Per ad esempio
.custom.createFirewallPolicy
Crea un file del vincolo
enforceLoggingEnabled.yaml
con le seguenti informazioni.name: organizations/ORGANIZATION_ID/customConstraints/custom.enforceLoggingEnabled resource_types: compute.googleapis.com/FirewallPolicy condition: "resource.rules.exists(rule, rule.action != 'goto_next' && rule.enableLogging == false)" action_type: DENY method_types: [CREATE, UPDATE] display_name: Enforce that all rules have logging enabled description: Firewall policy rules with action other than goto_next can only be created when firewall rules logging is enabled.
Sostituisci
ORGANIZATION_ID
con l'ID della tua organizzazione.Imposta il vincolo personalizzato.
gcloud org-policies set-custom-constraint enforceLoggingEnabled.yaml
Crea un file di criteri
enforceLoggingEnabled-policy.yaml
con fornite nell'esempio seguente e applicare questo vincolo a livello di progetto. Puoi impostarlo anche a livello di organizzazione o cartella livello.name: projects/PROJECT_ID/policies/custom.enforceLoggingEnabled spec: rules: – enforce: true
Sostituisci
PROJECT_ID
con l'ID progetto.Applica il criterio.
gcloud org-policies set-policy enforceLoggingEnabled-policy.yaml
Per testare la limitazione, crea una regola del criterio firewall che consenta il traffico TCP in entrata sulla porta
22
con il logging disattivato.gcloud compute network-firewall-policies create test-fw-policy --global
gcloud compute network-firewall-policies rules create 1000 \ --action ALLOW \ --direction INGRESS \ --firewall-policy test-fw-policy \ --src-ip-ranges 0.0.0.0/0 \ --layer4-configs tcp:22 \ --no-enable-logging \ --global-firewall-policy
L'output è simile al seguente:
ERROR: (gcloud.compute.network-firewall-policies.create) Could not fetch resource: - Operation denied by custom org policy: [customConstraints/custom.enforceLoggingEnabled] :Firewall policy rules with action other than goto_next can only be created when firewall rules logging is enabled.
Elimina il criterio firewall creato nel passaggio precedente.
gcloud compute network-firewall-policies delete test-fw-policy --global
Crea un file di vincoli
restrictFirewallPolicyRulesSshRanges.yaml
con le seguenti informazioni.name: organizations/$ORGANIZATION_ID/customConstraints/custom.restrictFirewallPolicyRulesSshRanges resource_types: compute.googleapis.com/FirewallPolicy condition: "resource.rules.exists(rule, rule.priority < 2147483644 && (rule.direction == 'INGRESS') && !rule.match.srcIpRanges.all(ipRange, ipRange.startsWith('192.168.')) && rule.match.layer4Configs.all(l4config, l4config.ipProtocol == 'tcp' && l4config.ports.all(port, port == '22')) )" action_type: DENY method_types: [CREATE, UPDATE] display_name: Limit firewall policy rules that allow ingress SSH traffic description: Firewall Policy rules that allow ingress SSH traffic can only be created with allowed source ranges.
Sostituisci
ORGANIZATION_ID
con l'ID della tua organizzazione.Imposta il vincolo personalizzato.
gcloud org-policies set-custom-constraint restrictFirewallPolicyRulesSshRanges.yaml
Crea un file di criteri
restrictFirewallPolicyRulesSshRanges-policy.yaml
con le informazioni fornite nell'esempio che segue e applicare a livello di progetto. Puoi anche impostare questo vincolo a livello di organizzazione o di cartella.name: projects/PROJECT_ID/policies/custom.restrictFirewallPolicyRulesSshRanges spec: rules: – enforce: true
Sostituisci
PROJECT_ID
con l'ID progetto.Applica il criterio.
gcloud org-policies set-policy restrictFirewallPolicyRulesSshRanges-policy.yaml
Per testare il vincolo, crea una regola di criterio firewall che consenta Traffico TCP in entrata SSH sulla porta
22
con intervallo IP di origine10.0.0.0/0
.gcloud compute network-firewall-policies create test-fw-policy --global
gcloud compute network-firewall-policies rules create 1000 \ --action ALLOW \ --direction INGRESS \ --firewall-policy test-fw-policy \ --src-ip-ranges 10.0.0.0/8 \ --layer4-configs tcp:22 \ --global-firewall-policy
L'output è simile al seguente:
ERROR: (gcloud.compute.network-firewall-policies.create) Could not fetch resource: - Operation denied by custom org policy: [customConstraints/custom.restrictFirewallPolicyRulesSshRanges]: Firewall Policy rules that allow ingress SSH traffic can only be created with allowed source ranges.
Elimina il criterio firewall creato nel passaggio precedente.
gcloud compute network-firewall-policies delete test-fw-policy --global
- Introduzione al servizio Criteri dell'organizzazione
- Creare e gestire i criteri dell'organizzazione
- Vincoli dei criteri dell'organizzazione
REST
Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Per saperne di più, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per gestire i criteri dell'organizzazione per le risorse Cloud NGFW, chiedi all'amministratore di concederti i seguenti ruoli IAM:
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per gestire i criteri dell'organizzazione per le risorse Cloud NGFW. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per gestire i criteri dell'organizzazione per le risorse Cloud NGFW sono necessarie le seguenti autorizzazioni:
Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati altri ruoli predefiniti.
Configura 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
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 resource_types: compute.googleapis.com/RESOURCE_NAME method_types: – METHOD1 – METHOD2 condition: "CONDITION" action_type: ACTION display_name: DISPLAY_NAME description: DESCRIPTION
Sostituisci quanto segue:
Per saperne di più su come creare un vincolo personalizzato, consulta Definire vincoli personalizzati.
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 comandogcloud org-policies set-custom-constraint
: Sostituiscigcloud org-policies set-custom-constraint CONSTRAINT_PATH
CONSTRAINT_PATH
con il percorso completo del tuo personalizzato. Ad esempio:/home/user/customconstraint.yaml
. Al termine, i vincoli personalizzati saranno disponibili come criteri dell'organizzazione nel tuo elenco di criteri dell'organizzazione di Google Cloud. Per verificare che la limitazione personalizzata esista, utilizza il comandogcloud org-policies list-custom-constraints
: Sostituiscigcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
ORGANIZATION_ID
con l'ID della risorsa dell'organizzazione. Per ulteriori informazioni, consulta Visualizzare i criteri dell'organizzazione.Applicare un vincolo personalizzato
Puoi applicare un vincolo booleano creando un criterio dell'organizzazione che vi faccia riferimento. e applicare il criterio dell'organizzazione a una risorsa Google Cloud.Console
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:
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 richiede fino a 15 minuti.Esempio: crea un vincolo che applichi tutte le regole firewall per abilitare il logging
Questo vincolo impedisce la creazione di regole di criterio firewall senza il logging abilitato. Le regole del criterio firewall con azione
goto_next
sono escluse perché non supportano il logging.gcloud
Esempio: crea un vincolo che imponga a tutte le regole firewall SSH in entrata di avere un intervallo di origine specifico
Questo vincolo impone che le regole del criterio firewall che consentono il traffico SSH in entrata debbano avere intervalli IP di origine che iniziano con il blocco
192.168.
.gcloud
Prezzi
Il servizio Criteri dell'organizzazione, inclusi i criteri predefiniti e personalizzati dell'organizzazione, è offerto senza costi aggiuntivi.
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-11-23 UTC.
-