Kunci API
Kunci API memungkinkan skrip dan CI memakai REST API. Buat di Account settings → API Keys.
- Kunci diawali
zv_pat_dan hanya ditampilkan sekali. Perlakukan seperti kata sandi. - Setiap kunci punya izin dan bisa dibatasi ke beberapa proyek. Beri kunci hanya yang dibutuhkan tugasnya.
- Tidak ada kunci yang bisa mengubah akun Anda (email, kata sandi, kunci), membuat kunci lain, atau menyentuh tagihan, pembelian, atau anggota tim.
- Pilih masa berlaku 30, 90, atau 365 hari, atau tanpa batas. Daftar menampilkan kapan setiap kunci terakhir dipakai; hapus kunci yang tidak lagi Anda perlukan.
curl -H "Authorization: Bearer $ZENAVO_API_KEY" https://zenavo.app/api/projectsIzin
| Izin | Bisa | Tidak bisa | Bertindak sebagai |
|---|---|---|---|
| Read only | Melihat proyek, layanan, deployment, job, log, server, dan penggunaan | Melihat nilai konfigurasi (variabel lingkungan, detail koneksi), mengubah apa pun | Paling tinggi Viewer |
| Deploy | Juga men-deploy, rollback, me-restart, dan melanjutkan layanan, mengedit konfigurasi proyek (termasuk variabel lingkungan), mengunggah sumber, menambahkan domain otomatis, membuat backup | Membuka shell atau menjalankan perintah, membaca atau mengubah file dan baris database, mengunduh atau memulihkan backup, membuat, menghapus, memindahkan, atau menghentikan proyek, mengubah server atau firewall | Paling tinggi Member |
| Full access | Semua yang bisa dilakukan API key, dengan peran Anda sendiri | Tagihan, membeli atau memperpanjang server, mengundang atau menghapus anggota, membuat, menghapus, atau mentransfer tim | Peran Anda |
Kunci tidak pernah melebihi peran Anda di sebuah tim: kunci Deploy milik viewer tetap viewer. Kunci yang dibuat sebelum ada izin punya Full access, seperti sebelumnya. Permintaan yang tidak diizinkan oleh izin kunci dijawab 403.
Log bisa berisi apa pun yang dicetak layanan Anda. Jika layanan mencetak rahasia, kunci Read only bisa melihatnya.
Batasi kunci ke beberapa proyek
Pilih Only some projects dan centang proyeknya. Kunci itu lalu tidak melihat apa pun selain itu: daftar proyek dan job hanya menampilkan proyek tersebut, proyek lain menjawab 404, dan apa pun di luar proyek (server, pengaturan tim, anggota) menjawab 403. Kunci itu juga tidak bisa menghapus, mengkloning, memindahkan, atau mentransfer proyeknya, bahkan dengan Full access. Ini pilihan paling aman untuk agen AI atau job CI.
Batas proyek diperiksa di setiap permintaan bersama peran Anda, jadi bila Anda keluar dari tim, kunci juga kehilangan proyek itu.
Login CLI
zenavo auth login dari CLI membuat kunci untuk CLI tanpa menyalinnya secara manual. Terminal menampilkan kode; buka /device di konsol, ketik kodenya, dan setujui. Pastikan nama perangkat dan jaringannya milik Anda: setujui hanya kode yang baru saja Anda minta sendiri. Persetujuan dicatat di aktivitas keamanan Anda. Kunci itu bernama CLI on <hostname>, kedaluwarsa setelah 90 hari, dan muncul di daftar ini.
Halaman persetujuan menampilkan izin yang diminta CLI. Anda bisa menyetujuinya dengan izin lebih rendah (misalnya Read only alih-alih Deploy) dan membatasinya ke beberapa proyek; Anda tidak pernah bisa memberinya lebih dari yang diminta. CLI lama yang tidak meminta izin mendapat Full access.