4.15.04.00 - Private Cloud için Apigee Edge sürüm notları

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

19 Mayıs 2015 Salı günü, Apigee Edge Private Cloud'un üç aylık sürümünü yayınladık.

Eski ürün adı "Apigee Edge On-premises" veya "OPDK" artık "Apigee Edge for Private Cloud" olarak adlandırılıyor.

Sorularınız için Apigee Edge Destek Ekibi ile iletişime geçin.

Tüm Apigee Edge sürüm notlarının listesi için Apigee Sürüm Notları'na bakın.

Yeni özellikler ve geliştirmeler

Bu sürümdeki yeni özellikler ve geliştirmeler aşağıda verilmiştir.

OpenLDAP - yükleme ve yükseltme

OpenLDAP artık yeni ve yükseltme kurulumları için Edge tarafından desteklenen tek LDAP sunucusudur.

API Hizmetleri

Edge API Hizmetleri'ndeki yeni özellikler ve geliştirmeler aşağıda verilmiştir.

WebSockets

Edge, bir web istemcisi ile sunucu arasında gerçek zamanlı web iletişimi sağlamak için WebSocket protokolünü destekler. Edge, WebSocket iletişimlerinde istemci veya sunucu rolünü oynayabilir. Edge'de WebSocket'leri ayarlama ve kullanma hakkında bilgi edinmek için Apigee Edge for Private Cloud Using WebSockets kılavuzunu inceleyin.

API yönetimi için harici kimlik doğrulama sağlayıcı desteği

Edge, Active Directory ve API yönetim kullanıcılarınızı içeren diğer harici kimlik doğrulama sağlayıcılar/LDAP sistemleriyle entegre olur. Daha fazla bilgi için Edge for Private Cloud Harici Kimlik Doğrulama Yapılandırması kılavuzuna bakın.

Yönetim kullanıcı arayüzünde birlikte markalama

Edge yönetim kullanıcı arayüzüne, Apigee logosunun yanında görünen kendi özel logonuzla ortak marka oluşturabilirsiniz. Daha fazla bilgi için Apigee Edge for Private Cloud Operations Guide'daki "Adding a custom logo to the Apigee UI menu" (Apigee kullanıcı arayüzü menüsüne özel logo ekleme) başlıklı makaleyi inceleyin.

İzlemede Node.js günlükleri

Node.js API proxy'lerinde hata ayıklarken API proxy düzenleyicisinin İzleme görünümünde Node.js Günlüğü özelliğini etkinleştirebilirsiniz. Özelliği etkinleştirmek için kurulumunuzdaki apigee-base.conf veya apigee-onpremise.conf dosyasında apigee.feature.disableNodeJSLogs="false" değerini ayarlayın. Node.js günlüğü hakkında daha fazla bilgi için Node.js proxy'lerinde hata ayıklama ve sorun giderme başlıklı makaleyi inceleyin.

Şifre süre sonu

Edge 4.15.01.x sürümünde Edge şifrelerinin süresi 30 gün sonra otomatik olarak doluyordu. Bu durumda, kullanıcılar şifrelerinin süresi dolmadan önce değiştirmedikleri takdirde hesaplarına erişemiyordu. Ancak bu durum, sistem yöneticisinin şifresinin süresinin dolmasına da neden oldu ve sistem yöneticisinin Edge'e erişimi engellendi.

4.15.04.00 sürümüne yükselttiğinizde varsayılan ayar, şifrelerin geçerlilik süresinin dolmaması şeklinde değişir. Gerekirse /opt/apigee4/bin/apigee-enable-pwlockout.sh komut dosyasını kullanarak Edge şifrelerinin geçerlilik süresini sona erecek şekilde yapılandırabilirsiniz. Daha fazla bilgi için Apigee Edge for Private Cloud Operations Guide'ı inceleyin.

Sistem yöneticisi erişimini belirli e-posta alanlarıyla sınırlama

sysadmin veya sysadmin read-only rollerine üyeliği belirli e-posta alanlarındaki kullanıcılarla sınırlayabilirsiniz. Bu özelliği etkinleştirmek için izin verilen alanları Apigee Edge for Private Cloud Operations Guide'da açıklandığı gibi apigee4/conf/apigee/management-server/security.properties dosyasına ekleyin.

Yönetim kullanıcı arayüzündeki hata mesajları

Yönetim kullanıcı arayüzünde hata mesajı gösterimi, ekran alanını daha verimli kullanacak şekilde yeniden tasarlandı.

Yeni OAuthV2 hata değişkenleri

Bu yeni hata ile ilgili değişkenler OAuthV2 politikası tarafından ayarlanır:

  • oauthV2.<policy-name>.failed: Politika başarısız olduysa doğru değerine ayarlanır.
  • oauthv2.<policy_name>.<fault_name>: Hatayı adı. Örneğin, invalid_request
  • oauthv2.<policy_name>.<fault_cause>: Hata nedeni. Örneğin: Jetonun süresi doldu

http://apigee.com/docs/api-services/content/oauthv2-policy adresini ziyaret edin.

Ürün oluşturma

Yeni bir ürün oluştururken artık görünen adın yanı sıra ürün adını da belirtebilirsiniz.

http://apigee.com/docs/developer-services/content/creating-api-products adresine bakın.

Kullanıcıları kuruluştan kaldırma kullanıcı arayüzü

Kullanıcı arayüzündeki Kuruluş Kullanıcıları sayfasında Sil düğmesi, Kaldır düğmesiyle değiştirildi. Bu, bir kullanıcıyı kuruluştan kaldırdığınızda kullanıcının Apigee hesabının etkin kalacağını netleştirmek için yapılır.

http://apigee.com/docs/api-services/content/managing-organization-users adresine bakın.

Yönetim kullanıcı arayüzündeki filtreleme seçenekleri

Yönetim kullanıcı arayüzündeki API Proxies, Products, Developers ve Apps sayfalarında arama için yeni filtreleme seçenekleri sunulur.

Çevrimdışı İzleme Aracı

Çevrimdışı İzleme aracı, daha önce kaydedilmiş izleme oturumlarını görüntülemenize ve analiz etmenize olanak tanır. Kaydedilen izleme oturumu, temelde bir izleme oturumunun "kaydı"dır ve sorun giderme ile daha fazla analiz gerektiren durumlarda faydalı olabilir. Çevrimdışı İzleme aracının kullanıcı arayüzü, "canlı" İzleme aracının kullanıcı arayüzüne benzer.

Daha fazla bilgi için Çevrimdışı İzleme aracını kullanma başlıklı makaleyi inceleyin.

Kullanıcı ayarlarında gösterilen kullanıcı rolleri

Yönetim kullanıcı arayüzünün Kullanıcı Ayarları sayfasında (kullanıcı adı > Kullanıcı Ayarları) kullanıcının rolleri artık gösteriliyor.

Edge yönetim kullanıcı arayüzünde geliştirmeler

Bu sürüm, Edge yönetim kullanıcı arayüzünde kullanışlılık ve tutarlılıkla ilgili bir dizi küçük iyileştirme içerir.

Analytics Hizmetleri

Edge Analytics Services'teki yeni özellikler ve geliştirmeler aşağıda verilmiştir.

Altı aylık veriler kullanılabilir

Yönetim kullanıcı arayüzü veya API ile analiz raporları oluştururken, geçerli tarihten altı aydan daha eski verilere varsayılan olarak erişilemez. Altı aydan eski verilere erişmek istiyorsanız Apigee Edge Destek Ekibi ile iletişime geçin.

Analize eklenen değişkenler

Aşağıdaki yeni değişkenler, API proxy izleme penceresinin AX aşamasında görülebilen Edge Analytics'e iletilir.

  • apigee.edge.execution.is_target_error: API hatalarının hedef tarafı hataları (değer "1") mı yoksa başarısız HTTP yanıtları için hedef olmayan hatalar (değer "0") mı olduğunu belirlemenizi sağlar. Değer, başarılı bir HTTP yanıtı için null'dur.
  • apigee.edge.execution.is_policy_error: Bir politikanın başarısız olup olmadığını (değer "1") veya başarısız bir HTTP yanıtında herhangi bir politikanın başarısız olmadığını (değer "0") belirlemenizi sağlar. Değer, başarılı bir HTTP yanıtı için null'dur.
    Aşağıdaki ilgili değişkenler, önce başarısız olan politikanın ayrıntılarını sağlar. Hiçbir politika başarısız olmadıysa değerler boş olur.
    • apigee.edge.execution.fault_policy_name: Başarısız olan politikanın adı.
    • apigee.edge.execution.fault_flow_name: Politikada başarısız olan akışın adı (ör. PreFlow, PostFlow veya kullanıcı tanımlı bir akış).
    • apigee.edge.execution.fault_flow_state: Politikaların akışa eklendiği konum. Olası değerler: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.

Gösterge Tabloları

  • API'ler, geliştiriciler, ürünler ve geliştirici uygulamalarıyla ilgili performans grafikleri taşındı. Bu öğeler, ana sayfaların alt kısmında gösteriliyordu. Artık her sayfanın üst kısmındaki Analytics sekmesini seçerek grafiklere erişebilirsiniz.
  • Bu sürümde, mevcut veya yeni şu kontrol panellerinde önemli çalışmalar yapıldı:
    • Apigee Kontrol Paneli (Revize Edildi): Proxy Trafiği, Geliştirici Etkileşimi ve Geliştirici Uygulamaları olmak üzere üç metrik grafiği içerir. Her grafik, her metriği ayrıntılı olarak incelemenize olanak tanıyan bir "daha fazla ayrıntı" görünümü sunar. Apigee kontrol paneli başlıklı makaleyi inceleyin.
    • Proxy Performansı (Yeni): API proxy trafik kalıplarını ve işleme sürelerini gösterir. API Proxy Performansı kontrol panelinin yerini alır. API Proxy Performansı başlıklı makaleyi inceleyin.
    • Trafik Bileşimi (Yenilendi): Kontrol panelinin görünümü ve içeriği tamamen yenilendi. En iyi API'lerinizin, uygulamalarınızın, geliştiricilerinizin ve ürünlerinizin genel API programınıza göreceli katkısını ölçer. Trafik bileşimi başlıklı makaleyi inceleyin.
    • Hata Analizi (Revize Edildi): Görünüm ve içerik tamamen revize edildi. API proxy'leri ve hedefleri için hata oranlarını gösterir. Hata Kodu Analizi Kontrol Paneli'ne bakın.
  • Mevcut kontrol panellerinin adları değiştirildi:
    • Uç nokta performansı, Hedef Performansı olarak yeniden adlandırıldı: API proxy arka uç hedeflerinin trafik kalıplarını ve performans metriklerini gösterir. Hedef performansı bölümünü inceleyin.
    • İş Ortağı Etkileşimi, Geliştirici Etkileşimi olarak yeniden adlandırıldı: Kayıtlı uygulama geliştiricilerinizden hangisinin en fazla API trafiği oluşturduğunu gösterir. Her bir geliştiriciniz için en fazla API trafiğini ve en fazla hatayı kimin oluşturduğunu öğrenebilirsiniz. Geliştirici etkileşimi başlıklı makaleyi inceleyin.

Geliştirici Hizmetleri

Edge Developer Services'teki yeni özellikler ve geliştirmeler aşağıda verilmiştir.

SmartDocs için Swagger 2.0 desteği

Smart Docs, Swagger 2.0 spesifikasyon belgelerinin içe aktarılmasını destekler ve Swagger 1.2 ile geriye dönük uyumluluğu korur. Güvenlik şeması nesneleri ve merkezi şemalar için destek sonraki bir sürümde kullanıma sunulacaktır.

Para kazanma

Edge para kazanma özelliğindeki yeni özellikler ve geliştirmeler aşağıda verilmiştir. Para kazanma hakkında daha fazla bilgi için "Bilinen sorunlar" bölümüne de bakın.

Şirketler ve geliştiriciler için ayrı işlem

Şirketler ve geliştiriciler artık ayrı ayrı ele alınıyor. Bu sayede, geliştiricilere birden fazla şirket ve şirketlere birden fazla geliştirici ekleme konusunda daha fazla esneklik sağlanıyor. Yönetim kullanıcı arayüzünde artık "Şirketler" ve "Geliştiriciler" için ayrı pencereler bulunur ("Yayınla" menüsünden erişilebilir).

Şirketleri ve geliştiricileri yönetme başlıklı makaleyi inceleyin.

Para kazanma raporlarında, filtre etiketi "Geliştiriciler"den "Şirketler"e değişmiş olsa da şirketler birincil filtre olarak kalmaya devam eder.

Düzeltilen hatalar

Bu sürümde aşağıdaki hatalar düzeltilmiştir.

Sorun Kimliği Açıklama
OPDK-954 4.15.01 Cassandra şeması yükseltilmedi
MGMT-1986 Geliştirici eklenirken kullanıcı arayüzü hatası
MGMT-1983 OAuth 2.0 yetkilendirme kodu alma API'si yanlış durum döndürüyor
MGMT-1962 Güçlü şifreyle yönetim kullanıcı arayüzüne giriş yaparken hata
Yüzde işareti gibi belirli özel karakterlerle kullanıcı arayüzüne giriş yaparken artık hata oluşmuyor.
MGMT-1894 Geliştirici uygulamaları sayfası, geliştirici sütunu için hiçbir zaman yüklenmeyi tamamlamıyor
MGMT-1872 Özel raporlar indirilemiyor
MGMT-1777 .acn üst düzey alan adına sahip e-posta adresi olan kullanıcı eklenemiyor
MGMT-1362 E-posta adresi "_" içeriyorsa şifremi unuttum e-postası çalışmıyor
Alt çizgi içeren e-posta adresleriyle Özel Bulut'taki şifre sıfırlama sorunu düzeltildi.
CORERT-613 "unrecognized_name" nedeniyle SSL el sıkışma hataları
APIRT-1346 OAuth2.0 - hash.oauth.tokens.enabled doğru olduğunda erişim jetonu yanıtında karma oluşturulmuş değer döndürülür

Bu sürüm, aşağıdaki sürümlerdeki hata düzeltmelerini de içerir:

Edge Cloud Edge for Private Cloud

Bilinen sorunlar

Bu sürümde aşağıdaki bilinen sorunlar var.

Sorun Kimliği Açıklama
Yok

Yükleyicinin para kazanma yükleme veya yükseltme işleminde kullandığı iki Cassandra komut dosyası, sürümde yer almadı.

Bu sorunu çözmek için Cassandra yüklemesinden veya yükseltmesinden sonra aşağıdaki komutları çalıştırarak para kazanma yüklemesini/yükseltmesini tamamlayın:

  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/360-company-developers.txt
  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/320-update-notification-service_item.txt
CORERT-318 Büyük yükler (100'lerce KB) içeren API çağrıları bazen askıda kalabilir. Bu sorunu çözmek için router.properties dosyanızda şu özellik değerini ayarlayın:
HTTPServer.streaming.buffer.limit=0 (varsayılan ayar 10'dur)