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

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

Uygulamaları kaydedin ve API anahtarlarını yönetin (aşağıdaki bölümlerde açıklandığı şekilde).

Giriş

Uygulama kaydı, API'lerinize kimlerin erişebileceğini kontrol etmenizi sağlayan temel mekanizmadır.

API sağlayıcı olarak, API ürünlerini yönetme bölümünde açıklandığı gibi API'lerinizi paketlemek için bir veya daha fazla API ürünü oluşturursunuz. Bir uygulama kaydedilirken uygulama geliştirici, hangi API ürünlerinin kullanılacağını seçer ve Edge, geliştiricinin bu API ürünlerine erişmek için kullanabileceği tek bir API anahtarı sağlar. Uygulama geliştirici, API ürünlerinde bulunan API proxy'lerine yapılan her çağrıda API anahtarını iletir. Dilediğiniz zaman bir uygulamanın API anahtarını iptal edebilir ve uygulama geliştiricinin, söz konusu uygulama tarafından referans verilen API ürünlerinin tamamına veya bir kısmına erişmesini engelleyebilirsiniz.

Genellikle uygulama geliştiriciler, geliştirici portalınızı kullanarak API ürünlerinizi kullanmak için kaydolur. 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, bir API sağlayıcı olarak uygulama kaydı süreci üzerinde daha fazla kontrol sahibi olmak ve uygulamaları aşağıdaki bölümlerde açıklandığı gibi Edge'e kaydetmeyi tercih etmek isteyebilirsiniz. Örneğin, dahili geliştirme ekipleriniz için veya portalınıza erişimi olmayan bir geliştirici adına uygulamaları 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şin ve sayfayı inceleyin.

Uygulama kaydetme

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

• Uygulama geliştiriciler, Uygulama geliştiriciler portalınızla nasıl etkileşim kurar? başlıklı makalede 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 erişin.
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, Management 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 hybrid, şirket uygulamalarını desteklemez. Bu alan geçerli değildir. Şirket veya Geliştirici'yi seçin ve açılır listeden bir şirket ya da geliştirici adı belirleyin. Not: Performans nedeniyle, açılır listede 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ştiricileri kaydetme başlıklı makaleyi de inceleyin.	Evet
   Geri Çağırma URL'si	Genellikle istemci uygulaması adına yetkilendirme kodu alacak şekilde belirlenen bir uygulamanın URL'sini belirtir. Bu değer tüm API ürünleri için gerekli değildir.	Hayır
   Notlar	Uygulama için açıklayıcı notlar.	Hayır

4. API anahtarının geçerlilik süresi ve durumu ile ilişkili API ürünleri de dahil olmak üzere Kimlik bilgilerini 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üresini veya tarihini yapılandırın ya da API anahtarının geçerliliğinin hiçbir zaman bitmeyecek şekilde ayarlayın ve Tamam'ı tıklayın.
   Ürünler	API anahtarıyla bir veya daha fazla API ürünü 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ünleri için API anahtarlarının manuel olarak onaylanması gerekiyorsa API anahtarlarını onaylama veya iptal etme başlıklı makalede açıklandığı şekilde bu anahtarları onaylayın.

Bir geliştiriciye kayıtlı uygulamaları görüntüleme

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

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

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

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

1. Uygulamalar sayfasına erişin.
2. Görüntülemek ve düzenlemek istediğiniz uygulamanın satırını tıklayın.
   Uygulama ayrıntıları gösterilir.
3. Bir uygulamayı düzenlemek için Düzenle'yi tıklayın.
4. Aşağıdaki görevlerden birini veya daha fazlasını gerçekleştirin:
   • Ad, geri çağırma URL'si veya notlar gibi uygulama ayrıntılarını değiştirin.
   • Kimlik bilgilerini yönetme
   • Özel özellikler ekleyin veya silin.
     En fazla 18 özel özellik ekleyebilirsiniz.
   • Uygulamayı onaylayın veya erişimini iptal edin.
5. Kaydet'i tıklayın.

Kimlik bilgilerini yönetme

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

Önceki şekilde vurgulandığı 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
• Tüm ilişkili API ürünleri veya tek bir API ürünü için API anahtarını onaylayın ya da iptal edin.
• Bir uygulamada API ürünlerini yönetme
• Yeni kimlik bilgileri oluşturma

Kimlik bilgilerini yönetmek için API'yi kullanmak üzere 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ını içe aktarma

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

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

1. Uygulamalar sayfasına erişin.
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ı onaylanmış, geçerli ve API'yi içeren API ürünü tarafından tanımlanan koşulları karşılıyorsa çağrılara izin verir.

API ürünlerini yönetme başlıklı makalede açıklandığı gibi, API anahtarlarının otomatik olarak onaylanması için bir API ürü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 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 anahtarını istediğiniz zaman yeniden onaylayabilirsiniz.

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

1. Uygulamalar sayfasına erişin.
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.

Bir uygulamada API ürünlerini yönetme

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

• Uygulamaya API ürünü ekleme
• Bir uygulamadan API ürünü kaldırma

Uygulamaya API ürünü ekleme

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

1. Uygulamalar sayfasına erişin.
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: Yeni bir kimlik bilgisi oluşturmak üzere simgesini tıklayın, 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 Bilgisi 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.

Bir uygulamadan API ürünü kaldırma

Bir API anahtarının etkin kalmasını istiyor ancak bir API ürünü tarafından kullanılmasını istemiyorsanız anahtarı ilişkili kimlik bilgisinden kaldırabilirsiniz.

1. Uygulamalar sayfasına erişin.
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 geçerlilik süresi dolduğunda rotasyon dışı kalacak anahtarlarla geçerlilik süresi çakışan yeni anahtarlar oluşturabilirsiniz. Orijinal anahtar/gizli dizinin güvenliği ihlal edildiyse yeni bir anahtar/gizli dizi de oluşturabilirsiniz. Yeni bir anahtar oluşturursanız mevcut API anahtarları, süreleri dolana veya siz bunları açıkça iptal edene kadar çalışmaya devam eder.

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

1. Uygulamalar sayfasına erişin.
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. Geçerlilik süresini belirtin, API ürünlerini ekleyin ve durumlarını ayarlayın.
6. İsteğe bağlı olarak, gerektiğinde diğer API anahtarlarından herhangi birini iptal edin.
7. Kaydet'i tıklayın.

Uygulamaları onaylama veya iptal etme

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

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

Bir uygulamayı onaylamak veya iptal etmek için:

1. Uygulamalar sayfasına erişin.
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 veya İptal et'i seçin.
5. Kaydet'i tıklayın.

Uygulama silme

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

Gelecekte bir geliştirici uygulamasını yeniden etkinleştirmek isteyebileceğinizi düşünüyorsanız silme işlemine alternatif olarak uygulamayı iptal edebilirsiniz.

Uygulamayı silmek için:

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

Not: Apigee Edge for Public Cloud'da, geliştirici uygulamasının ve ilişkili yapıların silinmesi eşzamansız olarak gerçekleşir. 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ç saniyeden birkaç dakikaya kadar sürebilir.

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

API'yi kullanarak uygulamaları kaydetme ve yönetme hakkında bilgi edinmek için Geliştirici uygulamalarını kaydetme başlıklı makaleyi inceleyin. Ayrıca, API referans belgelerindeki aşağıdaki bölümlere de bakın:

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

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