> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/deka-gpu-documentations/panduan-untuk-enterprise/deka-metal/deka-metal-deka-box/overview-deka-box/cors-settings.md).

# Pengaturan CORS

Bagian ini menjelaskan **CORS Settings** di Service Portal Cloudeka. **CORS** adalah singkatan dari *Cross-Origin Resource Sharing*. Fitur ini memungkinkan aplikasi web mengakses sumber daya dari domain berbeda. CORS merupakan mekanisme keamanan berbasis HTTP yang memungkinkan server mengontrol permintaan data dari domain lain. Secara default, peramban membatasi akses lintas domain demi keamanan. CORS menyediakan cara aman dan terkontrol untuk mengizinkan pengecualian atas pembatasan tersebut. Dengan CORS, Anda dapat menentukan apakah peramban diizinkan untuk memberi halaman web dari satu origin (domain, protokol, dan port) akses ke sumber daya dari origin lain.

Berikut contoh cara kerja CORS:\
Misalnya, Anda memiliki situs web di `https://www.technicalwriters.id/` dan menyimpan file statis, seperti gambar, video, atau PDF, di Deka Box Service Portal Cloudeka melalui tautan `https://putri.basic.box.cloudeka.id/demo-deka-box/logo.png`. Saat peramban mencoba mengakses file dari domain Cloudeka, peramban akan memblokir permintaan karena bucket menolak akses untuk alasan keamanan. Karena itu, Anda perlu mengonfigurasi **CORS Settings** pada bucket agar situs web dapat melakukan akses lintas domain.

Pada CORS Configuration di Service Portal Cloudeka, Anda dapat [Menambahkan Konfigurasi CORS](#tambah-konfigurasi-cors) dan [Menghapus Konfigurasi CORS](#hapus-konfigurasi-cors).

## Tambah Konfigurasi CORS

Untuk menambahkan konfigurasi CORS ke Deka Box melalui Service Portal Cloudeka, buka tab **Overview** pada halaman detail Deka Box, lalu klik tombol **CORS Settings**.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-13acb204b74416fa4a7b89264e7e65d02fc9a541%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Halaman **Cors Configuration** akan muncul. Klik tombol **Add**.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-a6815de402f497be99190ea8facab9d2507c583f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Jendela **Advanced CORS Options** akan muncul. Isi kolom yang tersedia, lalu klik tombol **Save Option**.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-2c9ab146031656a0dc53b037f385a21d955c1645%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="197">Kolom</th><th>Deskripsi</th></tr></thead><tbody><tr><td>Bucket Name</td><td>Nama untuk mengidentifikasi bucket.</td></tr><tr><td>Origin</td><td>Origin permintaan CORS yang mencakup skema (http atau https), domain, dan port pengirim permintaan.</td></tr><tr><td>Allow Methods</td><td><p>Daftar metode yang diizinkan pada permintaan CORS ke bucket:</p><ul><li><strong>GET</strong> digunakan untuk mengambil atau membaca data dari bucket. Metode ini umum digunakan untuk file statis pada situs web dan diperlukan untuk akses baca.</li><li><strong>PUT</strong> digunakan untuk mengunggah file atau menimpa objek dalam bucket. Metode ini biasanya digunakan aplikasi web yang memungkinkan pengguna mengunggah file ke bucket.</li><li><strong>DELETE</strong> digunakan untuk menghapus file melalui API.</li><li><strong>POST</strong> digunakan untuk mengunggah file melalui formulir multipart.</li><li><strong>HEAD</strong> digunakan untuk meminta metadata file tanpa mengunduh kontennya.</li></ul></td></tr><tr><td>Allow Header</td><td>Daftar header HTTP yang diizinkan pada permintaan CORS.</td></tr></tbody></table>

Pada bagian **Origin**, masukkan alamat situs web yang valid. Panduan ini menggunakan `https://technicalwriters.id`.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-d05bc2a29813759a25222fc95175c7b4ff4e386d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Pada bagian **Allowed Methods**, karena situs web hanya menampilkan gambar, cukup pilih opsi **GET**.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-77e2e4b492cedc6c0f9d316edd47b375294c6299%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Pada bagian **Allowed Headers**, Anda dapat membiarkannya kosong jika tidak memerlukan header khusus. Namun, untuk fleksibilitas dan keamanan, gunakan simbol wildcard `*`. Wildcard `*` berarti semua jenis header diizinkan, seperti `Authorization` dan `Content-Type`.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-4dd2e4019ead2b491685c88cd5a6df0c5480d393%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Setelah menambahkan konfigurasi CORS, klik tombol **Apply Changes** untuk menyimpan pengaturan.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-b5b9d6667323db660bbd63aa163bccb1f5dffc6a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Tunggu hingga proses selesai dan notifikasi **"Successfully updated CORS rules"** muncul.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-f95b51ee6a4f8f9dd9012b256421c8ce25d6000c%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Hapus Konfigurasi CORS

Untuk menghapus konfigurasi CORS pada Deka Box yang sudah tidak digunakan melalui Service Portal Cloudeka, buka tab **Overview** pada halaman detail Deka Box, lalu klik tombol **CORS Settings**.

Pada daftar **CORS Configuration**, klik tombol **Delete** pada konfigurasi CORS yang ingin dihapus.