Uygulamaları kaydedin ve API anahtarlarını yönetin

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info

Aşağıdaki bölümlerde açıklandığı gibi uygulamaları kaydedin ve API anahtarlarını yönetin.

Giriş

Uygulama kaydı, API'lerinize kimlerin erişebileceğini kontrol etmek için birincil mekanizmayı sağlar.

API sağlayıcısı olarak, API ürünlerini yönetme bölümünde açıklandığı gibi API'lerinizi bir araya getirmek için bir veya daha fazla API ürünü oluşturursunuz. Uygulama geliştirici, uygulamayı kaydederken hangi API ürünlerinin kullanılacağını seçer. Edge, geliştiricinin bu API ürünlerine erişmek için kullanabileceği tek bir API anahtarı sağlar. Uygulama geliştirici, her çağrıda API anahtarını API ürünlerindeki API proxy'lerine iletir. Uygulama geliştiricilerin, uygulama tarafından referans verilen API ürünlerinin tamamına veya bir alt kümesine erişmesini engellemek için dilediğiniz zaman bir uygulamanın API anahtarını iptal edebilirsiniz.

Uygulama geliştiriciler genellikle API ürünlerinizi kullanmak için geliştirici portalınızı kullanarak kaydolurlar. Portalınızı oluşturma ve API ürünlerinizi yayınlama adımları Portalınızı oluşturma bölümünde açıklanmıştır.

Alternatif olarak, API sağlayıcı olarak uygulama kaydı süreci üzerinde daha fazla kontrol sahibi olmak isteyebilir ve aşağıdaki bölümlerde açıklandığı gibi Edge'de uygulama kaydetmeyi seçebilirsiniz. Örneğin, dahili geliştirme ekipleriniz için veya portalınıza erişimi olmayan bir geliştirici adına uygulama kaydetmek isteyebilirsiniz.

Aşağıdaki bölümlerde, kullanıcı arayüzü ve API kullanılarak uygulamaların nasıl kaydedileceği ve API anahtarlarının nasıl yönetileceği açıklanmaktadır.

Uygulamalar sayfasını keşfetme

Aşağıda açıklandığı şekilde Uygulamalar sayfasına erişip sayfayı keşfedin.

Uygulama kaydı

Uygulamalar aşağıdaki yöntemlerden biri kullanılarak kaydedilebilir:

• Uygulama geliştiriciler, Uygulama geliştiricileri portalınızla nasıl etkileşimde bulunur? bölümünde açıklandığı gibi uygulamayı portalınız üzerinden kaydedebilir.
• Aşağıda açıklandığı şekilde Edge'e uygulama kaydedebilirsiniz. Anahtarı uygulama geliştiriciye nasıl sağlayacağınızı belirlemek size bağlıdır.

Kayıtlı uygulamalar şuraya eklenir:

• Edge'de kayıtlı uygulamaların listesi. Geliştirici ayrıntılarını görüntüleme ve düzenleme başlıklı makaleyi inceleyin.
• Geliştirici portalındaki Uygulamalar sayfası.

Edge'e uygulama kaydetmek için:

1. Uygulamalar sayfasına gidin.
2. + Uygulama'yı tıklayın.
3. Uygulama Ayrıntıları'nı belirtin:

   Alan	Açıklama	Zorunlu mu?
   Ad	Uygulamanın adı. Uygulama oluşturulduktan sonra adı değiştiremezsiniz. Bu ad, yönetim API çağrılarında kullanılır.	Evet
   Görünen Ad	Edge yönetim kullanıcı arayüzünde ve geliştirici portalında görünen uygulamanın görünen adı.	Hayır
   Şirket/Geliştirici	Not: Apigee karma, şirket uygulamalarını desteklemez. Bu alan geçerli değildir. Şirket veya Geliştirici'yi seçin ve açılır menüden bir şirket veya geliştirici adı seçin. Not: Performans nedeniyle, açılır menüde tüm şirketler veya geliştiriciler gösterilmez. Arama kutusuna şirket adını, geliştirici adını veya e-posta adresini yazmaya başlayın. Uygulama geliştiricilerini kaydetme başlıklı makaleyi de inceleyin.	Evet
   Geri Çağırma URL'si	Genellikle, istemci uygulaması adına yetkilendirme kodu almak üzere atanan bir uygulamanın URL'sini belirtir. Bu değer tüm API ürünleri için gerekli değildir.	Hayır
   Notlar	Uygulamayla ilgili açıklayıcı notlar.	Hayır

4. API anahtarının geçerlilik süresi ve durumu ile ilişkili API ürünleri dahil olmak üzere Kimlik Bilgileri'ni belirtin.
   Kimlik Bilgileri bölümünde simgesini tıklayın ve aşağıdaki bilgileri girin:

   Alan	Açıklama
   Geçerlilik Süresi	Geçerlilik bitiş süresi veya tarihi yapılandırın ya da API anahtarının süresi hiç dolmayacak şekilde ayarlayın ve Tamam'ı tıklayın.
   Ürünler	Bir veya daha fazla API ürününü API anahtarıyla ilişkilendirin: Ürün ekle'yi tıklayın. Listeden bir veya daha fazla API ürünü seçin. Ekle'yi tıklayın. Her API ürünü için Durum'u Onaylandı veya İptal Edildi olarak ayarlayın. Daha fazla API ürünü eklemek için adımları tekrarlayın.

5. Özel Özellikleri belirtin:
   1. Özel Özellikler bölümünde simgesini tıklayın.
   2. Adı ve değeri girin.
   3. Ekle'yi veya Ekle ve başka bir tane başlat'ı tıklayın.
      Ekleyebileceğiniz maksimum özel özellik sayısı 18'dir.
6. Oluştur'u tıklayın.

Uygulamayla ilişkilendirdiğiniz API ürünlerinin API anahtarları için manuel onay gerekiyorsa API anahtarlarını onaylama veya iptal etme bölümünde açıklandığı şekilde bunları onaylayın.

Bir geliştirici için kayıtlı uygulamaları görüntüleme

Belirli bir geliştirici için kayıtlı uygulamaları görüntülemek üzere aşağıdaki yöntemlerden birini kullanın:

• Kayıtlı tüm uygulamaları görüntüleyin, Arama açılır menüsünden Geliştirici'yi seçin ve arama alanına geliştiricinin adını girin.
• Kayıtlı tüm uygulama geliştiricilerini görüntüleyin ve geliştiriciyle ilişkili satırı tıklayın.

Uygulamaları görüntüleme ve düzenleme

Bir uygulamayı görüntülemek ve düzenlemek için:

1. Uygulamalar sayfasına gidin.
2. Görüntülemek ve düzenlemek istediğiniz uygulamanın satırını tıklayın.
   Uygulama ayrıntıları görüntülenir.
3. Bir uygulamayı düzenlemek için Düzenle'yi tıklayın.
4. Aşağıdaki görevlerden en az birini gerçekleştirin:
   • Ad, geri çağırma URL'si veya notlar dahil olmak üzere uygulama ayrıntılarını değiştirin.
   • Kimlik bilgilerini yönetin.
   • Özel özellikler ekleyin veya silin.
     Ekleyebileceğiniz maksimum özel özellik sayısı 18'dir.
   • Uygulamayı onaylayın veya iptal edin.
5. Kaydet'i tıklayın.

Kimlik bilgilerini yönetme

Bir uygulamayı düzenlerken, uygulamanın kimlik bilgilerini aşağıdaki şekilde gösterildiği gibi Kimlik bilgileri bölümünde yönetebilirsiniz:

Önceki şekilde belirtildiği gibi, Kimlik Bilgileri bölümünde kullanıcı arayüzünü kullanarak aşağıdaki görevleri gerçekleştirebilirsiniz:

• API anahtarını ve gizli anahtarını görüntüleme
• İlişkili tüm API ürünleri veya tek bir API ürünü için API anahtarını onaylayabilir veya iptal edebilirsiniz.
• Uygulamada API ürünlerini yönetme
• Yeni kimlik bilgileri oluştur

API'yi kimlik bilgilerini yönetmek için kullanmak istiyorsanız aşağıdaki bölümlere bakın:

• Uygulamalar için tüketici anahtarlarını yönetme
• Mevcut tüketici anahtarlarını ve gizli anahtarları içe aktarma

API anahtarını ve gizli anahtarı görüntüleme

Bir API anahtarını ve gizli anahtarını görüntülemek için:

1. Uygulamalar sayfasına gidin.
2. API anahtarını ve gizli anahtarını görüntülemek istediğiniz uygulamanın satırını tıklayın.
3. Kimlik Bilgileri bölümünde, görüntülemek istediğiniz API anahtarı veya gizli anahtarla ilişkili Göster'i tıklayın.

API anahtarını onaylama veya iptal etme

API proxy'lerine yapılan API çağrıları genellikle API anahtarı gerektirir. Edge, yalnızca API anahtarı onaylandığında, geçerli olduğunda ve API'yi içeren API ürünü tarafından tanımlanan koşulları karşıladığında çağrılara izin verir.

API ürünlerini yönetme bölümünde açıklandığı gibi, API anahtarlarının otomatik olarak onaylanması için bir API ürününü yapılandırabilirsiniz. Ancak API ürünü API anahtarlarının manuel olarak onaylanmasını gerektiriyorsa anahtarı manuel olarak onaylamanız gerekir.

Bir API anahtarını tüm API ürünleri veya tek bir API ürünü için iptal edebilirsiniz. Bu durumda API anahtarı ve gizli anahtar geçersizdir ve ilişkili API ürünlerindeki API'lere erişmek için kullanılamaz. API anahtarlarını istediğiniz zaman yeniden onaylayabilirsiniz.

Bir API anahtarını onaylamak veya iptal etmek için:

1. Uygulamalar sayfasına gidin.
2. Görüntülemek ve düzenlemek istediğiniz uygulamanın satırını tıklayın.
3. Düzenle'yi tıklayın.
4. Aşağıdaki görevlerden birini gerçekleştirin:
   • Bir API anahtarıyla ilişkili tüm API ürünleri için API anahtarını onaylamak veya iptal etmek üzere API anahtarıyla ilişkili Onaylandı veya İptal edildi'yi seçin.
   • Belirli bir API ürünü için API anahtarını onaylamak veya iptal etmek üzere API ürününün Durum sütununda Onaylandı veya İptal edildi'yi seçin.
5. Kaydet'i tıklayın.

Uygulamalarda API ürünlerini yönetme

Aşağıdaki görevleri gerçekleştirerek uygulamanızdaki API ürünlerini yönetin:

• Bir uygulamaya API ürünü ekleme
• API ürünlerini uygulamalardan kaldırma

Bir uygulamaya API ürünü ekleme

Bir uygulamaya API ürünü eklemek için:

1. Uygulamalar sayfasına gidin.
2. Görüntülemek ve düzenlemek istediğiniz uygulamanın satırını tıklayın.
3. Düzenle'yi tıklayın.
4. Aşağıdaki görevlerden birini gerçekleştirin:
   • Yeni bir API anahtarına API ürünü eklemek için 'yi tıklayarak yeni bir kimlik bilgisi oluşturun, bir geçerlilik süresi seçin ve API ürününü API anahtarına ekleyin.
   • Mevcut bir API anahtarına API ürünü eklemek için Kimlik Bilgileri bölümünde Ürün ekle'yi tıklayın ve açılır listeden API ürününü seçin.
5. Kaydet'i tıklayın.

API ürününü uygulamadan kaldırma

Bir API anahtarını etkin durumda tutmak ancak bir API ürünü tarafından kullanılmasına izin vermemek istiyorsanız anahtarı ilişkili kimlik bilgisinden kaldırabilirsiniz.

1. Uygulamalar sayfasına gidin.
2. Görüntülemek ve düzenlemek istediğiniz uygulamanın satırını tıklayın.
3. Düzenle'yi tıklayın.
4. API ürününün yanındaki simgesini tıklayın.
5. Kaydet'i tıklayın.

Kaldırılan bir ürünü yeniden ekleyebilirsiniz.

Yeni kimlik bilgileri oluşturma

Bir uygulama için yeni kimlik bilgileri oluşturabilirsiniz. Örneğin, API anahtarı rotasyonu kullanıyorsanız süresi dolduğunda rotasyondan çıkacak anahtarlarla çakışan yeni anahtarlar oluşturabilirsiniz. Orijinal anahtarın/gizli anahtarın güvenliği ihlal edilirse yeni bir anahtar/gizli anahtar da oluşturabilirsiniz. Yeni bir anahtar oluşturursanız mevcut API anahtarları, süresi dolana veya açıkça iptal edilene kadar çalışmaya devam eder.

Yeni bir API anahtarı oluşturmak için:

1. Uygulamalar sayfasına gidin.
2. Görüntülemek ve düzenlemek istediğiniz uygulamanın satırını tıklayın.
3. Düzenle'yi tıklayın.
4. Kimlik Bilgileri bölümünde simgesini tıklayın.
5. Süre sonunu belirtin, API ürünlerini ekleyin ve durumlarını ayarlayın.
6. İsteğe bağlı olarak, diğer API anahtarlarından herhangi birini gerektiği gibi iptal edin.
7. Kaydet'i tıklayın.

Uygulamaları onaylama veya iptal etme

bölümünde açıklandığı gibi, belirli bir kullanıcıyla ilişkilendirilmiş uygulamaları onaylayabilir veya iptal edebilirsiniz.

Aşağıda açıklandığı şekilde bir uygulamayı onaylayın veya iptal edin. Bir uygulamayı iptal ettiğinizde, onaylanan API anahtarları artık Edge'e yapılan API çağrılarında kullanılamaz. Bir uygulamayı yeniden onayladığınızda, API çağrıları yapmak için onaylanmış ve geçerli olan tüm API anahtarları kullanılabilir.

Uygulama başka kuruluşlara kayıtlıysa bu kuruluşların her birinde uygulamayı iptal etmeniz gerekir. Değişikliklerin tüm ileti işleyiciler tarafından tanınması birkaç dakika sürebilir.

Bir uygulamayı onaylamak veya iptal etmek için:

1. Uygulamalar sayfasına gidin.
2. Görüntülemek ve düzenlemek istediğiniz uygulamanın satırını tıklayın.
3. Düzenle'yi tıklayın.
4. Uygulamayı onaylamak veya iptal etmek için Uygulama Durumu alanında Onayla'yı veya İptal et'i seçin.
5. Kaydet'i tıklayın.

Uygulama silme

Bir uygulamayı sildiğinizde, uygulamayla ilişkili tüm istemci anahtarları geçersiz hale gelir. Bir istekte geçersiz anahtar kullanılması, isteğin başarısız olmasına neden olur.

Geliştirici uygulamasını ileride yeniden etkinleştirmek isteyebilirsiniz. Bu durumda, silme yerine uygulamayı iptal edebilirsiniz.

Uygulamayı silmek için:

1. Uygulamalar sayfasına gidin.
2. İmleci, silmek istediğiniz uygulamanın satırına getirin.
3. İşlemler sütununda simgesini tıklayın.

Not: Herkese Açık Bulut için Apigee Edge'de geliştirici uygulamasının ve ilişkili yapıların silinmesi eşzamanlı değildir. Geliştirici uygulaması hemen silinir ancak bu geliştirici uygulamasıyla ilişkili kaynakların (ör. uygulama anahtarları veya erişim jetonları) otomatik olarak silinmesi birkaç saniye ile birkaç dakika arasında sürebilir.

API'yi kullanarak uygulamaları kaydetme ve API anahtarlarını yönetme

API'yi kullanarak uygulamaları kaydetmek ve yönetmek için Geliştirici uygulamalarını kaydetme başlıklı makaleyi inceleyin. API referans dokümanlarında aşağıdaki bölümlere de göz atın:

• Uygulamalar
• Uygulamalar: Şirket
• Uygulamalar: Geliştirici
• Şirket Uygulama Anahtarları
• Geliştirici Uygulama Anahtarları

Ayrıca Mevcut tüketici anahtarlarını ve gizli anahtarları içe aktarma başlıklı makaleyi de inceleyin.