API tokenlarını yönetme, yeniden oluşturma ve iptal etme

Tokenlar sekmesi, API tokenlarınızı erişimleri, sınırları ve son kullanımlarıyla birlikte listeler. Buradan bir token'ın gizli anahtarını yeniden oluşturabilir, token'ı iptal edebilir ve bir token'ın neden çalışmayı durdurduğunu görebilirsiniz.

Tokenlarınızı nerede bulabilirsiniz#

Çalışma alanı menüsünü açın ve AI agents & API seçeneğini belirleyin. Tokenlar sekmesi ilk sekmedir; her sekme kendi sayısını gösterir.

Kimlerin hangi tokenları gördüğü:

Her satır Ad (gizli anahtarın son karakterleriyle birlikte, örneğin clv_agent_…k7Qe), Sahip, Erişim (izinleri), kapsadığı Siteler, Oluşturuldu, Son kullanım ve Sona eriyor bilgilerini gösterir. Alt bilgi, çalışma alanının aktif token sayısını sınırına göre hesaplar. Bir satırdaki rozetler:

İptal edilen ve süresi dolan tokenlar varsayılan olarak gizlidir. Bunları listelemek için İptal edilen ve süresi dolanları göster (sayı) seçeneğine tıklayın; 30 gün boyunca listelenmeye devam ederler.

Bir token'ın erişimini değiştirme#

Bir token'ın izinleri, siteleri, sona erme tarihi, harcama sınırları ve IP izin listesi oluşturulduktan sonra düzenlenemez. Bunlardan herhangi birini değiştirmek için yeni ayarlarla yeni bir token oluşturun, ajansınızı buna geçirin ve ardından eskisini iptal edin.

Bir token'ın gizli anahtarını yeniden oluşturma#

Gizli anahtar sızmış olabileceğinde veya belirli bir program dahilinde döndürmek istediğinizde yeniden oluşturun. Yeni gizli anahtar aynı ada, erişime, sitelere, IP izin listesine, harcama sınırlarına ve sona erme tarihine sahiptir.

1. Token'ın menüsünü açın#

   Tokenlar sekmesinde, token satırındaki ⋯ menüsünü açın ve Gizli anahtarı yeniden oluştur seçeneğini belirleyin.

2. Eski gizli anahtarın ne zaman duracağını seçin#

   İletişim kutusu "ad" yeniden oluşturulsun mu?" diye sorar: "Aynı erişime sahip yeni bir gizli anahtar alırsınız. Eskisi çalışmayı durdurur." Ajanlar hala kullanıyorsa ve geçiş yapmak için zamana ihtiyacınız varsa Eski gizli anahtarın 24 saat boyunca çalışmaya devam etmesini sağla seçeneğini işaretleyin. Eski gizli anahtarı hemen durdurmak için işareti kaldırın.

3. Yeni gizli anahtarı kopyalayın#

   Yeniden oluştur'a tıklayın. Token oluşturuldu iletişim kutusu yeni gizli anahtarı bir kez gösterir. Kopyalayın, ajansınızı veya gizli anahtar deponuzu güncelleyin ve ardından Kaydettim'e tıklayın.

Yeniden oluşturma kuralları:

• Yalnızca token'ı oluşturan kişi onu yeniden oluşturabilir. Oluşturmayan bir sahip veya yönetici "Yalnızca bu token'ı oluşturan kişi onu yeniden oluşturabilir. İptal edebilirsiniz." mesajını görür.
• Bir gizli anahtar bir kez yeniden oluşturulabilir. Bundan sonra, eski satır "Yeniden oluşturulan bir gizli anahtarla değiştirildi" ifadesini gösterir ve Gizli anahtarı yeniden oluştur seçeneği bulunmaz; bunun yerine yeni token'ı yeniden oluşturun. Eski gizli anahtarda tekrar denemek "Bu token zaten yeniden oluşturuldu, iptal edildi veya süresi doldu; yerine geçeni kullanın veya yeni bir tane oluşturun." mesajını döndürür.
• Sona erme tarihi değişmez. 90 gün için oluşturulan bir token orijinal tarihinde sona erer. Eski gizli anahtarın 24 saati bu tarihi geçecekse, sona erme tarihinde durur.
• Çalışma alanı aktif token sınırındayken bile yeniden oluşturabilirsiniz. 24 saatlik çakışma süresince her iki gizli anahtar da çalışır ve her ikisi de aktif token olarak sayılır.
• Yeniden oluşturma, çalışma alanının Pro veya üzerinde olmasını gerektirir; aksi takdirde Gizli anahtarı yeniden oluştur yükseltme iletişim kutusunu açar.

Bir token'ı iptal etme#

1. Token satırındaki ⋯ menüsünü açın ve Yetkiyi kaldır seçeneğini belirleyin.
2. Token'ı iptal et ile onaylayın: "Bu token'ı kullanan ajanlar erişimini hemen kaybeder. Bu işlem geri alınamaz."

İptal edilen bir token, çalışma alanının aktif token sınırındaki yerini hemen boşaltır.

Sona erme#

Her token'ın süresi dolar. Oluştururken kullanım ömrünü seçersiniz: 7 gün, 30 gün, 90 gün (varsayılan) veya 1 yıl. "Asla sona ermez" seçeneği yoktur, bu nedenle unutulan bir token sonsuza kadar geçerli kalamaz. Sona eriyor sütunu tarihi gösterir.

Sona erme tarihinden sonra, her çağrı "Bu token'ın süresi doldu. Integrations → AI agents & API kısmından yeni bir tane oluşturun." mesajını döndürür. Süresi dolan bir token yenilenemez veya yeniden oluşturulamaz; yeni bir tane oluşturun.

IP izin listesi#

Bir token, ajansınızın çalıştığı adreslerle (örneğin bir CI çalıştırıcısı veya sunucu) sınırlandırılabilir. Bunu sihirbazın Sınırlar adımında Gelişmiş → IP izin listesi altında ayarlarsınız: "İsteğe bağlı. Satır başına bir adres veya aralık; başka herhangi bir yerden gelen çağrılar reddedilir."

• IPv4 veya IPv6 adresleri (203.0.113.7) veya CIDR biçiminde aralıklar (198.51.100.0/24) girin, en fazla 20 giriş.
• Herhangi bir adrese izin vermek için boş bırakın. İnceleme adımı daha sonra Herhangi bir adres seçeneğini gösterir.
• Başka bir adresten gelen çağrı "Bu token bu IP adresinden kullanılamaz." mesajını döndürür.
• Adres veya aralık olmayan bir giriş reddedilir: "değer bir IP adresi veya aralığı değildir."

Bir token neden çalışmayı durdurdu#

Olağandışı etkinlik#

Clevera her token'ı ani artışlar için izler ve çalışma alanı sahibine "token üzerinde olağandışı etkinlik" bildirimiyle haber verir:

• Birçok reddedilen istek: birkaç dakika içinde token iptal edilir. "Birkaç dakika içinde birçok reddedilen istek yaptı."
• Olağandışı yüksek sayıda değişiklik: birkaç dakika içinde (10 dakikada 200'den fazla yazma veya 20 sayfa silme), yazma işlemleri 10 dakika duraklatılır. Çağrılar "Bu token'dan gelen yazma işlemleri, olağandışı bir değişiklik artışından sonra duraklatıldı. Çalışma alanı sahibi bilgilendirildi." mesajını döndürür. Okuma işlemleri çalışmaya devam eder.
• Olağandışı hızlı harcanan krediler: token 24 saat boyunca ücretli iş başlatamaz. "Birkaç dakika içinde olağandışı yüksek miktarda kredi harcadı, bu yüzden şimdilik ücretli iş başlatamaz."

Çalışma alanı Pro'dan ayrılırsa#

AI agents & API, Pro, Business ve Custom planlarında bulunur. Çalışma alanı Starter veya Free planına geçerse, sayfa "AI agents & API, Pro'ya dahildir" mesajını gösterir: "Claude, ChatGPT ve betiklerinizin bu çalışma alanında çalışması için yükseltin. Mevcut tokenlar ve uygulamalar o zamana kadar çalışmayı durdurur; buradan iptal edebilirsiniz."

• Tokenlar listelenmeye devam eder ve iptal edilebilir, ancak her çağrı plan_locked ile reddedilir.
• Gizli anahtarı yeniden oluştur bunun yerine yükseltme iletişim kutusunu açar.
• Pro'ya geri yükseltmek tokenları tekrar çalışır hale getirir. Hiçbir şey silinmez; tokenlar hala kendi tarihlerinde sona erer.

İlgili#