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ü, Private Cloud için Apigee Edge'in üç aylık sürümünü yayınladık.

Eski ürün adı "Apigee Edge On-company" veya "OPDK", artık "Apigee Edge for Private Cloud" olarak değiştirilmiştir.

Sorularınız varsa Apigee Müşteri Desteği sayfasına gidin.

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 işlemleri 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şimini etkinleştirmek için WebSocket protokolünü destekler. Edge, WebSocket iletişimlerinde istemci veya sunucu rolünü oynayabilir. Edge'de WebSocket ayarlama ve kullanma hakkında bilgi edinmek için Apigee Edge for Private Cloud Using WebSockets (Özel Cloud'u Kullanarak Apigee Edge) kılavuzunu inceleyin.

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

Edge, Active Directory ve API yönetici kullanıcılarınızı içeren diğer harici kimlik doğrulama sağlayıcıları/LDAP sistemleriyle entegre olur. Daha fazla bilgi edinmek için Edge for Private Cloud External Authentication Configuration kılavuzuna bakın.

Yönetim kullanıcı arayüzünde ortak markalama (co-branding)

Apigee logosunun yanında görünen kendi özel logonuzu kullanarak Edge yönetim kullanıcı arayüzünü birlikte markalayabilirsiniz. Daha fazla bilgi için Apigee Edge for Private Cloud Operations Guide (Özel Bulut Operasyonları Kılavuzu için Apigee Edge) dokümanındaki "Add a custom logo to Apigee UI" (Apigee kullanıcı arayüzü menüsüne özel logo ekleme) bölümüne bakın.

Trace'teki Node.js Günlükleri

Node.js API proxy'leri için hata ayıklarken API proxy düzenleyicisinin İzleme görünümünde Node.js Günlüğü özelliğini etkinleştirebilirsiniz. Bu özelliği etkinleştirmek için kurulumunuzdaki Apigee-base.conf veya Apigee-on öne çıkan.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 bölümüne bakın.

Şifre süre sonu

Edge 4.15.01.x'te Edge şifrelerinin süresi 30 gün sonra otomatik olarak dolar. Diğer bir ifadeyle, kullanıcı, şifresini süresi dolmadan önce değiştirmediği takdirde hesabına erişememeye başlamıştı. Ancak bu hata aynı zamanda sistem yöneticisi şifresinin süresinin dolmasına ve sistem yöneticisinin Edge'e kilitlenmesine yol açmıştır.

4.15.04.00 sürümüne geçtiğinizde, varsayılan ayar, şifrelerin süresinin dolmaması için değişir. Gerekirse /opt/apigee4/bin/apigee-enable-pwlockout.sh komut dosyasını kullanarak Edge şifrelerini süresi dolacak şekilde yapılandırabilirsiniz. Daha fazla bilgi için Özel Bulut İşlem Rehberi'ne göz atın.

Sistem yöneticisi erişimini belirli e-posta alan adlarıyla sınırlandırma

Sistem yöneticisi veya salt okuma rollerine üyeliği, belirli e-posta alanlarındaki kullanıcılarla kısıtlayabilirsiniz. Bu özelliği etkinleştirmek için izin verilen alan adlarını Özel Bulut Operasyonları için Apigee Edge bölümünde açıklandığı şekilde Apigee4/conf/Apigee/management-server/security.properties dosyasına ekleyin.

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

Yönetim kullanıcı arayüzündeki hata mesajı görüntüleme, ekran alanı daha verimli bir şekilde kullanılması için yeniden tasarlandı.

Yeni OAuthV2 hata değişkenleri

Hatayla ilgili aşağıdaki yeni değişkenler OAuthV2 politikası tarafından belirlenir:

  • oauthV2.<policy-name>.failed - Politika başarısız olursa değeri doğru olarak ayarlayın.
  • oauthv2.<policy_name>.<fault_name> - Hatanın 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 adresine bakın.

Ü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.

Kuruluştan kullanıcı kaldırmak için kullanılan kullanıcı arayüzü

Kullanıcı arayüzündeki Kuruluş Kullanıcıları sayfasındaki Sil düğmesinin yerini Kaldır düğmesi aldı. Bu sayede, kuruluştan kaldırdığınız kullanıcıların Apigee hesapları etkin durumda kalır.

http://apigee.com/docs/api-services/content/managing-organization-users adresini ziyaret edin.

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

Yönetim kullanıcı arayüzündeki API Proxy'leri, Ürünler, Geliştiriciler ve Uygulamalar sayfalarında arama için yeni filtreleme seçenekleri mevcuttur.

Çevrimdışı İzleme aracı

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

Daha fazla bilgi için Çevrimdışı İzleme aracını kullanma sayfasını inceleyin.

Kullanıcı Ayarları'nda gösterilen kullanıcı rolleri

Artık yönetim kullanıcı arayüzünün Kullanıcı Ayarları sayfasında (kullanıcı adı > Kullanıcı Ayarları) kullanıcının rolleri görüntülenir.

Uç yönetimi kullanıcı arayüzü geliştirmeleri

Bu sürüm, Edge yönetim kullanıcı arayüzünde birkaç küçük kullanılabilirlik ve tutarlılık iyileştirmesi içerir.

Analiz Hizmetleri

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

Altı aylık veri kullanılabilir

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

Değişkenler analizlere eklendi

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

  • apigee.edge.execution.is_target_error - API hatalarının hedef taraf hataları ("1 değeri") mı yoksa başarısız HTTP yanıtları için hedef olmayan hatalar mı ("0" değeri) olduğunu tanımlayabilmenizi sağlar. Başarılı bir HTTP yanıtı için değer boş.
  • apigee.edge.execution.is_policy_error - Bir politikanın başarısız olup olmadığını ("1" değeri) veya başarısız bir HTTP yanıtında ("0" değeri) hiçbir politikanın başarısız olup olmadığını tanımlamanızı sağlar. Başarılı bir HTTP yanıtı için değer boştur.
    Aşağıdaki ilgili değişkenler, ilk olarak başarısız olan politikayla ilgili ayrıntıları sağlar. Hiçbir politika başarısız olduysa değerler null olur.
    • apigee.edge.execution.fault_policy_name - Başarısız olan politikanın adı.
    • apigee.edge.execution.fault_flow_name: Politikadaki başarısız olan akışın adı (PreFlow, PostFlow veya kullanıcı tanımlı bir akış gibi).
    • apigee.edge.execution.fault_flow_state - Politikanı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ı için performans grafikleri taşındı. Eskiden bu varlıklar için ana sayfaların alt kısmında gösteriliyorlardı. Artık grafiklere, her sayfanın üst kısmındaki Analytics sekmesini seçerek erişebilirsiniz.
  • Bu sürümde, mevcut veya yeni kontrol panelleriyle ilgili önemli çalışmalar yer almaktadır:
    • Apigee Kontrol Paneli (Düzenlenmiş): Üç metrik grafiği içerir: Proxy Trafiği, Geliştirici Etkileşimi ve Geliştirici Uygulamaları. Her grafikte, metrikleri ayrıntılı olarak incelemenize olanak tanıyan bir "diğer ayrıntılar" görünümü sunulur. Apigee kontrol panelini 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ı bölümünü inceleyin.
    • Trafik Yapısı (Düzenlenmiş): Tamamen düzeltilmiş kontrol paneli görünümü ve tarzı ile içerikleri. En iyi API'lerinizin, uygulamalarınızın, geliştiricilerinizin ve ürünlerinizin genel API programınıza olan göreceli katkısını ölçer. Trafik kompozisyonu bölümüne bakın.
    • Hata Analizi (Düzeltilmiş): Tamamen düzeltilmiş görünüm, tarz ve içerik. API proxy'leri ve hedefler için hata oranlarını gösterir. Hata Kodu Analizi Kontrol Paneli'ne bakın.
  • Bu mevcut kontrol panelleri yeniden adlandırıldı:
    • Uç Nokta Performansı, Hedef Performans olarak yeniden adlandırıldı: API proxy arka uç hedefleri için trafik kalıplarını ve performans metriklerini gösterir. Hedef performans bölümünü inceleyin.
    • İş Ortağı Etkileşimi'nin adı Geliştirici Etkileşimi olarak değiştirildi: Adını, kayıtlı uygulama geliştiricilerinizden hangilerinin en fazla API trafiği oluşturduğunu gösterir. Geliştiricilerinizin her biri için en fazla API trafiğini ve en çok hatayı kimin oluşturduğunu öğrenebilirsiniz. Geliştirici etkileşimi bölümünü inceleyin.

Geliştirici Hizmetleri

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

SmartDokümanlar için Swagger 2.0 desteği

SmartDokümanlar, Swagger 2.0 spesifikasyon belgelerini içe aktarmayı 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 sunulacaktır.

Para kazanma

Edge'den para kazanma ile ilgili 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 göz atın.

Şirket ve Geliştiricileri ayrı ayrı yönetme

Şirketler ve geliştiriciler artık ayrı olarak ele alındığından, geliştiricilere birden fazla şirket ve şirketlere birden fazla geliştirici ekleme esnekliği sunulur. Yönetim kullanıcı arayüzü artık "Şirketler" ve "Geliştiriciler" için ayrı pencereler sağlıyor ("Yayınla" menüsünden erişilebilir).

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

"Geliştiriciler" olan filtre etiketi "Şirketler" olarak değiştirilse de, para kazanma raporlarında şirketler birincil filtre olarak kalır.

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ı yeni sürüme geçirilmemiş
MGMT-1986 Geliştirici eklenirken kullanıcı arayüzü hatası
MGMT-1983 OAuth 2.0 yetkilendirme kodu API'sinin yanlış durum döndürmesi
MGMT-1962 Güçlü şifreyle yönetim kullanıcı arayüzüne giriş hatası
Artık yüzde işareti gibi belirli özel karakterlerle kullanıcı arayüzüne giriş yapma başarısız olmuyor.
MGMT-1894 Geliştirici Uygulamaları sayfasının geliştirici sütununun yüklenmesi hiç tamamlanmıyor
MGMT-1872 Özel raporlar indirilemiyor
MGMT-1777 TLD'si .acn olan e-posta adresine sahip kullanıcı eklenemez
MGMT-1362 Şifremi Unuttum e-postası, e-posta adresinde "_" işareti varsa çalışmaz
Private Cloud'da alt çizgi içeren e-posta adresleriyle şifre sıfırlama sorununu düzeltir.
CORERT-613 "untagnized_name" nedeniyle gerçekleşen 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şturma işlemi uygulanmış değer döndürülür

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

Uç Bulutu Private Cloud için Edge

Bilinen sorunlar

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

Sorun Kimliği Açıklama
Yok

Yükleyicinin para kazanma yükleme veya yükseltme işlemlerinde kullandığı iki Cassandra komut dosyası sürüme dahil edilmedi.

Bu sorunu çözmek için Cassandra kurulumundan veya yükseltmesinden sonra aşağıdaki komutları çalıştırarak para kazanma kurulumunu/yükseltilmesini 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ükleri (100 KB) olan API çağrıları bazen askıya alınabilir. Bu sorunu çözmek için yönlendirici.properties dosyanızda aşağıdaki özellik değerini ayarlayın:
HTTPServer.streaming.buffer.limit=0 (varsayılan ayar 10'dur)