Questa pagina mostra configurazioni di esempio per la condivisione delle risorse tra origini (CORS). Quando imposti una configurazione CORS su un bucket, consenti le interazioni tra risorse di origini diverse, cosa 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 dei tuoi utenti di richiedere risorse
dal bucket. In base alla seguente configurazione, le richieste preflight sono
valide per 1 ora e le richieste del browser riuscite restituiscono l'Content-Type
della
risorsa nella risposta.
Riga di comando
Comando gcloud di esempio
gcloud storage buckets update gs://example_bucket --cors-file=example_cors_file.json
File JSON di esempio contenente la configurazione CORS
[ { "origin": ["https://your-example-website.appspot.com"], "method": ["GET"], "responseHeader": ["Content-Type"], "maxAgeSeconds": 3600 } ]
Per maggiori informazioni 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 della risorsa 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, vedi Formato di configurazione CORS per XML.
Rimuovere 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 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.
Il seguente esempio rimuove qualsiasi configurazione CORS esistente da 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.
Il seguente esempio rimuove qualsiasi configurazione CORS esistente da 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.
Il seguente esempio rimuove qualsiasi configurazione CORS esistente da 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.
Il seguente esempio rimuove qualsiasi configurazione CORS esistente da 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.
Il seguente esempio rimuove qualsiasi configurazione CORS esistente da 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.
Il seguente esempio rimuove qualsiasi configurazione CORS esistente da 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.
Il seguente esempio rimuove qualsiasi configurazione CORS esistente da 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.
Il seguente esempio 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 della risorsa 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, vedi Formato di configurazione CORS per XML.
Passaggi successivi
- Scopri di più sulla condivisione delle risorse tra origini (CORS).
- Imposta e visualizza la configurazione CORS in un bucket.