API anahtarları: izinler, IP kısıtı ve geçerlilik süresi

API anahtarları, panele girmeden bazı işlemleri araçlar üzerinden yapabilmeniz içindir. TeknoWeb'de müşteri anahtarları, Claude Code, Codex ya da Gemini gibi yapay zekâ kodlama araçlarının MCP yapılandırmasına eklenen deploy anahtarları olarak kullanılır. Anahtarlarınızı API anahtarları sayfasından yönetirsiniz.

İzinler

Her anahtar yalnız seçtiğiniz işlemleri yapabilir; tüm yetkileri veren bir joker izin yoktur. En az bir izin seçmeniz gerekir.

İzin	Ne işe yarar?
deploy	Siteyi yüklemek ve canlıya almak
status	Site ve sipariş durumunu, disk kullanımını görmek
logs	Sitenin hata loglarını okumak
set_env	Ortam değişkeni (.env) tanımlamak

Yalnız ihtiyacınız olan izinleri seçmenizi öneririz. Örneğin yalnız log okuyacak bir araç için logs izni yeterlidir.

Anahtar oluşturma

1. API anahtarları sayfasında anahtara ayırt edici bir ad verin.
2. İzinleri seçin.
3. İsterseniz izinli IP adreslerini ve geçerlilik süresini belirleyin.
4. Anahtar oluştur düğmesine basın.
5. Anahtar ekranda yalnız bir kez gösterilir. Hemen kopyalayıp güvenli bir yerde saklayın; bir daha görüntülenemez. Kaybederseniz anahtarı silip yenisini oluşturun.

Kısıtlar

İzinli IP adresleri

Anahtarın yalnız belirli adreslerden çalışmasını istiyorsanız her satıra bir IP adresi ya da CIDR aralığı (IPv4 veya IPv6) yazın. En fazla 20 adres ya da aralık girebilirsiniz. Alan boş bırakılırsa anahtar her adresten kullanılabilir.

Geçerlilik süresi

Anahtara bir bitiş tarihi verebilirsiniz; süre dolunca anahtar kendiliğinden çalışmaz. Bitiş tarihi en fazla 730 gün sonrası olabilir. Panelde hazır seçenekler ve süresiz seçeneği bulunur.

Saatlik istek sınırı

Her anahtarın saatlik bir istek sınırı vardır ve anahtar listesinde görünür. Sınır aşıldığında istekler o saat için 429 (çok fazla istek) yanıtıyla reddedilir.

Güvenlik önerileri

• Anahtarı kod deposuna ya da herkese açık bir yere eklemeyin.
• Kullanmadığınız anahtarları silin.
• Kısıtları sonradan kısıtları düzenle bağlantısıyla güncelleyebilirsiniz.

Ekipten çıkarılan bir üyenin API anahtarları da devre dışı kalır; ayrıntılar için Ekip üyeleri ve roller makalesine bakabilirsiniz.