Mengelola, membuat ulang, dan mencabut token API
Temukan token API kamu, buat ulang rahasia (satu kali, dengan opsi tumpang tindih 24 jam), cabut token, pahami kedaluwarsa dan daftar izin IP, serta lihat alasan mengapa token berhenti berfungsi.
Tab Token mencantumkan token API kamu beserta akses, batas, dan penggunaan terakhirnya. Dari sana, kamu dapat membuat ulang rahasia token, mencabut token, dan melihat alasan mengapa token berhenti berfungsi.
Tempat menemukan token kamu
Buka menu ruang kerja dan pilih AI agents & API. Tab Token adalah tab pertama; setiap tab menampilkan jumlahnya.
Siapa yang melihat token mana:
| Peran kamu | Kamu melihat | Kamu dapat |
|---|---|---|
| Pemilik atau admin | "Setiap token di ruang kerja ini. Anggota melihat token mereka sendiri." Filter berdasarkan orang dengan menu pemilik (Semua orang menampilkan semua). | Mencabut token apa pun. Membuat ulang hanya token milikmu sendiri. |
| Editor atau Pembuat Konten | "Token kamu. Agen yang menggunakannya bertindak sebagai kamu." | Mencabut dan membuat ulang token milikmu sendiri. |
Setiap baris menampilkan Nama (dengan karakter terakhir rahasia, seperti clv_agent_…k7Qe), Pemilik, Akses (izinnya), Situs yang dicakupnya, Dibuat, Terakhir digunakan, dan Berakhir. Bagian bawah menghitung token aktif ruang kerja terhadap batasnya. Lencana pada baris:
| Lencana | Arti |
|---|---|
| Menggunakan kredit | Token memiliki credits:spend. Arahkan kursor ke sana untuk melihat batasnya: Per tugas, Per hari, Per bulan ("tanpa batas" jika kosong) dan "Disetujui secara otomatis di bawah n kredit" atau "Seseorang menyetujui setiap awal berbayar". |
| IP terbatas | Token memiliki daftar izin IP dan hanya berfungsi dari alamat tersebut. |
| Melebihi peran | "Peran pemilik berubah. Panggilan yang memerlukan kemampuan yang dicoret akan ditolak." |
| Dicabut / Kedaluwarsa | Token tidak lagi berfungsi. Alasannya muncul di sebelahnya (lihat Mengapa token berhenti berfungsi). |
Token yang dicabut dan kedaluwarsa disembunyikan secara default. Klik Tampilkan yang dicabut dan kedaluwarsa (jumlah) untuk mencantumkannya; token tersebut tetap terdaftar selama 30 hari.
Mengubah akses token
Izin, situs, masa berlaku, batas penggunaan, dan daftar izin IP token tidak dapat diedit setelah dibuat. Untuk mengubah salah satunya, buat token baru dengan pengaturan baru, alihkan agen kamu, lalu cabut yang lama.
Membuat ulang rahasia token
Buat ulang jika rahasia mungkin telah bocor, atau untuk merotasinya sesuai jadwal. Rahasia baru memiliki nama, akses, situs, daftar izin IP, batas penggunaan, dan tanggal kedaluwarsa yang sama.
Buka menu token
Pada tab Token, buka menu ⋯ di baris token dan pilih Buat ulang rahasia.
Pilih kapan rahasia lama berhenti
Dialog menanyakan "Buat ulang “nama”?": "Kamu mendapatkan rahasia baru dengan akses yang sama. Rahasia lama berhenti berfungsi." Centang Biarkan rahasia lama tetap berfungsi selama 24 jam jika agen masih menggunakannya dan kamu memerlukan waktu untuk mengalihkannya. Biarkan tidak dicentang untuk segera menghentikan rahasia lama.
Salin rahasia baru
Klik Buat ulang. Dialog Token dibuat menampilkan rahasia baru satu kali. Salin, perbarui agen atau penyimpanan rahasia kamu, lalu klik Saya sudah menyimpannya.
Aturan untuk membuat ulang:
- Hanya orang yang membuat token yang dapat membuatnya ulang. Pemilik atau admin yang tidak membuatnya akan melihat "Hanya orang yang membuat token ini yang dapat membuatnya ulang. Kamu dapat mencabutnya."
- Rahasia dapat dibuat ulang satu kali. Setelah itu, baris lama menampilkan "Digantikan oleh rahasia yang dibuat ulang" dan tidak memiliki opsi Buat ulang rahasia; buat ulang token baru sebagai gantinya. Mencoba lagi pada rahasia lama akan menghasilkan "Token ini sudah dibuat ulang, dicabut, atau kedaluwarsa; gunakan penggantinya atau buat yang baru."
- Tanggal kedaluwarsa tidak berubah. Token yang dibuat untuk 90 hari tetap kedaluwarsa pada tanggal aslinya. Jika 24 jam rahasia lama melewati tanggal tersebut, rahasia itu berhenti pada tanggal kedaluwarsa.
- Kamu dapat membuat ulang bahkan saat ruang kerja berada pada batas token aktifnya. Selama tumpang tindih 24 jam, kedua rahasia berfungsi dan keduanya dihitung sebagai token aktif.
- Membuat ulang memerlukan ruang kerja untuk berada di paket Pro atau lebih tinggi; jika tidak, Buat ulang rahasia akan membuka dialog peningkatan.
Mencabut token
- Buka menu ⋯ pada baris token dan pilih Cabut.
- Konfirmasi dengan Cabut token: "Agen yang menggunakan token ini kehilangan akses segera. Ini tidak dapat dibatalkan."
Token yang dicabut segera mengosongkan tempatnya dalam batas token aktif ruang kerja.
Kedaluwarsa
Setiap token kedaluwarsa. Kamu memilih masa pakai saat membuatnya: 7 hari, 30 hari, 90 hari (default), atau 1 tahun. Tidak ada opsi "tidak pernah kedaluwarsa", sehingga token yang terlupakan tidak dapat tetap valid selamanya. Kolom Berakhir menampilkan tanggalnya.
Setelah tanggal kedaluwarsa, setiap panggilan akan mengembalikan "Token ini telah kedaluwarsa. Buat yang baru di Integrasi → AI agents & API." Token yang kedaluwarsa tidak dapat diperbarui atau dibuat ulang; buat yang baru.
Daftar izin IP
Token dapat dibatasi ke alamat tempat agen kamu berjalan (misalnya, runner CI atau server). Kamu mengaturnya pada langkah Batas di wizard di bawah Lanjutan → Daftar izin IP: "Opsional. Satu alamat atau rentang per baris; panggilan dari tempat lain akan ditolak."
- Masukkan alamat IPv4 atau IPv6 (
203.0.113.7) atau rentang dalam bentuk CIDR (198.51.100.0/24), hingga 20 entri. - Biarkan kosong untuk mengizinkan alamat apa pun. Langkah peninjauan kemudian menampilkan Alamat apa pun.
- Panggilan dari alamat lain akan mengembalikan "Token ini tidak dapat digunakan dari alamat IP ini."
- Entri yang bukan alamat atau rentang akan ditolak: "nilai bukan alamat atau rentang IP."
Mengapa token berhenti berfungsi
| Ditampilkan pada token | Apa yang terjadi | Apa yang harus dilakukan |
|---|---|---|
| Kedaluwarsa | Masa pakainya habis. | Buat token baru. |
| "Dicabut oleh pemiliknya" | Orang yang membuatnya mencabutnya. | Buat token baru jika masih diperlukan. |
| "Dicabut oleh admin" | Pemilik ruang kerja atau admin mencabutnya. | Tanyakan alasannya sebelum membuat yang baru. |
| "Dicabut: pemilik meninggalkan ruang kerja" | Orang yang membuatnya dihapus dari ruang kerja. Semua token mereka dicabut. | Seseorang yang masih di ruang kerja membuat token baru. |
| "Dicabut: akun pemilik dihapus" | Pemilik menghapus akun Clevera mereka. | Buat token baru. |
| "Digantikan oleh rahasia yang dibuat ulang" | Rahasia dibuat ulang. | Gunakan rahasia baru. |
| "Dicabut: ditemukan di repositori publik" | Token ditemukan di repositori GitHub publik dan dicabut secara otomatis. | Hapus dari riwayat repositori, lalu buat token baru dan simpan di penyimpanan rahasia. |
| "Dicabut: aktivitas tidak biasa" | Membuat banyak permintaan yang ditolak dalam beberapa menit (lebih dari 50 dalam 10 menit). | Periksa aktivitas untuk melihat apa yang dicoba, perbaiki agen, lalu buat token baru. |
| "Dicabut: penggunaan ulang token terdeteksi" / "Dicabut: aplikasi terputus" | Ini berlaku untuk aplikasi yang terhubung, bukan token API. | Hubungkan kembali aplikasi. |
| Setiap panggilan mengembalikan "API agen tidak ada pada paket ruang kerja ini. API ini ada pada Pro dan lebih tinggi." | Ruang kerja keluar dari Pro, Business, atau Custom. | Tingkatkan ke Pro. Lihat Jika ruang kerja meninggalkan Pro. |
Aktivitas tidak biasa
Clevera memantau setiap token untuk lonjakan aktivitas dan memberi tahu pemilik ruang kerja dengan notifikasi "Aktivitas tidak biasa pada token":
- Banyak permintaan yang ditolak dalam beberapa menit: token dicabut. "Membuat banyak permintaan yang ditolak dalam beberapa menit."
- Jumlah perubahan yang sangat tinggi dalam beberapa menit (lebih dari 200 penulisan atau 20 penghapusan halaman dalam 10 menit): penulisan dijeda selama 10 menit. Panggilan mengembalikan "Penulisan dari token ini dijeda setelah lonjakan perubahan yang tidak biasa. Pemilik ruang kerja telah diberitahu." Pembacaan tetap berfungsi.
- Kredit dihabiskan sangat cepat: token tidak dapat memulai pekerjaan berbayar selama 24 jam. "Menghabiskan jumlah kredit yang sangat tinggi dalam beberapa menit, jadi tidak dapat memulai pekerjaan berbayar untuk saat ini."
Jika ruang kerja meninggalkan Pro
AI agents & API tersedia pada paket Pro, Business, dan Custom. Jika ruang kerja pindah ke Starter atau Free, halaman menampilkan "AI agents & API disertakan dalam Pro": "Tingkatkan agar Claude, ChatGPT, dan skrip kamu berfungsi di ruang kerja ini. Token dan aplikasi yang ada berhenti berfungsi sampai saat itu; kamu masih dapat mencabutnya di sini."
- Token tetap terdaftar dan dapat dicabut, tetapi setiap panggilan ditolak dengan
plan_locked. - Buat ulang rahasia membuka dialog peningkatan sebagai gantinya.
- Meningkatkan kembali ke Pro membuat token berfungsi kembali. Tidak ada yang dihapus; token tetap kedaluwarsa pada tanggalnya.