Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info
3.3.x sürümü
Hata düzeltmeleri ve iyileştirmeler v.3.3.x
3.3.5
20 Aralık 2024 Cuma günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.3.5 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 18 sürümünü kullanıyorsanız Edge Microgateway, başlatılırken 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'in daha eski bir sürümünü çalıştırıyorsanız şu hata mesajını görürsünüz: You are using a version of NodeJS that is not supported |
Güvenlik sorunları düzeltildi
- 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
Hata düzeltmeleri ve iyileştirmeler v.3.3.x
3.3.4
18 Eylül 2024'te Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri yayınladık.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.3.4 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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'ın istemci IP adreslerini günlüğe kaydetmemesine neden olan sorun düzeltildi. |
Güvenlik sorunları düzeltildi
- CVE-2021-23337
- CVE-2024-4068
- CVE-2020-28469
- CVE-2020-28503
3.3.3
25 Nisan 2024'te Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.3.3 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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'ten 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ı |
|
Güvenlik sorunları düzeltildi
- 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'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.3.2 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 şunlardır: 16, 18 ve 20. 3.3.2 sürümü itibarıyla Edge Microgateway CLI komutları yalnızca desteklenen sürümlerde çalışır. Desteklenmeyen sürümlerde CLI komutlarının yürütülmesi hatayla sonuçlanır. Ayrıca Apigee'nin desteklediği yazılımlar ve desteklenen sürümler başlıklı makaleyi inceleyin. |
283947053 | Hata |
Edge Microgateway'in, bir uygulamayla ilişkili API ürünleri listesinde ilk API ürününü döndürdüğü sorun düzeltildi. Artık isteğe göre döndürülecek doğru API ürününü 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ü |
Güvenlik sorunları düzeltildi
Yok.
3.3.1
7 Haziran 2022'de Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.3.1 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 16 sürümü artık desteklenmektedir. |
231972608 | Hata |
|
233315475 | Hata |
|
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 Ayrıntılar için Komut satırı referansı başlıklı makaleyi inceleyin. |
218723889 | Doküman Güncellemesi |
Dokümanlar, GitHub'da depolanan desteklenen Edge Microgateway eklentilerinin bağlantısını içerecek şekilde güncellendi. Edge Microgateway ile birlikte sunulan mevcut eklentiler başlıklı makaleyi inceleyin. |
Güvenlik sorunları düzeltildi
Sorun Kimliği | Açıklama |
---|---|
CVE-2021-23413 | Bu durum, 3.7.0'dan önceki jszip paketini etkiler. Dosya adlarının nesne prototipi değerlerine (ör. proto, toString vb.) ayarlandığı yeni bir zip dosyası oluşturmak, değiştirilmiş bir prototip örneğine sahip bir nesnenin döndürülmesine neden olur. |
3.3.0
4 Şubat 2022'de Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.3.0 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 Gateway 3.3.0, npm audit fix komutuyla uyumlu değildir.
Sorunu düzeltmek için 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 |
192534424 | Hata |
Apigee analizlerinde görülen yanıt kodunun Edge Microgateway yanıt koduyla eşleşmemesiyle ilgili sorun düzeltildi. |
198986036 | Geliştirme | Edge Microgateway artık her anket aralığında bir kimlik sağlayıcının (IDP) ortak anahtarını getirir ve ayrıca IDP'nin ortak anahtarı değişirse anahtarı günceller.
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 |
Dokümanlar, TLS/SSL'nin birden fazla hedef için nasıl yapılandırılacağını açıklamak üzere geliştirildi. İstemci SSL/TLS seçeneklerini kullanma başlıklı makaleyi inceleyin. |
171538483 | Hata |
Günlük dosyası adlandırma kuralı düzeltilmek üzere dokümanlar 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 anahtar çifti kullanılarak anahtar iptal edilirken revokekeys komutunun hata döndürdüğü sorun düzeltildi. |
205524197 | Hata | Dokümanlar, günlük kaydı düzeylerinin tam listesini içerecek şekilde güncellendi. edgemicro özellikleri ve Günlük kaydı düzeyini ayarlama başlıklı makaleleri inceleyin. |
3.2.x sürümü
Hata düzeltmeleri ve iyileştirmeler v.3.2.x
3.2.3
17 Eylül 2021'de Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri yayınladık.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.2.3 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 |
|
192799989 | Özellik |
|
148062415 | Hata | Docker kapsayıcı bağlamında Edge Microgateway'in docker stop {containerId} komutuyla düzgün bir şekilde kapanmaması sorunu düzeltildi. İşlem sonlandırıldı ancak .sock ve .pid dosyaları kaldırılmadı. Artık dosyalar kaldırıldı 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 işlemi sırasında bazı isteklerin takılıp kalmasına neden olan sorun düzeltildi. Bu sorun aralıklarla ortaya çıkıyordu ve yüksek trafik durumlarında meydana geliyordu.
Sorun, OAuth eklentisinin tokenCache ve cacheKey özellikleri kullanıldığında görüldü.
|
183910111 | Hata | Sonunda eğik çizgi bulunan 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ır. |
Güvenlik sorunları düzeltildi
Sorun Kimliği | Açıklama |
---|---|
CVE-2020-28503 | 2.0.5'ten önceki paket copy-props, ana işlev aracılığıyla prototip kirliliğine 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'ne (ReDoS) karşı savunmasızdır. ReDoS, en kötü durumda polinom zaman karmaşıklığı gösterir. |
3.2.2
15 Temmuz 2021 Perşembe günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.2.2 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 |
Jeton isteği ve yenileme jetonu isteği API'leri artık
RFC 6749 OAuth 2.0 Yetkilendirme Çerçevesi'ne uymak için |
188492065 | Değiştir |
Node.js 8 desteğinin sonu
3.2.2 sürümü itibarıyla Node.js 8 artık desteklenmeyecek. 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 değil, standart çıkışa göndermeyi seçmenize olanak tanır. Edge Microgateway'i Docker container'ında çalıştırma adımlarını uygularsanız container varsayılan olarak stdout ve hata çıkışını container'da
Günlük bilgilerinin 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ı çalıştırmak için yeni bir |
191352643 | Özellik | Edge Microgateway iç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. |
Güvenlik sorunları düzeltildi
Sorun Kimliği | Açıklama |
---|---|
CVE-2021-28860 | Node.js mixme'de 0.5.1 sürümünden önce saldırganlar, mutate() ve merge() işlevlerini kullanarak "__proto__" aracılığıyla bir nesnenin özelliklerini ekleyebilir veya değiştirebilir. kirlileştirilmiş özellik doğrudan programdaki her nesneye atanır. Bu durum, programın kullanılabilirliğini riske atarak olası bir hizmet reddi (DoS) saldırısına neden olur. |
CVE-2021-30246 | Node.js için 10.1.13'e kadarki jsrsasign paketinde, bazı geçersiz RSA PKCS#1 v1.5 imzaları yanlışlıkla geçerli olarak algılanıyor. NOT: Bilinen bir pratik saldırı yoktur. |
CVE-2021-23358 | 1.13.0-0 ile 1.13.0-2 arasındaki ve 1.3.2 ile 1.12.1 arasındaki underscore paketi, özellikle de bir değişken özelliği temizlenmediği için bağımsız değişken olarak aktarıldığında şablon işlevi aracılığıyla rastgele kod eklemeye karşı savunmasızdır. |
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 başlangıcı, bazı dizelerde katlanarak geri izlemeye neden olabilir. Bu sorun, hizmetin reddedilmesine yol açabilir. Sorun, 3.1.1 sürümünde düzeltilmiştir. |
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'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.2.1 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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şulu artık Not: Bu düzeltme için edgemicro-auth proxy'sini yükseltmeniz gerekir. |
179971737 | Hata |
Hedef 4XX / 5XX durum yanıtlarının edgemicro_* proxy'leri için proxy hatası olarak kaydedilmesine neden olan sorun düzeltildi.
Edge Microgateway işlemleri için Apigee Edge hata kodu analizleri kontrol panelinde yanlış hedef hata sayıları gösteriliyordu. Hedef hatalarının 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ünlerinin listesini ürün durum 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'sinde JWT Değişkenlerini Ayarla politikasına
|
178423436 | Hata |
CLI'de veya ortam değişkenleri aracılığıyla iletilen anahtar ve gizli değerler, işlem gezgini komut satırı bağımsız değişkenlerinde görünür.
Komut satırı bağımsız değişkenlerinden iletilen veya ortam değişkenleri aracılığıyla ayarlanan Edge mikroağ geçidi anahtarının ve gizli değerlerinin, mikroağ geçidi başlatıldıktan sonra düğüm işleyici/alt işlem bağımsız değişkenlerinde gösterildiği bir sorun bildirildi. Ortam değişkeni senaryosu için bu sorunu düzeltmek amacıyla, değerler artık işlem gezgini komut satırı bağımsız değişkenlerinde görünmez. Mikro ağ geçidi başlatılırken anahtar ve gizli değer komut satırına aktarılırsa ayarların, ayarlanmışsa tüm ortam değişkeni değerlerinin yerini alması Bu durumda değerler, işlem gezgini komut satırı bağımsız değişkenlerinde görünmeye devam eder. |
178341593 | Hata |
apikeys eklentisi için bir doküman hatası düzeltildi.
apikeys eklentisinin README dosyasında
|
179366445 | Hata |
Hedeflere gönderilen tüm GET isteklerinde yükün düşürüldüğü bir sorun giderildi.
İstediğiniz davranışı yeni bir yapılandırma parametresi olan Örneğin: edgemicro: enable_GET_req_body: true RFC 7231, bölüm 4.3.1: GET'e göre, GET istek yükü tanımlanmış bir anlam bilgisine sahip olmadığından hedefe gönderilebilir. |
3.2.0
21 Ocak 2021 Perşembe günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.2.0 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 x-api-key başlığını istek nesnesinde client_id içerecek şekilde ayarlamak için extauth eklentisini etkinleştirin. x-api-key , sonraki eklentiler tarafından kullanılabilir.
|
168836123, 172295489, 176462355, 176462872 | Özellik | Node.js 14 desteği eklendi. |
172376835 | Hata | edgemicro-auth proxy'sinde /token uç noktası için doğru zaman birimini kullanın.
Düzeltme, son kullanma süresinin uzunluğunu değil yalnızca zaman birimini değiştirir. Yalnızca erişim jetonu yanıtı yükündeki İstemciler, jetonların süresi dolmadan önce jetonları yenilemek için milisaniye cinsinden İstemciler, jeton yenileme süresini değerlendirmek için her zaman JWT jetonundaki değerleri kullandıysa istemcilerin değişiklik yapması gerekmez. |
173064680 | Hata | Mikro ağ geçidinin, tüm veri parçaları işlenmeden önce hedef isteği sonlandırmasına yol açan sorun düzeltildi.
Bu, yüksek yük boyutu isteklerinde gözlemlenen ve 3.1.7 sürümünde ortaya çıkan aralıklı bir sorundur. |
174640712 | Hata | Eklentileri uygun şekilde veri işleme ekleyin.
Aşağıdaki eklentilere doğru veri işleme eklendi: |
3.1.x sürümü
Hata düzeltmeleri ve iyileştirmeler v.3.1.x
3.1.8
16 Kasım 2020 Pazartesi günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.1.8 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 | Çalışma ortamı değişkeni etiketlerinde sayısal ve mantıksal değerler yanlış ayrıştırıldı.
Ortam değişkeni değiştirme işlemi tüm değerleri dize olarak ayrıştırdı. Bu durum, boole veya sayısal değerler için ayrıştırma hatalarına neden oldu. Örneğin, |
169202749 | Hata | Ortam değişkeni değiştirme işlemi bazı durumlarda çalışmıyordu.
Ortam değişkeni değiştirme işlemi bazı yapılandırma özellikleri için çalışmıyordu. Sınırlılıklar hakkında bilgi edinmek için Yapılandırma özelliklerini ortam değişkeni değerleriyle 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 bir sorun düzeltildi.
edgemicro-auth proxy'sindeki |
170609716 | Hata | edgemicro-auth proxy'sindeki /refresh akışının apiProductList içermeyen bir JWT oluşturmasına yol açan sorun düzeltildi.
|
170708611 | Hata | API ürün kapsamları, özel eklentiler tarafından kullanılamaz.
API ürün kapsamları özel eklentilere sunulmadı veya önbelleğe alma yapılandırma dosyasına yazılmadı. Kapsam ayrıntılarının eklentilere nasıl erişilebilir hale getirildiğini görmek için Eklentinin 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 önbelleğe alma 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ına kaydedilmez. Anahtar ve gizli anahtar daha önce önbellek yapılandırma dosyasına yazılmışsa kaldırılır. |
170708621 | Özellik | Analizler eklentisi devre dışı bırakılamıyor.
Önceki mikro ağ geçidi sürümlerinde analiz eklentisi varsayılan olarak etkinleştiriliyordu ve devre dışı bırakılamıyordu. 3.1.8 sürümünde, analiz eklentisini etkinleştirmek veya devre dışı bırakmak için |
159571119 | Hata | Yanıt/soket zaman aşımı için özel eklentilerde onerror_request kancasında null hatası alınıyor.
|
3.1.7
24 Eylül 2020 Perşembe günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.1.7 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 null yanıtı yanlış işledi ve çalışanların çıkış yapmasına neden oldu.
|
133162200 | Hata | Geliştirici uygulama bilgileri, yetkisiz ürün kaynak yollarından kaynaklanan 403 durum yanıtları veya süresi dolmuş ya da geçersiz bir jetondan kaynaklanan 401 yanıtlarıyla Analytics'te doldurulmadı.
|
132194290 | Hata | Apigee Edge bazı Analytics kayıtlarını reddettiğinde Analytics kayıtları atılır.
|
158618994 | Hata | Aşırı sayıda Redis istemci bağlantısı.
|
161404373 | Hata | 404 durum yanıtı durumunda, proxy URI'sinin tamamı yanıt mesajına dahil edildi. |
166356972 | Hata | Edge Microgateway'i Node.js 12.13.x veya sonraki bir sürümle çalıştırmak, istek yükünü dönüştüren eklentileri çalıştırırken aşağıdaki hataya neden oldu: {"message":"write after end","code":"ERR_STREAM_WRITE_AFTER_END"}
|
168681746 | Hata | redisBasedConfigCache:true ile Edge Microgateway manuel olarak yeniden yükleme işlemi çalışmıyordu.
|
149256174 | Hata | Ağ hataları için OAuth eklentisi hataları günlüğe kaydedilmedi.
|
166517190 | Hata | jwk_public_keys verileri Senkronizasyon Aracı tarafından depolanmadı, getirilmedi ve Redis'de saklanmadı.
|
141659881 | Hata | Geçersiz hedef sertifikanın hata işleme işlemi, yanıltıcı hata yanıtları gösterdi.
|
142808699 | Hata | accesscontrol eklentisi, "izin ver" ve "reddet" bölümlerini doğru şekilde işlemiyordu.
Mikro geçit 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ıyla eşleşme sağlamak için mikro ağ geçidi yapılandırma dosyasına yeni bir |
3.1.6
20 Ağustos 2020 Perşembe günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.1.6 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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çenekleri hakkında ayrıntılı bilgi için Anahtarları döndürme bölümüne bakın. |
||||||||||||
154838259 | Hata | Birden fazla veri merkezindeki birden fazla örnek için anahtar rotasyonunu düzeltme
Bu yeni komut seçenekleri hakkında ayrıntılı bilgi için Anahtarları döndürme bölümüne bakın. |
||||||||||||
145525133 | Alfa özelliği | Yeni eklenti metrikleri
Ayrıntılar için GitHub'daki Yeni eklenti metrikleri README dosyasını inceleyin. |
||||||||||||
159396879 | Hata | Kullanılmayan paket yardımcısını kaldırma | ||||||||||||
161092943 | Hata | Temel yol doğrulaması yanlıştı
3.1.6 sürümünden önce, temel yol Aşağıda, önceki davranış (3.1.6'da düzeltilmiştir) daha ayrıntılı şekilde açıklanmaktadır:
Bir proxy'nin
|
||||||||||||
160431789 | Hata | Özel Eklentiler - init işlevine 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 hale getirilir. config bölümüne bakın. |
||||||||||||
162758808 | Hata | Redis yedek deposu için yeni kota yapılandırması
Kotalar için bir Redis yedek deposu belirtmek üzere aşağıdaki yapılandırmayı kullanabilirsiniz. Ayrıntılar için Kota için Redis yedek depolama alanı kullanma başlıklı makaleyi inceleyin. |
3.1.5
26 Haziran 2020 Cuma günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.1.5 ile ilişkili tek tek bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 atlamak amacıyla 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 eklentisi ile ilgili sorunlar düzeltildi
Eklentinin yinelenen Content-Type başlıkları oluşturması ve bazı durumlarda başlıkların hedefe beklendiği gibi gönderilmemesi sorunlarını düzelttik. |
156560067, 159688634 | Özellik | Yapılandırmada ortam değişkeni değerlerini kullanma Yapılandırıcı dosyada etiketleri kullanarak ortam değişkenlerini belirtmenize olanak tanıyan bir özellik eklendi. Belirtilen ortam değişkeni etiketleri, gerçek ortam değişkeni değerleriyle değiştirilir. Değişiklikler yalnızca bellekte depolanır, orijinal yapılandırma veya önbelleğe alma dosyalarında depolanmaz. Ayrıntılar için Yapılandırma özelliklerini ortam değişkeni değerleriyle ayarlama başlıklı makaleyi inceleyin. |
155077210 | Hata | Günlük biçimlendirme sorunu düzeltildi.
Hedef ana makinenin günlüklerde ek iki nokta işareti eklenmiş şekilde görünmesi sorunu düzeltildi. |
153673257 | Hata | (Yalnızca Private Cloud için Edge) Microgateway'ten haberdar olmayan ürünler çekilmiyor Mikro ağ geçidi bilinçli ürünlerin çekilmemesiyle ilgili sorun düzeltildi. Bu sorun yalnızca Edge for Private Cloud kurulumlarında mevcuttu. |
154956890, 155008028, 155829434 | Özellik | İndirilen ürünleri özel özelliklere göre filtreleme 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 sürecinin kilitlenmesine neden olan sorun düzeltildi
Hata işleme, hatayı yakalayıp konsola mesaj yazdırmak için iyileştirildi. |
155499600 | Hata | Anahtar rotasyonu ve KVM yükseltmeyle ilgili sorunlar düzeltildi
Ayrıca JWT anahtarlarını döndürme başlıklı makaleyi de inceleyin. |
3.1.4
23 Nisan 2020 Cuma günü, Edge Microgateway'te aşağıdaki düzeltmeyi kullanıma sunduk.
Hata düzeltmesi:
3.1.3 sürümündeki bir 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çerlidir.
3.1.3
15 Nisan 2020 Çarşamba günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.1.3 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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ısına neden olduğu sorun düzeltildi. Sorun 3.1.0, 3.1.1 ve 3.1.2 sürümlerinde mevcuttur.
- 153509313: Günlük kaydında iki farklı işlem için aynı ileti kimliğinin yazdırıldığı sorun düzeltildi.
- 151673570 - Edge Microgateway'in yeni Apigee KVM API'lerini kullanacak şekilde güncellenmemesi sorunu 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, kaynak yolu eşlemesinin işlenmesinin Apigee Edge ile eşleşecek şekilde güncellendi. Bu sürümde,
/literal_string/*
kalıbının doğru şekilde işlenmediği bir sorun düzeltildi. Örneğin,/*/2/*
. Ayrıca "/", "/*" ve "/**" içeren bir 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ı etkinleştirmek amacıyla değişiklikler yapıldı.
- 152005003: Kotalar için kuruluş ve ortam kapsamlı tanımlayıcıları etkinleştirmek amacıyla değişiklikler yapıldı. "org + env + appName + productName" kombinasyonu, kota tanımlayıcısı olarak kullanılır.
3.1.2
16 Mart 2020 Pazartesi günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.1.3 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 mikro ağ geçidi ile arka uç hedefleri arasındaki trafik için HTTP proxy desteği eklemek amacıyla bir özellik geliştirmesi yapıldı. Ayrıca, Edge Microgateway ile Apigee Edge arasındaki mevcut HTTP proxy desteğiyle ilgili sorunlar düzeltildi. Ayrıntılı bilgi için:
- 149101890 - Hedef sunucunun veya yük dengeleyicinin bağlantısını kapattığı durumlardaki günlük bildirim kodu ERROR yerine INFO olarak değiştirildi.
- 150746985 - Yapılandırma dosyasında
redisBasedConfigCache: true
veyaquotaUri: https://%s-%s.apigee.net/edgemicro-auth
varsaedgemicro verify
komutunun düzgün çalışmamasına neden olan sorun düzeltildi. - 151284716 - Yeniden yükleme sırasında işçiler yeniden başlatıldığında sunucu bağlantılarının daha hızlı kapatılması için bir iyileştirme yapıldı.
- 151588764 - Edge Microgateway'i Docker container'da çalıştırmak için kullanılan Docker görüntüsünde Node.js sürümünü 12'ye güncelleyin. Node.js 8'in desteği sonlandırılmıştır.
- 151306049 - Edge Microgateway CLI komutları tarafından kullanılan Apigee Edge yönetim API'lerini listelemek için dokümanlar 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'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.1.1 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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ünHTTP_PROXY
veHTTPS_PROXY
ortam değişkenlerine uymamasına neden olan sorun düzeltildi. Bu değişiklikle birlikte, YAML yapılandırma dosyasında belirtilen proxy ayarları yoksayılır. Proxy belirtmek için yalnızca ortam değişkenleri kullanılır.Yapılandırma dosyasında proxy yapılandırmasını belirtmek istiyorsanız yapılandırma dosyasında belirtilenle aynı proxy URL'sinden bahseden 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
Aşağıdaki ortam değişkenini de belirtmeniz gerekir:
HTTP_PROXY=http://10.128.0.20:3128
- 146320620 - Yeni bir yapılandırma parametresi (
edgemicro.headers_timeout
) eklendi. Bu özellik, HTTP ayrıştırıcının tüm HTTP üst bilgilerini almak için bekleyeceği süreyi (milisaniye cinsinden) sınırlar. Örneğin:edgemicro: keep_alive_timeout: 6000 headers_timeout: 12000
Parametre, dahili olarak isteklerde Node.js
Server.headersTimeout
özelliğini ayarlar. (Varsayılan:edgemicro.keep_alive_timeout
ile ayarlanan zamandan 5 saniye daha uzun. Bu varsayılan ayar, yük dengeleyicilerin veya proxy'lerin bağlantıyı yanlışlıkla düşürmesini engeller.) 149278885 - Tek bir genel zaman aşımı ayarı kullanmak yerine hedef API zaman aşımını API proxy düzeyinde ayarlamanıza olanak tanıyan yeni bir özellik eklendi.
API proxy'sinde TargetEndpoint mülkünü
io.timeout.millis
ayarlarsanız Edge Microgateway bu mülkü alabilir ve hedef uç noktasına özgü zaman aşımlarını 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'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.1.0 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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üzeyinde etkinlik kaydedilir. Bu işaret, kota işleme hatası meydana gelirse veya Edge'e gönderilen "kota uygulama" isteği uzak kota sayaçları güncelleyemezse tetiklenir. Bu durumda, kota yalnızca bir sonraki başarılı uzak kota senkronizasyonuna kadar yerel sayılara 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 tespit ettiğinde devam eden veya yeni işlemlerin etkilendiği bir 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ır. Bu değişiklik, devam eden işlemler ve mikro geçiş noktasına gönderilen yeni API çağrılarını etkilemez.
- 146378327 -
sourceRequest
,targetRequest
vetargetResponse
için günlük seviyesi INFO olarak değiştirildi. - 146019878 - Edge Analytics'te "API Proxy Performansı" için hesaplanan gecikme ile Edge Microgateway sourceResponse/targetResponse günlük etkinlikleri arasında bir tutarsızlık düzeltildi. Artık Edge analizlerindeki ve Microgateway günlük etkinliklerindeki gecikme uyumlu hale getirildi.
- Desen eşleştirme mantığıyla ilgili değişiklikler:
- 147027862 - OAuth eklentisi, API Ürünleri'nde 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 "/**" şeklindeki bir kaynak yolunun davranışını yapılandırma bölümünde açıklandığı gibi Apigee Edge ile aynı kalıp eşleştirmeyi kullanıyor.
- 145644205 - Update pattern matching logic of apiKeys plugin to match oauth plugin.
- 147027862 - OAuth eklentisi, API Ürünleri'nde belirtildiği gibi aşağıdaki kaynak yolu eşleştirme kalıplarını destekleyecek şekilde güncellendi:
- 143488312 - İstemci kimliği parametresindeki baştaki veya sondaki boşlukların, OAuth jetonu ve API anahtarı isteklerinde JWT ürün listesinin boş oluşturulmasına neden olduğu bir sorun düzeltildi.
- 145640807 ve 147579179: "Senkronizasyon aracısı" adlı özel bir Edge Microgateway örneğinin Apigee Edge'den yapılandırma verilerini almasına ve yerel bir Redis veritabanına yazmasına olanak tanıyan yeni bir özellik eklendi. Diğer mikro geçit örnekleri, yapılandırma verilerini veritabanından okuyacak şekilde yapılandırılabilir. Bu özellik, Edge mikro ağ geçidi için bir düzeyde esneklik sağlar.
Bu sayede mikro ağ geçidi örnekleri, Apigee Edge ile iletişim kurmaya gerek kalmadan başlatılabilir ve çalışabilir. 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ışmak üzere desteklenmektedir.
3.0.x sürümü
Hata düzeltmeleri ve iyileştirmeler v.3.0.x
3.0.10
8 Kasım Cuma günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.0.10 ile ilişkili bileşen projelerinin sürüm numaraları listelenmiştir. Her bileşen ayrı bir proje olduğundan sürüm 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 API ürünlerinde kullanılan kaynak yollarının kalıp eşleştirmesi, artık '/', '/*' ve '/**' şeklindeki bir 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ştirmesiyle uyumlu olacak şekilde bir özellik güncellemesi yapıldı.
Not:
/*/2/**
gibi birleşik bir kaynak kalıbı kullanıyorsanızedgemicro_auth
proxy'sinin bağımsız bir API ürününe eklendiğinden emin olmanız gerekir. Ardından, bu ürünü aşağıdaki ekran görüntüsünde gösterildiği gibi proxy'nin Geliştirici Uygulamasına eklemeniz gerekir:Not: "/", "/*" ve "/**" şeklindeki bir kaynak yolunun davranışını yapılandırma bölümünde açıklanan
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 daha net anlaşılması 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ğininquotas
olarak adlandırıldığını unutmayın. Ayrıquotas
yapılandırma özellikleri hakkında ayrıntılı bilgi için kota için 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 yedek deposu 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ırlandırılır. Yanlış ise destekleyici depolama alanı olarak volos-quota-apigee modülü kullanılır ve kota sayacı geneldir. Ayrıntılar için Kota için 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 bitiş süresi 108.000 milisaniyeden (1,8 dakika) 1.800 saniyeye (30 dakika) değiştirildi. - 143551282 - SAML özellikli kuruluşları desteklemek için
edgemicro genkeys
komutu,‑‑token
parametresi içerecek şekilde güncellendi. Bu parametre, kimlik doğrulaması 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'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.0.9 ile ilişkili bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm 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 "açık hatayla sonlandır" özelliği eklendi.
Bu özellik etkinleştirildiğinde, kota işleme hatası meydana gelirse veya Edge'e gönderilen "kota uygulama" isteği uzak kota sayaçları güncelleyemezse kota, yalnızca bir sonraki başarılı uzak kota senkronizasyonuna kadar yerel sayılara göre işlenir. Bu iki durumda da istek nesnesinde bir
quota-failed-open
işareti ayarlanır."Açık durumda hata" kota ö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şımlarını önlemek için
edgemicro-auth
proxy'sinde yapılandırma değişikliği yapıldı. Değişiklik, kota türünü takvim olarak ayarlamaktır. Bu iyileştirmeyi kullanmak içinedgemicro-auth
'ünüzü 3.0.7 veya sonraki bir sürüme güncellemeniz gerekir. - 142520568: Kota yanıtlarında MP (mesaj işleyici) 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'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.0.8 ile ilişkili tek tek bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm 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 "açık hata" ö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 yenilenemiyorsa 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, Edge Microgateway'in geçici bir bağlantı hatası durumunda 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 getirilir ve önbellekte eski JWT'nin yerini alır.
Yeni "açık hatayla devam et" özelliğini yapılandırmak için aşağıdakileri yapın:
- Edge Microgateway yapılandırma dosyasında
oauth
dizesinde 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 yenilenemeyen eski jeton 5 saniye boyunca kullanılır. 5 saniye sonra kimlik doğrulama hatası döndürülür.
- Edge Microgateway yapılandırma dosyasında
- 141168968 - Tüm eklenti günlük çıkışlarına
correlation_id
dahil edecek şekilde bir güncelleme yapıldı. Ayrıca, bazı günlüklerin günlük düzeyleri gerektiği gibierror
olarak değiştirildi. - 140193349 -
edgemicro-auth
proxy'sinde, API anahtarını doğrulama isteğinde her seferinde Edge Microgateway anahtarının ve gizli anahtarının doğrulanmasını zorunlu kılacak bir güncelleme yapıldı. Edge Microgateway, her API Anahtarı 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. - 140090250 - Kota işleme için teşhis günlük kaydı eklemek üzere bir güncelleme yapıldı. Bu değişiklikle birlikte, artık quoteo günlük çıkışını Edge Microgateway günlüklerinin geri kalanıyla ilişkilendirmek mümkün.
3.0.7
12 Eylül Perşembe günü Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Bileşen sürümleri:
Aşağıdaki tabloda, Edge Microgateway 3.0.7 ile ilişkili tek tek bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm 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ürülmesi için bir güncelleme yapıldı. Daha önce, eklenti 200 olmayan tüm durumlarda yalnızca 4xx durum kodları döndürüyordu. Artık 200 durumu olmayan tüm mesaj yanıtları için hataya bağlı olarak tam 4xx veya 5xx kodu döndürülecek.
Bu özellik varsayılan olarak devre dışıdır. Bu özelliği etkinleştirmek için
oauth.useUpstreamResponse: true
özelliğini Edge Microgateway yapılandırmanıza 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ılanedgemicro-auth
proxy ü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
mülkünü kullanmak için en sonedgemicro-auth
proxy'sine geçmeniz gerekir. Ayrıntılar için edgemicro-auth proxy'yi yükseltme başlıklı makaleyi inceleyin. - 140470888 - Kimlik doğrulama sağlamak için kota aramalarına bir Authorization üstbilgisi eklendi.
Ayrıca,
edgemicro-auth
proxy'si, kota tanımlayıcısı Kota uç noktası müşterinin kuruluşunda bulunduğundan artık kota tanımlayıcısı gerekmez. - 140823165 - Aşağıdaki mülk adı:
edgemicro: keepAliveTimeout
3.0.6 sürümünde yanlış şekilde belgelenmiştir. Doğru tesis adı:
edgemicro: keep_alive_timeout
- 139526406 - Developer uygulaması birden fazla ürüne sahipse yanlış kota sayısının Kota, artık birden fazla ürünü olan bir uygulamadaki her ürün için doğru şekilde uygulanıyor. Kota tanımlayıcısı olarak "uygulamaAdı + ürünAdı" kombinasyonu kullanılır.
3.0.6
29 Ağustos Perşembe günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
- 138633700 -
keepAliveTimeout
adlı yeni bir yapılandırma özelliği eklendi. Bu özellik, Edge mikro ağ geçidi zaman aşım süresini (milisaniye cinsinden) belirlemenizi sağlar. (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ılanedgemicro-auth
proxy'si üzerinden yönetmek istiyorsanız bu yapılandırma özelliğini ayarlayın. Bu mülk 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 son sürümünü kuruluşunuza dağıtmanız gerekir. Ayrıntılar için edgemicro-auth proxy'yi yükseltme başlıklı makaleyi inceleyin. - 138722809 -
stack_trace
adlı yeni bir yapılandırma özelliği eklendi. Bu özellik, yığın izlemelerinin günlük dosyalarında görünüp görünmeyeceğini kontrol etmenizi sağlar. Örneğin:stack_trace: false
stack_trace
true
olarak ayarlanırsa yığın izleme, günlüklere yazdırılır. Bu değerfalse
olarak ayarlanırsa yığın izleme günlüklere yazdırılmaz.
3.0.5
15 Ağustos Perşembe günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Düzeltilen hatalar- 139005279:
edgemicro status
komutunun doğru sayıda işleyici işlemi döndürmemesi sorunu düzeltildi. - 138437710: ExitCounter sınıfında, doğru günlük kaydının yazılmasını engelleyen bir sorun düzeltildi.
- 139064652: Etkinlik ve sistem günlükleri için
trace
vedebug
günlük kaydı düzeyleri ekleme özelliği eklendi. Şu anda yalnızca bu günlük düzeylerini ekleme özelliği eklendi. Şu anda kullanılabilen günlük düzeyleriinfo
,warn
veerror
'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çerir:
- Zaman damgası
- Bileşen adı
- İşlem Kimliği
- Konsol günlük mesajı
- 138413755 - cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey ve configure CLI komutları için JWT anahtarı ve gizlilikle ilgili günlük mesajlarını iyileştirin.
- 138413577 - Arka uç hizmet zaman aşımları için hata işleme ekleme ve iyileştirme.
- 138413303 - Yanıt ve soket zaman aşımlarıyla ilgili hata işleme ekleyin ve iyileştirin.
- 138414116 - "Bağlantı reddedildi" hataları için hata işleme ekleme ve iyileştirme.
3.0.4
1 Ağustos Perşembe günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
- 134445926 - Dahili Edge Microgateway kimlik doğrulamasında iyileştirmeler.
- 137582169: İstenmeyen işlemlerin başlatılmasına neden olan bir sorun giderildi. Ek işlemler, eklentilerin yeniden yüklenmesine neden oluyor ve aşırı bellek kullanıyordu. Edge Microgateway artık işlem sayısını beklenen sınırda 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ı.
- Konsolu günlükleri, merkezi bir günlük kaydı işlevi kullanacak şekilde güncellendi.
- 138321133, 138320563 - Gelecekteki kota geliştirmelerini etkinleştirmek için kota arabelleğinde temel dahili değişiklik
3.0.3
23 Temmuz Salı günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
- Günlüğe kaydetme iyileştirmeleri: Mevcut çalışma zamanındaki günlükler, çalışma zamanındaki verileri tutarlı bir biçimde yakalayıp kaydeden yeni bir
eventLog()
işlevi 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 üstbilgisinde yer alan istek ana makine adı.
- İşlem kimliği: Node.js işlemleri kümesi çalıştırıyorsanız bu, günlüğe kaydetme işleminin gerçekleştiği işlemin kimliğidir.
- Apigee kuruluş adı.
- Kuruluştaki ortam adı.
- API proxy adı.
- İstemci IP adresi.
- ClientId.
- Bağıntı kimliği (şu anda ayarlanmamıştır).
- Edge Microgateway bileşeninin adı.
- Özel mesaj: Bazı nesneler bu hata mülküne iletilen ek bilgileri yazdırabilir.
- İstek yöntemi (HTTP isteği varsa).
- Yanıt durum kodu (HTTP isteği varsa).
- Hata mesajı.
- Hata kodu: Bir nesnede hata kodu varsa bu özellikte yazdırılır.
- Geçen süre.
- İşletim sistemi satır sonu işaretçisi.
Boş özellik değerleri boş parantez (
[]
) ile gösterilir.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 kalitesi iyileştirmeleri.
3.0.2
3 Temmuz 2019 Çarşamba günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
Kod kalitesi: Kod, kalite açısından incelendi ve kullanıcıların istediği kalite standartlarını karşılamak için kod değişiklikleri yapıldı. JSHint'ten kaynaklanan kod kalitesi hatalarını ve uyarılarını giderdik.
Sonuç olarak, bazı gerçek kod hataları tespit edildi ve düzeltildi. Tüm Apigee Edge Microgateway modülleri bu sürece tabi tutuldu. microgateway-config
,
microgateway-core
,
microgateway-plugins
ve
microgateway
için 28 Haziran ve 2 Temmuz tarihli taahhütleri inceleyin.
Kod kalitesinde değişiklik yapılan tüm modüller, müşteri kullanım alanları için Edge Microgateway'in yürütülmesini doğrulayan dahili araçlarla test edilmiştir.
3.0.1
21 Haziran 2019 Cuma günü, Edge Microgateway'te aşağıdaki düzeltmeleri ve iyileştirmeleri kullanıma sunduk.
- 134834551 - Edge Microgateway için desteklenen Node.js sürümlerini değiştirin
(Desteklenen Node.js 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 Products uç noktası, filtre kalıbı yanlışsa 5XX döndürüyor
- 135113408 - Workers should restart if they terminate unexpectedly
- 134945852 - tokenCacheSize, oauth eklentisinde kullanılmaz
- 134947757 - set cacheTTL in oauth plug-in
- 135445171 - gracePeriod calculation in OAuth is not correct
- Edge Microgateway kurulumuyla birlikte sağlanan hafızalı modülü kullanın
- 135367906 - Güvenlik denetimi
2.5.x sürümü
2.5.x sürümü için yeni özellikler ve geliştirmeler
(2.5.38 sürümünde 07.06.2019 tarihinde düzeltildi)
Hatalı biçimlendirilmiş JWT'ler, jeton önbelleği kullanıldığında işçilerin 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'te hata ayıklama desteği eklendi.
mgdebug
işaretini edgemicroctl
ile 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
İstemci/gizli anahtarı Base64 Kodlanmış Temel Yetkilendirme başlığı olarak ve grant_type parametresini form parametresi olarak iletmenize olanak tanıyan yeni bir edgemicro-auth/token API eklendi. Taşıyıcı jetonlarını doğrudan 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'in, Private Cloud için Edge'de OAuth2 erişim jetonu kullanacak şekilde yapılandırılmasının düzgün çalışmamasına (jetona uyulmaması) neden olan sorun düzeltildi.
Docker: Kendinden imzalı sertifika kullanımı desteği
(2.5.29'da eklendi) Node.js tarafından varsayılan olarak güvenilmeyen bir sertifika yetkilisi (CA) kullanıyorsanız Edge Microgateway ile bir Docker kapsayıcı çalıştırırken 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'da 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 desteklemektedir.
Aşağıdaki örneklerde, bu TLS yapılandırmalarının nasıl ayarlanacağı ayrıntılı olarak açıklanmıştır:
Bu örneklerde, Edge Microgateway yapılandırma dosyasında referans verilen sertifikaları yüklemek için kapsayıcı bağlama noktası /opt/apigee/.edgemicro
'nin nasıl kullanılacağını göreceksiniz.
Docker: İstek proxy'si desteği
(2.5.27'de eklendi) Edge Microgateway'i bir Docker kapsayıcısında çalıştırırsanız mikroağ geçidi 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ı 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ırsanız artık eklentileri dağıtmak için iki seçeneğiniz var. Docker bağlama noktası kullanma seçeneği yenidir. Diğer seçenek daha önce de mevcuttu ve temelde değişmedi ancak Dockerfile güncellendi. Ayrıntılar için aşağıdaki bağlantılara göz atın:
- A seçeneği: Eklenti dizinini bir birime bağlama (Yeni)
- B seçeneği: Eklentileri kapsayıcıya yerleştirme (Güncellendi)
KVM yükseltme komutu için yeni OAuth jetonu desteği
(2.5.27'de 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 ayırabilirsiniz. Daha fazla bilgi için Yolları analizlerden hariç tutma başlıklı makaleyi inceleyin.
Yerel proxy'yi yapılandırma
(2.5.25'te eklendi) Yerel bir proxy kullandığınızda Apigee Edge'de mikro ağ geçidi bilinçli 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) Edge Microgateway yapılandırmasının anahtarını ve gizli kimlik bilgilerini iptal eden yeni bir CLI komutu eklendi.
edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]
Docker desteği
(2.5.19'da eklendi) Artık en son 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üne bir yan araç ağ geçidi olarak dağıtabilirsiniz. Şu makaleye bakın: Edge Microgateway'i Kubernetes ile entegre etmeye genel bakış.
TCP nodelay seçeneği için destek
(2.5.16'da eklendi) Edge Micro yapılandırmasına nodelay
adlı yeni bir yapılandırma ayarı eklendi.
Varsayılan olarak TCP bağlantıları, verileri göndermeden önce arabelleğe almak için 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ına da bakın.
nodelay
seçeneğ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
Forever 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 ya da durdurmanıza olanak tanır. Ayrıca Forever izleme başlıklı makaleyi inceleyin.
Parametre | Açıklama |
---|---|
-f, --file | forever.json dosyasının konumunu belirtir. |
-a, --action | start veya stop . Varsayılan değer başlangıçtır. |
Örnekler:
Sonsuza kadar özelliğini 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 mikro ağ geçidinde OAuth güvenliği için kullanılan JWT jetonlarını oluşturmak amacıyla kullanılan ortak/özel anahtar çiftlerini döndürmenize olanak tanıyan yeni bir özellik eklendi. JWT anahtarlarını döndürme başlıklı makaleyi inceleyin.
İndirilen API proxy'lerini filtreleme
Edge Microgateway, varsayılan olarak Edge kuruluşunuzdaki "edgemicro_" ad ön ekiyle 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'si olmayan ürünleri belirtme
Apigee Edge'de API proxy'si 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 tüm proxy'lerle çalışmasına olanak tanır. Edge Microgateway, 2.5.4 sürümü itibarıyla bu ürün yapılandırmasını destekler.
Sonsuz 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 yapılandırmalarını tek bir yerden 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.
Sonsuz KSA seçeneği için destek
(2.5.8 sürümünde eklendi) forever.json
dosyasının konumunu belirtmek için edgemicro forever [package.json]
komutunu kullanın. 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 edgemicro reload
komutuyla --configUrl
veya -u
seçeneğini kullanabilirsiniz.
JWT zaman uyuşmazlıkları için ek süre
(2.5.7'de eklendi) OAuth yapılandırmasında gracePeriod özelliği, sistem saatiniz ile JWT yetkilendirme jetonunda belirtilen "En erken" (nbf) veya "Verilme zamanı" (iat) arasında küçük tutarsızlıklardan kaynaklanan hataları önlemeye yardımcı olur. Bu tür tutarsızlıklara izin vermek için bu özelliği saniye sayısına ayarlayın. OAuth özelliklerine bakın.
(2.5.7'de eklendi) OAuth yapılandırmasında gracePeriod özelliği, sistem saatiniz ile JWT yetkilendirme jetonunda belirtilen "En erken" (nbf) veya "Verilme zamanı" (iat) arasında küçük tutarsızlıklardan kaynaklanan hataları önlemeye yardımcı olur. Bu tür tutarsızlıklara izin vermek için bu özelliği saniye sayısına ayarlayın. OAuth özelliklerine bakın.
2.5.x sürümünde düzeltilen hatalar
- (Sorunu #236) Önbelleği temizlemeyle ilgili yazım hatası düzeltildi.
- (Sorunun numarası: 234) Edge Microgateway 2.5.35 için yeniden yükleme kilitleniyor.
- (Sorunun numarası: 135) -v seçeneği kullanılırken geçersiz sanal ana makine referansı "secure" hatası. Bu düzeltme, sanal ana makinelerin "-v" işaretinde belirtilenle tam olarak eşleştiğinden emin olmak için dağıtımdan önce edgemicro-auth proxy'sini değiştirir. Ayrıca, sanal ana makine için dilediğiniz sayıda ve dilediğiniz adı belirtebilirsiniz (artık varsayılan ve güvenli ile sınırlı değildir).
- (Sorunun numarası: 141) edgemicro reload komutu, yapılandırma dosyası seçeneği -c'yi desteklemez. Bu sorun düzeltildi.
- (Sorunun numarası: 142) Edge Microgateway, yükleme sırasında desteği sonlandırılan kriptodan şikayet ediyor. Bu sorun düzeltildi.
- (Issue #145) Quota not working with Edge Microgateway. 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'ta hem API proxy'leri hem de Kaynak URI'si ile doğrulandı. Bu sorun düzeltildi.
- (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 değerini düzeltin.
- (Sorunun numarası: 157) Aşağıdaki hata mesajına neden olan sorun düzeltildi:
ReferenceError: deployProxyWithPassword
tanımlanmadı. - (Issue #169) Update Node.js dependencies (npm audit)
edgemicro-auth
proxy'si artık Edge JWT politikalarını kullanıyor. Proxy artık JWT desteği sağlamak için Node.js'e bağlı değildir.
2.4.x sürümü
2.4.x sürümü için yeni özellikler ve geliştirmeler
1. edgemicro-auth proxy için özel bir takma ad ayarlama (PR 116)
edgemicro-auth proxy'sinin varsayılan taban yolunu değiştirebilirsiniz. Varsayılan temel yol /edgemicro-auth'tur. 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)
edgemicro_* proxy'sinin 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. /**/ değerinin desteklenmediğini unutmayın.
Önemli: Apigee, temel yolun ilk öğesi olarak "*" joker karakterinin kullanılmasını DESTEKLEMEZ. Örneğin, şu URL desteklenmez: /*/arama.3. Private Cloud yapılandırması için KSA'ya özel yapılandırma yolu eklendi (PR 99)
Varsayılan olarak mikro geçit 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 kurulumları için özel yapılandırma dizininin tanınmaması sorunu düzeltildi.
Örnek:
edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config
4. *_PROXY değişkenlerine uyma (PR 61)
Edge Microgateway bir güvenlik duvarının arkasında yüklüyse ve herkese açık bulutta Apigee Edge ile iletişim kuramıyorsa iki seçenekten yararlanabilirsiniz:
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ünellemek için HTTP CONNECT yöntemini kullanır. (Proxy'yi yapılandırmayla ilgili ortam değişkenleri TLS etkinse de aynı durum geçerlidir).
2. Seçenek:
İkinci seçenek, bir proxy belirtmek ve mikro ağ geçidi yapılandırma dosyasında proxy_tunnel parametresini false 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 Edge Microgateway proxy'lerini hangi ana makinelerin işlememesi gerektiğini kontrol etmek için aşağıdaki değişkenleri ayarlayabilirsiniz: HTTP_PROXY, HTTPS_PROXY ve NO_PROXY. NO_PROXY ayarını, Edge Microgateway'in proxy'si olmaması gereken alan adlarının virgülle ayrılmış bir listesi olarak 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:
https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables
5. Hedef istekler için özel bir zaman aşımı ayarlama (PR 57)
Bu yapılandırmayla hedef istekler için özel bir zaman aşımı ayarlayabilirsiniz:
edgemicro: request_timeout: 10
Zaman aşımı saniye cinsinden ayarlanır. Zaman aşımı oluşursa Edge Microgateway 504 durum koduyla yanıt verir.
6. Hedef yanıttaki özel HTTP durum mesajlarına uyma (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 değerini ayarlayabilir
Varsa X-Forwarded-For üstbilgisi, Edge Analytics'te raporlanan client_ip değişkenini ayarlar. Bu özellik, Edge Microgateway'e istek gönderen istemcinin IP adresini öğrenmenizi sağlar.
8. OAuth eklentisi değişiklikleri
OAuth eklentisi, API anahtarı doğrulamasını ve OAuth erişim jetonu doğrulamasını destekler. Bu değişiklikten önce, bu iki güvenlik biçimi de eklentiye kabul ediliyordu. Bu değişiklikle, geriye dönük uyumluluğu korurken bu güvenlik modellerinden yalnızca birine izin verebilirsiniz.
OAuth eklentileri iki yeni işaret ekler:
-
allowOAuthOnly: true olarak ayarlanırsa her API'de, Taşıyıcı Erişim Jetonu içeren bir Yetkilendirme başlığı bulunmalıdır.
-
allowAPIKeyOnly: true olarak ayarlanırsa her API'de API anahtarı içeren bir x-api-key başlığı (veya özel bir konum) bulunmalıdır.
Bu işaretleri Edge mikro geçidi yapılandırma dosyasında aşağıdaki gibi 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. Bir eklentide varsayılan hedef URL'yi yeniden yazma (PR 74)
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 için false olarak ayarlayın. req.targetSecure parametresini 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ğrulaması 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>
2.4.3 sürümünde düzeltilen hatalar
- edgemicro-auth proxy'nin düzgün şekilde çalıştırılması için ücretli bir kuruluşun gerekli olduğu sorun düzeltildi. Artık Edge Microgateway'i deneme kuruluşlarıyla da kullanabilirsiniz. (PR 5)
- Akışta verilerin işlenmesi tamamlanmamış olmasına rağmen son işleyicilerin yine de çalıştırılması sorunu düzeltildi. Bu durum, kısmi bir yanıtın gönderilmesine neden oldu. (PR 71)
- Private Cloud kurulumları için özel yapılandırma dizininin tanınmaması sorunu düzeltildi. (PR 110)
- İstemci ile Edge Microgateway arasındaki iki yönlü SSL ile ilgili bir sorun düzeltildi. (PR 70)
- API anahtarı doğrulamasının düzgün çalışması için proxy taban yolunda sonuna eğik çizgi eklenmesinin gerektiği sorun düzeltildi. Artık ana yolun sonuna eğik çizgi eklemeniz gerekmez. (PR 48)
Sürüm 2.3.5
2.3.5 sürümündeki yeni özellikler ve iyileştirmeler
Proxy filtreleme
Bir Edge Microgateway örneğinin hangi mikrogeçiş farkında proxy'leri işleyeceğini filtreleyebilirsiniz.
Edge Microgateway başladığında, ilişkili olduğu kuruluştaki tüm mikro geçit uyumlu 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 edgemicro_proxy-1
, edgemicro_proxy-2
ve edgemicro_proxy-3
ile sınırlandırır:
proxies: - edgemicro_proxy-1 - edgemicro_proxy-2 - edgemicro_proxy-3
Analytics verilerini maskeleme
Yeni bir yapılandırma, istek yolu bilgilerinin Edge analizlerinde gösterilmesini 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
2.3.3 sürümü için yeni özellikler ve iyileştirmeler
Bu sürümdeki yeni özellikler ve geliştirmeler aşağıda verilmiştir.
Otomatik değişiklik anketini devre dışı bırakma
Mikro geçit yapılandırmasında bu özelliği ayarlayarak otomatik değişiklik yoklamasını devre dışı bırakabilirsiniz:
disabled_config_poll_interval: true
Varsayılan olarak, düzenli anket, Edge'de yapılan değişikliklerin (ürünlerde, mikro ağ geçidi bilinçli proxy'lerde vb.) yanı sıra yerel yapılandırma dosyasında yapılan değişiklikleri de alır. Varsayılan anket aralığı 600 saniyedir (beş dakika).
Eklentilerdeki hedef URL'leri yeniden yazma
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ışı
Günlük kaydı hizmeti artık varsayılan olarak indirilen proxy'lerin, ürünlerin ve JWT'nin JSON'unu atlar.
Edge Microgateway'i başlatırken 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'ye özel yapılandırma yolu eklendi
Varsayılan olarak mikro geçit yapılandırma dosyası ./config/config.yaml dosyasındadı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
2.3.3 sürümünde düzeltilen hatalar
- Büyük istek/yanıtlar sırasında oluşan bir bellek sızıntısı düzeltildi.
- Eklenti yürütme sırası düzeltildi. Artık dokümanda açıklandığı şekilde davranıyor.
- accumulate-request eklentisi artık GET istekleri için kilitlenmiyor.
- Yanıt gövdesinin eksik olması nedeniyle hatalara neden olan accumulate-response eklentisinde bir sorun düzeltildi.
Sürüm 2.3.1
Kurulum notu
Edge Microgateway'in önceki sürümlerinden bazıları, ZIP dosyası indirerek yazılımı yüklemenize olanak tanır. 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.
2.3.1 sürümündeki yeni özellikler ve iyileştirmeler
Bu sürümdeki yeni özellikler ve geliştirmeler aşağıda verilmiştir.
Proxy'leri filtreleme
Yeni yapılandırma, Edge Microgateway'in başlangıçta hangi proxy'leri yükleyeceğini filtrelemenize olanak tanır. Daha önce mikrogeçiş, edgemicro yapılandır komutunda belirttiğiniz Edge kuruluşundan/ortamından alınan tüm mikrogeçiş bilinçli proxy'leri (edgemicro_* adlı proxy'ler) yüklerdi. Bu yeni özellik, Edge Microgateway'in yalnızca belirttiğiniz proxy'leri yüklemesi için bu proxy listesini filtrelemenize olanak tanır. Proxy öğesini mikro ağ geçidi yapılandırma dosyasına aşağıdaki gibi eklemeniz yeterlidir:
edge micro: proxies: - edgemicro_[name] - edgemicro_[name] ...
Örneğin, Edge org/env'inizde edgemicro_foo
ve edgemicro_bar
adlı olanlar da dahil olmak üzere 50 edgemicro_*
proxy'niz olduğunu varsayalım. Mikro ağ geçidini yalnızca bu iki proxy'yi kullanması için şu şekilde belirtebilirsiniz:
edge micro: proxies: - edgemicro_foo - edgemicro_bar
Mikro ağ geçidi, başlangıçta yalnızca belirtilen proxy'leri çağırabilir. Edge kuruluşundan/ortamından indirilen diğer mikro geçit uyumlu proxy'leri çağırma girişimleri hatayla sonuçlanır.
Eklentilerde hedef istek başlıklarını ayarlama
Hedef istek üstbilgileri eklemek veya değiştirmek istiyorsanız dikkate almanız gereken iki temel kalıp vardır: gelen isteğinde veri içeren (POST isteğinde olduğu gibi) ve içermeyen (basit bir GET isteğinde olduğu gibi) kalıplar.
Gelen isteğinde veri bulunduğu ve hedef isteğinde istek üstbilgilerini 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ı, önce istemciden gelen tüm verileri toplamaktır. Ardından, onend_request()
işlevinde başlıkları özelleştirmek için yeni request.setOverrideHeader(name,
value)
işlevini kullanın.
Bunun nasıl yapıldığını gösteren örnek eklenti kodunu aşağıda bulabilirsiniz. onend_request
içinde ayarlanan üstbilgiler 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 onrequest()
işleyicisinde hedef üstbilgileri ayarlayabilirsiniz. Bu kalıp yeni değildir. Daha önce belgelenmiş ve Edge Microgateway ile sağlanan ö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'te yapılandırma değişikliği yaptıktan sonra, herhangi bir mesajı düşürmeden yapılandırmayı yükleyebilirsiniz. Bu değişiklikle birlikte Edge Microgateway her zaman küme modunda başlar 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 mikro ağ geçidinin çalışıp çalışmadığını kontrol eder.edgemicro stop
: Edge Microgateway kümesini durdurur.edgemicro reload
: Edge Microgateway yapılandırmasını herhangi bir kesinti olmadan yeniden yükler.
Kapalı kalma süresi olmadan otomatik yapılandırma yeniden yükleme
Edge Microgateway, düzenli aralıklarla yeni bir yapılandırma yükler ve herhangi bir değişiklik olursa yeniden yükleme işlemi gerçekleştirir. Anket, Edge'de yapılan değişikliklerin (ürünlerde yapılan değişiklikler, mikro ağ geçidi bilinçli proxy'ler vb.) yanı sıra yerel yapılandırma dosyasında yapılan değişiklikleri de alır. Varsayılan anket aralığı 600 saniyedir (beş dakika). Varsayılan değeri, mikro geçit yapılandırma dosyasında aşağıdaki gibi değiştirebilirsiniz:
edgemicro: config_change_poll_interval: [seconds]
CLI'ye sürüm bilgileri eklendi
CLI'ye --version
işareti eklendi. Edge Microgateway'in mevcut sürümünü almak için:
edgemicro --version
Yeni Edge Microgateway sunucu SSL seçenekleri
Edge Microgateway artık key
ve cert
'e ek olarak aşağıdaki sunucu SSL seçeneklerini de desteklemektedir:
Option | Açıklama |
---|---|
pfx |
İstemcinin özel anahtarını, sertifikasını ve CA sertifikalarını PFX biçiminde içeren bir pfx dosyasının yolu. |
passphrase |
Özel anahtar veya PFX'nin şifre ifadesini içeren bir dize. |
ca |
PEM biçiminde güvenilir sertifikaların listesini içeren bir dosyanın yolu. |
ciphers |
Kullanılacak şifreleri ":" ile ayırarak tanımlayan bir dize. |
rejectUnauthorized |
Doğru ise sunucu sertifikası, sağlanan CA listesi ile karşılaştırılarak doğrulanır. Doğrulama başarısız olursa bir 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 verme
Yetkilendirme proxy'si için özel kimlik doğrulama hizmeti 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'sini dağıtma
Edge Microgateway yetkilendirme proxy'sini Edge'e dağıtmak için kullanılan komutun Windows sistemleriyle uyumlu olması için bir iyileştirme yapıldı.
2.1.0 sürümü
21.0 sürümü için yeni özellikler ve geliştirmeler
Yeni özellikler ve iyileştirmeler aşağıda açıklanmıştır:
İstemci SSL/TLS seçeneklerini belirtme
Yeni bir yapılandırma seçenekleri grubu kullanarak hedeflere SSL/TSL bağlantıları için istemci seçeneklerini belirtebilirsiniz. İ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 önceki sürümlerinden bazıları, ZIP dosyası indirerek yazılımı yüklemenize olanak tanır. 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.
2.0.11 sürümündeki yeni özellikler ve iyileştirmeler
Yeni özellikler ve iyileştirmeler aşağıda açıklanmıştır:
Başlangıçta bir bağlantı noktası belirtme
start komutu, yapılandırma dosyasında belirtilen bağlantı noktasını geçersiz kılmak için 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 komutuna bakın.
İsteğe bağlı olarak kimlik doğrulama üstbilgilerini koruma
keepAuthHeader adlı yeni yapılandırma ayarı, istekle gönderilen Yetkilendirme başlığını korumanıza olanak tanır. Doğru değerine ayarlanırsa Auth başlığı hedefe iletilir. oauth özelliklerine bakın.
Özel yetkilendirme hizmeti kullanma yeteneği
Kimlik doğrulamayı işlemek için kendi özel hizmetinizi kullanmak istiyorsanız Edge Microgateway yapılandırma dosyasında 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.
2.0.4 sürümü
Edge Microgateway 2.0.4 sürümü 25 Mayıs 2016'da kullanıma sunuldu.
2.0.4 sürümündeki yeni özellikler ve iyileştirmeler
Bu sürümdeki yeni özellikler ve geliştirmeler aşağıda verilmiştir.
Ürünlerdeki kaynak yolları için destek
Edge Microgateway artık ürünlerdeki kaynak yollarını destekliyor. Kaynak yolları, API'lere erişimi proxy yolu son ekine göre 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 dokümanlarına bakın.
Sürüm 2.0.0
Edge Microgateway 2.0.0 sürümü 18 Nisan 2016'da kullanıma sunuldu.
2.0.0 sürümü için yeni özellikler ve geliştirmeler
Bu sürümdeki yeni özellikler ve geliştirmeler aşağıda verilmiştir.
Tek işlemli sunucu
Edge Microgateway artık tek işlemli bir sunucudur. Artık bir sürecin (eski adıyla "temsilci") Edge Microgateway'i, ikinci sürecin ise Edge Microgateway'i başlattığı iki süreç modeli kullanılmıyor. Yeni mimari, otomasyonu ve kapsayıcı oluşturmayı kolaylaştırır.
Ad alanı adı verilen yapılandırma dosyaları
Yapılandırma dosyaları artık aynı ana makinede birden fazla Microgateway örneğinin çalışabilmesi için kuruluş ve ortam kullanılarak adlandırma alanına sahip. Edge Microgateway yapılandırma komutunu çalıştırdıktan sonra yapılandırma dosyalarını ~/.edgemicro bölümünde bulabilirsiniz.
Yeni ortam değişkenleri
Artık 4 ortam değişkeni vardır: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY, EDGEMICRO_SECRET. Bu değişkenleri sisteminizde ayarlarsanız Edge Microgateway'ı 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ı kullanır.
Küme modu
Edge Microgateway'i artık küme modunda başlatma seçenekleri mevcuttur. 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.
2.0.0 sürümünde düzeltilen hatalar
Eklenti etkinliği yaşam döngüsü artık yeni geri çağırma işlevi içeren kod içeren eşzamansız kodu düzgün şekilde yönetiyor.
Sürüm 1.1.2
Edge Microgateway 1.1.2 sürümü 14 Mart 2016'da kullanıma sunuldu.
1.1.2 sürümündeki yeni özellikler ve iyileştirmeler
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 iyileş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 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ı rotasyonu
Yeni bir yapılandırma özelliği, Edge Microgateway günlükleri için bir döndürme aralığı belirtmenize olanak tanır.
1.1.2 sürümünde düzeltilen hatalar
1.1.2 sürümünde aşağıdaki hatalar düzeltilmiştir.
Açıklama |
---|
Şirket içi Edge ile kullanılan edgemicro-internal proxy için Java açıklama metni artık doğru MGMT sunucusunu kullanıyor. |
Temsilciden typescript bağımlılıkları kaldırın. |
Basit dağıtım seçeneği kullanılırken CLI hatası düzeltildi. |
Sertifika mantığı bağımlılığı referansını düzeltin. |