Cross Origin Resource Sharing (CORS) memungkinkan interaksi antara resource dari origin yang berbeda, sesuatu yang biasanya dilarang untuk mencegah perilaku berbahaya. Gunakan halaman ini untuk mempelajari cara menetapkan konfigurasi CORS pada bucket Cloud Storage dan cara melihat konfigurasi yang ditetapkan pada bucket. Lihat Contoh konfigurasi untuk CORS untuk mengetahui contoh konfigurasi CORS, termasuk konfigurasi yang menonaktifkan konfigurasi yang ada di bucket Anda.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk menetapkan dan melihat konfigurasi CORS di bucket, minta administrator untuk memberi Anda peran Storage Admin (roles/storage.admin
) di bucket.
Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk menetapkan dan melihat konfigurasi CORS. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
storage.buckets.get
storage.buckets.update
Anda juga bisa mendapatkan izin ini dengan peran standar atau peran khusus lainnya.
Untuk mengetahui informasi tentang cara memberikan peran pada bucket, lihat Menggunakan IAM dengan bucket.
Menetapkan konfigurasi CORS pada bucket
Anda menetapkan konfigurasi CORS pada bucket dengan menentukan informasi, seperti metode HTTP dan domain asal, yang mengidentifikasi jenis permintaan yang dapat diterima bucket.
Gunakan langkah-langkah berikut untuk menetapkan konfigurasi CORS di bucket Anda:
Konsol
Anda tidak dapat mengelola CORS menggunakan Konsol Google Cloud. Untuk itu, gunakan gcloud CLI.
Command line
Buat file JSON dengan konfigurasi CORS yang ingin Anda terapkan. Lihat contoh konfigurasi untuk mengetahui contoh file JSON.
Gunakan perintah
gcloud storage buckets update
dengan flag--cors-file
:gcloud storage buckets update gs://BUCKET_NAME --cors-file=CORS_CONFIG_FILE
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang relevan. Contoh,my-bucket
.CORS_CONFIG_FILE
adalah jalur ke file JSON yang Anda buat pada Langkah 1.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menetapkan konfigurasi CORS pada bucket:
C#
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menetapkan konfigurasi CORS pada bucket:
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menetapkan konfigurasi CORS pada bucket:
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menetapkan konfigurasi CORS pada bucket:
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menetapkan konfigurasi CORS pada bucket:
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menetapkan konfigurasi CORS pada bucket:
Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menetapkan konfigurasi CORS pada bucket:
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menetapkan konfigurasi CORS pada bucket:
REST API
JSON API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Buat file JSON dengan konfigurasi CORS yang ingin Anda terapkan. Lihat contoh konfigurasi untuk mengetahui contoh file JSON.
Gunakan
cURL
untuk memanggil JSON API dengan permintaan BucketPATCH
: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
Dengan keterangan:
BUCKET_NAME
adalah nama bucket. Misalnya,my-bucket
.CORS_CONFIG_FILE
adalah jalur ke file JSON yang Anda buat di Langkah 2.
XML API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Buat file XML dengan konfigurasi CORS yang ingin Anda terapkan. Lihat contoh konfigurasi untuk mengetahui contoh file XML.
Gunakan
cURL
untuk memanggil XML API dengan permintaanPUT Bucket
yang dicakupkan ke?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"
Dengan keterangan:
BUCKET_NAME
adalah nama bucket. Misalnya,my-bucket
.PROJECT_ID
adalah ID project yang terkait dengan bucket. Contoh,my-project
.CORS_CONFIG_FILE
adalah jalur ke file XML yang Anda buat di Langkah 2.
Guna menghapus konfigurasi CORS untuk bucket, tetapkan konfigurasi CORS kosong.
Melihat konfigurasi CORS untuk bucket
Untuk melihat konfigurasi CORS untuk bucket:
Konsol
Anda tidak dapat mengelola CORS menggunakan Konsol Google Cloud. Untuk itu, gunakan gcloud CLI.
Command line
Gunakan perintah gcloud storage buckets describe
dengan flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(cors_config)"
Dengan BUCKET_NAME
adalah nama bucket yang konfigurasi CORS-nya ingin Anda lihat. Contoh, my-bucket
.
Library klien
Agar dapat melihat konfigurasi CORS untuk bucket menggunakan library klien, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom CORS dalam respons:
C++
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C#
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
REST API
JSON API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Gunakan
cURL
untuk memanggil JSON API dengan permintaan BucketGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=cors"
Dengan
BUCKET_NAME
adalah nama bucket yang konfigurasi CORS-nya ingin Anda lihat. Misalnya,my-bucket
.
XML API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Gunakan
cURL
untuk memanggil XML API dengan permintaan Bucket yang dicakupkan ke?cors
:GET
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?cors"
Dengan
BUCKET_NAME
adalah nama bucket yang konfigurasi CORS-nya ingin Anda lihat. Misalnya,my-bucket
.
Langkah selanjutnya
- Pelajari contoh konfigurasi CORS, termasuk contoh yang menghapus konfigurasi CORS pada bucket.
- Pelajari CORS lebih lanjut.
- Pelajari cara memecahkan masalah permintaan CORS.