Menyiapkan dan melihat konfigurasi CORS (original) (raw)

Langsung ke konten utama

Menyiapkan dan melihat konfigurasi CORS

Ringkasan Contoh konfigurasi

Cross Origin Resource Sharing (CORS) memungkinkan interaksi antar-resource dari asal yang berbeda, hal yang biasanya dilarang untuk mencegah perilaku berbahaya. Gunakan halaman ini untuk mempelajari cara menetapkan konfigurasi CORS di bucket Cloud Storage dan cara melihat konfigurasi CORS yang ditetapkan di bucket. Lihat Contoh konfigurasi CORS untuk mengetahui contoh konfigurasi CORS, termasuk konfigurasi yang menonaktifkan konfigurasi yang ada di bucket Anda.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menetapkan dan melihat konfigurasi CORS di bucket, minta administrator untuk memberi Anda peran Storage Admin (roles/storage.admin) di bucket tersebut.

Peran yang telah ditentukan ini berisi izin yang diperlukan untuk menetapkan dan melihat konfigurasi CORS. Untuk melihat izin yang benar-benar diperlukan, luaskan bagianIzin yang diperlukan:

Izin yang diperlukan

Anda juga bisa mendapatkan izin ini dengan peran standar atauperan khusus lainnya.

Untuk informasi tentang cara memberikan peran pada bucket, lihatMenggunakan 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

  1. Buat file JSON dengan konfigurasi CORS yang ingin Anda terapkan. Lihat contoh konfigurasi untuk mengetahui contoh file JSON.
  2. 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 di 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 informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

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 informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

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 informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

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 informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

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 informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

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 informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

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 informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

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 informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Contoh berikut menetapkan konfigurasi CORS pada bucket:

REST API

JSON API

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.
  2. Buat file JSON dengan konfigurasi CORS yang ingin Anda terapkan. Lihat contoh konfigurasi untuk mengetahui contoh file JSON.
  3. Gunakan cURL untuk memanggil JSON API dengan permintaan Bucket PATCH:
    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. Contoh,my-bucket.
    • CORS_CONFIG_FILE adalah jalur ke file JSON yang Anda buat di Langkah 2.

XML API

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.
  2. Buat file XML dengan konfigurasi CORS yang ingin Anda terapkan. Lihat contoh konfigurasi untuk mengetahui contoh file XML.
  3. Gunakan cURL untuk memanggil XML API dengan permintaan PUT Bucket yang dicakup untuk ?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. Contoh,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.

Untuk menghapus konfigurasi CORS untuk bucket, tetapkan konfigurasi CORS kosong.

Melihat konfigurasi CORS untuk bucket

Untuk melihat konfigurasi CORS untuk bucket:

Langkah berikutnya

Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.

Terakhir diperbarui pada 2025-05-06 UTC.