Drupal tabanlı bir portal ile Edge arasında iletişim kurma

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

Geliştirici Hizmetleri portalı, Apigee Edge için istemci görevi görür. Bu, portalın bağımsız bir sistem olarak çalışmadığı anlamına gelir. Bunun yerine, portal tarafından kullanılan bilgilerin çoğu Edge'de saklanır. Portal, gerektiğinde Edge'den bilgi almak veya Edge'e bilgi göndermek için HTTP veya HTTPS isteği gönderir.

Edge, portala istek göndermez, yalnızca portaldan gönderilen isteklere yanıt verir. Bu nedenle, portal ile Edge arasındaki tüm etkileşimler portal tarafından başlatılır.

Portal ile Edge arasındaki bağlantıyı yapılandırma

Portalın Edge ile iletişim kurması için aşağıda belirtilen üç bilgi gerekir.

• Edge uç noktasının URL'si
  
  Edge'in bulut tabanlı sürümünün varsayılan uç noktası https://api.enterprise.apigee.com/v1'dir.
  
  Özel Bulut kurulumu için URL şu şekildedir: http://EdgePrivateCloudIp:8080/v1 veya https://EdgePrivateCloudIp:TLSport/v1.
  
  Burada EdgePrivateCloudIp, Edge Yönetim Sunucusu sunucusunun IP adresi, TLSport ise Edge yönetim API'sinin TLS/SSL bağlantı noktasıdır. Örneğin, 8443.
• Apigee kuruluş adı
  
  Bu, Edge'deki kuruluşunuzun adıdır. Kuruluşu, Edge'de hesabınızı oluştururken ayarlarsınız.
• Geliştirici yöneticisinin kullanıcı adı ve şifresi
  
  Portaldan Edge'e yapılan çağrıların kimliği doğrulanır ve Geliştirici Yöneticisi ayrıcalıklarına sahip bir kullanıcı gerektirir. Sizin için bir Geliştirici Portalı hazırlandığında kuruluşunuza Geliştirici Yöneticisi rolü eklenir. devadmin+{org_name}@apigee.com adlı tek bir kullanıcıyı içeren bu rol, yalnızca Geliştirici Portalınızı Edge kuruluşunuza bağlamak içindir. Portal, Edge geliştirici uygulamalarınızı, API ürünlerinizi vb. gösterdiğinden kimlik doğrulama gerektiren yönetim API çağrıları yaparak Edge kuruluşunuzla senkronize kalmalıdır. "user" adlı geliştirici yöneticisi gerekli izinlere sahiptir.
  

Bağlantı bilgilerini görüntülemek için:

1. Drupal yönetim menüsünde Yapılandırma > Geliştirici Portalı > Uygulama Ayarları'nı seçin.

Yapılandırmayı değiştirmek için:

Yapılandırmayı değiştirme şekliniz, portal kurulumunuza ve portal sürümünüze bağlıdır:

• 15.01.06 ve sonraki sürümlerin bulut tabanlı kurulumu: Bağlantı bilgilerini değiştirmek için Apigee Edge Destek Ekibi'ne istekte bulunmanız gerekir. Örneğin, kuruluşun adını değiştirmek isterseniz
• 15.01.06 sürümünden önceki sürümlerde şirket içi kurulum ve bulut tabanlı portal: Bağlantı bilgilerini aşağıda açıklandığı şekilde değiştirin:

1. Drupal yönetim menüsünde Yapılandırma > Dev Portal Ayarları'nı seçin.
2. Management API Kuruluşu alanına kuruluşunuzun adını girin.
3. Management API Uç Noktası URL'si alanına Edge uç noktasının URL'sini girin.
4. Uç Nokta Kimlik Doğrulaması Yapılan Kullanıcı ve Kimlik Doğrulaması Yapılan Kullanıcının Şifresi alanlarına kuruluş yöneticisi kimlik bilgilerini girin.
5. Bağlantının başarılı olduğundan emin olmak için Bağlantıyı Test Et'i seçin.
6. Yapılandırmayı Kaydet'i seçin.

Portaldan Edge'e erişim sağlama

Portal tarafından kullanılan bilgilerin çoğu Edge'de depolandığından, portalın Edge'e erişebildiğinden emin olmanız gerekir. Portal, HTTP ve HTTPS üzerinden REST istekleri göndererek Edge ile iletişimi başlatır. Örneğin, bir geliştirici portala yeni bir uygulama kaydettiğinde portal, Edge'e uygulamayla ilgili bilgileri göndermesi için istek gönderir.

Hem Edge hem de portal bulutta veya şirket içinde dağıtılabilir. Ayrıca dağıtım türlerini karıştırabilirsiniz. Örneğin, hem bulutta hem de şirket içinde dağıtabilir veya birini bulutta, diğerini şirket içinde dağıtabilirsiniz:

• Hem portal hem de Edge, Apigee tarafından bulutta dağıtılmışsa portaldan Edge'e istek gönderirken sorun yaşanmaz.
• Portalı şirket içinde dağıtırsanız, Edge'in bulutta veya şirket içinde dağıtılmış olması fark etmeksizin portalın Edge'e istek gönderebildiğinden emin olmanız gerekir.
• Edge'i şirket içinde dağıtıyorsanız portalın Edge'e erişebildiğinden emin olmanız gerekir. Bu nedenle, Edge sunucunuzun portalın bulutta veya şirket içinde dağıtılmış olmasına bakılmaksızın portaldan gelen istekleri kabul etmesi gerekir.

Uygulamaları ve API anahtarlarını portaldan yönetme

Geliştirici portalda uygulama kaydı sürecini tamamladığında portal, uygulama adı ve uygulamayla ilişkili API ürünleri de dahil olmak üzere uygulamayla ilgili bilgileri Edge'e gönderir.

Edge, uygulamayı başarıyla kaydederse portala tek bir API anahtarı döndürür. Geliştirici, uygulamayla ilişkili API ürünlerine erişmek için bu API anahtarını kullanır.

Uygulamalar ve API anahtarları hakkında hiçbir bilgi portalda depolanmaz. Bunun yerine, tüm bu bilgiler Edge'de saklanır. Bu nedenle, bir geliştirici bir uygulamayla ilgili bilgileri görüntülemek için portalı her kullandığında portal, Edge'e bu bilgilere erişmek için istek gönderir. Geliştirici bir uygulamada değişiklik yaptığında portal bu değişiklikleri otomatik olarak Edge'e gönderir.

Örneğin, bir geliştirici portala giriş yapar ve Uygulamalarım sayfasına gider. Portal, Uygulamalarım sayfasını doldurmak için geliştiricinin uygulamaları ve API anahtarları hakkında bilgi almak üzere Edge'e istek gönderir. Bu bilgiler daha sonra geliştiricinin portaldaki Uygulamalarım sayfasında görünür:

Geliştirici daha sonra bir uygulama eklerse, kaldırırsa veya değiştirirse portal bu değişiklikleri Edge'e gönderir.

Uygulamalar ve API anahtarlarıyla ilgili tüm bilgiler Edge'de depolandığından Edge yöneticisi, Edge kullanıcı arayüzünü kullanarak bu bilgileri değiştirebilir. Örneğin, yöneticiler:

• Geliştiricinin uygulamasını ekleme, kaldırma veya değiştirme
• Bir uygulamanın API anahtarını iptal etme veya onaylama

Aşağıda, Edge kullanıcı arayüzünde bir yöneticiye göründüğü şekliyle aynı uygulama ("Hava Durumu Uygulamam") gösterilmektedir:

Geliştiricileri portaldan yönetme

Bir geliştirici yeni portal kullanıcısı olarak kaydolduğunda geliştirici Edge'de ve portalda oluşturulur. Bu nedenle, uygulamalar ve API anahtarlarının aksine, geliştiricilerle ilgili bilgiler hem Edge'de hem de portalda saklanır.

Edge'de saklanan geliştirici bilgileri şunları içerir:

• Ad
• Soyadı
• E-posta adresi
• Portaldan gönderilen isteğe bağlı ek bilgiler

Portal, Edge ile aynı bilgileri depolar ancak aşağıdakiler gibi ek bilgiler de depolar:

• Portal şifresi
• Portal hesap durumu: etkin veya engellenmiş
• Portal rolü: kimliği doğrulanmış kullanıcı, yönetici, diğer
• Role dayalı izinler: Geliştiricinin portalda gerçekleştirmesine izin verilen işlemleri belirler.

Bir geliştirici portala giriş yaptığında geliştiricinin kimliğini doğrulamaktan ve rol tabanlı izinleri uygulamaktan portal sorumludur.

Portal, geliştiricilerle ilgili tüm bilgileri depoladığından portalı Edge değil, geliştirici bilgileri için kayıt sistemi olarak düşünün. Geliştirici portaldaki bilgilerini değiştirdiğinde bu bilgiler portalda depolanır ve varsa Edge'e gönderilir. Örneğin, geliştirici adını değiştirirse bu bilgiler Edge'e gönderilir. Ancak geliştirici şifresini değiştirirse bu bilgiler yalnızca portalda yerel olarak saklanır.

Daha fazla bilgi için Kullanıcı hesapları ekleme ve yönetme başlıklı makaleyi inceleyin.

Uygulama geliştiricilerini portal ile Edge arasında senkronize etme

Edge, portalla iletişimi başlatmaz. Edge yöneticisi olarak Edge kullanıcı arayüzünde bir geliştiriciyle ilgili bilgileri değiştirirseniz bu bilgilerin portala ne zaman gönderileceği garanti edilmez. Bu nedenle, geliştirici oluşturmak, değiştirmek ve silmek için Edge'i değil, portalın yönetim özelliklerini kullanın.

Portal yöneticileri, Edge'den portala bilgi indirmek için portal ile Edge arasında senkronizasyon yapılmasını zorunlu kılabilir. Ancak geliştiricileri yalnızca portalda değiştirirseniz ve Edge'de değiştirmezseniz bu senkronizasyonu hiç yapmanız gerekmez. Ayrıca, Edge bir geliştirici oluşturduğunuzda şifre belirlemenize izin vermez. Bu nedenle, Edge'de oluşturulan tüm geliştiricilerin portal şifresi rastgele bir değere ayarlanır. Bu nedenle, geliştiricinin portala giriş yapabilmesi için şifre kurtarma sürecini tamamlaması gerekir.

Portalı Edge'deki uygulama geliştiricilerle senkronize etmek için

:

• Yönetici veya içerik oluşturma ayrıcalıklarına sahip bir kullanıcı olarak portalınıza giriş yapın.
• Drupal yönetim menüsünde Kullanıcılar'ı seçin.
• Edge'deki uygulama geliştiricilerle senkronize olmak için sayfanın üst kısmındaki Dev Portal Geliştirici Senkronizasyonu düğmesini seçin.