Panoramica Esempi di configurazione
La condivisione delle risorse tra origini (CORS) consente interazioni tra risorse di origini diverse, cosa normalmente vietata per prevenire comportamenti dannosi. Utilizza questa pagina per scoprire come impostare una configurazione CORS su un bucket Cloud Storage e come visualizzare la configurazione CORS impostata su un bucket. Consulta Esempi di configurazione per CORS per visualizzare configurazioni CORS di esempio, inclusa quella che disattiva qualsiasi configurazione esistente nel bucket.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per impostare e visualizzare la configurazione CORS
in un bucket, chiedi all'amministratore di concederti il ruolo Amministratore archiviazione
(roles/storage.admin
) nel bucket.
Questo ruolo predefinito contiene le autorizzazioni necessarie per impostare e visualizzare le configurazioni CORS. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.update
Puoi anche ottenere queste autorizzazioni con altri ruoli predefiniti o ruoli personalizzati.
Per informazioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket.
Imposta la configurazione CORS su un bucket
Imposti una configurazione CORS su un bucket specificando informazioni, ad esempio metodi HTTP e domini di origine, che identificano i tipi di richieste che il bucket può accettare.
Per impostare una configurazione CORS sul bucket:
Console
Non puoi gestire CORS utilizzando la Google Cloud console. Utilizza invece gcloud CLI.
Riga di comando
Crea un file JSON con la configurazione CORS che vuoi applicare. Consulta gli esempi di configurazione per visualizzare i file JSON di esempio.
Utilizza il comando
gcloud storage buckets update
con il flag--cors-file
:gcloud storage buckets update gs://BUCKET_NAME --cors-file=CORS_CONFIG_FILE
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.CORS_CONFIG_FILE
è il percorso del file JSON che hai creato nel passaggio 1.
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
L'esempio seguente imposta una configurazione CORS su un bucket:
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
L'esempio seguente imposta una configurazione CORS su un bucket:
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
L'esempio seguente imposta una configurazione CORS su un bucket:
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
L'esempio seguente imposta una configurazione CORS su un bucket:
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
L'esempio seguente imposta una configurazione CORS su un bucket:
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
L'esempio seguente imposta una configurazione CORS su un bucket:
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
L'esempio seguente imposta una configurazione CORS su un bucket:
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
L'esempio seguente imposta una configurazione CORS su un bucket:
API REST
API JSON
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Crea un file JSON con la configurazione CORS che vuoi applicare. Consulta gli esempi di configurazione per visualizzare i file JSON di esempio.
Utilizza
cURL
per chiamare l'API JSON con una richiestaPATCH
Bucket:curl --request PATCH \ 'https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=cors' \ --header 'Authorization: Bearer $(gcloud auth print-access-token)' \ --header 'Content-Type: application/json' \ --data-binary @CORS_CONFIG_FILE
Dove:
BUCKET_NAME
è il nome del bucket. Ad esempio,my-bucket
.CORS_CONFIG_FILE
è il percorso del file JSON che hai creato nel passaggio 2.
API XML
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Crea un file XML con la configurazione CORS che vuoi applicare. Consulta gli esempi di configurazione per visualizzare i file XML di esempio.
Utilizza
cURL
per chiamare l'API XML con una richiestaPUT Bucket
con ambito?cors
:curl -X PUT --data-binary @CORS_CONFIG_FILE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com/BUCKET_NAME?cors"
Dove:
BUCKET_NAME
è il nome del bucket. Ad esempio,my-bucket
.PROJECT_ID
è l'ID del progetto associato al bucket. Ad esempio,my-project
.CORS_CONFIG_FILE
è il percorso del file XML che hai creato nel passaggio 2.
Per rimuovere la configurazione CORS per un bucket, imposta una configurazione CORS vuota.
Visualizza la configurazione CORS per un bucket
Per visualizzare la configurazione CORS per un bucket:
Console
Non puoi gestire CORS utilizzando la Google Cloud console. Utilizza invece gcloud CLI.
Riga di comando
Utilizza il comando gcloud storage buckets describe
con il flag
--format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(cors_config)"
Dove BUCKET_NAME
è il nome del bucket
di cui vuoi visualizzare la configurazione CORS. Ad esempio, my-bucket
.
Librerie client
Per visualizzare la configurazione CORS per un bucket utilizzando le librerie client, segui le istruzioni per visualizzare i metadati di un bucket e cerca il campo CORS nella risposta:
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
API REST
API JSON
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiestaGET
Bucket:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=cors"
Dove
BUCKET_NAME
è il nome del bucket di cui vuoi visualizzare la configurazione CORS. Ad esempio,my-bucket
.
API XML
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiestaGET
Bucket con ambito?cors
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?cors"
Dove
BUCKET_NAME
è il nome del bucket di cui vuoi visualizzare la configurazione CORS. Ad esempio,my-bucket
.
Passaggi successivi
- Esplora gli esempi di configurazione CORS, incluso un esempio che rimuove la configurazione CORS su un bucket.
- Scopri di più su CORS.
- Scopri come risolvere i problemi relativi alle richieste CORS.