Token dan keamanan
Kredensial mana untuk apa, siapa boleh melakukan apa, dan apa yang tidak pernah diloloskan ATLAS.
Baca 2 menit
Jenis token
Token milik satu brand. Nilai aslinya ditampilkan sekali, saat token dibuat, dan ATLAS hanya menyimpan hash. Hanya admin yang bisa membuat atau mencabut token, selain token pratinjau singkat.
| Jenis | Membaca | Siapa yang membuat | Kedaluwarsa |
|---|---|---|---|
read | Konten yang sudah terbit melalui /v1/public | Admin | Opsional, 1 sampai 43200 menit. Tanpa itu, tidak pernah kedaluwarsa. |
preview | Termasuk draf, tidak pernah di-cache | Admin, atau anggota mana pun untuk pratinjau editor sendiri | Wajib. Hingga 7 hari untuk admin, hingga 2 jam untuk anggota. |
agent | Pintu terbatas untuk agen luar (baca, dan penulisan khusus draf) | Admin, saat brand mengizinkan agen | 15 menit sampai 90 hari, 30 hari secara default. |
developer | Mendorong tema dari command line atlas | Admin | 15 menit sampai 90 hari, 30 hari secara default. |
- Simpan token baca di variabel lingkungan sisi server. Jangan pernah menyertakannya di kode browser atau meng-commit-nya.
- Rotasi dengan membuat token baru, men-deploy-nya, lalu mencabut yang lama.
- Token pratinjau harus kedaluwarsa. Beri masa hidup sesingkat yang cocok untuk tinjauan.
- Token agen tidak pernah menerbitkan: tulisannya berupa draf yang disetujui seseorang.
Cara mengirim token
# Either header works
curl -s "https://api.atlascms.id/v1/public/page?path=/" -H "Authorization: Bearer $ATLAS_TOKEN"
curl -s "https://api.atlascms.id/v1/public/page?path=/" -H "X-Atlas-Token: $ATLAS_TOKEN"Token di query string tidak pernah diterima. Situs yang memanggil dari servernya boleh menambahkan X-Atlas-Client-Ip dan X-Atlas-Client-User-Agent agar pembatasan laju menilai pengunjung, bukan server.
Peran
Setiap anggota brand memiliki satu peran. API memeriksanya sebelum melihat isi permintaan.
| Peran | Bisa |
|---|---|
| Editor | Menulis draf, meminta tinjauan, mengunggah media, membuat term, dan memindahkan halaman yang belum tayang. |
| Publisher | Semua yang bisa dilakukan editor, ditambah terbitkan, jadwalkan, rollback dan hapus, mengubah halaman yang tayang, redirect, menu, fragmen dan string, serta membaca dan mengelola lead. |
| Admin | Semua yang bisa dilakukan publisher, ditambah pengaturan, tema, anggota, token, integrasi, secret, impor, dan jejak audit. |
Tipe konten kustom bisa menetapkan peran minimum. Pemanggil di bawahnya mendapat 403 pada entri tipe itu. Brand selalu mempertahankan setidaknya satu admin.
Apa yang ditegakkan ATLAS
- Isolasi brand. Setiap row milik brand dibatasi ke brand-nya dan pembatasan itu gagal tertutup. Id record dari brand lain adalah 404.
- Secret terenkripsi. Key integrasi dan secret webhook bersifat hanya-tulis: disimpan terenkripsi dan tidak pernah dikembalikan, dicatat di log, atau ditaruh di URL.
- Jejak audit. Setiap perubahan pada output yang tayang menulis baris audit berisi id, tidak pernah isi konten atau secret.
- Tautan dan markup yang aman. Setiap tautan yang disimpan diperiksa saat simpan dan sekali lagi saat output, dan teks kaya dibersihkan saat simpan.
- Panggilan keluar yang aman. Webhook, forward CRM, dan purge CDN berjalan lewat HTTPS ke alamat publik saja, tidak pernah ke jaringan privat.
- Webhook bertanda tangan. Setiap pengiriman ditandatangani dengan HMAC-SHA256. Lihat webhook.
- AI adalah draf. Output AI masuk sebagai revisi draf. Satu-satunya pengecualian adalah pengaturan autopost yang diaktifkan admin, yang mati secara default dan diaudit.
Ringkasan dalam bahasa sederhana ada di halaman Keamanan. Untuk melaporkan kerentanan, tulis ke [email protected].
Apakah halaman ini membantu?
Usulkan perubahan
Referensi API publik