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

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 varsa 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ı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öneticisi 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ünü, Apigee logosunun yanında görünen kendi özel logonuzla birlikte markalayabilirsiniz. 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'lerini 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 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, şifresinin süresi dolmadan önce değiştirmeyen kullanıcıların hesapları kilitleniyordu. Ancak bu durum, sistem yöneticisinin şifresinin süresinin dolmasına da neden oldu ve sistem yöneticisi Edge'e erişemedi.

4.15.04.00 sürümüne yükselttiğinizde varsayılan ayar, şifrelerin süresinin dolmaması için değiştirilir. 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ığı şekilde 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 mesajlarının gösterilmesi, ekran alanını daha verimli kullanacak şekilde yeniden tasarlandı.

Yeni OAuthV2 hata değişkenleri

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

  • oauthV2.<policy-name>.failed: Politika başarısız olduysa true 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 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 adresini ziyaret edin.

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

Kullanıcı arayüzündeki Kuruluş Kullanıcıları sayfasında Sil düğmesinin yerini Kaldır düğmesi aldı. 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.

Offline Trace aracı

Çevrimdışı İzleme aracı, daha önce kaydedilen izleme oturumlarını görüntülemenize ve analiz etmenize olanak tanır. Kaydedilmiş 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 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 analizlerine iletilir.

  • apigee.edge.execution.is_target_error: API hatalarının hedef taraflı hatalar (değer "1") mı yoksa başarısız HTTP yanıtları için hedef taraflı 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: Hataya neden olan politikadaki 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.

Kontrol panelleri

  • 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österilirdi. Artık her sayfanın üst kısmındaki Analizler 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): Üç metrik grafiği içerir: Proxy Trafiği, Geliştirici Etkileşimi ve Geliştirici Uygulamaları. 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 paneline bakın.
    • Proxy Performansı (Yeni): API proxy trafiği modellerini ve işleme sürelerini gösterir. API Proxy'si Performansı kontrol panelinin yerini alır. API Proxy Performansı başlıklı makaleyi inceleyin.
    • Trafik Yapısı (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 yaptığı göreceli katkıyı ö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ı yeniden adlandırıldı:
    • 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 Geliştirici Hizmetleri'ndeki 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 sunuluyor ("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ı olan e-posta adresine sahip 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'ta şifre sıfırlama sorunu düzeltildi.
Alt çizgi içeren e-posta adresleriyle Ö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ükleme veya yükseltme işleminden sonra aşağıdaki komutları çalıştırarak para kazanma yükleme/yükseltme işlemini 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)