Edge Microgateway sürüm notları

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

Sürüm 3.3.x

Hata düzeltmeleri ve geliştirmeler v.3.3.x

3.3.7

17 Temmuz 2025'te Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
191613108 Özellik

Edge Microgateway (EMG), excludeUrls yapılandırmasında joker karakterli URL kalıplarını destekleyecek şekilde geliştirildi. Bu geliştirme, executeURL özelliğinin statik URL'lerle sınırlı olduğu, URL kalıpları veya GET isteklerindeki sorgu parametreleri için destek sunmadığı önceki sınırlamayı ele almaktadır.

Güncellenen işlev, eklentilerin dinamik veya kalıp eşleştirme URL'lerine göre koşullu olarak hariç tutulmasına olanak tanıyordu. Bu değişiklik geriye dönük uyumluydu ve mevcut statik URL yapılandırmalarının herhangi bir değişiklik gerektirmeden tam işlevsel kalmasını sağlıyordu.

Örneğin,

edgemicro:
  plugins:
    excludeUrls: '/hello,/proxy_one/*' # global exclude urls
    sequence:
      -oauth
      -json2xml
      -quota
      -json2xml:
          excludeUrls: '/hello/xml/*'  # plugin level exclude urls
135276110 Özellik

Edge Microgateway (EMG) analiz verileri gateway_flow_id içeriyordu. Bu alan daha önce atlanıyordu. Bu durum, Analytics etkinliklerinin belirli API yürütmeleriyle benzersiz şekilde tanımlanmasını ve ilişkilendirilmesini engelliyordu.

EMG, her bir analiz kaydını gateway_flow_id için benzersiz bir UUID ile otomatik olarak dolduracak şekilde güncellendi. Bu alan, varsayılan olarak tüm analiz yüklerinin zorunlu bir bileşeni haline geldi ve veri izlenebilirliğini ve raporlama tutarlılığını önemli ölçüde iyileştirdi.

422696257 Hata

Kritik bir kilitlenme sorununun çözülmesiyle sistem kararlılığı önemli ölçüde artırıldı.

Düzeltme, daha önce sistemin aşırı yüklenmesine yol açan yinelenen bir süreç döngüsüne neden olan dahili bir modüldeki yanlış yapılandırmanın tanımlanmasını ve düzeltilmesini içeriyordu. Bu hedefli düzeltme, döngüyü ortadan kaldırarak daha sağlam ve güvenilir bir sistem oluşturdu.

Düzeltilen güvenlik sorunları

3.3.6

16 Nisan 2025'te Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.3.6 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.3.6 3.3.6 3.3.6 3.3.6 3.2.2

Düzeltilen güvenlik sorunları

  • CVE-2025-27789
  • CVE-2024-21538
  • CVE-2024-12133

3.3.5

20 Aralık 2024 Cuma günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.3.5 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.3.5 3.3.5 3.3.5 3.3.5 3.2.2

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
383024578 Özellik

Node.js 22 sürümü için destek ekledik ve 16 sürümü için desteği kaldırdık. Node.js v18 kullanıyorsanız Edge Microgateway, başlatma sırasında aşağıdaki hata mesajını yazdırır:

current nodejs version is  18.x.x Note, v18.x.x will be out of support soon, see https://docs.apigee.com/release/notes/edge-microgateway-release-notes-0

Node.js'nin eski bir sürümünü kullanıyorsanız şu hata mesajını görürsünüz:

You are using a version of NodeJS that is not supported

Düzeltilen güvenlik sorunları

  • CVE-2024-21538
  • CVE-2024-45590
  • CVE-2019-3844
  • CVE-2019-12290
  • CVE-2020-1751
  • CVE-2018-12886
  • CVE-2023-50387
  • CVE-2019-3843
  • CVE-2022-4415
  • CVE-2021-3997

3.3.4

18 Eylül 2024'te Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.3.4 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.3.4 3.3.4 3.3.4 3.3.4 3.2.2

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
675987751 Hata

Edge Microgateway'in istemci IP adreslerini günlüğe kaydetmemesine neden olan sorun düzeltildi.

Düzeltilen güvenlik sorunları

  • CVE-2021-23337
  • CVE-2024-4068
  • CVE-2020-28469
  • CVE-2020-28503

3.3.3

25 Nisan 2024'te Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.3.3 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.3.3 3.3.3 3.3.3 3.3.3 3.2.2

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
315939218 Kaldırıldı

Eureka istemci eklentisi, Edge Microgateway'den kaldırıldı. Bu özelliğin kaldırılması, Edge Microgateway'in temel işlevini veya hedef URL'lerin yeniden yazılmasını etkilemez. Daha fazla bilgi için Eklentilerde hedef URL'leri yeniden yazma başlıklı makaleyi inceleyin.

283947053 Kaldırıldı

forever-monitor desteği Edge Microgateway'den kaldırıldı. forever-monitor yerine PM2'yi kullanabilirsiniz. Ayrıntılı bilgi için şu Apigee Community yayınına bakın: Edgemicro + PM2: Starting edgemicro as a service (Edgemicro + PM2: Edgemicro'yu hizmet olarak başlatma).

Düzeltilen güvenlik sorunları

  • CVE-2023-0842
  • CVE-2023-26115
  • CVE-2022-25883
  • CVE-2017-20162
  • CVE-2022-31129
  • CVE-2022-23539
  • CVE-2022-23541
  • CVE-2022-23540
  • CVE-2024-21484
  • CVE-2022-46175
  • CVE-2023-45133
  • CVE-2020-15366
  • CVE-2023-26136
  • CVE-2023-26115

3.3.2

18 Ağustos 2023'te Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.3.2 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.3.2 3.3.2 3.3.2 3.3.2 3.2.2

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
296187679 Özellik

Desteklenen Node.js sürümleri: 16, 18 ve 20. 3.3.2 sürümünden itibaren Edge Microgateway KSA komutları yalnızca desteklenen sürümlerde çalışır. CLI komutlarının desteklenmeyen sürümlerde yürütülmesi hataya neden olur. Ayrıca Apigee Desteklenen yazılımlar ve desteklenen sürümler başlıklı makaleyi de inceleyin.

283947053 Hata

Edge Microgateway'in bir uygulamayla ilişkili API ürünleri listesindeki ilk API ürününü döndürmesine neden olan sorun düzeltildi. Artık döndürülecek doğru API ürününü isteğe göre belirliyoruz.

274443329 Hata

Docker'ın eski bir resim sürümünü çekmesi sorunu düzeltildi. Docker düğüm sürümü, Node.js 18 sürümüne güncellendi. Artık Docker görüntüsünü 18.17-buster-slim sürümüyle oluşturuyoruz.

Düzeltilen güvenlik sorunları

Yok.

3.3.1

7 Haziran 2022'de Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.3.1 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.3.1 3.3.1 3.3.1 3.3.1 3.2.2

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
220885293 Özellik

Node.js sürüm 16 artık destekleniyor.

231972608 Hata

private configure komutunun özel bir bulut için yapılandırmaya çalışırken hata vermesine neden olan sorun düzeltildi.

233315475 Hata

json2xml eklentisinin, yanıtı JSON'dan XML'ye dönüştürürken ve accumulate-response eklentisiyle birlikte kullanıldığında ayrıştırma hatası vermesine neden olan sorun düzeltildi.

221432797 Değiştir

Temel Edge Microgateway görüntüsünün Docker Node.js sürümü Node.js 14'e yükseltildi.

215748732 Özellik

revokekeys komutuna SAML jetonu kimlik doğrulaması desteği eklendi.

Artık revokekeys komutundaki -t seçeneğini kullanarak kullanıcı adı ve şifre kimlik bilgileri yerine SAML jetonu iletebilirsiniz.

Ayrıntılar için Komut satırı referansı başlıklı makaleyi inceleyin.

218723889 Doküman Güncelleme

GitHub'da depolanan desteklenen Edge Microgateway eklentilerinin bağlantısı dokümanlara eklendi. Edge Microgateway ile birlikte gelen mevcut eklentiler başlıklı makaleyi inceleyin.

Düzeltilen güvenlik sorunları

Sorun Kimliği Açıklama
CVE-2021-23413 Bu güvenlik açığı, 3.7.0'dan önceki jszip paketini etkiler. Dosya adları, nesne prototipi değerlerine (ör. proto, toString vb.) ayarlanmış yeni bir zip dosyası oluşturmak, değiştirilmiş bir prototip örneği içeren döndürülen bir nesneyle sonuçlanır.

3.3.0

4 Şubat 2022'de Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.3.0 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.3.0 3.3.0 3.3.0 3.3.0 3.2.2

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
219556824 Bilinen Sorun Edge Microgateway 3.3.0 sürümü, npm audit fix komutuyla uyumlu değildir.

npm audit fix komutunun çalıştırılması, apigeetool komutunun 0.15.2 sürümüne yükseltilmesine neden olur. Bu durum, edgemicro upgradeauth komutunu etkiler.

npm audit fix komutunu çalıştırıp ardından edgemicro upgradeauth komutunu çalıştırırsanız şu hatayı görürsünüz:

Error: This method has been removed in JSZip 3.0, please check the upgrade guide.

Sorunu düzeltmek için aşağıdaki komutu çalıştırarak apigeetool'nın doğru sürümünü geri yükleyin:

npm install apigeetool@0.15.1

Bu sorun, Edge Microgateway'in gelecekteki bir sürümünde giderilecektir.

138622990 Özellik

Kota eklentisi için yeni bir işaret olan isHTTPStatusTooManyRequestEnabled, kota ihlali varsa eklentiyi 403 durumu yerine HTTP 429 yanıt durumu döndürecek şekilde yapılandırır. Kota için yapılandırma seçenekleri başlıklı makaleyi inceleyin.

192534424 Hata

Apigee Analytics'te görünen yanıt kodunun Edge Microgateway yanıt koduyla eşleşmemesi sorunu düzeltildi.

198986036 Geliştirme Edge Microgateway artık her yoklama aralığında bir kimlik sağlayıcının (IdP) ortak anahtarını getiriyor ve IdP'nin ortak anahtarı değişirse anahtarı da güncelliyor. Daha önce, bir kimlik sağlayıcının ortak anahtarı değiştiğinde extauth eklentisi, Edge Microgateway'i yeniden yüklemeden ortak anahtarı güncelleyemiyordu.
168713541 Hata

Birden fazla hedef için TLS/SSL'nin nasıl yapılandırılacağını açıklamak üzere dokümanlar geliştirildi. İstemci SSL/TLS seçeneklerini kullanma başlıklı makaleyi inceleyin.

171538483 Hata

Günlük dosyası adlandırma kuralını düzeltmek için doküman değiştirildi. Günlük dosyası adlandırma kuralları başlıklı makaleyi inceleyin.

157908466 Hata

Edge Microgateway'in belirli bir sürümünün nasıl yükleneceğini doğru şekilde açıklamak için dokümanlar değiştirildi. İnternet bağlantınız varsa Edge Microgateway'i yükseltme başlıklı makaleyi inceleyin.

215748427 Hata Mevcut bir anahtar ve gizli dizi çifti kullanılarak anahtar iptal edilirken revokekeys komutunun hata döndürmesine neden olan sorun düzeltildi.
205524197 Hata Günlük kaydı düzeylerinin tam listesini içerecek şekilde dokümanlar güncellendi. edgemicro özellikleri ve Günlük düzeyini ayarlama başlıklı makaleleri inceleyin.

Sürüm 3.2.x

Hata düzeltmeleri ve geliştirmeler v.3.2.x

3.2.3

17 Eylül 2021'de Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.2.3 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.2.3 3.2.3 3.2.3 3.2.3 3.2.2

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
192416584 Özellik

disableStrictLogFile yapılandırma özelliği, uygulama günlük dosyasında api-log.log katı dosya izinlerini gevşetmenize olanak tanır. Ayrıntılı bilgi için Günlük dosyası izinlerini nasıl gevşetebilirim? başlıklı makaleyi inceleyin.

192799989 Özellik

on_target_response_abort yapılandırma özelliği, istemci (Edge Microgateway) ile hedef sunucu arasındaki bağlantı erken kapanırsa Edge Microgateway'in nasıl davranacağını kontrol etmenizi sağlar. Ayrıntılar için edgemicro özellikleri başlıklı makaleyi inceleyin.

148062415 Hata Docker kapsayıcı bağlamında Edge Microgateway'in docker stop {containerId} komutuyla düzgün şekilde kapatılamamasına neden olan sorun düzeltildi. İşlem sonlandırıldı ancak .sock ve .pid dosyaları kaldırılmadı. Artık dosyalar kaldırılıyor ve aynı kapsayıcının yeniden başlatılması beklendiği gibi çalışıyor.
190715670 Hata Mikro ağ geçidinin dahili yeniden yükleme etkinliği sırasında bazı isteklerin takılı kalmasına neden olan sorun düzeltildi. Bu sorun aralıklı olarak yaşanmış ve yoğun trafik durumlarında ortaya çıkmıştır. Bu sorun, OAuth eklentisinin tokenCache ve cacheKey özellikleri kullanıldığında görülmüştür.
183910111 Hata Sondaki eğik çizgiye sahip bir kaynak yolu URL'sinin yanlışlıkla ayrı bir kaynak yolu olarak yorumlanmasına neden olan sorun düzeltildi. Örneğin, /country/all ve /country/all/ yolları artık aynı yol olarak yorumlanıyor.

Düzeltilen güvenlik sorunları

Sorun Kimliği Açıklama
CVE-2020-28503 2.0.5'ten önceki paket kopyalama özellikleri, ana işlev aracılığıyla Prototype Pollution saldırısına karşı savunmasızdır.
CVE-2021-23343 path-parse paketinin tüm sürümleri, splitDeviceRe, splitTailRe ve splitPathRe normal ifadeleri aracılığıyla Normal İfade Hizmet Reddi (ReDoS) güvenlik açığına sahiptir. ReDoS, en kötü durumda polinom zaman karmaşıklığı gösterir.

3.2.2

15 Temmuz 2021 Perşembe günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.2.2 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.2.2 3.2.2 3.2.2 3.2.2 3.2.2

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
185323500 Değiştir

expires_in değeri dizeden tam sayıya değiştirildi

Jeton isteği ve yenileme jetonu isteği API'leri artık expires_in değerini saniye cinsinden belirtilen bir tam sayı değeri olarak döndürüyor.

RFC 6749 The OAuth 2.0 Authorization Framework ile uyumluluk için expires_in yapılandırma parametresinin beklenen değeri dizeden tam sayıya değiştirildi. Ayrıntılar için İşlem ve yapılandırma referansı başlıklı makaleyi inceleyin.

188492065 Değiştir Node.js 8 desteğinin sonu

3.2.2 sürümünden itibaren Node.js 8 desteklenmeyecektir. Daha fazla bilgi için Desteklenen yazılımlar ve desteklenen sürümler: Edge Microgateway başlıklı makaleyi inceleyin.

183990345 Özellik Docker kapsayıcısı için günlük çıkışını yapılandırma

Edge Microgateway yapılandırma parametresi to_console günlük bilgilerini bir günlük dosyasına göndermek yerine standart çıkışa göndermeyi seçmenize olanak tanır. Edge Microgateway'i Docker container'da çalıştırma adımlarını uygularsanız container, stdout ve hata çıkışını varsayılan olarak container'daki ${APIGEE_ROOT}/logs/edgemicro.log konumunda bulunan bir dosyaya yönlendirir.

Günlük bilgilerinin edgemicro.log'ya gönderilmesini önlemek için kapsayıcıyı çalıştırırken yeni LOG_CONSOLE_OUTPUT_TO_FILE değişkenini kullanın.

Bu yeni değişkenin nasıl kullanılacağıyla ilgili ayrıntılar için Edge Microgateway için Docker'ı kullanma başlıklı makaleyi inceleyin.

183057665 Özellik edgemicro.pid ve edgemicro.sock dosya yollarını yapılandırılabilir hale getirin.

Edge Microgateway ile Docker kapsayıcısı çalıştırmak için yeni bir -w, --workdir parametresi, edgemicro.sock ve edgemicro.pid dosyalarının Docker kapsayıcısında oluşturulması gereken dizinin yolunu belirtmenize olanak tanır. Edge Microgateway için Docker'ı kullanma başlıklı makaleye bakın.

191352643 Özellik Edge Microgateway'in Docker görüntüsü, NodeJS 12.22 sürümünü kullanacak şekilde güncellendi. Edge Microgateway için Docker'ı kullanma başlıklı makaleye bakın.

Düzeltilen güvenlik sorunları

Sorun Kimliği Açıklama
CVE-2021-28860 Node.js mixme'de v0.5.1'den önceki sürümlerde saldırgan, mutate() ve merge() işlevleri aracılığıyla "__proto__" üzerinden bir nesnenin özelliklerini ekleyebilir veya değiştirebilir. Kirlenmiş özelliği, programdaki her nesneye doğrudan atanır. Bu durum, programın kullanılabilirliğini riske atarak olası bir hizmet reddine (DoS) neden olur.
CVE-2021-30246 Node.js için 10.1.13 sürümüne kadar olan jsrsasign paketinde, bazı geçersiz RSA PKCS#1 v1.5 imzaları yanlışlıkla geçerli olarak tanınıyor. NOT: Bilinen pratik bir saldırı yoktur.
CVE-2021-23358 1.13.0-0 ve 1.13.0-2'den önceki, 1.3.2 ve 1.12.1'den önceki paket alt çizgisi, özellikle değişken bir özellik bağımsız değişken olarak iletildiğinde şablon işlevi aracılığıyla rastgele kod yerleştirmeye karşı savunmasızdır. Bunun nedeni, değişkenin temizlenmemesidir.
CVE-2021-29469 Node-redis, Node.js Redis istemcisidir. 3.1.1 sürümünden önce, bir istemci izleme modundayken izleme mesajlarını algılamak için kullanılan normal ifade, bazı dizelerde üstel geri izlemeye neden olabiliyordu. Bu sorun, hizmet reddine yol açabilir. Bu sorun 3.1.1 sürümünde düzeltildi.
CVE-2020-8174 Docker görüntüsü, Node.js 12.22 sürümünü kullanacak şekilde güncellendi.

3.2.1

5 Mart 2021 Cuma günü Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.2.1 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.2.1 3.2.1 3.2.1 3.2.1 3.2.1

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
180362102 Hata Boş değere sahip JWK anahtarlarının uygulamaların başarısız olmasına neden olduğu sorun düzeltildi.

Boş koşul artık jwkPublicKeys içinde boş değer geçirilmesini önleyecek şekilde işleniyor.

Not: Bu düzeltme için edgemicro-auth proxy'sini yükseltmeniz gerekir.

179971737 Hata edgemicro_* proxy'lerinde hedef 4XX / 5XX durum yanıtlarının proxy hataları olarak kaydedildiği sorun düzeltildi.

Edge Microgateway işlemlerinde, Apigee Edge hata kodu analizleri kontrol panelinde yanlış hedef hata sayıları gösteriliyordu. Hedef hatalarıyla ilgili hata kodları, proxy hataları olarak sayılıyordu. Bu sorun düzeltildi ve artık doğru hedef hata sayıları gösteriliyor.

179674670 Özellik JWT'ye yerleştirilen API ürünleri listesini ürün durumu kodlarına göre filtrelemenize olanak tanıyan yeni bir özellik eklendi.

API ürünlerinin üç durum kodu vardır: Beklemede, Onaylandı ve İptal Edildi. edgemicro-auth proxy'sindeki Set JWT Variables politikasına allowProductStatus adlı yeni bir özellik eklendi. Bu özelliği, JWT'de listelenen API ürünlerini filtrelemek için kullanmak üzere:

  1. Apigee proxy düzenleyicisinde edgemicro-auth proxy'sini açın.
  2. SetJWTVariables politikasının XML'sine allowProductStatus özelliğini ekleyin ve üzerinde filtreleme yapılacak durum kodlarının virgülle ayrılmış listesini belirtin. Örneğin, Beklemede ve İptal edildi durumuna göre filtrelemek için:
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Javascript timeLimit="20000" async="false" continueOnError="false"
        enabled="true" name="Set-JWT-Variables">
        <DisplayName>Set JWT Variables</DisplayName>
        <FaultRules/>
        <Properties>
            <Property name="allowProductStatus">Pending,Revoked</Property>
        </Properties>
        <ResourceURL>jsc://set-jwt-variables.js</ResourceURL>
    </Javascript>
    
    

    Yalnızca onaylanmış ürünlerin listelenmesini istiyorsanız mülkü aşağıdaki gibi ayarlayın:

    <Property name="allowProductStatus">Approved</Property>
  3. Proxy'yi kaydedin.

    Property etiketi yoksa tüm durum kodlarına sahip ürünler JWT'de listelenir.

    Bu yeni mülkü kullanmak için edgemicro-auth proxy'sini yükseltmeniz gerekir.

178423436 Hata CLI'da veya ortam değişkenleri aracılığıyla iletilen anahtar ve gizli anahtar değerleri, süreç gezgini komut satırı bağımsız değişkenlerinde görünür.

Komut satırı bağımsız değişkenlerinden geçirilen veya ortam değişkenleri aracılığıyla ayarlanan Edge Microgateway anahtarı ve gizli değerlerinin, microgateway başlatıldıktan sonra düğüm çalışanı/alt süreçlerinin bağımsız değişkenlerinde gösterildiği bir sorun bildirildi.

Ortam değişkeni senaryosunda bu sorunu düzeltmek için değerler artık işlem gezgini komut satırı bağımsız değişkenlerinde görünmüyor.

Mikro ağ geçidi başlatılırken komut satırında anahtar ve gizli değerler iletilirse ayarlar, ayarlanmışsa ortam değişkeni değerlerini geçersiz kılar. Bu durumda değerler, İşlem Gezgini komut satırı bağımsız değişkenlerinde görünmeye devam eder.

178341593 Hata apikeys eklentisiyle ilgili bir doküman hatası düzeltildi.

apikeys eklentisinin README dosyasında yanlışlıkla gracePeriod özelliği yer alıyordu. Bu mülk ve açıklaması README dosyasından kaldırıldı.

gracePeriod özelliği, oauth eklentisinde uygulanır. Ek süre özelliğini kullanmak için oauth eklentisini kullanmanız gerekir.

179366445 Hata Hedeflere yönelik tüm GET isteklerinde yükün bırakılması sorunu giderildi.

İstediğiniz davranışı yeni bir yapılandırma parametresi olan edgemicro: enable_GET_req_body ile kontrol edebilirsiniz. true olarak ayarlandığında, istek başlığı transfer-encoding: chunked tüm GET isteklerine eklenir ve varsa bir GET yükü hedefe gönderilir. false (varsayılan) ise istek hedefe gönderilmeden önce yük sessizce kaldırılır.

Örneğin:

edgemicro:
 enable_GET_req_body: true

RFC 7231, bölüm 4.3.1: GET'e göre bir GET isteği yükünün tanımlanmış semantiği yoktur. Bu nedenle, hedef cihaza gönderilebilir.

3.2.0

21 Ocak 2021 Perşembe günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.2.0 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.2.0 3.2.0 3.2.0 3.2.0 3.2.0

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
152640618 Hata Jeton geçerliyken istek nesnesinde client_id değerini içerecek şekilde x-api-key başlığını ayarlamak için extauth eklentisini etkinleştirdi. x-api-key, sonraki eklentiler tarafından kullanılabilir.
168836123, 172295489, 176462355, 176462872 Özellik Node.js 14 için destek eklendi.
172376835 Hata edgemicro-auth proxy'sindeki /token uç noktası için doğru zaman birimini kullanın.

edgemicro-auth proxy'sindeki /token uç noktasının milisaniye cinsinden expires_in döndürmesine neden olan sorun düzeltildi. Ancak OAuth Şartnamesi'ne göre, refresh_token_expires_in için zaman birimiyle (saniye) tutarlı olması gerekir.

Düzeltme, geçerlilik süresinin uzunluğunu değil, yalnızca zaman birimini değiştirir. Yalnızca erişim jetonu yanıt yükündeki expires_in alanı için geçerlidir. Aynı yanıt yükündeki JWT jetonu iki alan içerir: iat ve exp. Bu alanlar, seconds zaman birimiyle her zaman doğru şekilde oluşturulur.

İstemciler, jetonların süresi dolmadan önce jetonları yenilemek için milisaniye cinsinden expires_in değerini kullanıyorsa bu düzeltmeyi istemcileri değiştirmeden uygulamak çok daha sık ve gereksiz yenilemelere neden olur. Bu istemcilerin, orijinal davranışı korumak için zaman birimi değişikliğini hesaba katacak şekilde değiştirilmesi gerekir.

İstemciler, jeton yenileme dönemini değerlendirmek için her zaman JWT jetonundaki değerleri kullandıysa istemcilerin herhangi bir değişiklik yapmasına gerek yoktur.

173064680 Hata Mikro ağ geçidinin, tüm veri parçaları işlenmeden hedef isteği sonlandırmasına neden olan sorun düzeltildi.

Bu, yüksek yük boyutlu isteklerde gözlemlenen aralıklı bir sorundur ve 3.1.7 sürümünde ortaya çıkmıştır.

174640712 Hata Eklentilere uygun veri işleme ekleyin.

Aşağıdaki eklentilere uygun veri işleme özelliği eklendi: json2xml, accumulate-request, accumulate-response ve header-uppercase. Eklenti ayrıntıları için microgateway-plugins başlıklı makaleyi inceleyin.

Sürüm 3.1.x

Hata düzeltmeleri ve geliştirmeler v.3.1.x

3.1.8

16 Kasım 2020 Pazartesi günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.8 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.1.8 3.1.9 3.1.7 3.1.3 3.1.2

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
169201295 Hata Sayısal ve Boole değerleri, ortam değişkeni etiketlerinde yanlış ayrıştırılıyordu.

Ortam değişkeni değiştirme işleme özelliği, tüm değerleri dize olarak ayrıştırdığı için boole veya sayısal değerlerde ayrıştırma hatalarına neden oluyordu. Örneğin, edgemicro.port sayısal bir değer bekler ve gerektirir. Boole ve sayısal değerleri desteklemek için düzeltmeler yapıldı. Yapılandırma ayrıntıları için Yapılandırma özelliklerini ortam değişkeni değerleriyle ayarlama başlıklı makaleye bakın.

169202749 Hata Bazı durumlarda ortam değişkeni değiştirme işlemi çalışmıyordu.

Bazı yapılandırma özellikleri için ortam değişkeni değiştirme işleme özelliği çalışmıyordu. Sınırlamalar hakkında bilgi için Ortam değişkeni değerleriyle yapılandırma özelliklerini ayarlama başlıklı makaleyi inceleyin.

168732942 Hata OAuth kapsamlarının, API proxy erişimini beklendiği gibi kısıtlamamasına neden olan sorun düzeltildi.

edgemicro-auth proxy'sindeki /token akışı, iki farklı senaryo sonucunda Edge'de doğru ürün kapsamları tanımlanmadan JWT'ler oluşturuyordu: 1) /token akışına yönelik istek yükünde bir kapsam parametresi iletilmedi veya 2) /token akışına yönelik istek yükünde geçersiz bir kapsam iletildi. Apigee Edge'deki API ürünlerinde tanımlanan tüm kapsamların döndürülmesi için düzeltme yapıldı.

170609716 Hata edgemicro-auth proxy'sindeki /refresh akışının apiProductList içermeyen bir JWT oluşturmasına neden olan sorun düzeltildi.

170708611 Hata API ürün kapsamları, özel eklentilerde kullanılamaz.

API ürün kapsamları özel eklentiler için kullanıma sunulmamış veya önbellek yapılandırma dosyasına yazılmamıştır. Kapsam ayrıntılarının eklentilere nasıl erişilebilir hale getirildiği hakkında bilgi edinmek için About the plugin init() function (Eklenti init() işlevi hakkında) başlıklı makaleyi inceleyin.

169810710 Özellik Anahtar ve gizli kod, önbellek yapılandırma dosyasına kaydedilir.

Edge Microgateway anahtarı ve gizli anahtarı, her yeniden yükleme/başlatma işleminde önbellek yapılandırması yaml dosyasına kaydediliyordu. 3.1.8 sürümünde anahtar ve gizli anahtar artık önbellek yapılandırma dosyasında kaydedilmiyor. Anahtar ve gizli anahtar daha önce önbellek yapılandırma dosyasına yazılmışsa bunlar kaldırılır.

170708621 Özellik Analiz eklentisi devre dışı bırakılamıyor.

Önceki microgateway sürümlerinde, analiz eklentisi varsayılan olarak etkinleştirilmişti ve devre dışı bırakılamıyordu. 3.1.8 sürümünde, enableAnalytics adlı yeni bir yapılandırma parametresi kullanıma sunuldu. Bu parametre, Analytics eklentisini etkinleştirmek veya devre dışı bırakmak için kullanılır. Ayrıntılar için Yapılandırma referansı başlıklı makaleyi inceleyin.

159571119 Hata Yanıt/soket zaman aşımı nedeniyle özel eklentilerdeki onerror_request kancasında boş hatası alınıyor.

onerror_request etkinlikleri için doğru HTTP durum kodu ve hata mesajının, onerror_response etkinlikleri için ise doğru hata mesajının doldurulmasıyla ilgili düzeltmeler yapıldı.

3.1.7

24 Eylül 2020 Perşembe günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.7 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.1.7 3.1.8 3.1.6 3.1.2 3.1.1

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
131708105 Hata analytics eklentisi, axpublisher çağrılarından gelen boş yanıtı yanlış işledi ve çalışanların çıkmasına neden oldu.

133162200 Hata Geliştirici uygulama bilgileri, yetkisiz ürün kaynağı yollarından kaynaklanan 403 durum yanıtları veya süresi dolmuş ya da geçersiz jetondan kaynaklanan 401 yanıtlarıyla analizlere doldurulmadı.

132194290 Hata Apigee Edge bazı Analytics kayıtlarını reddettiğinde Analytics kayıtları silinir.

158618994 Hata Aşırı Redis istemci bağlantısı.

161404373 Hata 404 durum yanıtı verilmesi durumunda, yanıt mesajına tam proxy URI'si dahil edildi.
166356972 Hata

Edge Microgateway'i Node.js 12.13.x veya daha yeni bir sürümle çalıştırmak, istek yükünü dönüştüren eklentiler yürütülürken aşağıdaki hataya neden oluyordu:

{"message":"write after end","code":"ERR_STREAM_WRITE_AFTER_END"}

168681746 Hata redisBasedConfigCache:true ile Edge Microgateway'in manuel olarak yeniden yüklenmesi çalışmıyordu.

149256174 Hata Ağ hataları için OAuth eklentisi hataları kaydedilmedi.

166517190 Hata jwk_public_keys verileri Synchronizer tarafından depolanmadı ve getirilip Redis'te saklanmadı.

141659881 Hata Geçersiz hedef sertifikanın hata işleme özelliği yanıltıcı hata yanıtları gösteriyordu.

142808699 Hata accesscontrol eklentisi, "allow" (izin ver) ve "deny" (reddet) bölümlerini doğru şekilde işlemiyordu.

Mikro ağ geçidi artık reddetme bölümünü düzgün şekilde işliyor ve "izin ver" ile "reddet" bölümlerinin sırasına uyuyor. Apigee Edge AccessControl politikası ile eşitlik sağlamak için mikro ağ geçidi yapılandırma dosyasına yeni bir noRuleMatchAction özelliği eklendi. GitHub'daki Access Control Plugin README (Erişim Denetimi Eklentisi README) dosyasına da göz atın.

3.1.6

20 Ağustos 2020 Perşembe günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.6 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.1.6 3.1.7 3.1.5 3.1.1 3.1.1

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
163711992 Özellik rotatekey komutu için özel anahtar ve sertifika dosyası konumu seçenekleri.

Bu yeni komut seçenekleriyle ilgili ayrıntılar için Anahtarları döndürme başlıklı makaleye bakın.

154838259 Hata Birden fazla veri merkezindeki çoklu örnekler için anahtar döndürmeyi düzeltme

Bu yeni komut seçenekleriyle ilgili ayrıntılar için Anahtarları döndürme başlıklı makaleye bakın.

145525133 Alfa özelliği Yeni eklenti metrikleri

Ayrıntılar için GitHub'daki New plugin metrics (Yeni eklenti metrikleri) README dosyasına bakın.

159396879 Hata Kullanılmayan paket Yardımcısı'nı kaldırma
161092943 Hata Temel yol doğrulaması hatalıydı

3.1.6 sürümünden önce, temel yol / ile bitmediğinde proxy temel yolu yanlış şekilde eşleştiriliyordu.

Aşağıda, önceki davranış (3.1.6 sürümünde düzeltilmiştir) daha ayrıntılı olarak açıklanmaktadır:

Bir proxy'nin temel yol: /hello/v1 ve hedef yol: https://mocktarget.apigee.net ile yapılandırıldığını varsayalım. Şimdi, proxy'nin aşağıdaki istekleri aldığını varsayalım:

Yol iste Çözümlenmiş yol Sonuç
/hello/v1/json https://mocktarget.apigee.net/json /hello/v1 temel yolu doğru şekilde eşleştirildiği için çözümlenen yol doğrudur.
Yol iste Çözümlenmiş yol Sonuç
/hello/v1json https://mocktarget.apigee.netjson /hello/v1, /hello/v1json öğesinin alt dizesi olduğundan çözümlenen yol yanlış. /hello/v1json geçerli bir yol olmadığından Edge Microgateway 404 hatası vermelidir. 3.1.6 ve sonraki sürümlerde bu durumda 404 hatası verilir.
160431789 Hata Özel eklentiler - init'e iletilen yapılandırma nesnesi doldurulmuyor

Apigee Edge yapılandırması, Edge Microgateway yapılandırma dosyasıyla birleştirildikten sonra tüm özel eklentiler için yapılandırma nesnesinde kullanılabilir. Yapılandırma bölümüne bakın.

162758808 Hata Redis destekli deposu için yeni kota yapılandırması

Kotalar için Redis destekli bir depolama alanı belirtmek üzere aşağıdaki yapılandırmayı kullanabilirsiniz. Ayrıntılar için Kota için Redis destekli depolama alanı kullanma başlıklı makaleyi inceleyin.

3.1.5

26 Haziran 2020 Cuma günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.5 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.1.5 3.1.6 3.1.4 3.1.0 3.1.0

Hata düzeltmeleri ve geliştirmeler:

Sorun Kimliği Tür Açıklama
159210507 Özellik Eklenti işlemeyi hariç tutacak yapılandırma

Belirtilen URL'ler için eklentilerin işlenmesini atlamaya yönelik yeni bir yapılandırma özelliği eklendi. Ayrıntılar için Eklentiler için hariç tutulan URL'leri yapılandırma başlıklı makaleyi inceleyin.

156986819, 158529319 Hata json2xml eklentisiyle ilgili sorunlar düzeltildi

Eklentinin yinelenen Content-Type başlıkları oluşturduğu ve bazı durumlarda başlıkların hedefe beklendiği gibi gönderilmediği sorunlar düzeltildi.

156560067, 159688634 Özellik

Yapılandırmada ortam değişkeni değerlerini kullanma

Yapılandırma dosyasındaki etiketleri kullanarak ortam değişkenlerini belirtmenize olanak tanıyan bir özellik eklendi. Belirtilen ortam değişkeni etiketlerinin yerine gerçek ortam değişkeni değerleri getirilir. Değişiklikler yalnızca bellekte depolanır ve orijinal yapılandırma veya önbellek dosyalarında depolanmaz. Ayrıntılar için Yapılandırma özelliklerini ortam değişkeni değerleriyle ayarlama başlıklı makaleye bakın.

155077210 Hata Günlük biçimlendirme sorunu düzeltildi.

Hedef ana makinenin, günlüklerde sonuna fazladan iki nokta işareti eklenmiş şekilde görünmesine neden olan sorun düzeltildi.

153673257 Hata

(Yalnızca Private Cloud için Edge) Microgateway'e duyarlı ürünler çekilmiyor

Mikro ağ geçidiyle uyumlu ürünlerin çekilmemesine neden olan sorun düzeltildi. Bu sorun yalnızca Private Cloud yüklemelerinde Edge'de vardı.

154956890, 155008028, 155829434 Özellik İndirilen ürünlerin özel özelliklere göre filtrelenmesi desteği

Ayrıntılar için Ürünleri özel özelliklere göre filtreleme başlıklı makaleyi inceleyin.

153949764 Hata Günlük hedef dosyası dolduğunda Edge Microgateway işleminin kilitlenmesine neden olan sorun düzeltildi.

Hata yakalamak ve konsola mesaj yazdırmak için istisna işleme iyileştirildi.

155499600 Hata Anahtar döndürme ve KVM yükseltme ile ilgili sorunlar düzeltildi

JWT anahtarlarına rotasyon uygulama başlıklı makaleyi de inceleyin.

3.1.4

23 Nisan 2020 Cuma günü Edge Microgateway'de aşağıdaki düzeltmeyi yayınladık.

Hata düzeltmesi:

3.1.3 sürümündeki bağımlılık sorunu düzeltildi. 3.1.3 sürümü, npm deposunda kullanımdan kaldırıldı olarak işaretlendi. Aksi takdirde, 3.1.3 sürüm notunda açıklanan tüm hata düzeltmeleri ve geliştirmeler bu sürüm için geçerli olur.

3.1.3

15 Nisan 2020 Çarşamba günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.3 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.1.3 3.1.3 3.1.3 3.0.14 3.0.9

Hata düzeltmeleri ve geliştirmeler:

  • 153509313 - Node.js hata ayıklama modülünün bellek sızıntılarına neden olduğu sorun düzeltildi. Bu sorun, v3.1.0, v3.1.1 ve 3.1.2 sürümlerinde mevcuttur.
  • 153509313 - İki farklı işlem için aynı ileti kimliğinin günlük çıktısına yazdırılması sorunu düzeltildi.
  • 151673570 - Edge Microgateway'in yeni Apigee KVM API'lerini kullanacak şekilde güncellenmemesine neden olan sorun düzeltildi. Edge Microgateway artık KVM değerlerini eklemek ve güncellemek için yeni komutları kullanıyor.
  • 152822846 - Önceki sürümlerde, Edge Microgateway'in kaynak yolu eşlemesini işleme şekli Apigee Edge'in işleme şekliyle eşleşecek şekilde güncellendi. Bu sürümde, /literal_string/* kalıbının doğru şekilde işlenmemesine neden olan sorun düzeltildi. Örneğin, /*/2/*. Ayrıca "/", "/*" ve "/**" kaynak yolunun davranışını yapılandırma başlıklı makaleyi de inceleyin.
  • 152005003 - Kotalar için kuruluş ve ortam kapsamlı tanımlayıcıların etkinleştirilmesiyle ilgili değişiklikler yapıldı.
  • 152005003 - Kotalar için kuruluş ve ortam kapsamlı tanımlayıcıların etkinleştirilmesiyle ilgili değişiklikler yapıldı. Kota tanımlayıcısı olarak "org + env + appName + productName" kombinasyonu kullanılır.

3.1.2

16 Mart 2020 Pazartesi günü Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.3 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.1.2 3.1.2 3.1.2 3.0.13 3.0.9

Hata düzeltmeleri ve geliştirmeler:

  • 151285018 - Edge Microgateway ile arka uç hedefleri arasındaki trafik için HTTP proxy desteği eklemek üzere bir özellik geliştirildi. Ayrıca, Edge Microgateway ile Apigee Edge arasındaki mevcut HTTP proxy desteğiyle ilgili sorunlar da düzeltildi. Ayrıntılı bilgi için:
  • 149101890 - Hedef sunucu veya yük dengeleyici bağlantısını kapattığında hata yerine bilgi günlüğü bildirimi gönderilecek şekilde değişiklik yapıldı.
  • 150746985 - Yapılandırma dosyasında edgemicro verify veya quotaUri: https://%s-%s.apigee.net/edgemicro-auth karakterlerinden biri varsa edgemicro verify komutunun düzgün çalışmamasına neden olan sorun düzeltildi. redisBasedConfigCache: true
  • 151284716 - Yeniden yükleme sırasında çalışanlar yeniden başlatıldığında sunucu bağlantılarını daha hızlı kapatmak için iyileştirme yapıldı.
  • 151588764 - Node.js v8 kullanımdan kaldırıldığından, Edge Microgateway'i Docker container'da çalıştırmak için kullanılan Docker görüntüsündeki Node.js sürümünü 12 olarak güncelleyin.
  • 151306049 - Edge Microgateway KSA komutları tarafından kullanılan Apigee Edge yönetim API'lerinin listelendiği doküman güncellendi. Edge Microgateway hangi yönetim API'lerini kullanır? başlıklı makaleyi inceleyin.

3.1.1

20 Şubat Perşembe günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri kullanıma sunduk.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.1 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.1.1 3.1.1 3.1.1 3.0.13 3.0.9

Hata düzeltmeleri ve geliştirmeler:

  • 146069701 - microgateway-core modülünün HTTP_PROXY ve HTTPS_PROXY ortam değişkenlerine uymamasına neden olan sorun düzeltildi. Bu değişiklikle birlikte, YAML yapılandırma dosyasındaki proxy ayarları (belirtilmişse) artık yoksayılıyor. Proxy'yi belirtmek için yalnızca ortam değişkenleri kullanılıyor.

    Yapılandırma dosyasında proxy yapılandırması belirtmek istiyorsanız yapılandırma dosyasında belirtilenle aynı proxy URL'sini içeren bir HTTP_PROXY değişkeni de belirtmeniz gerekir. Örneğin, aşağıdaki yapılandırmayı belirtirseniz:

    edge_config:
      proxy: http://10.128.0.20:3128
      proxy_tunnel: true

    Ayrıca şu ortam değişkenini de belirtmeniz gerekir:

    HTTP_PROXY=http://10.128.0.20:3128
  • 146320620 - Yeni bir yapılandırma parametresi olan edgemicro.headers_timeout eklendi. Bu özellik, HTTP ayrıştırıcının tam HTTP üstbilgilerini almak için bekleyeceği süreyi (milisaniye cinsinden) sınırlar. Örneğin:
    edgemicro:
    keep_alive_timeout: 6000
    headers_timeout: 12000

    Dahili olarak, parametre isteklerde Node.js Server.headersTimeout özelliğini ayarlar. (Varsayılan: edgemicro.keep_alive_timeout ile ayarlanan süreden 5 saniye fazla. Bu varsayılan ayar, yük dengeleyicilerin veya proxy'lerin bağlantıyı yanlışlıkla bırakmasını engeller.)

  • 149278885 - Hedef API zaman aşımını tek bir genel zaman aşımı ayarı kullanmak yerine API proxy düzeyinde ayarlamanıza olanak tanıyan yeni bir özellik eklendi.

    API proxy'sinde TargetEndpoint özelliğini io.timeout.millis ayarlarsanız Edge Microgateway bu özelliği alabilir ve hedef uç noktaya özel zaman aşımları uygulayabilir. Bu parametre uygulanmazsa Edge Microgateway, edgemicro.request_timeout ile belirtilen genel zaman aşımını kullanır.

3.1.0

21 Ocak Salı günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.0 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.1.0 3.1.0 3.1.0 3.0.12 3.0.9

Hata düzeltmeleri ve geliştirmeler:

  • 144187500 - quotas.failOpen işareti tetiklendiğinde yeni bir UYARI düzeyi etkinliği kaydedilir. Bu işaret, kota işleme hatası oluşursa veya Edge'e gönderilen "kota uygula" isteği uzak kota sayaçlarını güncelleyemezse tetiklenir. Bu durumda, bir sonraki başarılı uzak kota senkronizasyonu gerçekleşene kadar kota yalnızca yerel sayımlara göre işlenir. Daha önce bu etkinlik yalnızca günlük düzeyi DEBUG olarak ayarlandığında günlüğe kaydediliyordu.

    Örneğin:

    2020-01-20T02:52:53.040Z [warn][localhost:8000][5][foo-eval][test][hello/][]
    [DbpGIq9jKfzPX8jvXEivhA0LPwE][f372cc30-3b2f-11ea-845f-a627f][quota][remote quota not
    available so processing locally, setting quota-failed-open for identifier: AppQuota60.Quota60]
    [GET][][][][]
  • 145023519 - Edge Microgateway bir API proxy'sinde değişiklik algıladığında devam eden veya yeni işlemlerin etkilenmesiyle ilgili sorun düzeltildi. Artık bir proxy'de değişiklik yapıldığında Edge Microgateway önbelleği yeniler ve çalışan düğümleri yeniden başlatılır. Bu değişiklikle birlikte, devam eden işlemler ve mikro ağ geçidine gönderilen yeni API çağrıları etkilenmez.
  • 146378327 - sourceRequest, targetRequest ve targetResponse günlük seviyesi INFO seviyesine değiştirildi.
  • 146019878 - Edge Analytics'te "API Proxy Performansı" için hesaplanan gecikme ile Edge Microgateway sourceResponse/targetResponse günlük etkinlikleri arasındaki tutarsızlık düzeltildi. Artık Edge Analytics ve Microgateway günlük etkinliklerindeki gecikme süresi aynıdır.
  • Desen eşleştirme mantığıyla ilgili değişiklikler:
    • 147027862 - OAuth eklentisi, API ürünlerinde belirtildiği gibi aşağıdaki kaynak yolu eşleştirme kalıplarını destekleyecek şekilde güncellendi:
      • /{literal}**
      • /{literal}*
      • Yukarıdaki iki kalıbın herhangi bir kombinasyonu

      Bu değişiklikle birlikte Edge Microgateway eklentisi artık "/", "/*" ve "/**" kaynak yolu davranışını yapılandırma başlıklı makalede açıklandığı gibi Apigee Edge ile aynı kalıp eşleştirme yöntemini kullanıyor.

    • 145644205 - Update pattern matching logic of apiKeys plugin to match oauth plugin.
  • 143488312 - İstemci kimliği parametresindeki baştaki veya sondaki boşlukların, OAuth jetonu ve API anahtarı istekleri için JWT ürün listesinin boş oluşturulmasına neden olduğu sorun düzeltildi.
  • 145640807 ve 147579179: "Senkronizasyon aracı" adlı özel bir Edge Microgateway örneğinin, yapılandırma verilerini Apigee Edge'den alıp yerel bir Redis veritabanına yazmasına olanak tanıyan yeni bir özellik eklendi. Diğer mikro ağ geçidi örnekleri daha sonra yapılandırma verilerini veritabanından okuyacak şekilde yapılandırılabilir. Bu özellik, Edge Microgateway'e dayanıklılık kazandırır. Bu sayede, mikro ağ geçidi örnekleri Apigee Edge ile iletişim kurmaya gerek kalmadan başlatılabilir ve çalıştırılabilir. Ayrıntılar için Senkronizasyon aracını kullanma başlıklı makaleyi inceleyin.

    Senkronizasyon özelliği şu anda Redis 5.0.x ile çalışacak şekilde desteklenmektedir.

Sürüm 3.0.x

Hata düzeltmeleri ve geliştirmeler v.3.0.x

3.0.10

8 Kasım Cuma günü Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.0.10 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.0.10 3.0.8 3.0.8 3.0.11 3.0.8

Hata düzeltmeleri ve geliştirmeler:

  • 142677575 - Edge Microgateway için API ürünlerinde kullanılan kaynak yollarının kalıp eşleştirme işleminin, "/", "/*" ve "/**" kaynak yolunun davranışını yapılandırma bölümünde açıklandığı gibi Apigee Edge tarafından kullanılan kaynak yolu kalıp eşleştirme işlemiyle uyumlu olması için bir özellik güncellemesi yapıldı.

    Not: /*/2/** gibi bileşik kaynak kalıbı kullanıyorsanız edgemicro_auth proxy'sinin bağımsız bir API ürününe eklendiğinden emin olmanız gerekir. Ardından, aşağıdaki ekran görüntüsünde gösterildiği gibi bu ürünü proxy'nin geliştirici uygulamasında kullanmanız gerekir:

    alt_text

    Not: Configuring the behavior of a resource path of '/', '/*', and '/**' başlıklı makalede açıklandığı gibi features.isSingleForwardSlashBlockingEnabled yapılandırma özelliği, Edge Microgateway için desteklenmez.

  • 143740696 - quotas yapılandırma yapısı değişti (3.0.9 sürümünün sürüm notlarına da bakın). quotas özelliği, kota eklentisini yapılandırmak için kullanılır. Yapıdaki değişiklik, yapılandırma öğelerinin netliğini artırmak için yapıldı. Kota eklentisini yapılandırmak için aşağıdaki YAML yapılandırmasını kullanın. Yapılandırma özelliğinin quotas olarak adlandırıldığını unutmayın. Tek tek quotas yapılandırma özellikleri hakkında ayrıntılı bilgi için Kota yapılandırma seçenekleri başlıklı makaleyi inceleyin.

    edgemicro:
      home: ../gateway
      port: 8000
      max_connections: -1
      max_connections_hard: -1
      logging:
        level: info
        dir: /var/tmp
        stats_log_interval: 60
      plugins:
        dir: ../plugins
        sequence:
          - oauth
          - quota
    quotas:
      bufferSize:
        hour: 20000
        minute: 500
        default: 10000
      useDebugMpId: true
      failOpen: true
    ...
  • 141750056 - Kota destekli depolama alanı olarak Redis'i kullanmanıza olanak tanıyan yeni bir özellik eklendi. useRedis doğruysa volos-quota-redis modülü kullanılır. Doğru olduğunda kota yalnızca Redis'e bağlanan Edge Microgateway örnekleriyle sınırlanır. Yanlışsa destek deposu olarak volos-quota-apigee modülü kullanılır ve kota sayacı genel olur. Ayrıntılar için Kota yapılandırma seçenekleri başlıklı makaleyi inceleyin. Örneğin:
    edgemicro:
    ...
    quotas:
      useRedis: true
      redisHost: localhost
      redisPort: 6379
      redisDb: 1
  • 140574210 - edgemicro-auth proxy'si tarafından oluşturulan jetonların varsayılan geçerlilik süresi 108.000 milisaniyeden (1,8 dakika) 1.800 saniyeye (30 dakika) çıkarıldı.
  • 143551282 - SAML'nin etkinleştirildiği kuruluşları desteklemek için edgemicro genkeys komutu, ‑‑token parametresini içerecek şekilde güncellendi. Bu parametre, kimlik doğrulama için kullanıcı adı/şifre yerine OAuth jetonu kullanmanıza olanak tanır. Ayrıntılı bilgi için Anahtar oluşturma başlıklı makaleyi inceleyin.

3.0.9

11 Ekim Cuma günü Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.0.9 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.0.9 3.0.7 3.0.7 3.0.10 3.0.7

Hata düzeltmeleri ve geliştirmeler:

  • 141989374 - Kota eklentisi için yeni bir "fail open" özelliği eklendi. Bu özellik etkinleştirildiğinde, kota işleme hatası oluşursa veya Edge'e yönelik "kota uygulama" isteği uzak kota sayaçlarını güncelleyemezse kota, bir sonraki başarılı uzak kota senkronizasyonu gerçekleşene kadar yalnızca yerel sayımlara göre işlenir. Bu iki durumda da istek nesnesinde quota-failed-open işareti ayarlanır.

    Kota "fail open" özelliğini etkinleştirmek için aşağıdaki yapılandırmayı ayarlayın:

    quotas :
     failOpen : true

    Not: Ayrıca, OAuth eklentisinin fail-open istek nesnesi işaretinin adı oauth-failed-open olarak değiştirildi.

  • 142093764 - Kota aşımını önlemek için edgemicro-auth proxy'sinde yapılandırma değişikliği yapıldı. Değişiklik, kota türünü calendar olarak ayarlamayı amaçlamaktadır. Bu iyileştirmeyi kullanmak için edgemicro-auth sürümünüzü 3.0.7 veya sonraki bir sürüme güncellemeniz gerekir.
  • 142520568 - Kota yanıtlarında MP (mesaj işlemci) kimliğinin günlüğe kaydedilmesini sağlayan yeni bir özellik eklendi. Bu özelliği kullanmak için edgemicro-auth proxy'nizi 3.0.7 veya sonraki bir sürüme güncellemeniz ve aşağıdaki yapılandırmayı ayarlamanız gerekir:
    quotas:
      useDebugMpId: true

    useDebugMpId ayarlandığında Edge'den gelen kota yanıtları MP kimliğini içerir ve Edge Microgateway tarafından günlüğe kaydedilir. Örneğin:

    {
        "allowed": 20,
        "used": 3,
        "exceeded": 0,
        "available": 17,
        "expiryTime": 1570748640000,
        "timestamp": 1570748580323,
        "debugMpId": "6a12dd72-5c8a-4d39-b51d-2c64f953de6a"
    }

3.0.8

26 Eylül Perşembe günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.0.8 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.0.8 3.0.6 3.0.6 3.0.9 3.0.6

Hata düzeltmeleri ve geliştirmeler:

  • 140025210 - Yeni bir "fail open" özelliği eklendi. Bu özellik, edgemicro-auth proxy'sine başarılı bir API anahtarı doğrulama çağrısı yapılmasını engelleyen bir bağlantı hatası nedeniyle süresi dolmuş bir JWT jetonu yenilenemezse API işlemenin devam etmesine olanak tanır.

    Bu özellik, eski jetonun önbellekte kalacağı ve ek süre sona erene kadar yeniden kullanılacağı bir ek süre belirlemenize olanak tanır. Bu özellik, geçici bağlantı hatası durumunda Edge Microgateway'in istekleri işlemeye devam etmesine olanak tanır. Bağlantı devam ettiğinde ve API anahtarını doğrulama çağrısı başarıyla tamamlandığında yeni bir JWT alınır ve önbellekteki eski JWT'nin yerini alır.

    Yeni "fail open" özelliğini yapılandırmak için aşağıdakileri yapın:

    1. Edge Microgateway yapılandırma dosyasındaki oauth bölümünde aşağıdaki özellikleri ayarlayın:
      oauth:
        failOpen: true
        failopenGraceInterval: time_in_seconds
        cacheKey: true
        ...

      Örneğin:

      oauth:
        failOpen: true
        failopenGraceInterval: 5
        cacheKey: true
        ...

      Bu örnekte, bağlantı sorunu nedeniyle yenilenemezse eski jeton 5 saniye boyunca kullanılır. 5 saniye sonra kimlik doğrulama hatası döndürülür.

  • 141168968 - Tüm eklenti günlük çıkışına correlation_id dahil edilecek şekilde güncelleme yapıldı. Ayrıca, bazı günlüklerin günlük düzeyleri gerektiği gibi error olarak değiştirildi.
  • 140193349 - edgemicro-auth proxy'sinde, her API anahtarını doğrulama isteğinde Edge Microgateway anahtarının ve gizli anahtarının doğrulanmasını zorunlu kılan bir güncelleme yapıldı. Edge Microgateway, her API anahtarını doğrulama isteğinde anahtarı ve gizli anahtarı her zaman gönderecek şekilde güncellendi. Bu değişiklik, istemcilerin yalnızca API anahtarıyla JWT almasını engeller. başlıklı makaleyi inceleyin.
  • 140090250 - Kota işleme için teşhis günlük kaydı eklemek üzere güncelleme yapıldı. Bu değişiklikle birlikte, kota günlük çıktısını Edge Microgateway'in diğer günlükleriyle ilişkilendirmek artık mümkün.

3.0.7

12 Eylül Perşembe günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.0.7 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan yayın numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway core config plugins edgeauth
3.0.7 3.0.5 3.0.5 3.0.8 3.0.5

Hata düzeltmeleri ve geliştirmeler:

  • 140075602 - OAuth eklentisinde, uygun durumlarda 5xx durum kodu döndürecek şekilde güncelleme yapıldı. Daha önce eklenti, 200 dışındaki tüm durumlarda yalnızca 4xx durum kodları döndürüyordu. Artık 200 durumu olmayan tüm ileti yanıtları için hataya bağlı olarak tam 4xx veya 5xx kodu döndürülür.

    Bu özellik varsayılan olarak devre dışıdır. Bu özelliği etkinleştirmek için Edge Microgateway yapılandırmanıza oauth.useUpstreamResponse: true özelliğini ekleyin. Örneğin:

    oauth:
      allowNoAuthorization: false
      allowInvalidAuthorization: false
      gracePeriod: 10
      useUpstreamResponse: true
  • 140090623 - 3.0.6 sürümünde quota.quotaUri adlı yeni bir yapılandırma özelliği eklendi. Kotaları kuruluşunuza dağıtılan edgemicro-auth proxy'si üzerinden yönetmek istiyorsanız bu yapılandırma özelliğini ayarlayın. Bu özellik ayarlanmazsa kota uç noktası varsayılan olarak dahili Edge Microgateway uç noktası olur. Örneğin:
    edge_config:
      quotaUri: https://%s-%s.apigee.net/edgemicro-auth

    3.0.7 sürümünde, edgemicro-auth bu yeni yapılandırmayı kabul edecek şekilde güncellendi. quotaUri özelliğini kullanmak için en yeni edgemicro-auth proxy'sine yükseltme yapmanız gerekir. Ayrıntılar için edgemicro-auth proxy'sini yükseltme başlıklı makaleyi inceleyin.

  • 140470888 - Kimlik doğrulama sağlamak için kota çağrılarına bir yetkilendirme üstbilgisi eklendi. Ayrıca, edgemicro-auth proxy'si, kota tanımlayıcısından "organization" öğesini kaldıracak şekilde değiştirildi. Kota uç noktası müşterinin kuruluşunda bulunduğundan kota tanımlayıcısına artık gerek yoktur.
  • 140823165 - Aşağıdaki mülk adı:
    edgemicro:
        keepAliveTimeout

    3.0.6 sürümünde yanlış belgelenmiştir. Doğru tesis adı:

    edgemicro:
        keep_alive_timeout
  • 139526406 - Bir geliştirici uygulamasında birden fazla ürün varsa yanlış kota sayımına neden olan hata düzeltildi. Birden fazla ürün içeren bir uygulamadaki her ürün için kota artık doğru şekilde uygulanıyor. Kota tanımlayıcı olarak "appName + productName" kombinasyonu kullanılır.

3.0.6

29 Ağustos Perşembe günü Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

  • 138633700 - keepAliveTimeout adlı yeni bir yapılandırma özelliği eklendi. Bu özellik, Edge Microgateway zaman aşımını (milisaniye cinsinden) ayarlamanıza olanak tanır. (Varsayılan: 5.000 milisaniye)

    Örneğin:

    edgemicro:
      keep_alive_timeout: 600
  • 140090623 - quotaUri adlı yeni bir yapılandırma özelliği eklendi. Kotaları kuruluşunuza dağıtılan edgemicro-auth proxy'si üzerinden yönetmek istiyorsanız bu yapılandırma özelliğini ayarlayın. Bu özellik ayarlanmazsa kota uç noktası varsayılan olarak dahili Edge Microgateway uç noktası olur. Örneğin:
    edge_config:
      quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
    

    Bu özelliği kullanmak için öncelikle edgemicro-auth proxy'nin en yeni sürümünü kuruluşunuza dağıtmanız gerekir. Ayrıntılar için edgemicro-auth proxy'sini yükseltme başlıklı makaleyi inceleyin.

  • 138722809 - stack_trace adlı yeni bir yapılandırma özelliği eklendi. Bu özellik, günlük dosyalarında yığın izlemelerinin görünüp görünmeyeceğini kontrol etmenize olanak tanır. Örneğin:
    stack_trace: false

    stack_trace, true olarak ayarlanırsa yığın izi günlüklerde yazdırılır. false olarak ayarlanırsa günlüklerde yığın izi yazdırılmaz.

3.0.5

15 Ağustos Perşembe günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

Düzeltilen hatalar
  • 139005279 - edgemicro status komutunun doğru sayıda çalışan işlemi döndürmemesine neden olan sorun düzeltildi.
  • 138437710 - ExitCounter sınıfında, uygun günlüğün yazılmasını engelleyen bir sorun düzeltildi.
Genel günlük mesajı iyileştirmeleri
  • 139064652 - Etkinlik ve sistem günlükleri için trace ve debug günlük kaydı düzeyleri ekleme özelliği eklendi. Şimdilik yalnızca bu günlük düzeylerini ekleme özelliği eklendi. Şu anda, kullanılabilir günlük düzeyleri info, warn ve error'dir.
  • 139064616 - Günlük çıkışı, tüm konsol günlük ifadeleri için standartlaştırıldı. Konsol günlük kaydı ifadeleri artık şu özellikleri içeriyor:
    • Zaman damgası
    • Bileşen adı
    • İşlem Kimliği
    • Konsol günlük mesajı
JWT anahtarı ve gizli günlük mesajı iyileştirmeleri
  • 138413755 - Şu CLI komutları için JWT anahtarı ve gizli anahtarla ilgili günlük mesajlarını iyileştirin: cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey ve configure.
Zaman aşımı ve bağlantı reddedildi hata mesajı iyileştirmeleri
  • 138413577 - Arka uç hizmeti zaman aşımları için hata işlemeyi ekleyin ve iyileştirin.
  • 138413303 - Yanıt ve soket zaman aşımları için hata işleme özelliği eklendi ve iyileştirildi.
  • 138414116 - "Bağlantı reddedildi" hataları için hata işleme özelliği eklendi ve iyileştirildi.

3.0.4

1 Ağustos Perşembe günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

  • 134445926 - Dahili Edge Microgateway kimlik doğrulamasıyla ilgili iyileştirmeler.
  • 137582169 - İstenmeyen işlemlerin başlatılmasına neden olan sorun giderildi. Ek işlemler, eklentilerin yeniden yüklenmesine ve aşırı bellek kullanılmasına neden oldu. Edge Microgateway artık işlem sayısını beklenen sınır içinde tutuyor.
  • 137768774 - Günlük mesajı iyileştirmeleri:
    • İşlem (istek) günlükleri temizlendi.
    • Gerektiğinde daha fazla günlük mesajı eklendi.
    • İşlem (istek) günlük mesajları, konsol çıkışından ilgili günlük dosyasına taşındı.
    • Merkezi günlük işlevi kullanılacak şekilde konsol günlükleri güncellendi.
  • 138321133, 138320563 - Gelecekteki kota geliştirmelerini etkinleştirmek için kota arabelleğinde temel bir dahili değişiklik yapıldı.

3.0.3

23 Temmuz Salı günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri kullanıma sunduk.

  • Günlük kaydı geliştirmeleri: Mevcut çalışma zamanı günlükleri, çalışma zamanı verilerini tutarlı bir biçimde yakalayan ve günlüğe kaydeden yeni bir eventLog() işlevini kullanır. Günlük bilgileri şunları içerir:
    • Zaman damgası (ISO 8601: YYYY-AA-GGTSS:dd:ss.sssZ).
    • Günlük kaydı düzeyi (hata, uyarı veya bilgi).
    • Ana makine adı: İstek üstbilgisindeki istekte bulunan ana makine adı.
    • İşlem kimliği: Bir Node.js işlemleri kümesi çalıştırıyorsanız bu, günlüğe kaydetmenin gerçekleştiği işlemin kimliğidir.
    • Apigee kuruluş adı.
    • Kuruluştaki ortam adı.
    • API proxy'sinin adı.
    • İstemci IP adresi.
    • ClientId.
    • Bağıntı kimliği (şu anda ayarlanmamış).
    • Edge Microgateway bileşeninin adı.
    • Özel mesaj: Bazı nesneler, bu hata özelliğine iletilen ek bilgileri yazdırabilir.
    • İstek yöntemi (HTTP isteği ise).
    • Yanıt durum kodu (HTTP isteği ise).
    • Hata mesajı.
    • Hata kodu: Bir nesne hata kodu içeriyorsa bu özellik hata kodunu yazdırır.
    • Geçen süre.
    • İşletim sistemi satır sonu işaretçisi.

    Boş özellik değerleri, boş parantezlere ([]) neden olur.

    Aşağıdaki örnekte günlük biçimi gösterilmektedir:

    Timestamp [level][hostname][ProcessId][Org][Environment][APIProxy][ClientIp][ClientId][][component][customMessage][reqMethod][respStatusCode][errMessage][errCode][timeTaken]

    (137770055)

  • Performans: API ürünleri ortama göre filtrelenmiyordu. Bu sorun düzeltildi. (135038879)
  • Çeşitli işlevsel test entegrasyonları ve kod kalitesinde iyileştirmeler yapıldı.

3.0.2

3 Temmuz 2019 Çarşamba günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri kullanıma sunduk.

Kod kalitesi: Kod, kalite açısından incelenmiş ve kullanıcıların istediği kalite standartlarını karşılamak için kod değişiklikleri yapılmıştır. JSHint'ten kaynaklanan kod kalitesi hatalarını ve uyarılarını giderdik. Sonuç olarak, bazı gerçek kod hataları tespit edilip düzeltildi. Tüm Apigee Edge Microgateway modülleri bu süreçten geçirilmiştir. microgateway-config, microgateway-core, microgateway-plugins ve microgateway için 28 Haziran ve 2 Temmuz tarihli taahhütlere bakın. Kod kalitesi değişiklikleri içeren tüm modüller, Edge Microgateway'in müşteri kullanım alanları için yürütülmesini doğrulayan dahili araçlarla test edilmiştir.

3.0.1

21 Haziran 2019 Cuma günü, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladık.

  • 134834551 - Edge Microgateway için desteklenen Node.js sürümlerini değiştirme
    (Node.js desteklenen sürümleri: 8 ve 12; 7, 9 ve 11 sürümleri deneyseldir)
  • 134751883 - Edge Microgateway, yük altında yeniden yüklenirken kilitleniyor
  • 134518428 - Edge Microgateway için ürün uç noktası, filtre kalıbı yanlışsa 5XX döndürüyor
  • 135113408 - Çalışanlar beklenmedik bir şekilde işi bırakırsa yeniden başlatma yapmalıdır
  • 134945852 - tokenCacheSize, oauth eklentisinde kullanılmıyor
  • 134947757 - set cacheTTL in oauth plug-in
  • 135445171 - OAuth'ta ek süre hesaplaması doğru değil
  • Edge Microgateway yüklemesiyle birlikte sağlanan memored modülünü kullanma
  • 135367906 - Güvenlik denetimi

Sürüm 2.5.x

Yeni özellikler ve geliştirmeler v.2.5.x

(2.5.38 sürümünde düzeltildi, 07.06.2019)

Yanlış biçimlendirilmiş JWT'ler, jeton önbelleği kullanılırken çalışanların kilitlenmesine neden olabilir. Edge microgateway-plugins modülünde düzeltildi. (b/134672029)

(2.5.37 sürümünde eklendi) edgemicro-cert -t KSA seçeneğini ekleyin.

edgemicro cert -t seçeneği, yönetim API'lerinin kimliğini doğrulamak için bir OAuth jetonu belirtmenize olanak tanır. Sertifikaları yönetme başlıklı makaleyi de inceleyin.

(2.5.35 sürümünde eklendi) edgemicroctl kullanarak Edge Microgateway'de hata ayıklama desteği ekleyin.

mgdebug işaretini edgemicroctl ile birlikte kullanabilirsiniz. Ayrıca Kubernetes entegrasyon görevleri başlıklı makaleyi inceleyin.

(2.5.35 sürümünde eklendi) edgemicroctl için Windows derlemesini etkinleştirin.

(2.5.31'de eklendi) Yeni edgemicro-auth/token API'si

İstemci/gizli anahtarı Base64 kodlu temel yetkilendirme üstbilgisi olarak ve grant_type'ı form parametresi olarak iletmenize olanak tanıyan yeni bir edgemicro-auth/token API'si eklendi. Doğrudan taşıyıcı jeton alma başlıklı makaleyi inceleyin.

(2.5.31 sürümünde düzeltildi) Özel yapılandırma, jeton işaretine uymuyor

Edge Microgateway'i Edge for Private Cloud'da OAuth2 erişim jetonu kullanacak şekilde yapılandırmanın düzgün çalışmamasına (jetonun dikkate alınmamasına) neden olan sorun düzeltildi.

Docker: Kendinden imzalı sertifikaların kullanımı için destek

(2.5.29 sürümünde eklendi) Node.js tarafından varsayılan olarak güvenilmeyen bir sertifika yetkilisi (CA) kullanıyorsanız Edge Microgateway ile bir Docker kapsayıcısı çalıştırdığınızda NODE_EXTRA_CA_CERTS parametresini kullanabilirsiniz. Ayrıntılar için Node.js tarafından güvenilmeyen bir CA kullanma başlıklı makaleyi inceleyin.

Docker: TLS desteği

(2.5.29 sürümünde eklendi) Docker kapsayıcısında çalışan Edge Microgateway artık Edge Microgateway sunucusuna gelen istekler (kuzeye giden istekler) ve Edge Microgateway'den hedef uygulamaya giden istekler (güneye giden istekler) için TLS'yi destekliyor.

Aşağıdaki örneklerde bu TLS yapılandırmalarının nasıl ayarlanacağı ayrıntılı olarak açıklanmaktadır:

Bu örneklerde, sertifikaları yüklemek için container bağlama noktasının /opt/apigee/.edgemicro nasıl kullanılacağını göreceksiniz. Sertifikalar daha sonra Edge Microgateway yapılandırma dosyasında referans olarak kullanılır.

Docker: İstek proxy'si oluşturma desteği

(2.5.27 sürümünde eklendi) Edge Microgateway'i bir Docker kapsayıcısında çalıştırıyorsanız microgateway bir güvenlik duvarının arkasında çalışırken proxy davranışını kontrol etmek için aşağıdaki seçenekleri kullanabilirsiniz:

  • HTTP_PROXY
  • HTTPS_PROXY
  • NO_PROXY

Ayrıntılar için Edge Micro'yu Docker kapsayıcısı olarak çalıştırma başlıklı makaleyi inceleyin.

Docker: Güncellenen eklenti talimatları

(2.5.27'de eklendi) Edge Microgateway'i bir Docker kapsayıcısında çalıştırıyorsanız artık eklentileri dağıtmak için iki seçeneğiniz var. Docker bağlama noktasını kullanma seçeneği yenidir. Diğer seçenek daha önce vardı, temelde değişmedi ancak Dockerfile güncellendi. Ayrıntılar için aşağıdaki bağlantıları inceleyin:

KVM yükseltme komutu için yeni OAuth jetonu desteği

(2.5.27 sürümünde eklendi) upgradekvm komutuyla OAuth jetonu kullanabilirsiniz. Ayrıntılar için KVM'yi yükseltme başlıklı makaleyi inceleyin.

Edge Analytics'te API'leri ayırma

(2.5.26'da eklendi) Yeni analiz eklentisi işaretleri, belirli bir API yolunu Edge Analytics kontrol panellerinde ayrı bir proxy olarak görünecek şekilde ayırmanıza olanak tanır. Örneğin, durum denetimi API'lerini gerçek API çağrılarıyla karıştırmamak için bunları ayırabilirsiniz. Daha fazla bilgi için Yolları analizlerden hariç tutma başlıklı makaleyi inceleyin.

Yerel proxy yapılandırma

(2.5.25'te eklendi) Yerel proxy ile Apigee Edge'de mikro ağ geçidi uyumlu bir proxy'yi manuel olarak oluşturmanız gerekmez. Bunun yerine, mikro ağ geçidi yerel proxy'nin temel yolunu kullanır. Daha fazla bilgi için Yerel proxy modunu kullanma başlıklı makaleyi inceleyin.

Bağımsız modu kullanma

(2.5.25'te eklendi) Edge Microgateway'i herhangi bir Apigee Edge bağımlılığından tamamen bağımsız olarak çalıştırabilirsiniz. Bağımsız mod olarak adlandırılan bu senaryo, Edge Microgateway'i internet bağlantısı olmadan çalıştırmanıza ve test etmenize olanak tanır. Edge Microgateway'i bağımsız modda çalıştırma başlıklı makaleyi inceleyin.

Anahtarları iptal etme

(2.5.19'da eklendi) Bir Edge Microgateway yapılandırması için anahtar ve gizli kimlik bilgilerini iptal eden yeni bir CLI komutu eklendi.

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]
Daha fazla bilgi için Anahtarları iptal etme başlıklı makaleyi inceleyin.

Docker desteği

(2.5.19 sürümünde eklendi) Artık en yeni Edge Microgateway sürümünü Docker görüntüsü olarak indirebilirsiniz:

docker pull gcr.io/apigee-microgateway/edgemicro:latest

Kubernetes desteği

(2.5.19'da eklendi) Edge Microgateway'i bir hizmet olarak veya Kubernetes kümesinde dağıtılan hizmetlerin önünde bir sidecar ağ geçidi olarak dağıtabilirsiniz. Şu makaleye bakın: Edge Microgateway'i Kubernetes ile entegre etmeye genel bakış.

TCP nodelay seçeneği desteği

(2.5.16 sürümünde eklendi) Edge Micro yapılandırmasına yeni bir yapılandırma ayarı (nodelay) eklendi.

TCP bağlantıları, verileri göndermeden önce arabelleğe almak için varsayılan olarak Nagle algoritmasını kullanır. nodelay değerini true olarak ayarlamak bu davranışı devre dışı bırakır (socket.write() her çağrıldığında veriler hemen gönderilir). Daha fazla ayrıntı için Node.js dokümanlarını da inceleyin.

nodelay özelliğini etkinleştirmek için Edge Micro yapılandırma dosyasını aşağıdaki gibi düzenleyin:

edgemicro:
  nodelay: true
  port: 8000
  max_connections: 1000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

Sürekli izleme için yeni CLI seçenekleri

(2.5.12'de eklendi) edgemicro forever komutuna yeni parametreler eklendi. Bu parametreler, forever.json dosyasının konumunu belirtmenize ve Forever arka plan sürecini başlatmanıza veya durdurmanıza olanak tanır. Ayrıca Sürekli izleme başlıklı makaleyi de inceleyin.

ParametreAçıklama
-f, --fileforever.json dosyasının konumunu belirtir.
-a, --actionstart veya stop Varsayılan değer başlangıçtır.

Örnekler:

Forever'ı başlatmak için:

edgemicro forever -f ~/mydir/forever.json -a start

Sonsuza Kadar özelliğini durdurmak için:

edgemicro forever -a stop

JWT anahtar rotasyonu

Edge Microgateway'de OAuth güvenliği için kullanılan JWT jetonlarını oluşturmak üzere kullanılan ortak/özel anahtar çiftlerini döndürmenize olanak tanıyan yeni bir özellik eklendi. JWT anahtarlarına rotasyon uygulama başlıklı makaleyi inceleyin.

İndirilen API proxy'lerini filtreleme

Edge Microgateway, varsayılan olarak Edge kuruluşunuzdaki "edgemicro_" adlandırma önekiyle başlayan tüm proxy'leri indirir. Bu varsayılan ayarı, adları bir kalıpla eşleşen proxy'leri indirecek şekilde değiştirebilirsiniz. İndirilen proxy'leri filtreleme başlıklı makaleyi inceleyin.

API proxy'leri olmayan ürünleri belirtme

Apigee Edge'de API proxy'leri içermeyen bir API ürünü oluşturabilirsiniz. Bu ürün yapılandırması, söz konusu ürünle ilişkili bir API anahtarının kuruluşunuzda dağıtılan herhangi bir proxy ile çalışmasına olanak tanır. Edge Microgateway, 2.5.4 sürümünden itibaren bu ürün yapılandırmasını desteklemektedir.

Sürekli izleme desteği

Edge Microgateway'in, Edge Microgateway'in kaç kez ve hangi aralıklarla yeniden başlatılacağını kontrol etmek için yapılandırabileceğiniz bir forever.json dosyası vardır. Bu dosya, Forever'ı programatik olarak yöneten forever-monitor adlı bir hizmeti yapılandırır. Sürekli izleme başlıklı makaleyi inceleyin.

Edge Micro yapılandırma dosyasının merkezi yönetimi

Birden fazla Edge Microgateway örneği çalıştırıyorsanız bunların yapılandırmalarını tek bir konumdan yönetmek isteyebilirsiniz. Bunu, Edge Micro'nun yapılandırma dosyasını indirebileceği bir HTTP uç noktası belirterek yapabilirsiniz. Yapılandırma dosyası uç noktası belirtme başlıklı makaleyi inceleyin.

Forever CLI seçeneği desteği

(2.5.8 sürümünde eklendi) edgemicro forever [package.json] dosyasının konumunu belirtmek için edgemicro forever [package.json] komutunu kullanın.forever.json Bu komut eklenmeden önce yapılandırma dosyasının Edge Microgateway kök dizininde olması gerekiyordu.

Örneğin:

edgemicro forever ~/mydir/forever.json

Yeniden yükleme komutuna configUrl seçeneği eklendi

(2.5.8 sürümünde eklendi) Artık --configUrl veya -u seçeneğini edgemicro reload komutuyla kullanabilirsiniz.

JWT zaman uyuşmazlıkları için ek süre

(2.5.7 sürümünde eklendi) OAuth yapılandırmasındaki gracePeriod özelliği, sistem saatiniz ile JWT yetkilendirme jetonunda belirtilen Not Before (nbf) veya Issued At (iat) zamanları arasındaki küçük farklılıklardan kaynaklanan hataları önlemeye yardımcı olur. Bu özelliği, bu tür tutarsızlıkların giderilmesi için izin verilecek saniye sayısı olarak ayarlayın. OAuth özellikleri konusunu inceleyin.

(2.5.7 sürümünde eklendi) OAuth yapılandırmasındaki gracePeriod özelliği, sistem saatiniz ile JWT yetkilendirme jetonunda belirtilen Not Before (nbf) veya Issued At (iat) zamanları arasındaki küçük farklılıklardan kaynaklanan hataları önlemeye yardımcı olur. Bu özelliği, bu tür tutarsızlıkların giderilmesi için izin verilecek saniye sayısı olarak ayarlayın. OAuth özellikleri konusunu inceleyin.

2.5.x sürümünde düzeltilen hatalar

  • (236 numaralı sorun) Önbelleği temizleme işlemindeki yazım hatası düzeltildi.
  • (234 numaralı sorun) Edge Microgateway 2.5.35 için yeniden yükleme sırasında kilitlenme.
  • (135 numaralı sorun) -v seçeneği kullanılırken geçersiz sanal ana makine referansı "secure" hatası. Bu düzeltme, sanal ana makinelerin "-v" işaretinde belirtilenlerle tam olarak eşleşmesini sağlamak için dağıtımdan önce edgemicro-auth proxy'sini değiştirir. Ayrıca, sanal ana makine için istediğiniz sayıda ve istediğiniz adla sanal ana makine belirtebilirsiniz (artık varsayılan ve güvenli ile sınırlı değildir).
  • (141 numaralı sorun) edgemicro reload komutu, yapılandırma dosyası seçeneği -c'yi desteklemiyor. Bu sorun düzeltildi.
  • (142 numaralı sorun) Edge Microgateway, yükleme sırasında kullanımdan kaldırılan kripto hakkında hata veriyor. Bu sorun düzeltildi.
  • (145 numaralı sorun) Kota, Edge Microgateway ile çalışmıyor. Bu sorun düzeltildi.
  • (Apigee Topluluğu sorunu: https://community.apigee.com/questions/33149/emg-jwt-token-validated-against-both-api-proxies-a.html#answer-33336) JWT jetonu, OAUTH'taki hem API proxy'lerine hem de kaynak URI'sine karşı doğrulanır. Bu sorun düzeltilmiştir.
  • (Apigee Topluluğu sorunu: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html) Microgateway, OAuth ile çalışmıyor. Bu sorun düzeltildi.
  • Windows'da pidPath'i düzeltin.
  • (157 numaralı sorun) Aşağıdaki hata mesajına neden olan sorun düzeltildi: ReferenceError: deployProxyWithPassword is not defined.
  • (169 numaralı sorun) Node.js bağımlılıklarını güncelleyin (npm denetimi)
  • edgemicro-auth proxy'si artık Edge JWT politikalarını kullanıyor. Proxy artık JWT desteği sağlamak için Node.js'ye bağlı değil.

Sürüm 2.4.x

Yeni özellikler ve geliştirmeler v.2.4.x

1. edgemicro-auth proxy'si için özel bir takma ad ayarlayın (PR 116)

edgemicro-auth proxy'sinin varsayılan temel yolunu değiştirebilirsiniz. Varsayılan olarak, temel yol /edgemicro-auth'dur. Bu değeri değiştirmek için edgemicro configure komutunda -x işaretini kullanın.

Örnek:

edgemicro configure -x /mypath …


2. Temel yollar için joker karakter desteği (PR 77)

Bir edgemicro_* proxy'nin temel yolunda bir veya daha fazla "*" joker karakteri kullanabilirsiniz. Örneğin, /team/*/members temel yolu, yeni ekipleri desteklemek için yeni API proxy'leri oluşturmanıza gerek kalmadan istemcilerin https://[host]/team/blue/members ve https://[host]/team/green/members adreslerini çağırmasına olanak tanır. /**/ öğesinin desteklenmediğini unutmayın.

Önemli: Apigee, temel yolun ilk öğesi olarak joker karakter "*" kullanımını DESTEKLEMEZ. Örneğin, /*/search desteklenmez.

3. Private Cloud yapılandırması için KSA'ya özel yapılandırma yolu eklendi (PR 99)

Varsayılan olarak, microgateway yapılandırma dosyası ./config/config.yaml konumundadır. Artık init, configure ve start komutlarında -c veya --configDir işaretlerini kullanarak komut satırında özel bir yapılandırma yolu belirtebilirsiniz. Private Cloud yüklemeleri için özel yapılandırma dizininin tanınmamasına neden olan sorun düzeltildi.

Örnek:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

4. *_PROXY değişkenlerine uyun (PR 61)

Edge Microgateway bir güvenlik duvarının arkasına yüklenmişse ve herkese açık buluttaki Apigee Edge ile iletişim kuramıyorsa göz önünde bulundurulması gereken iki seçenek vardır:

1. seçenek:

İlk seçenek, microgateway yapılandırma dosyasında edgemicro: proxy_tunnel seçeneğini true olarak ayarlamaktır:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: true

proxy_tunnel true olduğunda Edge Microgateway, HTTP isteklerini tek bir TCP bağlantısı üzerinden tünel oluşturmak için HTTP CONNECT yöntemini kullanır. (Aynı durum, proxy'yi yapılandırmak için kullanılan ortam değişkenlerinde TLS etkinleştirilmişse de geçerlidir.)

2. Seçenek:

İkinci seçenek ise bir proxy belirtmek ve microgateway yapılandırma dosyasında proxy_tunnelfalse olarak ayarlamaktır. Örneğin:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: false

Bu durumda, kullanmak istediğiniz her HTTP proxy'nin ana makinelerini veya hangi ana makinelerin Edge Microgateway proxy'lerini işlememesi gerektiğini kontrol etmek için aşağıdaki değişkenleri ayarlayabilirsiniz: HTTP_PROXY, HTTPS_PROXY ve NO_PROXY. Edge Microgateway'in proxy'sini oluşturmaması gereken alan adlarının virgülle ayrılmış bir listesi olarak NO_PROXY'yi ayarlayabilirsiniz. Örneğin:

export HTTP_PROXY='http://localhost:3786'
export HTTPS_PROXY='https://localhost:3786'

Bu değişkenler hakkında daha fazla bilgi için aşağıdaki kaynaklara bakın:

https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables


5. Hedef istekleri için özel bir zaman aşımı ayarlayın (PR 57)

Bu yapılandırmayla hedef istekleri için özel bir zaman aşımı ayarlayabilirsiniz:

edgemicro:
    request_timeout: 10

Zaman aşımı süresi saniye cinsinden ayarlanır. Zaman aşımı gerçekleşirse Edge Microgateway, 504 durum koduyla yanıt verir.

6. Hedef yanıttaki özel HTTP durum mesajlarına uyun (PR 53)

Edge Microgateway, hedef yanıtta ayarlanan özel HTTP durum mesajlarına uyar. Önceki sürümlerde, hedeften gönderilen durum mesajları Node.js varsayılanlarıyla geçersiz kılınıyordu.

7. X-Forwarded-For üstbilgisi, analytics için client_ip'yi ayarlayabilir.

Varsa X-Forwarded-For üstbilgisi, Edge Analytics'te bildirilen client_ip değişkenini ayarlar. Bu özellik, Edge Microgateway'e istek gönderen istemcinin IP'sini bilmenizi sağlar.

8. OAuth eklentisi değişiklikleri

OAuth eklentisi, API anahtarı doğrulaması ve OAuth erişim jetonu doğrulaması işlemlerini destekler. Bu değişiklikten önce eklenti, güvenlik için her iki formu da kabul ediyordu. Bu değişiklikle, geriye dönük uyumluluğu koruyarak bu güvenlik modellerinden yalnızca birine izin verebilirsiniz.

OAuth eklentileri iki yeni işaret ekler:

  • allowOAuthOnly: true olarak ayarlanırsa her API, Hamiline Ait Erişim Jetonu içeren bir Yetkilendirme başlığı taşımalıdır.

  • allowAPIKeyOnly: true olarak ayarlanırsa her API, API anahtarıyla bir x-api-key üstbilgisi (veya özel bir konum) taşımalıdır.

Bu işaretleri Edge Microgateway yapılandırma dosyasında şu şekilde ayarlarsınız:

oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    keep-authorization-header: false
    allowOAuthOnly: false
    allowAPIKeyOnly: false

9. edgemicro-auth proxy'si iyileştirildi (PR 40)

edgemicro-auth proxy'sinde iyileştirmeler yapıldı. Bu değişikliklerden önce proxy, anahtarları şifrelenmiş bir kasa olan Edge Secure Store'da saklıyordu. Artık proxy, anahtarları Edge'in şifrelenmiş anahtar/değer eşlemesinde (KVM) saklıyor.

10. Varsayılan hedef URL'yi bir eklentide yeniden yazma (PR 74)

Ayrıca hedef uç nokta bağlantı noktasını geçersiz kılabilir ve HTTP ile HTTPS arasında seçim yapabilirsiniz. Eklenti kodunuzdaki şu değişkenleri değiştirin: req.targetPort ve req.targetSecure. HTTPS'yi seçmek için req.targetSecure değerini true olarak, HTTP'yi seçmek için ise false olarak ayarlayın. req.targetSecure değerini doğru olarak ayarlarsanız daha fazla bilgi için bu tartışma dizisine bakın.

11. OAuth jetonu kimlik doğrulaması için ilk destek (PR 125)

Edge Microgateway'i, kimlik doğrulama için kullanıcı adı/şifre yerine OAuth jetonu kullanacak şekilde yapılandırabilirsiniz. OAuth jetonu kullanmak için edgemicro configure komutunda aşağıdaki parametreyi kullanın:

-t, --token <token>

Örneğin:

edgemicro configure -o docs -e test -t <your token>

Hata düzeltmeleri v2.4.3

  • edgemicro-auth proxy'sinin düzgün şekilde çalıştırılması için ücretli bir kuruluşun gerekmesine neden olan sorun düzeltildi. Artık Edge Microgateway'i deneme kuruluşlarıyla da kullanabilirsiniz. (PR 5)
  • Akışın verileri işlemeyi bitirmemesine rağmen son işleyicilerin yürütülmesine neden olan sorun düzeltildi. Bu durum, kısmi bir yanıt gönderilmesine neden oldu. (PR 71)
  • Private Cloud yüklemeleri için özel bir yapılandırma dizininin tanınmamasına neden olan sorun düzeltildi. (PR 110)
  • İstemci ile Edge Microgateway arasındaki çift yönlü SSL ile ilgili sorun düzeltildi. (PR 70)
  • API anahtarı doğrulamasının düzgün çalışması için proxy temel yolunda sondaki eğik çizginin gerekli olmasına neden olan sorun düzeltildi. Artık temel yolun sonunda eğik çizgiye gerek yoktur. (PR 48)

Sürüm 2.3.5

Yeni özellikler ve geliştirmeler v.2.3.5

Proxy filtreleme

Bir Edge Microgateway örneğinin hangi microgateway'e duyarlı proxy'leri işleyeceğini filtreleyebilirsiniz. Edge Microgateway başlatıldığında, ilişkili olduğu kuruluştaki tüm microgateway'e duyarlı proxy'leri indirir. Mikro ağ geçidinin hangi proxy'leri işleyeceğini sınırlamak için aşağıdaki yapılandırmayı kullanın. Örneğin, bu yapılandırma, mikro ağ geçidinin işleyeceği proxy'leri üçle sınırlar: edgemicro_proxy-1, edgemicro_proxy-2 ve edgemicro_proxy-3:

proxies:
  - edgemicro_proxy-1
  - edgemicro_proxy-2
  - edgemicro_proxy-3

Analytics'te veri maskeleme

Yeni bir yapılandırma, istek yolu bilgilerinin Edge analizlerinde görünmesini engellemenize olanak tanır. İstek URI'sini ve/veya istek yolunu maskelemek için mikro ağ geçidi yapılandırmasına aşağıdakileri ekleyin. URI'nin, isteğin ana makine adı ve yol bölümlerinden oluştuğunu unutmayın.

analytics:
  mask_request_uri: 'string_to_mask'
  mask_request_path: 'string_to_mask'

Sürüm 2.3.3

Yeni özellikler ve geliştirmeler v.2.3.3

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

Otomatik değişiklik yoklamasını devre dışı bırakma

Bu özelliği microgateway yapılandırmasında ayarlayarak otomatik değişiklik yoklamasını devre dışı bırakabilirsiniz:

disabled_config_poll_interval: true

Varsayılan olarak, periyodik yoklama Edge'de yapılan tüm değişiklikleri (ürünlerde, microgateway'e duyarlı proxy'lerde vb. yapılan değişiklikler) ve yerel yapılandırma dosyasında yapılan değişiklikleri alır. Varsayılan yoklama aralığı 600 saniyedir (beş dakika).

Hedef URL'leri eklentilerde yeniden yazma

Eklenti kodunuzdaki req.targetHostname ve req.targetPath değişkenlerini değiştirerek varsayılan hedef URL'yi bir eklentide dinamik olarak geçersiz kılabilirsiniz.

Yeni eklenti işlevi imzası

Hedef yanıtı bağımsız değişken olarak sağlayan yeni bir eklenti işlevi imzası eklendi. Bu ekleme, eklentilerin hedef yanıta erişmesini kolaylaştırır.

function(sourceRequest, sourceResponse, targetResponse, data, cb)

Basitleştirilmiş varsayılan günlük kaydı çıkışı

Varsayılan olarak, günlük kaydı hizmeti artık indirilen proxy'lerin, ürünlerin ve JWT'nin JSON'unu atlıyor. Edge Microgateway'i başlattığınızda DEBUG=* ayarını yaparak bu nesneleri varsayılan olarak çıkışa gönderecek şekilde değiştirebilirsiniz. Örneğin:

DEBUG=* edgemicro start -o docs -e test -k abc123 -s xyz456

CLI'ya özel yapılandırma yolu eklendi

Varsayılan olarak, microgateway yapılandırma dosyası ./config/config.yaml konumundadır. init, configure ve start komutlarında artık komut satırında özel bir yapılandırma yolu belirtebilirsiniz. Örneğin:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

v2.3.3 sürümünde düzeltilen hatalar

  • Büyük istek/yanıtlar sırasında oluşan bellek sızıntısı düzeltildi.
  • Eklenti yürütme sırası düzeltildi. Artık dokümanlarda açıklandığı şekilde çalışıyor.
  • accumulate-request eklentisi artık GET istekleri için kilitlenmiyor.
  • Yanıt gövdesinin olmaması nedeniyle hatalara neden olan bir sorun, accumulate-response eklentisinde düzeltildi.

Sürüm 2.3.1

Yükleme notu

Edge Microgateway'in bazı önceki sürümlerinde, ZIP dosyası indirerek yazılımı yükleyebilirsiniz. Bu ZIP dosyaları artık desteklenmiyor. Edge Microgateway'i yüklemek için şunları kullanmanız gerekir:

npm install -g edgemicro

Daha fazla bilgi için yükleme konusuna bakın.

Yeni özellikler ve geliştirmeler (2.3.1 sürümü)

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

Proxy'leri filtreleme

Yeni bir yapılandırma, Edge Microgateway'in başlangıçta hangi proxy'leri yükleyeceğini filtrelemenize olanak tanır. Daha önce, mikro ağ geçidi, edgemicro yapılandırma komutunda belirttiğiniz Edge kuruluşu/ortamından çekilen tüm mikro ağ geçidi uyumlu proxy'leri (edgemicro_* adlı proxy'ler) yüklüyordu. Bu yeni özellik, Edge Microgateway'in yalnızca belirttiğiniz proxy'leri yüklemesi için bu proxy listesini filtrelemenize olanak tanır. Proxy'ler öğesini microgateway yapılandırma dosyasına şu şekilde eklemeniz yeterlidir:

edge micro:
proxies:
    - edgemicro_[name]
    - edgemicro_[name]
    ...

Örneğin, Edge kuruluşunuzda/ortamınızda edgemicro_foo ve edgemicro_bar adlı olanlar da dahil olmak üzere 50 edgemicro_* proxy'niz olduğunu varsayalım. Mikro ağ geçidine yalnızca bu iki proxy'yi kullanmasını şu şekilde söyleyebilirsiniz:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

Mikro ağ geçidi, başlatıldığında yalnızca belirtilen proxy'leri çağırabilir. Edge kuruluşundan/ortamından indirilen diğer mikro ağ geçidi farkında olan proxy'leri çağırma girişimleri hatayla sonuçlanır.

Eklentilerde hedef istek başlıklarını ayarlama

Hedef istek başlıkları eklemek veya değiştirmek istiyorsanız göz önünde bulundurmanız gereken iki temel kalıp vardır: gelen isteğin veri içerdiği (POST isteğinde olduğu gibi) ve içermediği (basit bir GET isteğinde olduğu gibi) kalıp.

Gelen istekte verilerin bulunduğu ve hedef istekte istek başlıklarını ayarlamak istediğiniz bir durumu ele alalım. Edge Microgateway'in önceki sürümlerinde bu durumda hedef üstbilgileri güvenilir bir şekilde ayarlamak mümkün değildi.

Bu kalıbın anahtarı, öncelikle müşteriden gelen tüm verileri biriktirmektir. Ardından, onend_request() işlevinde, başlıkları özelleştirmek için yeni request.setOverrideHeader(name, value) işlevini kullanın.

Bunu nasıl yapacağınızı gösteren örnek bir eklenti kodunu aşağıda bulabilirsiniz. onend_request içinde ayarlanan başlıklar hedefe gönderilir:

module.exports.init = function(config, logger, stats) {


  function accumulate(req, data) {
    if (!req._chunks) req._chunks = [];
    req._chunks.push(data);
  }

  return {

    ondata_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      next(null, null);
    },

    onend_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      var content = Buffer.concat(req._chunks);
      delete req._chunks;
      req.setOverrideHeader('foo', 'bar');
      req.setOverrideHeader('content-length', content.length);
      next(null, content);
    },


    onerror_request: function(req, res, data, next) {
      next(null, null);
    }

  };

}

İstek veri içermiyorsa hedef üstbilgileri onrequest() işleyicisinde ayarlayabilirsiniz. Bu kalıp yeni değildir. Daha önce belgelenmiş ve Edge Microgateway ile birlikte verilen örnek eklentilerde kullanılmıştır.

onrequest: function(req, res, next) {
      debug('plugin onrequest');
      req.headers['x-foo-request-id'] = "bar";
      req.headers['x-foo-request-start'] = Date.now();
      next();
    }

Kapalı kalma süresi olmadan yeniden yükleme özelliği

Edge Microgateway'de yapılandırma değişikliği yaptıktan sonra, yapılandırmayı herhangi bir mesajı bırakmadan yükleyebilirsiniz. Bu değişiklikle birlikte Edge Microgateway her zaman küme modunda başlatılır ve --cluster seçeneği edgemicro start komutundan kaldırıldı.

Ayrıca üç yeni CLI komutu eklendi. Bu komutları, edgemicro start komutunun yürütüldüğü dizinden çalıştırmanız gerekir:

  • edgemicro status - Edge Microgateway'in çalışıp çalışmadığını kontrol eder.
  • edgemicro stop - Edge Microgateway kümesini durdurur.
  • edgemicro reload - Edge Microgateway yapılandırmasını çalışma süresi kesintisi olmadan yeniden yükler.

Kapalı kalma süresi olmadan otomatik yapılandırma yeniden yükleme

Edge Microgateway, yeni bir yapılandırmayı düzenli olarak yükler ve herhangi bir değişiklik olması durumunda yeniden yükleme işlemi gerçekleştirir. Yoklama, Edge'de yapılan tüm değişiklikleri (ürünlerde, mikro ağ geçidi farkında olan proxy'lerde vb. yapılan değişiklikler) ve yerel yapılandırma dosyasında yapılan değişiklikleri alır. Varsayılan yoklama aralığı 600 saniyedir (beş dakika). Varsayılan değeri, mikro ağ geçidi yapılandırma dosyasında aşağıdaki şekilde değiştirebilirsiniz:

edgemicro:
    config_change_poll_interval: [seconds]

CLI'ya sürüm bilgileri eklendi

CLI'ya --version işareti eklendi. Edge Microgateway'in mevcut sürümünü edinmek için şunu kullanın:

edgemicro --version

Yeni Edge Microgateway sunucusu SSL seçenekleri

Edge Microgateway artık key ve cert'ye ek olarak aşağıdaki sunucu SSL seçeneklerini de destekliyor:

Option Açıklama
pfx PFX biçiminde istemcinin özel anahtarını, sertifikasını ve CA sertifikalarını içeren bir pfx dosyasının yolu.
passphrase Özel anahtar veya PFX'nin parolasını içeren bir dize.
ca PEM biçiminde güvenilen sertifikaların listesini içeren bir dosyanın yolu.
ciphers Kullanılacak şifreleri açıklayan, ":" ile ayrılmış bir dize.
rejectUnauthorized Doğruysa sunucu sertifikası, sağlanan CA'ların listesine göre doğrulanır. Doğrulama başarısız olursa hata döndürülür.
secureProtocol Kullanılacak SSL yöntemi. Örneğin, SSL'yi 3. sürüme zorlamak için SSLv3_method.
servername SNI (Sunucu Adı Göstergesi) TLS uzantısının sunucu adı.

Günlük dosyalarını stdout'a gönderme

Yeni bir yapılandırma ayarıyla günlük verilerini standart çıkışa gönderebilirsiniz:

edgemicro:
  logging:
    to_console: true  

Günlük dosyalarını yönetme başlıklı makaleyi inceleyin.

Sürüm 2.1.2

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

Yapılandırma için özel API uç noktasına izin ver

Yetkilendirme proxy'si için, özel kimlik doğrulama hizmetinin kullanımını destekleyen yeni yapılandırılabilir uç noktalar vardır. Bu uç noktalar şunlardır:

  • edgeconfig:verify_api_key_url
  • edgeconfig:products

Ayrıntılar için Özel kimlik doğrulama hizmeti kullanma başlıklı makaleyi inceleyin.

Sürüm 2.1.1

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

Platformlar arası uyumlu kimlik doğrulama proxy'si dağıtma

Edge Microgateway yetkilendirme proxy'sini Edge'e dağıtmak için kullanılan komutun Windows sistemleriyle uyumlu olması için iyileştirme yapıldı.

Sürüm 2.1.0

Yeni özellikler ve geliştirmeler (21.0 sürümü)

Yeni özellikler ve geliştirmeler:

İstemci SSL/TLS seçeneklerini belirtme

Yeni bir yapılandırma seçeneği grubu kullanarak hedeflere yönelik SSL/TSL bağlantıları için istemci seçeneklerini belirleyebilirsiniz. İstemci SSL/TSL seçeneklerini kullanma başlıklı makaleyi inceleyin.

Sürüm 2.0.11

Kurulum notu v2.0.11

Edge Microgateway'in bazı önceki sürümlerinde, ZIP dosyası indirerek yazılımı yükleyebilirsiniz. Bu ZIP dosyaları artık desteklenmiyor. Edge Microgateway'i yüklemek için şunları kullanmanız gerekir:

npm install -g edgemicro

Daha fazla bilgi için yükleme konusuna bakın.

Yeni özellikler ve geliştirmeler v.2.0.11

Yeni özellikler ve geliştirmeler:

Başlangıçta bir bağlantı noktası belirtme

Başlatma komutu, yapılandırma dosyasında belirtilen bağlantı noktasını geçersiz kılacak bir bağlantı noktası numarası belirtmenize olanak tanır. PORT ortam değişkenini kullanarak bir bağlantı noktası numarası da belirtebilirsiniz. Ayrıntılar için start komutu başlıklı makaleyi inceleyin.

İsteğe bağlı olarak kimlik doğrulama üstbilgilerini koruma

Yeni bir yapılandırma ayarı olan keepAuthHeader, istekte gönderilen yetkilendirme başlığını korumanıza olanak tanır. Doğru olarak ayarlanırsa Auth üstbilgisi hedefe iletilir. oauth özelliklerine bakın.

Özel yetkilendirme hizmeti kullanabilme

Kimlik doğrulama işlemini gerçekleştirmek için kendi özel hizmetinizi kullanmak istiyorsanız Edge Microgateway yapılandırma dosyasındaki authUri değerini hizmetinize işaret edecek şekilde değiştirin. Ayrıntılar için Özel kimlik doğrulama hizmeti kullanma başlıklı makaleyi inceleyin.

Sürüm 2.0.4

Edge Microgateway 2.0.4 sürümü 25 Mayıs 2016'da yayınlandı.

Yeni özellikler ve geliştirmeler v2.0.4

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

Ürünlerde kaynak yolları için destek

Edge Microgateway artık ürünlerde kaynak yollarını destekliyor. Kaynak yolları, erişimi proxy yolu sonekine göre API'lerle kısıtlamanıza olanak tanır. Ürün oluşturma ve kaynak yollarını yapılandırma hakkında ayrıntılı bilgi için API ürünleri oluşturma başlıklı makaleyi inceleyin.

npm global install desteği

Artık Edge Microgateway'i npm -g (global) seçeneğini kullanarak yükleyebilirsiniz. Bu seçenekle ilgili ayrıntılar için npm belgelerine bakın.

Sürüm 2.0.0

Edge Microgateway 2.0.0 sürümü 18 Nisan 2016'da yayınlandı.

Yeni özellikler ve geliştirmeler v.2.0.0

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

Tek işlem sunucusu

Edge Microgateway artık tek bir işlem sunucusudur. Artık bir işlem (önceden "aracı" olarak bilinir) Edge Microgateway'i, ikinci işlem ise Edge Microgateway'i başlatan iki işlemli bir model kullanılmıyor. Yeni mimari, otomasyonu ve kapsayıcılaştırmayı kolaylaştırır.

Ad alanı içeren yapılandırma dosyaları

Yapılandırma dosyaları artık kuruluş ve ortam kullanılarak ad alanına yerleştiriliyor. Böylece birden fazla Microgateway örneği aynı ana makinede çalıştırılabiliyor. Edge Microgateway yapılandırma komutunu çalıştırdıktan sonra yapılandırma dosyalarını ~/.edgemicro dizininde bulabilirsiniz.

Yeni ortam değişkenleri

Artık 4 ortam değişkeni var: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY, EDGEMICRO_SECRET. Bu değişkenleri sisteminizde ayarlarsanız Edge Microgateway'i yapılandırmak ve başlatmak için komut satırı arayüzünü (CLI) kullandığınızda değerlerini belirtmeniz gerekmez.

Önbelleğe alınmış yapılandırma

Edge Microgateway, Apigee Edge'e bağlantı olmadan yeniden başlatılırsa önbelleğe alınmış bir yapılandırma dosyasını kullanır.

Küme modu

Artık Edge Microgateway'i küme modunda başlatma seçenekleri var. Küme modu, çok çekirdekli sistemlerden yararlanmanıza olanak tanır. Mikro ağ geçidi, bu özellik için Node.js küme modülünü kullanır. Ayrıntılar için Node.js belgelerine bakın.

Düzeltilen hatalar v2.0.0

Eklenti etkinlik yaşam döngüsü artık yeni bir geri çağırma içeren kodu içeren eşzamansız kodu düzgün şekilde işliyor.

Sürüm 1.1.2

Edge Microgateway v. 1.1.2, 14 Mart 2016'da yayınlandı.

Yeni özellikler ve geliştirmeler v.1.1.2

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

Performansı İyileştirme

Edge Microgateway artık daha iyi bağlantı havuzu oluşturmak için Node.js HTTP aracısını düzgün şekilde kullanıyor. Bu geliştirme, yüksek yük altında performansı ve genel kararlılığı artırır.

Uzaktan hata ayıklayıcı desteği

Edge Microgateway'i node-inspector gibi bir uzaktan hata ayıklayıcıyla çalışacak şekilde yapılandırabilirsiniz.

Yeni yapılandırma dosyası konumu

Edge Microgateway'i yapılandırdığınızda agent/config/default.yaml dosyası ~./edgemicro/config.yaml konumuna kopyalanır.

Günlük dosyası döndürme

Yeni bir yapılandırma özelliği, Edge Microgateway günlükleri için döndürme aralığı belirtmenize olanak tanır.

Hata düzeltmeleri v1.1.2

1.1.2 sürümünde aşağıdaki hatalar düzeltildi.

Açıklama
Şirket içi Edge ile kullanılan edgemicro-internal proxy için Java çağrısı artık doğru MGMT sunucusunu kullanıyor.
Temsilciden TypeScript bağımlılıklarını kaldırın.
Yalın dağıtım seçeneği kullanılırken CLI hatası düzeltildi.
Sertifika mantığı bağımlılığı referansını düzeltin.