Questa pagina mostra configurazioni di esempio per la condivisione delle risorse tra origini (CORS). Quando imposti una configurazione CORS su un bucket, consenti interazioni tra risorse da origini diverse, cosa che normalmente è vietata per prevenire comportamenti dannosi.
Configurazione CORS di base
Supponiamo che tu abbia un sito web dinamico a cui gli utenti possono
accedere all'indirizzo your-example-website.appspot.com
. Hai un file immagine ospitato in un bucket Cloud Storage denominato your-example-bucket
. Vuoi utilizzare
l'immagine sul tuo sito web, quindi devi applicare una configurazione CORS su
your-example-bucket
che consenta ai browser degli utenti di richiedere risorse
dal bucket. In base alla configurazione seguente, le richieste preflight sono valide per un'ora e le richieste del browser andate a buon fine restituiscono il Content-Type
della risorsa nella risposta.
Riga di comando
Esempio di comando gcloud
gcloud storage buckets update gs://example_bucket --cors-file=example_cors_file.json
Esempio di file JSON contenente la configurazione CORS
[ { "origin": ["https://your-example-website.appspot.com"], "method": ["GET"], "responseHeader": ["Content-Type"], "maxAgeSeconds": 3600 } ]
Per saperne di più su come impostare una configurazione CORS utilizzando Google Cloud CLI, consulta la documentazione di riferimento di gcloud storage buckets update
.
API REST
API JSON
{ "cors": [ { "origin": ["https://your-example-website.appspot.com"], "method": ["GET"], "responseHeader": ["Content-Type"], "maxAgeSeconds": 3600 } ] }
Per il formato generalizzato di un file di configurazione CORS, consulta la rappresentazione delle risorse bucket per JSON.
API XML
<?xml version="1.0" encoding="UTF-8"?> <CorsConfig> <Cors> <Origins> <Origin>https://your-example-website.appspot.com</Origin> </Origins> <Methods> <Method>GET</Method> </Methods> <ResponseHeaders> <ResponseHeader>Content-Type</ResponseHeader> </ResponseHeaders> <MaxAgeSec>3600</MaxAgeSec> </Cors> </CorsConfig>
Per il formato generalizzato di un file di configurazione CORS, consulta la pagina dedicata al formato di configurazione CORS per XML.
Rimuovi le impostazioni CORS da un bucket
Per rimuovere le impostazioni CORS da un bucket, fornisci un file di configurazione CORS vuoto.
Riga di comando
Quando utilizzi il comando gcloud storage buckets update
con il
flag --clear-cors
, rimuovi la configurazione CORS da un bucket:
gcloud storage buckets update gs://BUCKET_NAME --clear-cors
Dove BUCKET_NAME è il nome del bucket di cui vuoi rimuovere la configurazione CORS.
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente rimuove qualsiasi configurazione CORS esistente da un bucket:
C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente rimuove qualsiasi configurazione CORS esistente da un bucket:
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente rimuove qualsiasi configurazione CORS esistente da un bucket:
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente rimuove qualsiasi configurazione CORS esistente da un bucket:
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente rimuove qualsiasi configurazione CORS esistente da un bucket:
PHP
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente rimuove qualsiasi configurazione CORS esistente da un bucket:
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente rimuove qualsiasi configurazione CORS esistente da un bucket:
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente rimuove qualsiasi configurazione CORS esistente da un bucket:
API REST
API JSON
Se impostata su un bucket, la seguente configurazione rimuove tutte le impostazioni CORS da un bucket:
{ "cors": [] }
Per il formato generalizzato di un file di configurazione CORS, consulta la rappresentazione delle risorse bucket per JSON.
API XML
Se impostata su un bucket, la seguente configurazione rimuove tutte le impostazioni CORS da un bucket:
<CorsConfig></CorsConfig>
Per il formato generalizzato di un file di configurazione CORS, consulta la pagina dedicata al formato di configurazione CORS per XML.
Passaggi successivi
- Scopri di più sulla condivisione delle risorse tra origini (CORS).
- Imposta e visualizza la configurazione CORS su un bucket.