Operasional
Kontrol akses
Peran, policy, dan izin per koleksi yang berlaku sama di Studio, REST, GraphQL, dan MCP.
Setelah membaca panduan ini, kamu akan tahu cara memilih peran workspace, memberi izin per koleksi, dan memeriksa akses token pengguna. Studio, REST, GraphQL, dan MCP memakai otorisasi workspace yang sama.
Sebelum mulai
- Siapkan workspace beserta koleksi yang ingin diatur aksesnya.
- Gunakan akun owner untuk mengelola anggota dan akses.
- Tentukan koleksi yang perlu dibaca atau diubah oleh setiap anggota.
1. Pilih peran bawaan
| Peran | Bisa |
|---|---|
| Owner | Semuanya, termasuk anggota dan akses |
| Administrator | Mengelola model data dan semua record |
| Editor | Membuat, mengubah, dan menghapus record |
| Viewer | Membaca record |
| Public | Akses API tanpa login, mati secara default |
Note: Akses owner dan administrator tidak bisa dikurangi. Ada satu owner per instalasi, dan kepemilikan bisa dipindahkan.
2. Tambahkan peran kustom dan policy bila perlu
Buat hingga 20 peran kustom dan 50 policy per workspace di Pengaturan → Peran dan Pengaturan → Policy. Policy memberi izin create, read, update, atau delete per koleksi, jadi sebuah peran bisa membaca orders tapi hanya mengubah notes.
3. Periksa akses per koleksi
Editor dan viewer bisa mendapat hak CRUD berbeda di koleksi tertentu. Studio menampilkan akses efektif setiap anggota di samping setiap koleksi pada model data.
4. Periksa izin token dan agent
Token API pribadi bertindak atas nama pembuatnya, dengan izin yang sama. Token punya masa berlaku, disimpan sebagai hash, dan bisa dicabut. Token tidak bisa mengelola kredensial atau mengganti password. Tool MCP memakai aturan yang sama, jadi agent tidak pernah melihat lebih dari pemilik tokennya.
Note: Token pribadi mewarisi izin pemiliknya. API key dengan scope atau read-only serta service account masih direncanakan; token pribadi belum punya batas izin tersendiri.
Pemecahan masalah
- Editor atau viewer tidak bisa mengakses koleksi: periksa akses efektif anggota di workspace tersebut dan override per koleksi pada model data.
- Override tidak membatasi administrator: akses owner dan administrator tidak bisa dikurangi. Pilih peran dengan izin yang sesuai kebutuhan.
- Token tidak bisa mengganti password atau mengelola kredensial: token API pribadi tidak mengizinkan operasi tersebut, meskipun pemiliknya bisa melakukannya lewat Studio.
- Akses API tanpa login tidak tersedia: peran Public mati secara default. Pastikan akses publik memang dibutuhkan sebelum mengubah pengaturan akses.