Konfigurasi
CORS
Izinkan aplikasi browser di domain lain memanggil API Kanesh dengan bearer token.
Browser memblokir panggilan dari app.example.com ke api.example.com kecuali API mengizinkan origin itu. CORS mati secara default. Kode server, script, dan agent tidak membutuhkannya.
Nyalakan
| Variable | Default | Fungsinya |
|---|---|---|
CORS_ENABLED | false | true mengizinkan origin di bawah. |
CORS_ORIGINS | tidak diatur | Origin persis, dipisah koma, seperti https://app.example.com,http://localhost:5173. Tanpa wildcard, tanpa path. |
Atur lebih detail
Default cocok untuk kebanyakan aplikasi. Ubah hanya jika aplikasimu butuh lebih.
| Variable | Default | Fungsinya |
|---|---|---|
CORS_METHODS | GET,POST,PUT,PATCH,DELETE | Method HTTP yang boleh dipakai browser. |
CORS_HEADERS | Authorization,Content-Type,If-Match,If-None-Match,X-Request-ID,X-Workspace-ID | Header request yang boleh dikirim browser. |
CORS_EXPOSE_HEADERS | ETag,X-Request-ID,X-Response-Time,Retry-After,Content-Disposition | Header respons yang bisa dibaca kodemu. |
CORS_MAX_AGE | 10m | Berapa lama browser menyimpan cache pemeriksaan preflight. |
Kamu juga bisa mengelola CORS di Settings → Security, dan perubahannya berlaku tanpa restart. Variabel yang diatur menang atas Studio dan tampil read-only di sana, meskipun nilainya sama dengan default.
Note: Request lintas origin harus memakai bearer token. Cookie tidak pernah diizinkan lintas origin, dan login (
POST /api/v1/auth/login) dari origin lain menghasilkan 403access_denied. Ambil token di servermu sendiri, atau pakai token pribadi.