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 yeni sürüme geçirme

OpenLDAP artık yeni ve yükseltme kurulumlarında 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ılavuzuna bakın.

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 birlikte marka ekleyebilirsiniz. Daha fazla bilgi için Apigee Edge for Private Cloud İşlemleri Kılavuzu'ndaki "Apigee kullanıcı arayüzü menüsüne özel logo ekleme" bölümüne bakın.

İzleme'deki Node.js günlükleri

Node.js API proxy'lerinde hata ayıklarken API proxy'si düzenleyicisinin İzleme görünümünde Node.js Günlüğü özelliğini etkinleştirebilirsiniz. Özelliği etkinleştirmek için yüklemenizdeki 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, şifresinin süresi dolmadan değiştirmeyen kullanıcıların hesapları kilitleniyordu. Ancak bu durum, sistem yöneticisinin şifresinin süresinin dolmasına da neden oldu. Böylece sistem yöneticisi Edge'e erişemedi.

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 süresinin dolmasını sağlayabilirsiniz. Daha fazla bilgi için Apigee Edge for Private Cloud İşlemleri Kılavuzu'na bakın.

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 true (doğru) olarak ayarlayın.
  • oauthv2.<policy_name>.<fault_name>: Hatayı tanımlayan 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 inceleyin.

Ü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 adresini ziyaret edin.

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.

Offline Trace aracı

Çevrimdışı İzleme aracı, daha önce kaydedilen 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 yapılması gereken durumlarda faydalı olabilir. Offline Trace aracının kullanıcı arayüzü, "canlı" Trace 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ümde, Edge yönetim kullanıcı arayüzünde kullanılabilirlik ve tutarlılıkla ilgili çeşitli küçük iyileştirmeler yapıldı.

Analytics Hizmetleri

Edge Analytics Hizmetleri'ndeki 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ı ("1" değeri) veya başarısız bir HTTP yanıtında herhangi bir politikanın başarısız olmadığını ("0" değeri) 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 politikayla ilgili ayrıntıları 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: Politikanın akışta 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 bilgiler, söz konusu tüzel kişilerin ana sayfalarını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 trafiği modellerini ve işleme sürelerini gösterir. API Proxy Performansı kontrol panelinin yerini alır. API Proxy'si Performansı başlıklı makaleyi inceleyin.
    • Trafik Yapısı (Yenilendi): Kontrol panelinin görünümü, tarzı 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 yapısı 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 gösterge tablolarının adları değiştirildi:
    • Endpoint Performance (Uç Nokta Performansı) Target Performance (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üne bakın.
    • İş Ortağı Etkileşimi, Geliştirici Etkileşimi olarak yeniden adlandırıldı: Kayıtlı uygulama geliştiricilerinizden hangisinin en fazla API trafiğini 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

SmartDocs, 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 sağlanıyor ("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üklenmiyor
MGMT-1872 Özel raporlar indirilemiyor
MGMT-1777 .acn üst düzey alan adı olan e-posta adresine sahip kullanıcı eklenemiyor
MGMT-1362 E-posta adresi "_" içeriyorsa Şifremi Unuttum e-postası çalışmıyor.
E-posta adreslerinde alt çizgi bulunan Özel Bulut'ta ş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ümde aşağıdaki sürümlerdeki hata düzeltmeleri de yer almaktadır:

Edge Cloud Edge for Private Cloud

Bilinen sorunlar

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

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 (yüzlerce KB) içeren API çağrıları bazen takılabilir. 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)