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

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

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

Edge, portala istek göndermez, yalnızca portaldan yapılan isteklere yanıt verir. Bu nedenle, portal ve 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

Aşağıda belirtildiği gibi, portalın Edge ile iletişim kurması gereken üç bilgi vardır.

• Edge'nin uç noktasının URL'si
  
  Edge'in bulut tabanlı sürümü için varsayılan uç nokta şudur: https://api.enterprise.apigee.com/v1.
  
  Private Cloud kurulumu için URL şu biçimdedir: http://EdgePrivateCloudIp:8080/v1 veya https://EdgePrivateCloudIp:TLSport/v1.
  
  Burada EdgePrivateCloudIp, Edge Management Server sunucusunun IP adresi, TLSport ise Edge Management API'nin TLS/SSL bağlantı noktasıdır. Örneğin, 8443.
• Apigee kuruluş adı
  
  Kuruluşunuzun Edge'deki 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ı gerekir. Sizin için bir Geliştirici Portalı temel hazırlığı yapıldığında kuruluşunuza Geliştirici Yöneticisi rolü eklenir. devadmin+{org_name}@apigee.com adında tek bir kullanıcıyı içeren bu rol, yalnızca Geliştirici Portalınızı Edge kuruluşunuza bağlama amacına yöneliktir. Portalda Edge geliştirici uygulamalarınızı, API ürünlerinizi ve benzeri öğeler görüntülendiğinden kimlik doğrulama gerektiren yönetim API'si çağrıları yaparak Edge kuruluşunuzla senkronize olması gerekir. Geliştirici yöneticisi "kullanıcısı" gerekli izinlere sahip.
  

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ı nasıl değiştireceğiniz, portal yüklemenize ve portal sürümünüze bağlıdır:

• 15.01.06 ve üzeri portal sürümü için bulut tabanlı yükleme: Bağlantı bilgilerini değiştirmek için Apigee Edge Destek Ekibi'ne istek göndermeniz gerekir. Örneğin, kuruluşun adını değiştirmek için bu seçeneği belirleyebilirsiniz.
• 15.01.06 sürümünden eski şirket içi yükleme ve bulut tabanlı portal: Bağlantı bilgilerini aşağıda açıklanan şekilde değiştirin:

1. Drupal yönetim menüsünde Yapılandırma > Geliştirici Portalı Ayarları'nı seçin.
2. Management API Kuruluşu alanına kuruluşunuzun adını girin.
3. Management API Endpoint URL (Yönetim API'si Uç Nokta URL'si) alanına Edge uç noktasının URL'sini girin.
4. Uç Nokta Kimlik Doğrulaması Yapılmış Kullanıcı ve Kimliği Doğrulanmış 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. Save Configuration'ı (Yapılandırmayı Kaydet) seçin.

Portaldan Edge'e erişim sağlama

Portal tarafından kullanılan bilgilerin büyük kısmı Edge'de saklandığı için portalın Edge'e erişebildiğinden emin olmanız gerekir. Portal, HTTP ve HTTPS üzerinden REST istekleri oluşturarak Edge ile iletişimi başlatır. Örneğin, bir geliştirici portala yeni bir uygulama kaydettirdiğinde portal, uygulama hakkındaki bilgilerin Edge'e gönderilmesi için Edge'den istekte bulunur.

Hem Edge hem de portal bulutta veya şirket içinde dağıtılabilir. Dağıtım türlerini birlikte kullanabilirsiniz. Örneğin, hem şirket içinde hem de bulutta dağıtım yapabilir veya birini bulutta, diğerini de şirket içinde dağıtabilirsiniz:

• Hem portal hem de Edge bulutta Apigee tarafından dağıtılıyorsa portaldan Edge'e istek gönderilirken herhangi bir sorun olmaması gerekir.
• Portalı şirket içinde dağıtıyorsanız Edge'in bulutta veya şirkette dağıtılmasından bağımsız olarak portalın Edge'e istek gönderebildiğinden emin olmanız gerekir.
• Edge'yi şirket içinde dağıtıyorsanız portalın Edge'e erişebildiğinden emin olmanız gerekir. Bu nedenle, portalın bulutta veya şirkette dağıtılmış olup olmadığına bakılmaksızın, uç sunucunuzun portaldan gelen istekleri kabul etmesi gerekir.

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

Geliştirici, portalda uygulama kayıt işlemini 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 daha sonra bu API anahtarını, uygulamayla ilişkilendirilen API ürünlerine erişmek için kullanır.

Portalda aslında uygulamalar ve API anahtarları hakkında herhangi bir bilgi depolanmaz. Bunun yerine, tüm bu bilgiler Edge'de depolanır. Bu nedenle, geliştiriciler bir uygulamayla ilgili bilgileri görüntülemek için portalı her kullandığında, portal bu bilgilere erişmek için Edge'den bir istekte bulunur. Geliştirici bir uygulamada her 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 Edge'den, geliştiricinin uygulamaları ve API anahtarları hakkında bilgi alması için bir istekte bulunur. Bu bilgiler daha sonra geliştiricinin portaldaki Uygulamalarım sayfasında görünür:

Daha sonra geliştirici bir uygulama ekler, kaldırır veya değiştirirse portal bu değişiklikleri Edge'e gönderir.

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

• Geliştirici uygulaması ekleme, kaldırma veya değiştirme
• Bir uygulama için 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ın ve API anahtarlarının aksine, geliştiricilerle ilgili bilgiler aslında hem Edge'de hem de portal'da depolanır.

Edge'de depolanan 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 bilgileri de depolar:

• Portal şifresi
• Portal hesabı durumu: etkin veya engellendi
• Portal rolü: kimliği doğrulanmış kullanıcı, yönetici, diğer
• Rol tabanlı izinler: Geliştiricinin portalda gerçekleştirmesine izin verilen işlemleri belirleme

Bir geliştirici portala giriş yaptığında geliştiricinin kimliğini doğrulamak ve rol tabanlı izinleri zorunlu kılmak sorumlu olan portaldır.

Portalda bir geliştiriciyle ilgili tüm bilgiler depolandığından, portalı Edge değil, geliştirici bilgilerinin 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 bilgi Edge'e gönderilir. Ancak geliştirici, şifresini değiştirirse bu bilgiler yalnızca portalda yerel olarak depolanır.

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

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

Edge, portalla iletişimi başlatmaz. Bir EDGE yöneticisi olarak Edge kullanıcı arayüzünde bir geliştiriciyle ilgili bilgileri manipüle ederseniz, bu bilgilerin portala ne zaman aktarılacağının garantisi yoktur. Bu nedenle, geliştirici oluşturmak, değiştirmek ve silmek için Edge yerine portalın yönetim özelliklerini kullanın.

Portal yöneticisi, Edge'den portala bilgi indirmek için portal ile Edge arasında bir senkronizasyonu zorlayabilir. Ancak Edge'de değil de yalnızca portaldaki geliştiricileri değiştiriyorsanız bu senkronizasyonu hiçbir zaman yapmanız gerekmez. Ek olarak, Edge geliştirici oluştururken şifre belirlemenize izin vermediğinden, 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 önce şifre kurtarma işlemini tamamlaması gerekir.

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

:

• Portalınıza yönetici veya içerik oluşturma ayrıcalıklarına sahip bir kullanıcı olarak giriş yapın.
• Drupal yönetim menüsünde Kişiler'i seçin.
• Edge'deki uygulama geliştiricileriyle senkronize etmek için sayfanın üst kısmındaki Dev Portal Developer Sync (Geliştirici Portalı Geliştirici Senkronizasyonu) düğmesini seçin.