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, ancak API anahtarlarının ayarlarını düzenlemek ve API anahtarlarını oluşturmak ya da 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.
Özellik | Açıklama |
---|---|
API anahtarlarını etkinleştir |
Bu anahtar, kiracıdaki tüm API anahtarlarını etkinleştirir veya devre dışı bırakır. API anahtarlarını yalnızca kiracı yöneticisi etkinleştirebilir. |
Belirtecin maksimum sona erme tarihini değiştir |
Belirteç sona erme tarihi değerini değiştirdiğinizde tüm yeni belirteçler yeni sona erme tarihi değerine sahip olur. Zaten mevcut olan API'ler bu değişiklikten etkilenmez, eski sona erme tarihi değerine sahip olurlar. Değer için maksimum sınır yoktur. |
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 işlemi reddedilir. Maksimum değer sınırı 1000'dir. |
Aşağıdakileri yapın:
- Yönetim Konsolu'da Ayarlar sayfasına gidin.
- API anahtarları bölümünde API anahtarlarını etkinleştir düğmesini etkinleştirin.
- 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:
-
Kiracınızda oturum açın; örneğin, https://<tenantname>.com.
-
Sağ üst köşedeki profilinize tıklayın ve Profil ayarları'nı seçin.
-
API anahtarları'nı seçin.
-
Yeni anahtar oluştur'a tıklayın.
-
Bir API anahtarı açıklaması girin ve API anahtarının süresinin dolacağı zamanı seçin.
-
Oluştur'a tıklayın.
Bir API anahtarı oluşturulur.
-
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.