> 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/guideline-for-enterprise/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 [Tambah Konfigurasi CORS](#tambah-konfigurasi-cors) dan [Hapus 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><em>Bucket Name</em></td><td>Nama untuk mengidentifikasi <em>bucket</em>.</td></tr><tr><td><em>Origin</em></td><td><em>Origin</em> permintaan <em>CORS</em> yang mencakup skema (<em>http</em> atau <em>https</em>), domain, dan port pengirim permintaan.</td></tr><tr><td><em>Allow Methods</em></td><td><p>Daftar metode yang diizinkan pada permintaan <em>CORS</em> ke <em>bucket</em>:</p><ul><li><em><strong>GET</strong></em> digunakan untuk mengambil atau membaca data dari <em>bucket</em>. Metode ini umum digunakan untuk file statis pada situs web dan diperlukan untuk akses baca.</li><li><em><strong>PUT</strong></em> digunakan untuk mengunggah file atau menimpa objek dalam <em>bucket</em>. Metode ini biasanya digunakan aplikasi web yang memungkinkan pengguna mengunggah file ke <em>bucket</em>.</li><li><em><strong>DELETE</strong></em> digunakan untuk menghapus file melalui <em>API</em>.</li><li><em><strong>POST</strong></em> digunakan untuk mengunggah file melalui formulir <em>multipart</em>.</li><li><em><strong>HEAD</strong></em> digunakan untuk meminta metadata file tanpa mengunduh kontennya.</li></ul></td></tr><tr><td><em>Allow Header</em></td><td>Daftar <em>header HTTP</em> yang diizinkan pada permintaan <em>CORS</em>.</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.