Ana içeriğe geç

Sunucu API Anahtarı Yönetimi

Bu makalede

Bilgi

API anahtarı, Invapi'ye yapılan API isteklerini yetkilendirmek ve kontrol merkeziniz ile kişisel hesabınızdan bağımsız olarak belirli bir sunucunun Kontrol Paneline erişmek için kullanışlı bir yoldur.

Tüm hesaba veya belirli bir sunucuya erişmek için Invapi kontrol panelinin kişisel alanında bir API erişim anahtarı oluşturun. Bunu elde etmek için aşağıdaki talimatları izleyin.

Belirli bir sunucu için API anahtarı alma

  1. Invapi adresine gidin;

  2. Lütfen dış sunucu kontrol paneline erişmek istediğiniz sunucuyu seçin: My Servers >> İlgili Sunucu;

  3. Bir API anahtarı oluşturun:

    • Configuration sekmesine gidin ve API keys & control panel bölümünü seçin.
    • Create API key butonuna tıklayın;

    • Name alanına, anahtarı tanımlamak için bir isim girin;
    • IP ACL alanına, yalnızca bu anahtarın erişimine izin verilecek IP adreslerini belirtin veya kısıtlamasız erişim için boş bırakın;
    • Giriş bildirim yöntemini seçin (None, Email, Webhook)
    • Anahtarı etkinleştirmek için Active kutucuğunu işaretleyin;
    • Save butonuna tıklayın.

    Bundan sonra API anahtarınız görüntülenecektir.

Dikkat

API anahtarı değerini mutlaka kopyalayın ve kaydedin, çünkü yalnızca bir kez görüntülenecektir. Invapi, anahtarın yalnızca hash değerini saklar; bu nedenle orijinal anahtar kaybolursa yeniden oluşturulması gerekecektir.

API Anahtarını Düzenleme

Bir API anahtarını düzenlemek veya silmek için, yukarıda oluşturma sırasında açıklandığı gibi ya hesabınıza ya da belirli bir sunucuya gidin ve ilgili API anahtarına tıklayın. Açılan pencerede şunları yapabilirsiniz:

  • anahtar adını değiştirin (Name alanı);
  • anahtarın kullanılacağı IP adreslerini ayarlayın (IP ACL alanı);
  • anahtarı etkinleştirin veya geçici olarak devre dışı bırakın ( Active onay kutusu).

Ardından, değişiklikleri kaydetmek için Save butonuna tıklayabilirsiniz.

API Anahtarını Silme

Bir API anahtarını silmek için kullanıcı profili - API Keys bölümüne gidin

Anahtarlar listesinde silmek istediğiniz anahtarı bulun. ... simgesine tıklayın.

Açılır menüde Delete butonuna tıklayın

Dikkat

API anahtarı, geri döndürülemez şekilde silinir.

Bir API anahtarını kullanma

API anahtarı aşağıdaki şekillerde kullanılabilir:

  1. Invapi'deki bir hesaba veya sunucuya yapılacak sonraki API istekleri için gerekli olan oturum tokenını (session token) elde etmek için yetkilendirme gereklidir. Yetkilendirme, kullanılan API anahtarına bağlı olarak, auth/login çağrısı aracılığıyla ya tüm hesap ya da belirli bir sunucu için erişim sağlayan bir API anahtarı üzerinden alınabilir. Yetkilendirme başarılı olursa ve anahtar veritabanında bulunursa, sistem $HOSTKEY_TOKEN oturum tokenını döndürecektir.

  2. Invapi Kontrol Merkezi hesabınıza giriş yapmadan sunucu erişimi sağlayan Sunucu Kontrol Paneline erişmek ve HOSTKEY sunucularını yönetmek için faturalandırma sisteminize bağımsız bir modül olarak yerleştirmek için sunucuya özel API anahtarları oluşturmalısınız.

API anahtarı kullanım bilgileri

Usage history sekmesinde, bir hesap veya sunucu için belirli bir anahtar seçin ve bu API anahtarı ile belirli bir süre boyunca yapılan tüm girişleri görüntülemek için üzerine tıklayın. Çıktı; giriş için kullanılan e-posta adresini ve IP adresini, işlem durumunu ve olayın tarih ve saatini içerecektir.

Web paneli olmadan API anahtarı alma

API anahtarlarıyla çalışmak için API yöntemleri kullanılarak web kontrol paneli kullanılmadan de bir API anahtarı alınabilir. Bu yöntemler komut satırından yürütülebilir veya web çözümlerine dahil edilebilir.