Ana içeriğe geç

API anahtarlarını yönetme

BU SAYFADA

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ı, Management Console'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, Management Console'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 Management Console'dan silemezsiniz.

Kiracıda API anahtarlarını etkinleştirme

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

Properties for API keys
Property Description
Enable API keys

This switch enables or disables all the API keys in the tenant. Only the tenant admin can enable the API keys.
Change maximum token expiration

By changing the token expiration value, all new tokens will have the new expiration value. Already existing APIs will not be affected by the change, they will have the same expiration value as before.
Change maximum of API keys per user

This setting only affects new API keys. If a new API key makes the total number exceed the maximum number, creation is denied.

Aşağıdakileri yapın:

  1. Management Console'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 aşağıdaki iki gereksinimin yerine getirildiğinden emin olun:

  • Management Console'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öşede profilinize tıklayın ve Ayarlar'ı seçin.

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

  4. Yeni API  anahtarları 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.