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), 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 EMG, her bir analiz kaydını |
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ı |
|
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ü |
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 |
|
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ü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.
Sorunu düzeltmek için aşağıdaki komutu çalıştırarak 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 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 |
|
192799989 | Özellik |
|
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 |
Jeton isteği ve yenileme jetonu isteği API'leri artık
RFC 6749 The OAuth 2.0 Authorization Framework
ile uyumluluk için |
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
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ısı çalıştırmak için yeni bir |
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 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
|
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
|
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 Ö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.
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 İstemciler, jetonların süresi dolmadan önce jetonları yenilemek için milisaniye cinsinden İ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: |
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, |
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 |
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, |
159571119 | Hata | Yanıt/soket zaman aşımı nedeniyle özel eklentilerdeki onerror_request kancasında boş hatası alınıyor.
|
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 |
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 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:
|
||||||||||||
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
veyaquotaUri: https://%s-%s.apigee.net/edgemicro-auth
karakterlerinden biri varsaedgemicro 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ü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ı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
vetargetResponse
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.
- 147027862 - OAuth eklentisi, API ürünlerinde 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ı 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ızedgemicro_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: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ğininquotas
olarak adlandırıldığını unutmayın. Tek tekquotas
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çinedgemicro-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:
- 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.
- Edge Microgateway yapılandırma dosyasındaki
- 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 gibierror
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ılanedgemicro-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 yeniedgemicro-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ılanedgemicro-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.
- 139064652 - Etkinlik ve sistem günlükleri için
trace
vedebug
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ü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çeriyor:
- Zaman damgası
- Bileşen adı
- İşlem Kimliği
- Konsol günlük mesajı
- 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.
- 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:
- A seçeneği: Eklentiler 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 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]
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.
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:
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_tunnel'ı 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 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. |