Limitazione delle località delle risorse

Panoramica

Questa guida descrive come impostare un criterio dell'organizzazione che include le località delle risorse vincolo.

Puoi limitare la località fisica di una nuova risorsa con il Servizio Criteri dell'organizzazione delle località delle risorse. Puoi usare la proprietà location di una risorsa per identificare dove viene eseguito il deployment e la manutenzione dal servizio. Per contenenti dati di alcuni servizi Google Cloud, riflette anche la posizione in cui sono archiviati i dati. Questo vincolo consente definire le località Google Cloud consentite in cui le risorse è possibile creare servizi supportati nella gerarchia.

Dopo aver definito le località delle risorse, questa limitazione si applica solo alle risorse appena create. Risorse create prima di impostare la risorsa il vincolo di località continuerà a esistere e a eseguire la propria funzione.

Un criterio che include questo vincolo non verrà applicato in modo forzato alla risorsa secondaria per determinati servizi, come Cloud Storage e Dataproc.

Limitazioni

Il vincolo del Servizio Criteri dell'organizzazione per le località delle risorse controlla possibilità di creare risorse per le quali è possibile selezionare una località. Questo non influisce sulla posizione delle risorse globali, ad esempio Compute Engine, gli indirizzi globali o le risorse che non supportano la selezione di una località è stato creato.

Per evitare di danneggiare l'infrastruttura di pubblicazione esistente, devi testare tutte le nuove su progetti e cartelle non di produzione, quindi applica il criterio gradualmente all'interno della tua organizzazione.

Per gli impegni per l'archiviazione dei dati, consulta i Termini di servizio di Google Cloud e i Termini specifici dei servizi. Criteri dell'organizzazione che contengono il vincolo delle località delle risorse non sono impegni per l'archiviazione dei dati.

Questo vincolo si applica a un sottoinsieme specifico di prodotti e tipi di risorse. Per un elenco dei servizi supportati e i dettagli sul comportamento di ciascun servizio, vedi Servizi supportati per località delle risorse .

Tipi di località

Puoi eseguire il deployment delle risorse Google Cloud tipi di località che rappresentano categorie di dimensioni diverse. Il tipo di località più grande è multi-region, che include più di una region. Ogni region è ulteriormente suddiviso in zones. Per ulteriori informazioni sulle regioni e sulle zone, consulta Panoramica su regioni e zone.

• Multi-region località è supportata da risorse fisiche in più di una region e in genere sono utilizzati solo dalle risorse basate sullo spazio di archiviazione. Alcuni esempi includono us, asia, europe e global.

• Region località sono geograficamente isolate tra loro. Alcuni esempi includono us-west1 (Oregon), asia-northeast1 (Tokyo) e europe-west1 (Belgio).

• Zone località è il tipo di località isolato più granulare utilizzato per il deployment delle risorse. Un zone è un dominio in errore indipendente all'interno di un region. Alcuni esempi sono us-east1-b, us-west1-b e asia-northeast1-a.

Quando configuri le sedi, devi utilizzare il prefisso in: e un Gruppo di valori: Utilizzo di un gruppo di valori curato da Google Cloud consente di scegliere le posizioni geografiche senza dover specificare delle località Cloud future.

Il prefisso in: a un gruppo di valori specifica che tutti i valori esistenti il gruppo di valori viene considerato parte del criterio. Se inserisci un gruppo o una regione Google Cloud senza il prefisso, il prefisso in: automaticamente, in base a queste regole:

• Se inserisci una località che utilizza il prefisso in: e contiene termini non validi gruppo, la modifica del criterio non andrà a buon fine.
• Se inserisci una località che corrisponde a una regione, come us-east1, questa avrà il valore In questo esempio, il prefisso in: è anteposto a in:us-east1-locations.
• Se inserisci un gruppo di valori per una o più regioni, come us-locations, in questo esempio sarà preceduto dal prefisso in: a in:us-locations.
• Se inserisci una zona o più regioni come us-east1-b o us, i valori non verrà modificato.

Impostazione del criterio dell'organizzazione

Il vincolo delle località delle risorse è un tipo vincolo di elenco. Puoi aggiungere e rimuovere sedi da allowed_values o denied_values di un vincolo di località delle risorse. Per impedire i criteri dell'organizzazione di limitare inaspettatamente il comportamento del servizio quando vengono aggiunte nuove località disponibile, utilizza un gruppo di valori o un elenco allowed_values che rappresenta l'intero confine geografico da per definire.

Per impostare un criteri dell'organizzazione tra cui vincolo delle località delle risorse:

constraint: constraints/gcp.resourceLocations
listPolicy:
    deniedValues:
    - in:us-east1-locations
    - in:northamerica-northeast1-locations

gcloud org-policies set-policy \
    --organization 'ORGANIZATION_ID' \
    POLICY_PATH

name: organizations/01234567890/policies/gcp.resourceLocations
spec:
  rules:
  - values:
      allowedValues:
      - in:us-east1-locations
      - in:northamerica-northeast1-locations

curl -X POST -H "Content-Type: application/json" -H "Authorization: \
Bearer ${bearer_token}" -d '{policy: {etag: "BwVtXec438Y=", constraint: \
"constraints/gcp.resourceLocations", list_policy: {denied_values: \
["in:europe-locations", "in:southamerica-locations"] }}}' \
https://cloudresourcemanager.googleapis.com/v1/organizations/123456789:setOrgPolicy

name: organizations/01234567890/policies/gcp.resourceLocations
spec:
  rules:
  - values:
      deniedValues:
      - in:europe-locations
      - in:southamerica-locations

Per saperne di più sull'uso dei vincoli nei criteri dell'organizzazione, vedi Utilizzo dei vincoli.

Utilizzo dell'ereditarietà nel criterio dell'organizzazione

Puoi perfezionare il criterio dell'organizzazione per ereditarlo da dai nodi padre della risorsa. Ereditarietà offre un controllo granulare sui criteri dell'organizzazione utilizzati nell'intero nella gerarchia delle risorse.

Per abilitare l'ereditarietà su un nodo risorsa, imposta inheritFromParent = true nel del criterio dell'organizzazione .yaml. Ad esempio:

name: organizations/01234567890/policies/gcp.resourceLocations
spec:
  inheritFromParent: true
  rules:
    - values:
        deniedValues:
        - in:us-west1

Esempio di messaggio di errore

I servizi che supportano il vincolo di località delle risorse non sono consentiti creando nuove risorse in località che violerebbero il vincolo. Se il servizio tenta di creare una risorsa in una località che viola le vincolo, il tentativo avrà esito negativo e verrà generato un messaggio di errore.

Questo messaggio di errore avrà il seguente formato: LOCATION_IN_REQUEST violates constraint constraints/gcp.resourceLocations on the resource RESOURCE_TESTED.

Nell'esempio seguente, una risorsa Compute Engine non riesce a creare un nuovo instance a causa dell'applicazione dei criteri:

Location ZONE:us-east1-b violates constraint constraints/gcp.resourceLocations
on the resource
projects/policy-violation-test/zones/us-east1-b/instances/instance-3.

Voce di log di Google Cloud Observability e Cloud Audit Logs:

{
 insertId: "5u759gdngec"
 logName: "projects/policy-violation-test/logs/cloudaudit.googleapis.com%2Factivity"
 protoPayload: {
  @type: "type.googleapis.com/google.cloud.audit.AuditLog"
  authenticationInfo: {…}
  authorizationInfo: [6]
  methodName: "beta.compute.instances.insert"
  request: {…}
  requestMetadata: {…}
  resourceLocation: {…}
  resourceName: "projects/policy-violation-test/zones/us-east1-b/instances/instance-3"
  response: {
   @type: "type.googleapis.com/error"
   error: {
    code: 412
    errors: [
     0: {
      domain: "global"
      location: "If-Match"
      locationType: "header"
      message: "Location ZONE:us-east1-b violates constraint constraints/gcp.resourceLocations on the resource projects/policy-violation-test/zones/us-east1-b/instances/instance-3."
      reason: "conditionNotMet"
     }
    ]
    message: "Location ZONE:us-east1-b violates constraint constraints/gcp.resourceLocations on the resource projects/policy-violation-test/zones/us-east1-b/instances/instance-3."
   }
  }
  serviceName: "compute.googleapis.com"
  status: {
   code: 3
   message: "INVALID_ARGUMENT"
  }
 }
 receiveTimestamp: "2019-06-14T03:04:23.660988360Z"
 resource: {
  labels: {…}
  type: "gce_instance"
 }
 severity: "ERROR"
 timestamp: "2019-06-14T03:04:22.783Z"
}

Vulnerabilità rilevate e correzione

Il vincolo relativo alla località delle risorse limita la creazione di risorse in fase di runtime. Questa funzione aiuta a evitare violazioni della posizione, ma non identificare o correggere violazioni esistenti. Puoi usare Security Health Analytics, uno strumento servizio di Security Command Center, per scoprire le violazioni delle località nella tua risorsa nella gerarchia. Per ulteriori informazioni, vedi Risultati relativi alle vulnerabilità dei criteri dell'organizzazione.

Se vengono rilevati risultati di Security Health Analytics relativi a violazioni della località, consulta Correzione dei risultati di Security Health Analytics per individuare le misure correttive. i risultati.

Gruppi di valori

I gruppi di valori sono raccolte di gruppi e località curate da Google per fornire un modo semplice per definire le località delle risorse. Gruppi di valori includono molte località correlate e vengono ampliate nel tempo da Google senza e non dovrai modificare il criterio dell'organizzazione per adattarlo alle nuove località.

Per utilizzare i gruppi di valori nel criterio dell'organizzazione, aggiungi il prefisso alle voci stringa in:. Per ulteriori informazioni sull'uso dei prefissi di valore, consulta Utilizzo dei vincoli. I nomi dei gruppi vengono convalidati durante la chiamata per impostare il criterio dell'organizzazione. L'utilizzo di un con un nome gruppo non valido, l'impostazione dei criteri avrà esito negativo.

La seguente tabella contiene l'elenco corrente dei gruppi disponibili:

Autenticazione

Il servizio Criteri dell'organizzazione utilizza OAuth 2.0 per l'API l'autenticazione e l'autorizzazione. Per ottenere un token di connessione OAuth 2.0:

1. Vai alla sezione Pagina OAuth 2.0 Playground.

2. Nell'elenco degli ambiti del Passaggio 1, seleziona la API Cloud Resource Manager v2 > https://www.googleapis.com/auth/cloud-platform, e fai clic su Autorizza API.

3. Nella pagina Accedi con Google visualizzata, seleziona il tuo account e accedi in.

4. Per fornire l'accesso a Google Oauth 2.0 Playground, fai clic su Consenti nella che viene visualizzata.

5. Nel Passaggio 2, fai clic su Scambia codice di autorizzazione per i token.

6. Nella parte inferiore del riquadro Richiesta / risposta a destra, i tuoi accessi viene visualizzata la stringa token:

    {
      "access_token": "ACCESS_TOKEN",
      "token_type": "Bearer",
      "expires_in": 3600
    }
   

   Dove ACCESS_TOKEN è la stringa del token di connessione OAuth 2.0 che hai per l'autorizzazione API.