Ana içeriğe geç

API anahtarlarını yönetme

API anahtarı bir kullanıcının, geliştiricinin kimlik doğrulaması veya API'ye program çağrısı için kullanılan benzersiz bir kimliktir. API anahtarları çoğu zaman kötü amaçlı API kullanımını engellemek amacıyla arayüzün nasıl kullanıldığını izlemek ve denetlemek için kullanılır.

API anahtarlarına genel bakış

Varsayılan olarak API anahtarları, Yönetim Konsolu'da devre dışı bırakılır. API anahtarlarını etkinleştirmek için Ayarlar bölümüne gidin. Kiracı yöneticisi, API anahtarlarını iptal edebilir ve API anahtarları ayarlarını düzenleyebilir. Ancak API anahtarlarını oluşturmak veya silmek için geliştirici rolüne sahip olmanız gerekir. Kiracı yöneticisi bir kullanıcıya geliştirici rolünü atar. Kiracı yöneticisiyseniz kendinize geliştirici rolünü atayabilirsiniz.

API anahtarları tablosu, API anahtarları hakkında aşağıdaki bilgileri gösterir: ad, kimlik, sahip, son güncelleme, oluşturma tarihi, bitiş tarihi ve durum. İlk üç alanda arama yapmak için arama alanını kullanın: Anahtar adı, Anahtar kimliği ve Sahip.

API anahtarı durumları

API anahtarları şu durumlara sahiptir:

  • Etkin: API anahtarı kullanılmaktadır.
  • Süresi Doldu: Bitiş tarihi gelmiştir.
  • İptal Edildi: API anahtarı iptal edilmiştir ve artık kullanılamamaktadır.

Yönetici olarak, Yönetim Konsolu'da Olaylar bölümünde kayıtlı API anahtar etkinliklerini gözden geçirebilirsiniz. Belirli bir API anahtarının yoğun kullanımı gibi şüpheli etkinlikler tespit edilirse bu API anahtarını iptal edebilirsiniz. Tablonun en sağındaki oka tıklayarak ayrıntılı listeyi açın ve API anahtarının kimliğini kopyalayın. İptal edilecek API anahtarını bulmak için daha sonra API anahtarları bölümünde kimliği arayabilirsiniz.

Tek bir API anahtarını iptal etmek için, en sağdaki ... düğmesine tıklayın ve İptal Et'i seçin. Yalnızca Etkin durumdaki anahtarları iptal edebilirsiniz. Birden çok anahtarı iptal etmek için iptal edilecek anahtarların solundaki onay kutularını seçin ve sağ üst köşedeki İptal Et'e tıklayın. İptal işlemi geri alınamaz, iptal edilen bir API anahtarı yeniden etkinleştirilemez.

İptal işlemine ek olarak silme seçeneği de vardır. API anahtarını hub'dan silebilirsiniz ancak Yönetim Konsolu'dan silemezsiniz.

Kiracıda API anahtarlarını etkinleştirme

API anahtarlarını etkinleştir ayarı, Yönetim Konsolu'daki Ayarlar sayfasında etkinleştirilir. Varsayılan olarak API anahtarları, Yönetim Konsolu'da devre dışı bırakılır.

API anahtarları için özellikler
Özellik Açıklama
API anahtarlarını etkinleştir

Bu tuş, kiracıdaki tüm API anahtarlarını etkinleştirir veya devre dışı bırakır. Yalnızca kiracı yöneticisi API anahtarlarını etkinleştirebilir.

Belirtecin maksimum sona erme tarihini değiştir

Belirteç bitiş tarihi değerini değiştirdiğinizde, tüm yeni belirteçler yeni bitiş tarihine sahip olur. Halihazırda mevcut API'ler bu değişiklikten etkilenmez ve önceki bitiş tarihi değerini kullanmaya devam eder.

Kullanıcı başına maksimum API anahtarını değiştir

Bu ayar yalnızca yeni API anahtarlarını etkiler. Yeni bir API anahtarı, toplam sayının maksimum sayıyı aşmasına neden olursa oluşturma reddedilir.

Aşağıdakileri yapın:

  1. Yönetim Konsolu'da Ayarlar sayfasına gidin.
  2. API anahtarları bölümünde API anahtarlarını etkinleştir düğmesini etkinleştirin.
  3. Uygunsa Belirtecin maksimum sona erme tarihini değiştir ve Kullanıcı başına maksimum API anahtarını değiştir ayarını değiştirin.

Hub'dan API anahtarı oluşturma

Hub'dan API anahtarları oluşturabilirsiniz. Başlamadan önce şu üç gereksinimin sağlandığından emin olun:

  • Bir lisans kullandığınızdan. API anahtarı oluşturmak için lisans gereklidir.

  • Yönetim Konsolu'da API anahtarlarını etkinleştir seçeneğinin açık olduğundan.
  • Kiracı yöneticisinin size geliştirici rolünü atamış olduğundan.

Aşağıdakileri yapın:

  1. Kiracınızda oturum açın; örneğin, https://<tenantname>.com.

  2. Sağ üst köşedeki profilinize tıklayın ve Profil ayarları'nı seçin.

  3. API  anahtarları'nı seçin.

  4. Yeni anahtar oluştur'a tıklayın.

  5. Bir API anahtarı açıklaması girin ve API anahtarının süresinin dolacağı zamanı seçin.

  6. Oluştur'a tıklayın.

    Bir API anahtarı oluşturulur.

  7. API anahtarını kopyalayıp güvenli bir yerde saklayın.

Oluşturma işleminden sonra API anahtarının adını düzenleyebilirsiniz. Ayrıca silebilirsiniz.