Edge Microgateway sürüm notları

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

Sürüm 3.3.x

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

3.3.2

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

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.3.2 ile ilişkili ayrı 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 çekirdek yapılandırma eklentiler 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 Öne Çıkarın

Desteklenen Node.js sürümleri şunları içerir: 16, 18 ve 20. Edge 3.3.2 sürümünden itibaren Edge Microgateway CLI komutları yalnızca desteklenen sürümlerde çalışır. Desteklenmeyen sürümlerde CLI komutları yürütmek hatayla sonuçlanır. Ayrıca, Apigee tarafından desteklenen yazılımlar ve desteklenen sürümler bölümüne de göz atın.

283947053 Böcek

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

274443329 Böcek

Docker'ın eski bir görüntü sürümünü çektiği bir sorun düzeltildi. Docker düğüm sürümü, Node.js sürüm 18'e güncellendi. Şimdi Docker görüntüsünü 18.17-buster-slim sürümüyle derliyoruz.

Güvenlik sorunları düzeltildi

Yok.

3.3.1

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

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.3.1 ile ilişkilendirilmiş ayrı 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 çekirdek yapılandırma eklentiler 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 Öne Çıkarın

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

231972608 Böcek

Özel bulut için yapılandırmaya çalışırken private configure komutunun hata verdiği bir sorun düzeltildi.

233315475 Böcek

json2xml plugin, yanıtı JSON'dan XML'e dönüştürürken ve accumulate-response plugin ile birlikte kullanıldığında ayrıştırma hatası döndürmesine neden olan sorun düzeltildi.

221432797 Değiştir

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

215748732 Öne Çıkarın

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

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

Ayrıntılar için Komut satırı referansı bölümüne bakın.

218723889 Doküman Güncellemesi

Dokümanlar, GitHub'da depolanan, desteklenen Edge Microgateway eklentilerine bağlantı içerecek şekilde güncellendi. Edge Microgateway ile birlikte sunulan mevcut eklentiler konusuna bakın.

Güvenlik sorunları düzeltildi

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

3.3.0

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

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.3.0 ile ilişkilendirilmiş ayrı 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 çekirdek yapılandırma eklentiler 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 Ağ Geçidi 3.3.0, npm denetleme düzeltme komutuyla uyumlu değildir.

npm audit fix işlevinin çalıştırılması apigeetool ürününün 0.15.2'ye yükseltilmesine neden oluyor ve bu durum, edgemicro upgradeauth komutunu etkiler.

npm audit fix komutunu, ardından edgemicro upgradeauth politikasını yürütürseniz şu hatayı görürsünüz:

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

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

npm install apigeetool@0.15.1

Bu sorun, Edge Mikro Ağ Geçidi'nin gelecekteki bir sürümünde giderilecektir.

138622990 Öne Çıkarın

Kota eklentisi için yeni bir işaret olan isHTTPStatusTooManyRequestEnabled, kota ihlali olması durumunda eklentiyi durum 403 yerine HTTP 429 yanıt durumu döndürecek şekilde yapılandırır. Kota için yapılandırma seçenekleri bölümüne bakın.

192534424 Böcek

Apigee Analytics'te görünen yanıt kodunun Edge Microgateway yanıt koduyla eşleşmemesine neden olan bir 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ı alıyor ve IDP'nin ortak anahtarı değiştiğinde anahtarı da günceller. Daha önce, bir IDP'nin ortak anahtarı değiştiyse extauth eklentisi, Edge Mikro Ağ Geçidi'ni yeniden yüklemeden ortak anahtarı güncelleyemiyordu.
168713541 Böcek

Belgeler, birden fazla hedef için TLS/SSL'nin nasıl yapılandırılacağı açıklanacak şekilde geliştirildi. İstemci SSL/TLS seçeneklerini kullanma başlıklı makaleye bakın.

171538483 Böcek

Günlük dosyası adlandırma kuralının düzeltilmesi için dokümanlar değiştirildi. Günlük dosyası adlandırma kuralları bölümüne göz atın.

157908466 Böcek

Edge Microgateway'in belirli bir sürümünün nasıl yükleneceğinin doğru şekilde anlatılması için belgeler değiştirildi. İnternet bağlantınız varsa Edge Mikro Ağ Geçidi'ni yükseltme başlıklı makaleye göz atın.

215748427 Böcek Mevcut bir anahtar ve gizli anahtar çiftini kullanarak anahtarı iptal ederken iptal anahtarı komutunun hata döndürmesine neden olan sorun düzeltildi.
205524197 Böcek Belgeler, günlük kaydı düzeylerinin tam listesini içerecek şekilde güncellendi. edgemicro özellikleri ve Günlük kaydı düzeyini ayarlama bölümlerine göz atın.

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üzeltme ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.2.3 ile ilişkili ayrı ayrı 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 çekirdek yapılandırma eklentiler 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 Öne Çıkarın

disableStrictLogFile yapılandırma özelliği, api-log.log uygulama günlük dosyasındaki yüksek düzey dosya izinlerini gevşetmenize olanak tanır. Ayrıntılar için Günlük dosyası izinlerini gevşetme bölümüne bakın.

192799989 Öne Çıkarın

on_target_response_abort yapılandırma özelliği, istemci (Edge Microgateway) ile hedef sunucu arasındaki bağlantı zamanından önce kapanması durumunda Edge Mikro Ağ Geçidi'nin nasıl davranacağını kontrol etmenizi sağlar. Ayrıntılar için edgemicro özellikleri bölümünü inceleyin.

148062415 Böcek Docker container bağlamında Edge Microgateway'in docker stop {containerId} komutuyla sorunsuz bir şekilde kapanmamasına neden olan bir sorun düzeltildi. İşlem sonlandırıldı ancak .sock ve .pid dosya kaldırılmadı. Artık dosyalar kaldırılır ve aynı kapsayıcının yeniden başlatılması beklendiği gibi çalışır.
190715670 Böcek Mikro ağ geçidinin dahili yeniden yükleme etkinliği sırasında bazı isteklerin takılıp kaldığı bir sorun düzeltildi. Bu sorun aralıklı olarak gerçekleşti ve trafiğin yüksek olduğu durumlarda ortaya çıktı. Sorun, OAuth eklentisinin tokenCache ve cacheKey özellikleri kullanıldığında görüldü.
183910111 Böcek Sonunda eğik çizgi olan bir kaynak yolu URL'sinin yanlış bir şekilde ayrı bir kaynak yolu olarak yorumlanmasına neden olan sorun düzeltildi. Şimdi örneğin, /country/all ve /country/all/ yolları aynı yol olarak yorumlanıyor.

Güvenlik sorunları düzeltildi

Sorun Kimliği Açıklama
CVE-2020-28503 2.0.5'ten önceki paket kopyalama sahneleri, ana işlev nedeniyle Prototip Kirliliğine karşı savunmasızdır.
CVE-2021-23343 Paket yolu ayrıştırma uygulamasının 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, polinom için en kötü durum zamanı karmaşıklığını gösteriyor.

3.2.2

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

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.2.2 ile ilişkili ayrı 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 çekirdek yapılandırma eklentiler 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

Dize olan expires_in değeri, tam sayı olarak değiştirildi

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

RFC 6749 OAuth 2.0 Yetkilendirme Çerçevesi'ne uymak için expires_in yapılandırma parametresi için beklenen değer dizeden tam sayı olarak değiştirildi. Ayrıntılar için İşlem ve yapılandırma referansı başlıklı makaleye bakın.

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

3.2.2 sürümünden itibaren, Node.js 8 artık desteklenmeyecektir. Daha fazla bilgi için Desteklenen yazılım ve desteklenen sürümler: Edge Microgateway sayfasına göz atın.

183990345 Öne Çıkarın Docker container'ı için günlük çıkışını yapılandırma

Edge Microgateway yapılandırma parametresi to_console, günlük bilgilerini günlük dosyası yerine standart çıkışa göndermenizi sağlar. Edge Microgateway'i bir Docker kapsayıcısında çalıştırma adımlarını uygularsanız container varsayılan olarak stdout'u ve hata çıkışını şu konumda bulunan kapsayıcıda bulunan bir dosyaya yönlendirir: ${APIGEE_ROOT}/logs/edgemicro.log.

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

Bu yeni değişkenin nasıl kullanılacağıyla ilgili ayrıntıları Edge Microgateway için Docker'ı kullanma bölümünde bulabilirsiniz.

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

Edge Microgateway ile Docker container'ı çalıştırmak için yeni bir -w, --workdir parametresi, edgemicro.sock ve edgemicro.pid dosyalarının Docker kapsayıcısında oluşturulması gereken dizine giden yolu belirtmenize olanak tanır. Edge Mikro Ağ Geçidi için Docker'ı kullanma başlıklı makaleyi inceleyin.

191352643 Öne Çıkarın Edge Mikro Ağ Geçidi için Docker görüntüsü, NodeJS 12.22 sürümünü kullanacak şekilde güncellendi. Edge Mikro Ağ Geçidi için Docker'ı kullanma başlıklı makaleyi inceleyin.

Güvenlik sorunları düzeltildi

Sorun Kimliği Açıklama
CVE-2021-28860 0.5.1 sürümünden önceki Node.js mixme'de, saldırganlar mutate() ve integration() işlevleriyle "__proto__" aracılığıyla bir nesnenin özelliklerini ekleyebilir veya değiştirebilir. Kirli özellik, programdaki her nesneye doğrudan atanır. Bu durum, programın kullanılabilirliğini riske atabilir. Bu durum, potansiyel bir hizmet reddine (DoS) neden olabilir.
CVE-2021-30246 Node.js için 10.1.13'e kadar olan jsrsasign paketinde, bazı geçersiz RSA PKCS#1 v1.5 imzaları yanlışlıkla geçerli olarak kabul edilmektedir. NOT: Bilinen bir pratik saldırı yoktur.
CVE-2021-23358 Paket, 1.13.0-0 ve 1.13.0-2 öncesi, 1.3.2 ve 1.12.1 öncesi sürümlerde alt çizgiyi gösterir. Özellikle bir değişken özelliği, temizlenmediği için bağımsız değişken olarak geçirildiğinde, şablon işlevi aracılığıyla Rastgele Kod Yerleştirmeye karşı savunmasızdır.
CVE-2021-29469 Node-redis, bir 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 eksponansiyel geri izlemeye neden olabiliyordu. Bu sorun, hizmet reddine neden olabilir. Soruna 3.1.1 sürümünde yama uygulanmıştır.
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üzeltme ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.2.1 ile ilişkili ayrı 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 çekirdek yapılandırma eklentiler 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 Böcek Boş değere sahip JWK anahtarlarının uygulamaların başarısız olmasına neden olan sorun düzeltildi.

jwkPublicKeys öğesinde null değer geçirilmesini önlemek için artık null koşulu ele alınıyor.

Not: Bu düzeltme, edgemicro-auth proxy'sini yükseltmenizi gerektirir.

179971737 Böcek Hedef 4XX / 5XX durum yanıtlarının edgemicro_* proxy'leri için proxy hataları olarak günlüğe kaydedilmesine yol açan bir sorun düzeltildi.

Edge Microgateway işlemleri için Apigee Edge hata kodu analiz kontrol panelinde yanlış hedef hata sayıları gösteriliyordu. Hedef hatalarına ilişkin hata kodları proxy hataları olarak sayılıyordu. Bu sorun düzeltildi ve artık doğru hedef hatası sayıları gösterilmektedir.

179674670 Öne Çıkarın 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'sindeki JWT Değişkenlerini Ayarla politikasına allowProductStatus adlı yeni bir özellik eklendi. Bu özelliği JWT'de listelenen API ürünlerini filtrelemek için kullanmak için:

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

    Yalnızca Onaylı ürünlerin listelenmesini istiyorsanız özelliği aşağıdaki gibi ayarlayın:

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

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

    Bu yeni özelliği kullanmak için edgemicro-auth proxy'sini yükseltmeniz gerekir.

178423436 Böcek KSA'da veya ortam değişkenleri aracılığıyla iletilen anahtar ve gizli anahtar değerleri, işlem gezgini komut satırı bağımsız değişkenlerinde görünür.

Mikro ağ geçidi başlatıldıktan sonra, komut satırı bağımsız değişkenlerinden geçirilen veya ortam değişkenleri aracılığıyla ayarlanan Edge Mikro Ağ Geçidi anahtar ve gizli anahtar değerlerinin, düğüm çalışanı/alt işlemlerinin 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 anahtar değerleri komut satırında aktarılırsa ayarlar, ayarlanmışsa tüm ortam değişkeni değerlerinin yerini alır. Bu durumda, değerler işlem gezgini komut satırı bağımsız değişkenlerinde görünmeye devam eder.

178341593 Böcek apikeys eklentisi için bir doküman hatası düzeltildi.

apikeys eklentisinin README dosyası, yanlış bir şekilde gracePeriod özelliği içeriyordu. Bu mülkü ve açıklamasını README'den kaldırdık.

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

179366445 Böcek Hedeflere yapılan tüm GET isteklerinde yükün bırakılmasına neden olan bir sorun giderildi.

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

Örneğin:

edgemicro:
 enable_GET_req_body: true

RFC 7231, bölüm 4.3.1: GET uyarınca GET isteği yükünün tanımlı bir anlamı olmadığından hedefe gönderilebilir.

3.2.0

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

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.2.0 ile ilişkilendirilmiş ayrı 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 çekirdek yapılandırma eklentiler 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 Böcek Jeton geçerli olduğunda x-api-key üst bilgisini istek nesnesinde client_id içerecek şekilde ayarlamak için extauth eklentisi etkinleştirildi. x-api-key daha sonra sonraki eklentiler tarafından kullanılabilir.
168836123, 172295489, 176462355, 176462872 Öne Çıkarın Node.js 14 için destek eklendi.
172376835 Böcek edgemicro-auth proxy'sinde /token uç noktası için doğru zaman birimini kullanın.

edgemicro-auth proxy'sindeki /token uç noktasının milisaniye cinsinden expires_in döndürmesiyle ilgili bir sorun düzeltildi. Ancak, OAuth Belirtimi uyarınca bu, refresh_token_expires_in zaman birimiyle (saniye cinsinden) tutarlı olmalıdır.

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

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

İstemciler, jeton yenileme dönemini değerlendirmek için her zaman JWT jetonundaki değerleri kullandıysa istemcilerin değiştirilmesi gerekmez.

173064680 Böcek Tüm veri parçaları işlenmeden önce mikro ağ geçidinin hedef isteğini sona erdirmesine neden olan bir sorun düzeltildi.

Bu, yüksek yük boyutu isteklerinde aralıklı olarak gözlemlenen bir sorundur ve 3.1.7 sürümünde tespit edilmiştir.

174640712 Böcek Eklentilere uygun veri işleme ekleyin.

Şu eklentilere doğru veri işleme eklendi: json2xml, accumulate-request, accumulate-response ve header-uppercase. Eklenti ayrıntıları için microgateway-plugins sayfasına bakın.

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üzeltme ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.8 ile ilişkilendirilmiş ayrı 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 çekirdek yapılandırma eklentiler 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 Böcek Ortam değişkeni etiketlerinde sayısal ve boole değerleri yanlış bir şekilde ayrıştırıldı.

Ortam değişkeni değiştirme işlemi, tüm değerleri dize olarak ayrıştırıldı. Bu işlem, boole veya sayısal değerler için hataların ayrıştırılmasına neden oldu. Örneğin edgemicro.port, sayısal bir değer bekler ve gerektirir. Boole ve sayısal değerleri desteklemek için düzeltmeler yapıldı. Yapılandırma ayrıntıları için Ortam değişkeni değerleriyle yapılandırma özelliklerini ayarlama bölümüne bakın.

169202749 Böcek Ortam değişkeni değişimi bazı durumlarda çalışmıyordu.

Ortam değişkenini değiştirme işlemi bazı yapılandırma özellikleri için çalışmıyordu. Sınırlamalar hakkında bilgi için Ortam değişkeni değerleriyle yapılandırma özelliklerini ayarlama bölümüne bakın.

168732942 Böcek OAuth kapsamlarının, API proxy erişimini beklendiği gibi kısıtlamadığı bir sorun düzeltildi.

edgemicro-auth proxy'sindeki /token akışı, Edge'de doğru ürün kapsamı tanımlanmadan JWT'ler oluşturur. Bunun nedeni: 1) /token akışına giden istek yükü, kapsam parametresinden geçmemiştir veya 2) /token akışına istek yükünde geçersiz kapsam geçirilmiştir. Apigee Edge'deki API ürünlerinde tanımlanan tüm kapsamları döndürmek için düzeltme yapıldı.

170609716 Böcek edgemicro-auth proxy'sindeki /refresh akışının, apiProductList içermeyen bir JWT oluşturması sorunu düzeltildi.

170708611 Böcek API ürün kapsamları, özel eklentiler tarafından kullanılamaz.

API ürün kapsamları özel eklentilere sunulmamıştır veya önbellek yapılandırma dosyasına yazılmamıştır. Kapsam ayrıntılarının eklentilerin erişimine nasıl açıldığını görmek için Init() eklentisi işlevi hakkında bölümüne bakın.

169810710 Öne Çıkarın Önbellek yapılandırma dosyasına kaydedilen anahtar ve sır.

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'de 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 Öne Çıkarın Analytics eklentisi devre dışı bırakılamıyor.

Önceki mikro ağ geçidi sürümlerinde analiz eklentisi varsayılan olarak etkindi 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 yeni bir yapılandırma parametresi olan enableAnalytics kullanıma sunuldu. Ayrıntılar için Yapılandırma referansı bölümüne bakın.

159571119 Böcek Yanıt/yuva zaman aşımı için özel eklentilerdeki onerror_request kancasında null hatası alınıyor.

onerror_request etkinlikleri için doğru HTTP durum kodu ve hata mesajı, onerror_response etkinlikleri için de doğru hata mesajı doldurulmak üzere düzeltmeler yapıldı.

3.1.7

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

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.7 ile ilişkilendirilmiş ayrı 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 çekirdek yapılandırma eklentiler 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 Böcek analytics eklentisi, axpublisher çağrılarından gelen boş yanıtı yanlış işleyerek çalışanların çıkış yapmasına neden oldu.

133162200 Böcek Geliştirici uygulaması bilgileri, yetkisiz ürün kaynağı yollarının neden olduğu 403 durum yanıtlarıyla veya süresi dolmuş ya da geçersiz bir jetonun neden olduğu 401 yanıtlarıyla Analytics'te doldurulmuyordu.

132194290 Böcek Apigee Edge bazı analiz kayıtlarını reddettiğinde Analytics kayıtları silinir.

158618994 Böcek Aşırı sayıda Redis istemci bağlantısı.

161404373 Böcek 404 durum yanıtı olması durumunda, yanıt mesajına tam proxy URI'si dahil edildi.
166356972 Böcek

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 yürütürken aşağıdaki hatayla sonuçlandı:

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

168681746 Böcek redisBasedConfigCache:true ile Edge Microgateway manuel yeniden yükleme işlemi çalışmıyordu.

149256174 Böcek OAuth eklentisi hataları, ağ hataları için günlüğe kaydedilmedi.

166517190 Böcek jwk_public_keys verileri Synchronizer tarafından depolanmadı, alınmadı ve Redis'te depolanmadı.

141659881 Böcek Geçersiz hedef sertifika işlenirken hata oluştu, yanıltıcı hata yanıtları gösterildi.

142808699 Böcek Accesscontrol eklentisi, "allow" ve "deny" bölümlerini doğru şekilde işleyemiyordu.

Mikro ağ geçidi artık reddetme bölümünü düzgün bir şekilde işlemekte ve "izin ver" ile "reddet" bölümlerinin sırasına uymaktadır. Apigee Edge AccessControl politikasıyla benzerlik sağlamak için mikro ağ geçidi yapılandırma dosyasına yeni bir noRuleMatchAction özelliği eklendi. GitHub'daki Access Control Plugin README'ye de göz atın.

3.1.6

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

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.6 ile ilişkili ayrı ayrı 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 çekirdek yapılandırma eklentiler 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 Öne Çıkarın Döndürme tuşu komutu için özel anahtar ve sertifika dosyası konumu seçenekleri.

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

154838259 Böcek Birden çok veri merkezindeki çoklu örnekler için anahtar rotasyonunu düzeltme

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

145525133 Alfa özelliği Yeni eklenti metrikleri

Ayrıntılar için GitHub'da Yeni eklenti metrikleri README sayfasına bakın.

159396879 Böcek Kullanılmayan paket yardımcısını kaldır
161092943 Böcek Temel yol doğrulaması yanlıştı

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

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

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

Yol iste Çözümlenen yol Sonuç
/hello/v1/json https://mocktarget.apigee.net/json /hello/v1 taban yolu doğru şekilde eşleştiği için çözülen yol doğru.
Yol iste Çözümlenen yol Sonuç
/merhaba/v1json https://mocktarget.apigee.netjson /hello/v1, /hello/v1json dizesinin bir alt dizesi olduğundan çözümlenen yol yanlıştır. /hello/v1json geçerli bir yol olmadığı için Edge Microgateway'in 404 hatası vermesi gerekirdi. 3.1.6 ve sonraki sürümlerde bu durumda 404 hatası verilir.
160431789 Böcek Ö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ıma sunulur. config bölümünü inceleyin.

162758808 Böcek Redis yedekleme 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 yedekleme deposu kullanma başlıklı makaleye bakın.

3.1.5

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

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.5 ile ilişkilendirilmiş ayrı 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 çekirdek yapılandırma eklentiler 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 Öne Çıkarın Eklenti işlemeyi hariç tutmak için yapılandırma

Belirtilen URL'lerde eklentilerin işlenmesini atlamak için yeni bir yapılandırma özelliği eklendi. Ayrıntılar için Eklentiler için URL'leri hariç tutmayı yapılandırma bölümüne bakın.

156986819, 158529319 Böcek json2xml eklentisiyle ilgili sorunlar düzeltildi

Eklentinin yinelenen İçerik Türü başlıkları oluşturması ve bazı durumlarda başlıkların hedefe beklendiği gibi gönderilmemesine neden olan sorunlar düzeltildi.

156560067, 159688634 Öne Çıkarın

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

Yapılandırma dosyasında 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 ve orijinal yapılandırmada veya önbellek dosyalarında depolanmaz. Ayrıntılar için Ortam değişkeni değerleriyle yapılandırma özelliklerini ayarlama bölümüne bakın.

155077210 Böcek Bir günlük biçimlendirme sorunu düzeltildi.

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

153673257 Böcek

(Yalnızca Private Cloud için Edge) Mikro ağ geçidine duyarlı ürünler çekilmedi

Mikro ağ geçidine duyarlı ürünlerin çekilmemesiyle ilgili bir sorun düzeltildi. Bu sorun yalnızca Edge for Private Cloud yüklemeleri için kullanılabiliyordu.

154956890, 155008028, 155829434 Öne Çıkarın İndirilen ürünlerin özel özelliklere göre filtrelenmesini destekleme

Ayrıntılar için Ürünleri özel özelliklere göre filtreleme bölümüne bakın.

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

İstisnaların işlenmesi, hatanın yakalanması ve konsola mesaj yazdırılması için iyileştirildi.

155499600 Böcek Anahtar rotasyonu ve KVM'nin yeni sürüme geçirilmesiyle ilgili sorunlar düzeltildi

Ayrıca bkz. JWT anahtarlarını döndürme.

3.1.4

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

Hata düzeltme:

3.1.3 sürümünde bir bağımlılık sorunu giderildi. 3.1.3 sürümü, npm deposunda kullanımdan kaldırıldı olarak işaretlenmiş. 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üzeltme ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.3 ile ilişkili ayrı 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 çekirdek yapılandırma eklentiler 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 olmasıyla ilgili bir sorun düzeltildi. Sorun, 3.1.0, 3.1.1 ve 3.1.2 sürümlerinde mevcuttur.
  • 153509313 - İki farklı işlem için aynı ileti kimliğinin, günlük kaydı çıktısına yazdırılmasına neden olan bir sorun düzeltildi.
  • 151673570 - Edge Microgateway'in yeni Apigee KVM API'lerini kullanacak şekilde güncellenmemesiyle ilgili bir sorun düzeltildi. Edge Microgateway, KVM değerlerini eklemek ve güncellemek için artık yeni komutları kullanıyor.
  • 152822846 - Önceki sürümlerde Edge Microgateway, kaynak yol eşlemesi işlemesinin Apigee Edge'le eşleşecek şekilde güncellendi. Bu sürümde, /literal_string/* kalıbının doğru işlenmemesine neden olan bir sorun düzeltilmiştir. Örneğin, /*/2/*. Ayrıca bkz. "/", "/*" ve "/**" kaynak yolunun davranışını yapılandırma.
  • 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ı. 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üzeltme ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.3 ile ilişkili ayrı 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 çekirdek yapılandırma eklentiler 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 özellik geliştirmesi yapıldı. Ayrıca Edge Microgateway ve Apigee Edge arasındaki mevcut HTTP proxy desteği ile ilgili sorunlar da düzeltildi. Ayrıntılı bilgi için:
  • 149101890 - Hedef sunucunun veya yük dengeleyicinin bağlantısını kapattığı durumlar için ERROR olan günlük bildirim kodu INFO olarak değiştirildi.
  • 150746985: Yapılandırma dosyasında redisBasedConfigCache: true veya quotaUri: https://%s-%s.apigee.net/edgemicro-auth olması halinde edgemicro verify komutunun düzgün çalışmamasına yol açan sorun düzeltildi.
  • 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 bir iyileştirme yapıldı.
  • 151588764 - Node.js v8 kullanımdan kaldırıldığı için Docker container'ında Edge Microgateway'i çalıştırmak için kullanılan Docker görüntüsündeki Node.js sürümünü 12'ye güncelleyin.
  • 151306049 - Edge Microgateway CLI komutlarının kullandığı Apigee Edge yönetim API'lerini listelemek için belge güncellemesi yapıldı. Edge Microgateway hangi yönetim API'lerini kullanır? bölümüne bakın.

3.1.1

20 Şubat Perşembe günü, Edge Microgateway'de aşağıdaki düzeltme ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.1 ile ilişkilendirilmiş ayrı 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 çekirdek yapılandırma eklentiler edgeauth
3.1.1 3.1.1 3.1.1 3.0.13 3.0.9

Hata düzeltmeleri ve geliştirmeler:

  • 146069701 - microgateway-core modülünün HTTP_PROXY ve HTTPS_PROXY ortam değişkenlerine uymadığı bir sorun düzeltildi. Bu değişiklikle birlikte, belirtilirse YAML yapılandırma dosyasındaki proxy ayarları artık yok sayılır. Proxy'yi belirtmek için yalnızca ortam değişkenleri kullanılır.

    Yapılandırma dosyasında proxy yapılandırmasını belirtmek isterseniz yapılandırma dosyasında belirtilenle aynı proxy URL'sini belirten 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
    

    Şu 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 tam 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 süreden 5 saniye fazla. Bu varsayılan ayar, yük dengeleyicilerin veya proxy'lerin bağlantıyı yanlışlıkla kesmesini önler.)

  • 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 özelliğini io.timeout.millis ayarlarsanız Edge Microgateway bu özelliği alıp hedefe ö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üzeltme ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.1.0 ile ilişkilendirilmiş ayrı 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 çekirdek yapılandırma eklentiler 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, WARN seviyesinde yeni bir etkinlik kaydedilir. Kota işleme hatası oluşursa veya Edge'e "kota uygulama" isteği uzak kota sayaçlarını güncelleyemezse bu işaret tetiklenir. Bu durumda kota, bir sonraki başarılı uzaktan kota senkronizasyonu gerçekleşene kadar yerel sayılara göre işlenir. Daha önce bu etkinlik yalnızca günlük düzeyi HATA AYIKLAMA 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 etkilenmesine yol açan bir sorun düzeltildi. Artık bir proxy'de değişiklik yapıldığında Edge Mikro Ağ Geçidi önbelleği yeniler ve çalışma düğümleri yeniden başlatılır. Bu değişiklikle, devam eden işlemler ve mikro ağ geçidine gönderilen yeni API çağrıları etkilenmez.
  • 146378327 - sourceRequest, targetRequest ve targetResponse günlük düzeyi, INFO (Bilgi) düzeyi olarak değiştirildi.
  • 146019878 - Edge analizindeki "API Proxy Performance" (API Proxy Performansı) ile Edge Microgateway sourceResponse/targetResponse günlük etkinlikleri için hesaplanan gecikme arasındaki tutarsızlık düzeltildi. Artık Edge analizi ve Microgateway günlük etkinliklerindeki gecikme uyumlu hale getirildi.
  • Kalıp 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 yolunun davranışını yapılandırma bölümünde açıklandığı gibi Apigee Edge ile aynı kalıp eşleştirmeyi uyguluyor.

    • 145644205 - apiKeys eklentisinin kalıp eşleştirme mantığını, OAuth eklentisiyle eşleşecek şekilde güncelleyin.
  • 143488312 - İstemci kimliği parametresinin başında veya sonunda boşlukların, OAuth jetonu ve API anahtarı istekleri için JWT ürün listesinin boş olmasına neden olan bir sorun düzeltildi.
  • 145640807 ve 147579179 - "Senkronize edici" 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 ağ geçidi örnekleri, yapılandırma verilerini veritabanından okuyacak şekilde yapılandırılabilir. Bu özellik, Edge Mikro Ağ Geçidi'ne bir esneklik düzeyi ekler. Apigee Edge ile iletişim kurmaya gerek kalmadan mikro ağ geçidi örneklerinin başlatılmasını ve çalışmasını sağlar. Ayrıntılar için Senkronize ediciyi kullanma bölümüne bakın.

    Senkronize edici ö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üzeltme ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.0.10 ile ilişkilendirilmiş ayrı ayrı 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 çekirdek yapılandırma eklentiler 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ında kullanılan kalıp eşleştirmenin, "/", "/*" ve "/**" kaynak yolunun davranışını yapılandırma bölümünde açıklandığı gibi, artık Apigee Edge tarafından kullanılan kaynak yolu kalıbı eşleşmesiyle uyumlu olması için bir özellik güncellemesi yapıldı.

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

    alt_text

    Not: "/", "/*" ve "/**" kaynak yolunun davranışını yapılandırma bölümünde 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ıda yapılan değişiklik, yapılandırma öğelerinin daha net anlaşılmasını sağlamak için yapılmıştır. Kota eklentisini yapılandırmak için aşağıdaki YAML yapılandırmasını kullanın. Yapılandırma özelliğinin quotas adlı olduğunu unutmayın. Bağımsız quotas yapılandırma özellikleriyle ilgili ayrıntılar için Kota için yapılandırma seçenekleri bölümüne bakın.

    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 - Redis'i kota yedekleme deposu olarak kullanmanıza olanak tanıyan yeni bir özellik eklendi. useRedis değeri doğruysa volos-QUOTA-redis modülü kullanılır. Bu değer doğru olduğunda kota yalnızca Redis'e bağlanan Edge Microgateway örnekleriyle sınırlıdır. Yanlış değerine ayarlanırsa volos-QUOTA-impression modülü, yedekleme deposu olarak kullanılır ve kota sayacı globaldir. Ayrıntılı bilgi için Kota yapılandırma seçenekleri bölümüne bakın. Örneğin:
    edgemicro:
    ...
    quotas:
      useRedis: true
      redisHost: localhost
      redisPort: 6379
      redisDb: 1
  • 140574210 - edgemicro-auth proxy'si tarafından oluşturulan jetonlar için varsayılan süre sonu 108.000 milisaniye (1,8 dakika) iken 1800 saniye (30 dakika) olarak değiştirildi.
  • 143551282 - SAML'nin etkin olduğu 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 bir OAuth jetonu kullanmanıza olanak tanır. Ayrıntılar için Anahtar oluşturma bölümüne bakın.

3.0.9

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

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.0.9 ile ilişkili ayrı ayrı 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 çekirdek yapılandırma eklentiler 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 "hata açma" özelliği eklendi. Bu özellik etkinleştirildiğinde kota işleme hatası oluşursa veya Edge'e "kota uygulama" isteği uzak kota sayaçlarını güncelleyemezse kota, yalnızca bir sonraki başarılı uzaktan kota senkronizasyonu gerçekleşene kadar yerel sayılara göre işlenir. Her iki durumda da istek nesnesinde bir quota-failed-open işareti ayarlanır.

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

    quotas :
     failOpen : true

    Not: Buna ek olarak, 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 bir yapılandırma değişikliği yapıldı. Değişiklik, kota türünü calendar olarak ayarlamaktır. Bu iyileştirmeyi kullanmak için edgemicro-auth uygulamanızı 3.0.7 veya sonraki bir sürüme güncellemeniz gerekir.
  • 142520568 - Kota yanıtlarında MP (mesaj işleyen) kimliğinin günlük kaydını etkinleştirmek için 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 ayarlanırsa 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üzeltme ve geliştirmeleri yayınladık.

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.0.8 ile ilişkilendirilmiş ayrı 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 çekirdek yapılandırma eklentiler 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 "hata açma" özelliği eklendi. edgemicro-auth proxy'ye yapılan başarılı bir API anahtarı doğrulama çağrısını engelleyen bir bağlantı hatası nedeniyle süresi dolmuş bir JWT jetonu yenilenemiyorsa bu özellik, API işlemenin devam etmesine olanak tanır.

    Bu özellik, eski jetonun önbellekte kaldığı ve ek süre sona erene kadar yeniden kullanıldığı bir ek yayınlanma süresi ayarlamanıza olanak tanır. Bu özellik, geçici bağlantı hatası durumunda Edge Mikro Ağ Geçidi'nin istekleri işlemeye devam etmesini sağlar. Bağlantı devam ettirildiğinde ve başarılı bir Valid API Key çağrısı yapıldığında, yeni bir JWT getirilir ve önbellekteki eski JWT'nin yerini alır.

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

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

      Örneğin:

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

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

  • 141168968 - Tüm eklenti günlüğü çıktısına correlation_id öğesini dahil edecek şekilde bir güncelleme yapıldı. Ayrıca, bazı günlüklerin günlük düzeyleri gerektiği gibi error olarak değiştirildi.
  • 140193349 - Her Valid API Key isteğinde Edge Microgateway anahtarı ve gizli anahtarının doğrulanmasını gerektirecek şekilde edgemicro-auth proxy'sinde bir güncelleme yapıldı. Edge Microgateway, her Doğrulama API Anahtarı isteğinde her zaman anahtarı ve gizli anahtarı gönderecek şekilde güncellenmiştir. Bu değişiklik, istemcilerin yalnızca API anahtarıyla JWT almasını önler.
  • 140090250 - Kota işleme için teşhis günlük kaydı eklemek üzere bir güncelleme yapıldı. Bu değişiklik sayesinde artık kota günlük çıktısı, Edge Microgateway günlüklerinin geri kalanıyla ilişkilendirilebilir.

3.0.7

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

Bileşen sürümleri:

Aşağıdaki tabloda, Edge Microgateway 3.0.7 ile ilişkilendirilmiş ayrı 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 çekirdek yapılandırma eklentiler edgeauth
3.0.7 3.0.5 3.0.5 3.0.8 3.0.5

Hata düzeltmeleri ve geliştirmeler:

  • 140075602 - Uygun durumlarda 5xx durum kodu döndürülmesi için OAuth eklentisinde bir güncelleme yapıldı. Önceden, eklenti 200 dışındaki tüm durumlarda yalnızca 4xx durum kodu döndürüyordu. Artık 200 durumu olmayan herhangi bir mesaj yanıtı 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 Mikro Ağ Geçidi 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 yeni bir yapılandırma özelliği (quota.quotaUri) eklendi. Kotaları kuruluşunuza dağıtılan edgemicro-auth proxy'si aracılığıyla 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ına ayarlanır. Ö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üncellenmiştir. quotaUri özelliğini kullanmak için en yeni edgemicro-auth proxy'sine yükseltme yapmanız gerekir. Ayrıntılar için Uç mikro kimlik doğrulama proxy'sini yeni sürüme geçirme bölümüne bakın.

  • 140470888 - Kimlik doğrulama sağlamak için kota çağrılarına bir Yetkilendirme üst bilgisi eklendi. Ayrıca, edgemicro-auth proxy'si, "kuruluş"u kota tanımlayıcısından kaldıracak şekilde değiştirildi. Kota uç noktası müşterinin kuruluşunda yer aldığından artık kota tanımlayıcısına gerek yoktur.
  • 140823165 - Şu tesis adı:
    edgemicro:
        keepAliveTimeout

    3.0.6 sürümünde yanlış belgelenmişti. Doğru özellik adı şudur:

    edgemicro:
        keep_alive_timeout
  • 139526406 - Bir geliştirici uygulamasının birden fazla ürünü olması durumunda kota sayısının yanlış olmasına yol açan bir hata düzeltildi. Kota, artık birden fazla ürün içeren bir uygulamadaki her ürün için doğru şekilde uygulanmaktadır. Kota tanımlayıcısı olarak "appName + productName" kombinasyonu kullanılır.

3.0.6

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

  • 138633700 - Yeni yapılandırma özelliği (keepAliveTimeout) eklendi. Bu özellik, Edge Microgateway zaman aşımını (milisaniye cinsinden) ayarlamanızı sağlar. (Varsayılan: 5.000 milisaniye)

    Örneğin:

    edgemicro:
      keep_alive_timeout: 600
  • 140090623 - Yeni bir yapılandırma özelliği (quotaUri) eklendi. Kotaları kuruluşunuza dağıtılan edgemicro-auth proxy'si aracılığıyla 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ına ayarlanır. Örneğin:
    edge_config:
      quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
    

    Bu özelliği kullanmak için önce edgemicro-auth proxy'sinin en son sürümünü kuruluşunuza dağıtmanız gerekir. Ayrıntılar için Uç mikro kimlik doğrulama proxy'sini yeni sürüme geçirme bölümüne bakın.

  • 138722809 - Yeni yapılandırma özelliği (stack_trace) eklendi. Bu özellik sayesinde yığın izlemelerin günlük dosyalarında görünüp görünmeyeceğini kontrol edebilirsiniz. Örneğin:
    stack_trace: false

    stack_trace, true değerine ayarlanırsa yığın izleme günlüklere yazdırılır. false değerine ayarlanırsa yığın izleme, günlüklere yazdırılmaz.

3.0.5

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

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

3.0.4

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

  • 134445926 - Dahili Edge Mikro Ağ Geçidi kimlik doğrulamasında iyileştirmeler.
  • 137582169 - İstenmeyen işlemlerin başlatılmasına neden olan bir sorun giderildi. Ekstra işlemler, eklentilerin yeniden yüklenmesine ve aşırı bellek kullanılmasına neden oldu. Edge Mikro Ağ Geçidi artık işlem sayısını beklenen sınır dahilinde tutuyor.
  • 137768774 - Mesaj iyileştirmelerini günlüğe kaydet:
    • İş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ı.
    • Konsol 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 düzeyde dahili değişiklik.

3.0.3

23 Temmuz Salı günü, Edge Microgateway'de aşağıdaki düzeltme ve geliştirmeleri yayınladık.

  • Günlük kaydı geliştirmeleri: Mevcut çalışma zamanı günlükleri, çalışma zamanı verilerini tutarlı bir biçimde yakalayıp kaydeden yeni bir eventLog() işlevi kullanır. Günlük bilgilerinde şunlar yer alır:
    • Zaman damgası (ISO 8601: YYYY-AA-GGTSS:dd:ss.sssZ).
    • Günlük düzeyi (hata, uyarı veya bilgi).
    • Ana makine adı: İstek başlığından istekte bulunan ana makine adı.
    • İşlem Kimliği: Bir Node.js işlem kümesi çalıştırıyorsanız bu, günlük kaydının gerçekleştiği işlemin kimliğidir.
    • Apigee kuruluş adı.
    • Kuruluştaki ortam adı.
    • API proxy'si adı.
    • İstemci IP adresi.
    • MüşteriNo.
    • Bağıntı kimliği (şu anda ayarlanmamış).
    • Edge Mikro Ağ Geçidi bileşen adı.
    • Özel mesaj: Bazı nesneler bu hata özelliğine iletilen ek bilgileri yazdırabilir.
    • İstek yöntemi (HTTP isteğiyse).
    • Yanıt durum kodu (HTTP isteği varsa).
    • Hata mesajı.
    • Hata kodu: Bir nesne hata kodu içeriyorsa bu özellikte yazdırılır.
    • Geçen süre.
    • İşletim sistemi çizgi sonu işaretçisi.

    Boş özellik değerleri, boş parantezlerle ([]) sonuçlanır.

    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'de aşağıdaki düzeltme ve geliştirmeleri yayınladık.

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. Kod kalitesi hatalarını ve JSHint'ten türetilen uyarıları ele aldık. Sonuç olarak bazı gerçek kod hataları tespit edilip onarıldı. Tüm Apigee Edge Mikro Ağ Geçidi modülleri bu süreçlerden geçirilmiştir. 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üldüğünü doğrulayan dahili araçlarla test edilmiştir.

3.0.1

21 Haziran 2019 Cuma günü, Edge Mikro Ağ Geçidi'nde aşağıdaki düzeltme ve geliştirmeleri yayınladık.

  • 134834551 - Edge Microgateway için desteklenen Node.js sürümlerini değiştirme
    (Node.js tarafından desteklenen sürümler: 8 ve 12; sürüm 7, 9 ve 11 deneyseldir)
  • 134751883 - Yük altında yeniden yüklenirken Edge Mikro Ağ Geçidi kilitleniyor
  • 134518428 - Filtre kalıbı yanlışsa Edge Microgateway için ürün uç noktası 5XX değerini döndürür
  • 135113408 - Beklenmedik şekilde işten ayrılan çalışanların yeniden başlatılması gerekiyor
  • 134945852: tokenCacheSize, oauth eklentisinde kullanılmıyor
  • 134947757 - OAuth eklentisinde cacheTTL ayarlama
  • 135445171 - OAuth'ta ek süre hesaplaması doğru değil
  • Edge Microgateway kurulumuyla sağlanan memored modülünü kullanın
  • 135367906 - Güvenlik denetimi

Sürüm 2.5.x

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

(Düzeltme 2.5.38, 07.06.2019)

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

(2.5.37 eklendi) KSA seçeneğini ekleme edgemicro-cert -t.

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

(2.5.35'te eklendi) edgemicroctl kullanarak Edge Microgateway hatalarını ayıklama desteği eklendi.

mgdebug işaretini edgemicroctl ile kullanabilirsiniz. Kubernetes entegrasyon görevleri bölümüne de göz atın.

(2.5.35 eklendi) edgemicroctl için Windows derlemesini etkinleştirin.

(Yeni uç mikro kimlik doğrulama/jeton API'si 2.5.31 eklendi)

İstemciyi/sırrı Base64 Kodlu Temel Yetkilendirme başlığı olarak, allow_type değerini ise form parametresi olarak aktarmanıza olanak tanıyan yeni bir Edgemicro-auth/token API eklendi. Doğrudan hamiline ait jeton alma konusuna bakın.

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

Edge Mikro Ağ Geçidi'nin, Private Cloud için Edge'de OAuth2 erişim jetonu kullanacak şekilde yapılandırılmasının düzgün çalışmaması (jetona uyulmadığı) sorunu giderildi.

Docker: Kendinden imzalı sertifikaları kullanma desteği

(Ek 2.5.29) Node.js tarafından varsayılan olarak güvenilmeyen bir Sertifika Yetkilisi (CA) kullanıyorsanız Edge Microgateway ile Docker container'ı çalıştırırken NODE_EXTRA_CA_CERTS parametresini kullanabilirsiniz. Ayrıntılar için Node.js tarafından güvenilmeyen bir CA kullanma bölümüne bakın.

Docker: TLS desteği

(Ek 2.5.29) Docker kapsayıcısında çalışan Edge Mikro Ağ Geçidi artık Edge Microgateway sunucusuna gelen istekler (kuzey bölgesi istekleri) ve Edge Microgateway'den bir 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 /opt/apigee/.edgemicro container ekleme noktasının nasıl kullanılacağı gösterilmektedir. Bu nokta, Edge Microgateway yapılandırma dosyasında yer almaktadır.

Docker: İstek için proxy kullanma desteği

(Ek 2.5.27) Edge Mikro Ağ Geçidi'ni Docker container'ında çalıştırırsanız mikro ağ geçidi bir güvenlik duvarının arkasında çalışırken proxy davranışını kontrol etmek için şu seçenekleri kullanabilirsiniz:

  • HTTP_PROXY
  • HTTPS_PROXY
  • NO_PROXY

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

Docker: Güncellenmiş eklenti talimatları

(Ek 2.5.27) Edge Microgateway'i Docker container'ında çalıştırıyorsanız eklentileri dağıtmak için iki seçeneğiniz vardır. Seçeneklerden biri yeni bir Docker ekleme noktasıdır. Daha önce mevcut olan diğer seçenek temelde değişmemiştir ancak Dockerfile güncellenmiştir. Ayrıntılar için aşağıdaki bağlantılara göz atın:

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

(Ek 2.5.27) OAuth jetonunu upgradekvm komutuyla kullanabilirsiniz. Ayrıntılar için KVM'yi yükseltme bölümünü inceleyin.

Edge Analytics'te API'leri Ayırma

(Ek 2.5.26) 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 bölümüne bakın.

Yerel proxy yapılandırma

(Ek 2.5.25) Yerel proxy ile Apigee Edge'de manuel olarak mikro ağ geçidine duyarlı proxy 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ı makaleye bakın.

Bağımsız modu kullanma

(2.5.25'te Ek) Edge Microgateway'i herhangi bir Apigee Edge bağımlılığından tamamen bağlantısı olmadan çalıştırabilirsiniz. Bağımsız mod olarak adlandırılan bu senaryo, Edge Mikro Ağ Geçidi'ni internet bağlantısı olmadan çalıştırıp test etmenize olanak tanır. Bağımsız modda Running Edge Microgateway bölümüne bakın.

Tuşları iptal etme

(Ek 2.5.19) Edge Mikro Ağ Geçidi yapılandırması için anahtar ve gizli anahtar kimlik bilgilerini iptal eden yeni bir CLI komutu eklendi.

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

Docker desteği

(Ek 2.5.19) 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

(Ek 2.5.19) Edge Mikro Ağ Geçidi'ni bir hizmet veya Kubernetes kümesinde dağıtılan hizmetlerin önüne bir yardımcı ağ geçidi olarak dağıtabilirsiniz. Edge Mikro Ağ Geçidi'ni Kubernetes'e genel bakış ile entegre etme bölümüne göz atın.

TCP Nodelay seçeneği için destek

(2.5.16 sürümü 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ğerinin true olarak ayarlanması, bu davranışı devre dışı bırakır (socket.write() her çağrıldığında veriler hemen verileri tetikler). Daha ayrıntılı bilgi için Node.js belgelerini de inceleyin.

nodelay hizmetini etkinleştirmek için Edge Micro yapılandırma dosyasını şu şekilde 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

Sonsuza kadar izleme için yeni KSA seçenekleri

(Ek 2.5.12) edgemicro forever komutuna yeni parametreler eklendi. Bu parametreler forever.json dosyasının konumunu belirtmenize ve Sonsuza kadar arka plan işlemini başlatmanıza veya durdurmanıza olanak tanır. Sonsuza kadar izleme başlıklı makaleyi de inceleyin

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

Örnekler:

Sonsuza kadar başlatmak için:

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

Sonsuza kadar durdurmak için:

edgemicro forever -a stop

JWT anahtarı rotasyonu

Edge Mikro Ağ Geçidi'nde OAuth güvenliği için kullanılan JWT jetonlarını oluşturmak amacıyla kullanılan herkese açık/özel anahtar çiftlerini dönüşümlü yayınlamanızı sağlayan yeni bir özellik eklendi. JWT anahtarlarını döndürme bölümüne bakın.

İndirilen API proxy'lerini filtreleme

Edge Mikro Ağ Geçidi varsayılan olarak, Edge kuruluşunuzda "edgemicro_" adlandırma önekiyle başlayan tüm proxy'leri indirir. Bu varsayılan değeri değiştirerek, adı bir kalıpla eşleşen proxy'leri indirebilirsiniz. İndirilen proxy'leri filtreleme bölümüne bakın.

API proxy'leri olmadan ü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şkilendirilmiş 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ı destekler.

Sonsuza kadar izleme desteği

Edge Microgateway, Edge Microgateway'in kaç kez ve hangi aralıklarla yeniden başlatılması gerektiğini kontrol etmek için yapılandırabileceğiniz bir forever.json dosyasına sahiptir. Bu dosya, Always-monitor adlı ve Forever programatik olarak yönetilen bir hizmeti yapılandırır. Sonsuza kadar izleme başlıklı makaleye göz atın.

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

Birden fazla Edge Microgateway örneği çalıştırıyorsanız bu örneklerin 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 bölümüne bakın.

Daima CLI seçeneği için destek

(Yeni sürüm 2.5.8) 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

Komutu yeniden yüklemek için configUrl seçeneğinin eklenmesi

(Ek 2.5.8) Artık edgemicro reload komutuyla --configUrl veya -u seçeneğini kullanabilirsiniz.

JWT süre tutarsızlıkları için ek süre

(Ek 2.5.7) OAuth yapılandırmasındaki gracePeriod özelliği, sistem saatiniz ile JWT yetkilendirme jetonunda belirtilen Öncesinde Değil (nbf) veya Yayınlanma zamanı (iat) zamanları arasındaki 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 özellikleri bölümünü inceleyin.

(Ek 2.5.7) OAuth yapılandırmasındaki gracePeriod özelliği, sistem saatiniz ile JWT yetkilendirme jetonunda belirtilen Öncesinde Değil (nbf) veya Yayınlanma zamanı (iat) zamanları arasındaki 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 özellikleri bölümünü inceleyin.

Hatalar düzeltildi 2.5.x

  • (Sorun 236) Önbelleği temizlerken yapılan yazım hatasını düzeltin.
  • (Sorun 234) Edge Microgateway 2.5.35 için kilitlenmeleri yeniden yükleme.
  • (Sorun 135) -v seçeneği kullanılırken geçersiz sanal ana makine referansı "güvenli" 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 istediğiniz sayıda ve herhangi bir ad belirtebilirsiniz (artık varsayılan ve güvenli ile sınırlı değildir).
  • (Sorun 141) edgemicro restart komutu, -c yapılandırma dosyası seçeneğini desteklemiyor. Bu sorun düzeltildi.
  • (Sorun 142) Edge Microgateway, yükleme sırasında desteği sonlandırılmış şifrelemeden şikayet ediyor. Bu sorun düzeltildi.
  • (Sorun 145) Kota, Edge Mikro Ağ Geçidi ile çalışmıyor. Bu sorun düzeltildi.
  • (Apigee Topluluk sorunu: https://community.../../.com/questions/33149/emg-jwt-token-Validated-against- her-api-proxies-a.html#answer-33336) JWT jetonu hem API Proxy'lerine hem de OAUTH'taki Kaynak URI'sına göre doğrulandı. Bu sorun düzeltilmiştir.
  • (Apigee Topluluk 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.
  • (Sorun 157) Şu hata mesajına neden olan sorun düzeltildi: ReferenceError: deployProxyWithPassword tanımlanmadı.
  • (Sorun 169) Node.js bağımlılıklarını güncelleme (npm denetimi)
  • edgemicro-auth proxy'si artık Edge JWT politikalarını kullanıyor. Proxy, JWT desteği sağlamak için artık Node.js'ye bağımlı değildir.

Sürüm 2.4.x

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

1. Edgemicro ile kimlik doğrulama proxy'si (PR 116) için özel bir takma ad belirleyin

edgemicro-auth proxy'sinin varsayılan temel yolunu değiştirebilirsiniz. Temel yol varsayılan olarak /edgemicro-auth şeklindedir. Bunu değiştirmek için edgemicro yapılandırır komutundaki -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, temel bir /team/*/members yolu, müşterilerin yeni ekipleri desteklemek için yeni API proxy'leri oluşturmanıza gerek kalmadan https://[host]/team/blue/members ve https://[host]/team/green/members adreslerini çağırmasına olanak tanır. /**/ ifadesinin desteklenmediğini unutmayın.

Önemli: Apigee, temel yolun ilk öğesi olarak "*" joker karakterini kullanmayı DESTEKLEMEZ. Örneğin, şu DESTEKLENMEZ: /*/search.

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 dizinindedir. Artık başlatma, yapılandırma ve başlatma 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ı sorunu giderildi.

Örnek:

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

4. *_PROXY değişkenlerine saygı göster (PR 61)

Edge Microgateway bir güvenlik duvarının arkasına kurulmuşsa ve herkese açık bulutta Apigee Edge ile iletişim kuramıyorsa iki seçeneğiniz vardır:

1. Seçenek:

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

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

proxy_tunnel değeri 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ırmak için kullanılan ortam değişkenleri TLS etkinleştirilmişse de aynı durum söz konusudur.)

2. Seçenek:

İkinci seçenek, bir proxy belirtmek ve microgateway yapılandırma dosyasında proxy_tunnel değerini false olarak ayarlamaktır. Örneğin:

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

Bu durumda, kullanmak istediğiniz her bir HTTP proxy'nin ana makinelerini veya Edge Microgateway proxy'lerini işlememesi gereken ana makineleri kontrol etmek için şu değişkenleri ayarlayabilirsiniz: HTTP_PROXY, HTTPS_PROXY ve NO_PROXY. NO_PROXY alanını, Edge Microgateway'in proxy yapmaması gereken alanları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 aşağıdaki konulara bakın:

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


5. Hedef istekler için özel zaman aşımı süresi ayarlayın (PR 57)

Şu yapılandırmayla, hedef istekler için özel bir zaman aşımı süresi ayarlayabilirsiniz:

edgemicro:
    request_timeout: 10

Zaman aşımı, saniye cinsinden ayarlanır. Bir zaman aşımı oluşursa Edge Mikro Ağ Geçidi 504 durum koduyla yanıt verir.

6. Hedef yanıtta özel HTTP durum mesajlarına uyar (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ınmıştır.

7. X-Forwarded-For başlığı, analytics için client_ip değerini ayarlayabilir.

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

8. OAuth eklentisiyle ilgili değişiklikler

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

OAuth eklentileri iki yeni işaret ekler:

  • allowOAuthOnly -- true olarak ayarlanırsa her API'nin, Hamiline Ait Erişim Jetonu içeren bir Yetkilendirme başlığı taşıması gerekir.

  • allowAPIKeyOnly -- true olarak ayarlanırsa her API'nin, API Anahtarına sahip bir x-api-key başlığı (veya özel bir konum) taşıması gerekir.

Bu flag'leri 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. Uç mikro kimlik doğrulama proxy'si (PR 40) iyileştirildi

edgemicro-auth proxy'sinde iyileştirmeler yapıldı. Bu değişiklikler yapılmadan önce proxy'nin anahtarları, şifrelenmiş bir kasa olan Edge Secure Store'da depolanıyordu. Artık proxy, anahtarları Edge'in şifrelenmiş anahtar/değer haritasında (KVM) depoluyor.

10. Bir eklentide varsayılan hedef URL'yi 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 kodunuzda şu değişkenleri değiştirin: req.targetPort ve req.targetSecure. HTTPS'yi seçmek için req.targetSecure alanını true, HTTP için ise false olarak ayarlayın. req.targetSecure ayarını true olarak ayarlarsanız daha fazla bilgi için bu tartışma dizisini inceleyin.

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

Edge Mikro Ağ Geçidi'ni, 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>

Düzeltilen hatalar 2.4.3 sürümü

  • Edge mikro kimlik doğrulama proxy'sini düzgün bir şekilde çalıştırmak için ücretli bir kuruluşun gerekli olmasına neden olan sorun düzeltildi. Artık Edge Microgateway'i deneme kuruluşlarıyla da kullanabilirsiniz. (5. Halkla İlişkiler)
  • Akışın veri işlemeyi tamamlamamasına rağmen son işleyicilerin yine de yürütmesine neden olan sorun düzeltildi. Bu durum kısmi bir yanıtın gönderilmesine neden olmuştur. (71. PR)
  • Private Cloud yüklemeleri için özel yapılandırma dizininin tanınmaması sorunu düzeltildi. (PR 110)
  • İstemci ile Edge Mikro Ağ Geçidi arasındaki çift yönlü SSL ile ilgili bir sorun giderildi. (70 PR)
  • API anahtarı doğrulamasının düzgün çalışması için proxy temel yolunda sondaki bir eğik çizginin gerekli olmasına neden olan sorun düzeltildi. Artık, Basepath'in 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 mikro ağ geçidi duyarlı proxy'leri işleyeceğini filtreleyebilirsiniz. Edge Mikro Ağ Geçidi başladığında, ilişkili olduğu kuruluştaki mikro ağ geçidi duyarlı tüm 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 üç olarak sınırlandırır: edgemicro_proxy-1, edgemicro_proxy-2 ve edgemicro_proxy-3:

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

Analytics veri maskeleme

Yeni bir yapılandırma, istek yolu bilgilerinin Edge analizinde gösterilmesini engellemenizi sağlar. İstek URI'sını ve/veya istek yolunu maskelemek için mikro ağ geçidi yapılandırmasına aşağıdakileri ekleyin. URI'nın, 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 yoklamayı devre dışı bırakın

Mikro ağ geçidi yapılandırmasında şu özelliği ayarlayarak otomatik değişiklik yoklamayı devre dışı bırakabilirsiniz:

disabled_config_poll_interval: true

Varsayılan olarak periyodik yoklamalar; Edge'de yapılan değişiklikler, mikro ağ geçidi duyarlı proxy'ler vb. gibi değişikliklerin yanı sıra yerel yapılandırma dosyasında yapılan değişiklikleri de alır. Varsayılan yoklama aralığı 600 saniyedir (beş dakika).

Eklentilerde hedef URL'leri yeniden yazma

Eklenti kodunuzda 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 ek, 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'ler, ürünler ve JWT'nin JSON'unu atlıyor. Edge Mikro Ağ Geçidi'ni başlattığınızda DEBUG=* değerini ayarlayarak bu nesnelerin çıkışını varsayılan olarak ayarlayabilirsiniz. Örneğin:

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

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

Varsayılan olarak microgateway yapılandırma dosyası ./config/config.yaml biçimindedir. Başlatma, yapılandırma ve başlatma 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

Düzeltilen hatalar 2.3.3 sürümü

  • 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ığı gibi davranır.
  • Eklenti publish-request eklentisi artık GET istekleri için askıda kalmayacak.
  • Toplama yanıtı eklentisinde, yanıt gövdesi olmamasının hatalara neden olduğu bir sorun düzeltildi.

Sürüm 2.3.1

Yükleme notu

Edge Microgateway'in önceki bazı sürümleri, yazılımı ZIP dosyası indirerek yüklemenize olanak tanıyor. Bu ZIP dosyaları artık desteklenmiyor. Edge Mikro Ağ Geçidi'ni yüklemek için şunları kullanmanız gerekir:

npm install -g edgemicro

Daha ayrıntılı bilgi için yükleme konusuna bakın.

Yeni özellikler ve geliştirmeler s.2.3.1

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

Proxy'leri filtreleyin

Yeni bir yapılandırma, Edge Mikro Ağ Geçidi'nin başlangıçta hangi proxy'leri yükleyeceğini filtrelemenizi sağlar. Daha önce, mikro ağ geçidi, Edgemicro yapılandırma komutunda belirttiğiniz Edge kuruluştan/ortamından alınan tüm mikro ağ geçidi duyarlı proxy'leri (edgemicro_* adlı proxy'ler) yüklüyordu. Bu yeni özellik, Edge Mikro Ağ Geçidi'nin yalnızca sizin belirttiğinizleri yüklemesi için bu proxy listesini filtrelemenizi sağlar. Proxy öğesini şu şekilde microgateway yapılandırma dosyasına eklemeniz yeterlidir:

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

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

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

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

Eklentilerde hedef istek başlıkları ayarlama

Hedef istek üst bilgilerini eklemek veya değiştirmek isterseniz dikkate alınması gereken iki temel kalıp vardır: biri gelen isteğin veri içerdiği (POST isteğinde olduğu gibi) ve diğeri ise veri içermeyen (basit bir GET isteğinde olduğu gibi).

Gelen isteğin veri içerdiği ve hedef istekte istek başlıkları ayarlamak istediğiniz bir durum düşünelim. Edge Microgateway'in önceki sürümlerinde, bu durumda hedef üstbilgilerinin güvenilir şekilde ayarlanması mümkün değildi.

Bu kalıbın anahtarı, öncelikle 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.

Bunu nasıl yapacağınızı gösteren örnek eklenti kodu aşağıda verilmiştir. onend_request politikasında 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 onrequest() işleyicide hedef başlıkları ayarlayabilirsiniz. Bu kalıp yeni değildir. Daha önce belgelenmiştir ve Edge Microgateway ile birlikte sunulan ö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 sıfır yeniden yükleme özelliği

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

Bunlara ek olarak, üç 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çidi'nin çalışıp çalışmadığını kontrol eder.
  • edgemicro stop - Edge Microgateway kümesini durdurur.
  • edgemicro reload - Edge Mikro Ağ Geçidi yapılandırmasını kapalı kalma süresi olmadan yeniden yükler.

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

Edge Microgateway, düzenli olarak yeni bir yapılandırma yükler ve herhangi bir değişiklik olursa yeniden yükleme işlemi gerçekleştirir. Yoklama, Edge'de yapılan değişikliklerin (ürünler, mikro ağ geçidi duyarlı proxy'ler vb.) yanı sıra yerel yapılandırma dosyasında yapılan değişiklikleri de alır. Varsayılan yoklama aralığı 600 saniyedir (beş dakika). microgateway yapılandırma dosyasındaki varsayılan değeri aşağıdaki gibi değiştirebilirsiniz:

edgemicro:
    config_change_poll_interval: [seconds]

KSA'ya sürüm bilgisi eklendi

KSA'ya --version işareti eklendi. Edge Microgateway'in geçerli sürümünü edinmek için şu komutu kullanın:

edgemicro --version

Yeni Edge Mikro Ağ Geçidi sunucusu SSL seçenekleri

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

Option Açıklama
pfx İstemcinin özel anahtarını, sertifikasını ve CA sertifikalarını PFX biçiminde içeren pfx dosyasının yolu.
passphrase Özel anahtar veya PFX parolasını içeren bir dize.
ca PEM biçimindeki güvenilir sertifikaların listesini içeren bir dosyanın yolu.
ciphers Kullanılacak şifreleri açıklayan, ":" ile ayrılmış bir dize.
rejectUnauthorized True (doğru) değerine ayarlanırsa sunucu sertifikası, sağlanan CA listesine göre 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, SSLv3_method [SSL'yi sürüm 3'e zorlamak için].
servername SNI (Sunucu Adı Göstergesi) TLS uzantısının sunucu adı.

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

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

edgemicro:
  logging:
    to_console: true  

Günlük dosyalarını yönetme bölümüne bakın.

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

Özel bir kimlik doğrulama hizmetinin kullanımını destekleyen yetkilendirme proxy'si için 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 sayfasına göz atın.

Sürüm 2.1.1

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

Yetkilendirme proxy'sini platformlar arası uyumlu olarak dağıtma

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

Sürüm 2.1.0

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

Yeni özellikler ve geliştirmeler aşağıda verilmiştir:

İstemci SSL/TLS seçeneklerini belirtme

Yeni bir yapılandırma seçeneği grubu kullanarak, hedeflerle kurulan SSL/TSL bağlantıları için istemci seçenekleri belirtebilirsiniz. İstemci SSL/TSL seçeneklerini kullanma bölümüne bakın.

Sürüm 2.0.11

Sürüm 2.0.11 yükleme notu

Edge Microgateway'in önceki bazı sürümleri, yazılımı ZIP dosyası indirerek yüklemenize olanak tanıyor. Bu ZIP dosyaları artık desteklenmiyor. Edge Mikro Ağ Geçidi'ni yüklemek için şunları kullanmanız gerekir:

npm install -g edgemicro

Daha ayrıntılı bilgi için yükleme konusuna bakın.

Yeni özellikler ve geliştirmeler s.2.0.11

Yeni özellikler ve geliştirmeler aşağıda verilmiştir:

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

Başlat komutu, yapılandırma dosyasında belirtilen bağlantı noktasını geçersiz kılacak bir bağlantı noktası numarası belirtebilmenizi sağlar. PORT ortam değişkenini kullanarak da bir bağlantı noktası numarası belirtebilirsiniz. Ayrıntılı bilgi için start komutuna bakın.

İsteğe bağlı olarak yetkilendirme üstbilgilerini koruyun

Yeni bir yapılandırma ayarı olan keepAuthHeader, istekte gönderilen Yetkilendirme üst bilgisini korumanıza olanak tanır. Doğru değerine ayarlanırsa Auth başlığı hedefe aktarılır. oauth özellikleri bölümünü inceleyin.

Özel yetkilendirme hizmeti kullanabilme

Kimlik doğrulama işlemi 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 sayfasına göz atın.

Sürüm 2.0.4

Edge Microgateway v.2.0.4, 25 Mayıs 2016'da yayınlandı.

Yeni özellikler ve geliştirmeler 2.0.4 sürümü

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ı, proxy yolu son ekine göre API'lere erişimi kısıtlamanızı sağlar. Ürün oluşturma ve kaynak yollarını yapılandırma hakkında ayrıntılı bilgi için API ürünleri oluşturma bölümüne bakın.

npm global yükleme desteği

Artık npm -g (global) seçeneğini kullanarak Edge Mikro Ağ Geçidi'ni 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 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şlemli sunucu

Edge Microgateway artık tek işlemli bir sunucu. Artık iki süreçli bir model kullanmamaktadır. Bu modelde bir işlem (daha önce "aracı" olarak biliniyordu) Edge Microgateway'i, ikinci süreci başlatır. Yeni mimari, otomasyonu ve container mimarisine alma sürecini kolaylaştırıyor.

Adlandırılmış yapılandırma dosyaları

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

Yeni ortam değişkenleri

Şu anda 4 ortam değişkeni vardır: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY, EDGEMICRO_SECRET. Sisteminizde bu değişkenleri ayarlarsanız Edge Mikro Ağ Geçidi'ni yapılandırmak ve başlatmak için Komut Satırı Arayüzü'nü (CLI) kullanırken bunların değerlerini belirtmeniz gerekmez.

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

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

Küme modu

Artık Edge Mikro Ağ Geçidi'ni küme modunda başlatma seçenekleri vardır. Küme modu, çok çekirdekli sistemlerden yararlanmanızı sağlar. Mikro ağ geçidi bu özellik için Node.js küme modülünü kullanır. Ayrıntılı bilgi için Node.js belgelerini inceleyin.

Düzeltilen hatalar 2.0.0 sürümü

Eklenti etkinlik yaşam döngüsü artık yeni bir geri çağırmayla kod 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 Artışı

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

Uzaktan hata ayıklayıcı desteği

Edge Mikro Ağ Geçidi'ni düğüm inceleyici gibi bir uzaktan hata ayıklayıcıyla çalışacak şekilde yapılandırabilirsiniz.

Yeni yapılandırma dosyası konumu

Edge Mikro Ağ Geçidi'ni yapılandırdığınızda agent/config/default.yaml dosyası artık ~./edgemicro/config.yaml öğesine kopyalanır.

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

Yeni bir yapılandırma özelliği, Edge Microgateway günlükleri için bir döndürme aralığı belirtmenizi sağlar.

Düzeltilen hatalar v1.1.2

Aşağıdaki hatalar 1.1.2 sürümü ile düzeltilmiştir.

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