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

25 Nisan 2024'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.3 ile ilişkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway çekirdek yapılandırma eklentiler 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 temel işlevini veya hedef URL'leri yeniden yazma özelliğini etkilemez. Daha fazla bilgi için Eklentilerdeki hedef URL'leri yeniden yazma bölümüne bakın.

283947053 Kaldırıldı

forever-monitor için sağlanan destek, Edge Microgateway'den kaldırıldı. forever-monitor değerini PM2 ile değiştirebilirsiniz. Ayrıntılar için şu Apigee Topluluğu gönderisine göz atın: Edgemicro + PM2: Edgemicro'yu hizmet olarak kullanmaya başlama.

Güvenlik sorunları giderildi

  • 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üzeltme 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ı listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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. 3.3.2 sürümünden itibaren, Edge Microgateway CLI komutları yalnızca desteklenen sürümlerde çalışmaktadır. Desteklenmeyen sürümlerde CLI komutları çalıştırmak hatayla sonuçlanır. Ayrıca Apigee tarafından desteklenen yazılımlar ve desteklenen sürümler başlıklı makaleye 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 bir 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ü çekmesine yol açan 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 oluşturuyoruz.

Güvenlik sorunları giderildi

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şkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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ırma yapılmaya çalışılı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ına neden olan bir 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 iletebilirsiniz.

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 sayfasına bakın.

Güvenlik sorunları giderildi

Sorun Kimliği Açıklama
CVE-2021-23413 Bu, 3.7.0'dan önceki paket jszip dosyasını etkiler. Nesne prototip değerlerine (ör. proto, toString vb.) ayarlanmış dosya adlarına sahip yeni bir zip dosyası oluşturmak, değiştirilmiş 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şkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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 çalıştırıldığında apigeetool, 0.15.2 sürümüne yükseltilir ve bu durum edgemicro upgradeauth komutunu etkiler.

npm audit fix yürütür ve ardından edgemicro upgradeauth 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 için 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 Microgateway'in 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 analizinde görülen yanıt kodunun, Edge Microgateway yanıt koduyla eşleşmediği 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ının değişmesi durumunda anahtarı da güncelliyor. Önceden, bir IDP'nin ortak anahtarı değiştiğinde extauth eklentisi, Edge Microgateway'i yeniden yüklemeden ortak anahtarı güncelleyemiyordu.
168713541 Böcek

Dokümanlar, birden fazla hedef için TLS/SSL'nin nasıl yapılandırılacağını açıklayacak ş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 bakın.

157908466 Böcek

Edge Microgateway'in belirli bir sürümünün nasıl yükleneceğini doğru bir şekilde açıklamak 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 anahtarları komutunun bir 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 düzeyi 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ü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ı listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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 katı dosya izinlerini gevşetmenize olanak tanır. Ayrıntılı bilgi için Günlük dosyası izinlerini gevşetme başlıklı makaleyi inceleyin.

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 kapanırsa Edge Microgateway'in nasıl davranacağını kontrol etmenizi sağlar. Ayrıntılar için edgemicro özellikleri konusuna bakın.

148062415 Böcek Docker container bağlamında Edge Microgateway'in docker stop {containerId} komutuyla düzgün bir şekilde kapanmadığı bir sorun düzeltildi. İşlem sonlandırıldı ancak .sock ve .pid dosya kaldırılmadı. Şimdi dosyalar kaldırılır ve aynı container'ı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 kalması sorunu düzeltildi. Bu sorun aralıklı olarak gerçekleşti ve trafiğin yoğun olduğu durumlarda ortaya çıktı. Sorun, OAuth eklentisinin tokenCache ve cacheKey özellikleri kullanıldığında ortaya çıktı.
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ı giderildi

Sorun Kimliği Açıklama
CVE-2020-28503 2.0.5'ten önceki paket kopyası öğeleri, ana işlevlerden dolayı Prototip Kirliliğine karşı savunmasızdır.
CVE-2021-23343 Paket yolu ayrıştırma işleminin tüm sürümleri, splitDeviceRe, splitTailRe ve splitPathRe normal ifadeleri aracılığıyla Normal İfade Hizmet Reddi (ReDoS) güvenlik açığına karşı savunmasızdır. ReDoS, polinom için en kötü durum zamanı karmaşıklığını ortaya koyuyor.

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 bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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 The OAuth 2.0 Yetkilendirme Çerçevesi ile uyum için expires_in yapılandırma parametresi için beklenen değer dizeden tamsayıya 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 bölümüne bakı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 container'ı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 hedefine gönderilmesini engellemek 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, Docker container'ında edgemicro.sock ve edgemicro.pid dosyalarının oluşturulması gereken dizin yolunu belirtmenize olanak tanır. Edge Microgateway için Docker'ı kullanma sayfasına bakın.

191352643 Öne Çıkarın Edge Microgateway için Docker görüntüsü, NodeJS 12.22 sürümünü kullanacak şekilde güncellendi. Edge Microgateway için Docker'ı kullanma sayfasına bakın.

Güvenlik sorunları giderildi

Sorun Kimliği Açıklama
CVE-2021-28860 Node.js mixme'de, sürüm 0.5.1'den önce bir saldırgan, "__proto__" aracılığıyla mutate() veMerge() işlevleriyle bir nesnenin özelliklerini ekleyebilir veya değiştirebilir. Devre dışı bırakılan özellik, programdaki her nesneye doğrudan atanır. Bu durum, programın kullanılabilirliğini riske atarak 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 edilir. NOT: Bilinen bir pratik saldırı yoktur.
CVE-2021-23358 Paket, 1.13.0-0 arasında ve 1.13.0-2'den önce, 1.3.2'den ve 1.12.1'den önce alt çizgiye sahiptir. Özellikle de 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ştirme güvenlik açığına 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 başlangıcı bazı dizelerde eksponansiyel geri izlemeye neden olabiliyordu. Bu sorun, hizmet reddine yol açabilir. Soruna 3.1.1 sürümünde yama eklenmiştir.
CVE-2020-8174 Docker görüntüsü, Node.js 12.22 sürümünü kullanacak şekilde güncellendi

3.2.1

5 Mart 2021 Cuma günü Edge Microgateway'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ı listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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 yol açtığı bir sorun düzeltildi.

jwkPublicKeys işlevinde null değerin iletilmesini önlemek için null koşulu artık işlenmektedir.

Not: Bu düzeltme, edgemicro-auth proxy'sini yeni sürüme geçirmenizi gerektirir.

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

Edge Microgateway işlemleri için Apigee Edge hata kodu analizi kontrol panelinde yanlış hedef hata sayıları gösteriliyordu. Hedef hatalarla ilgili hata kodları proxy hataları olarak sayılıyordu. Bu sorun düzeltildi ve artık doğru hedef hata 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. JWT'de listelenen API ürünlerini filtrelemek üzere bu özelliği kullanmak için:

  1. Apigee proxy düzenleyicisinde edgemicro-auth proxy'sini açın.
  2. allowProductStatus özelliğini SetJWTVariables politikasının XML'sine ekleyin ve filtre uygulamak için 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.

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 anahtar değerlerinin, mikro ağ geçidi başlatıldıktan sonra 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 iletilirse 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 eklentisiyle ilgili bir doküman hatası düzeltildi.

apikeys eklentisinin README dosyası, yanlış bir şekilde gracePeriod özelliği içeriyordu. Bu özelliği ve açıklamasını BENİOKU öğesinden 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 yönelik tüm GET istekleri için yükün düşmesiyle ilgili bir sorun giderildi.

İstediğiniz davranışı yeni bir yapılandırma parametresi olan edgemicro: enable_GET_req_body ile kontrol edebilirsiniz. true olarak ayarlandığında, transfer-encoding: chunked istek başlığı tüm GET isteklerine eklenir ve varsa GET yükü hedefe gönderilir. false ise (varsayılan) 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ığı için 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şkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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, sonraki eklentiler tarafından kullanılabilir.
168836123, 172295489, 176462355, 176462872 Öne Çıkarın Node.js 14 desteği 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 değerini döndürdüğü bir sorun düzeltildi. Ancak, OAuth Spesifikasyonu uyarınca bu, refresh_token_expires_in zaman birimiyle (saniye cinsinden) tutarlı olmalıdır.

Düzeltme, geçerlilik bitiş 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ın yenilenmesi için milisaniye cinsinden expires_in değerini kullanıyorsa bu düzeltmenin istemcilerde değişiklik yapılmadan uygulanması çok daha sık ve gereksiz yenilemelere neden olur. Orijinal davranışı korumak için bu istemcilerin zaman birimi değişikliğini hesaba katacak şekilde değiştirilmesi gerekir.

Müşteriler, jeton yenileme süresini değerlendirmek için her zaman JWT jetonundaki değerleri kullandıysa istemcileri değiştirmeleri gerekmez.

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

Bu sorun, yüksek yük boyutu isteklerinde ara sıra gözlemlenen ve sorun 3.1.7 sürümünde ortaya çıkmıştır.

174640712 Böcek Eklentilere doğru veri işleme ekleyin.

Doğru veri işleme özelliği şu eklentilere 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şkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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ış ayrıştırıldı.

Ortam değişkeni değiştirme işlemi, tüm değerleri dize olarak ayrıştırdı. Bu da boole veya sayısal değerler için ayrıştırma hatalarının ortaya çıkması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ğerlerine sahip yapılandırma özelliklerini ayarlama bölümüne bakın.

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

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 edinmek için Ortam değişkeni değerlerine sahip 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 kapsamları tanımlanmadan JWT'ler oluşturur. Bunun nedeni iki farklı senaryodur: 1) /token akışına giden istek yükü, kapsam parametresini geçemedi veya 2) /token akışına istek yükünde geçersiz kapsam geçirildi. Apigee Edge'deki API ürünlerinde tanımlanan tüm kapsamların döndürülmesi 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 eklentiler tarafından nasıl erişilebilir hale getirildiğini görmek için Eklenti init() işlevi hakkında bölümüne bakın.

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

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ına kaydedilmez. Anahtar ve gizli anahtar, önbellek yapılandırma dosyasına daha önce yazılmışsa kaldırılır.

170708621 Öne Çıkarın Analiz 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, Analytics 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 boş 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ının doldurulması için 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şkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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ındaki boş yanıtı yanlış işledi ve ç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 jetondan kaynaklanan 401 yanıtlarıyla Analytics'te doldurulmamış.

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ümü ile çalıştırmak, istek yükünü dönüştüren eklentiler yürütülü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şlevi çalışmıyor.

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

166517190 Böcek jwk_public_keys verileri, Synchronizer tarafından depolanıp 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österdi.

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 şekilde işler ve "izin ver" ile "reddet" bölümlerinin sırasına uyar. 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 README Eklentisi'ne 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 bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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 Anahtarları döndürme başlıklı makaleyi inceleyin.

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 Anahtarları döndürme başlıklı makaleyi inceleyin.

145525133 Alfa özelliği Yeni eklenti metrikleri

Ayrıntılar için GitHub'da Yeni eklenti metrikleri BENİOKU bölümüne 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 yolla yapılandırıldığını varsayalım: /hello/v1 ve hedef yol https://mocktarget.apigee.net. Ş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 temel yolu doğru şekilde eşleştiği için çözülen yol doğrudur.
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 bir 404 hatası atmış olmalıdır. 3.1.6 ve sonraki sürümlerde bu durumda 404 hatası verilir.
160431789 Böcek Özel Eklentiler - init'e geçirilen yapılandırma nesnesi doldurulmuyor

Apigee Edge yapılandırması, Edge Microgateway yapılandırma dosyasıyla birleştikten sonra tüm özel eklentiler için yapılandırma nesnesinde kullanıma sunulur. config konusuna bakın.

162758808 Böcek Redis yedekleme deposu için yeni kota yapılandırması

Kotalar için bir Redis yedekleme 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 göz atı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şkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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ç tutacak 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 Content-Type başlıkları oluşturduğu ve bazı durumlarda başlıkların beklendiği gibi hedefe 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ındaki 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 saklanır ve orijinal yapılandırmada veya önbellek dosyalarında saklanmaz. Ayrıntılar için Ortam değişkeni değerlerine sahip yapılandırma özelliklerini ayarlama bölümüne bakın.

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

Hedef ana makinenin, fazladan iki nokta işareti eklenmiş günlüklerde görünmesine yol açan bir sorun düzeltildi.

153673257 Böcek

(Yalnızca Private Cloud için Edge) Microgateway uyumlu ürünler çekilmedi

Mikro ağ geçidine duyarlı ürünlerin çekilmediği bir sorun düzeltildi. Bu sorun yalnızca Private Cloud yüklemeleri için Edge'de oluşmuştur.

154956890, 155008028, 155829434 Öne Çıkarın İndirilen ürünlerin özel özelliklere göre filtrelenmesi için destek

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

Hatayı yakalamak ve konsolda bir mesaj yazdırmak için istisna işleme 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ü, Edge Microgateway'de aşağıdaki düzeltmeyi yayınladık.

Hata düzeltmesi:

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 bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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 - Günlük çıktısında iki farklı işlem için aynı ileti kimliğinin yazdırılmasıyla ilgili bir sorun düzeltildi.
  • 151673570 - Edge Microgateway'in yeni Apigee KVM API'lerini kullanacak şekilde güncellenmemesi sorunu 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 yolu eşlemesinin işlenmesi Apigee Edge'inkiyle eşleşecek şekilde güncellendi. Bu sürümde, /literal_string/* kalıbının doğru şekilde işlenmemesine neden olan bir sorun düzeltildi. Ö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 bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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 Microgateway ile arka uç hedefleri arasındaki trafiğe HTTP proxy desteği eklemek için özellik iyileştirmesi yapıldı. Ek olarak, Edge Microgateway ve Apigee Edge arasındaki mevcut HTTP proxy desteği ile ilgili sorunlar 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ın daha hızlı kapatılması için iyileştirme yapıldı.
  • 151588764 - Node.js v8 kullanımdan kaldırıldığı için Docker container'ında Edge Microgateway ç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şkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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şkenlerini dikkate almaması sorunu düzeltildi. Bu değişiklikle birlikte, belirtilmesi durumunda YAML yapılandırma dosyasındaki proxy ayarları 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 yanlışlıkla bağlantıyı 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 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 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 bayrağı tetiklendiğinde "UYAR" düzeyinde yeni bir etkinlik kaydedilir. Kota işleme hatası oluşursa veya Edge'e yapılan "kota uygulama" isteği uzak kota sayaçlarını güncelleyemezse bu işaret tetiklenir. Bu durumda kota, yalnızca bir sonraki başarılı uzaktan kota senkronizasyonu gerçekleşene kadar 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 etkilenmesine neden olan bir sorun düzeltildi. Artık bir proxy'de değişiklik yapıldığında, Edge Microgateway önbelleği yeniler ve çalışma düğümleri yeniden başlatılır. Bu değişiklikle, hazırlık aşamasındaki işlemler ve mikro ağ geçidine gönderilen yeni API çağrıları bu değişiklikten etkilenmeyecektir.
  • 146378327 - sourceRequest, targetRequest ve targetResponse günlük düzeyi, INFO (Bilgi) düzeyine dönüştürüldü.
  • 146019878 - Edge analizindeki "API Proxy Performance" (API Proxy Performansı) ve 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 şekilde aşağıdaki kaynak yolu eşleştirme kalıplarını desteklemek üzere 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ştirmesini 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 bulunan boşlukların, OAuth jetonu ve API anahtarı istekleri için JWT ürün listesinin boş olmasına yol açan 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. Mikro ağ geçidi örneklerinin Apigee Edge ile iletişim kurmaya gerek kalmadan 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şkili bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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 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 bu ürünü, aşağıdaki ekran görüntüsünde gösterildiği gibi proxy'nin Geliştirici Uygulaması'na eklemeniz gerekir:

    alt_text

    Not: "/", "/*" ve "/**" kaynak yolunun davranışını yapılandırma bölümünde açıklanan features.isSingleForwardSlashBlockingEnabled yapılandırma özelliği, Edge Microgateway için desteklenmez.

  • 143740696 - quotas yapılandırma yapısı değişti (ayrıca sürüm 3.0.9 için sürüm notlarına da bakın). quotas özelliği, kota eklentisini yapılandırmak için kullanılır. Yapıdaki değişiklik, yapılandırma öğelerinin daha anlaşılır olması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 olarak adlandırıldığını unutmayın. 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. Doğru olduğunda kota yalnızca Redis'e bağlanan Edge Microgateway örnekleriyle sınırlıdır. Yanlış değeri döndürülürse yedek depolama olarak volos-quota-apigee modülü kullanılır ve kota sayacı global olur. Ayrıntılar için Kota için yapılandırma seçenekleri bölümünü inceleyin. Ö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 geçerlilik süresi 108.000 milisaniye (1,8 dakika) iken 1800 saniye (30 dakika) olarak değiştirildi.
  • 143551282 - SAML özellikli 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ızı sağlar. 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 bağımsız bileşen projelerinin sürüm numaraları listelenmektedir. Her bileşen ayrı bir proje olduğundan sürüm numaralarının ana ürün sürümüyle eşleşmeyebileceğini unutmayın:

microgateway ç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 "başarısız açılma" ö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 bayrağının adı oauth-failed-open olarak değiştirildi.

  • 142093764 - Kota aşımlarını önlemek için edgemicro-auth proxy'sinde yapılandırma değişikliği yapıldı. Değişiklik, kota türünü 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 gerekiyor.
  • 142520568 - Kota yanıtlarında MP (mesaj işlemci) 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 daha yeni 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 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 "açılamadı" özelliği eklendi. Bu özellik, edgemicro-auth proxy'sine başarılı bir API anahtarı doğrulama çağrısını engelleyen bir bağlantı hatası nedeniyle süresi dolan bir JWT jetonu yenilenemiyorsa API işlemenin devam etmesine olanak tanır.

    Bu özellik, eski jetonun önbellekte kaldığı ve ek süre dolana kadar yeniden kullanıldığı bir ek yayınlanma süresi ayarlamanıza olanak tanır. Bu özellik, geçici bir bağlantı hatası durumunda Edge Microgateway'in istekleri işlemeye devam etmesine olanak tanır. Bağlantı devam ettirildiğinde ve başarılı bir Doğrulama API Anahtarı ç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 dizede aşağıdaki özellikleri ayarlayın:
      oauth:
        failOpen: true
        failopenGraceInterval: time_in_seconds
        cacheKey: true
        ...

      Örneğin:

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

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

  • 141168968 - Tüm eklenti günlüğü çıkışlarına correlation_id öğesini dahil etmek için 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 fiyat 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ü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 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 güncelleme yapıldı. Önceden, eklenti 200 olmayan durumların tümünde 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ülecektir.

    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 yeni bir yapılandırma özelliği eklendi: quota.quotaUri. Kotaları, kuruluşunuza dağıtılan edgemicro-auth proxy'si üzerinden yönetmek istiyorsanız bu yapılandırma özelliğini ayarlayın. Bu özellik ayarlanmazsa kota uç noktası varsayılan olarak dahili Edge Microgateway uç noktası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üncellendi. quotaUri özelliğini kullanmak için en yeni edgemicro-auth proxy'sine yükseltmeniz gerekir. Ayrıntılar için Edgemicro-auth proxy'yi yeni sürüme geçirme sayfasına göz atın.

  • 140470888 - Kimlik doğrulama sağlamak için kota çağrılarına 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 bulunduğundan artık kota tanımlayıcısına gerek yoktur.
  • 140823165 - Şu tesis adı:
    edgemicro:
        keepAliveTimeout

    3.0.6 sürümünde yanlış bir şekilde belgelendiğini varsayalım. Doğru özellik adı şudur:

    edgemicro:
        keep_alive_timeout
  • 139526406 - Geliştirici uygulamasının birden fazla ürünü olması durumunda kota sayısının yanlış olmasına yol açan hata düzeltildi. Kota, artık birden fazla ürün içeren uygulamalardaki her ürün için doğru şekilde uygulanıyor. 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üzeltmeleri ve geliştirmeleri yayınladık.

  • 138633700 - keepAliveTimeout adlı yeni yapılandırma özelliği 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 yapılandırma özelliği (quotaUri) eklendi. Kotaları, kuruluşunuza dağıtılan edgemicro-auth proxy'si üzerinden yönetmek istiyorsanız bu yapılandırma özelliğini ayarlayın. Bu özellik ayarlanmazsa kota uç noktası varsayılan olarak dahili Edge Microgateway uç noktası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 göz atı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üzeltmeleri 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 info, warn ve error günlük düzeyleri kullanılabilir.
  • 139064616 - Günlük çıkışı tüm konsol günlük ifadeleri için standart hâle 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ını ve gizli anahtarla ilgili günlük mesajlarını iyileştirin: cert, verify, upgradekvm, token, genkeys, cancelkeys, modelini döndürme ve yapılandır.
Zaman aşımı ve bağlantı reddedildi hata mesajı iyileştirmeleri
  • 138413577 - Arka uç hizmeti zaman aşımları için hata işleme ekleme ve iyileştirme.
  • 138413303 - Yanıt ve yuva zaman aşımları için hata işleme ekleme ve iyileştirme.
  • 138414116 - "Bağlantı reddedildi" hataları için hata giderme işlemi ekleme ve iyileştirme.

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 Microgateway kimlik doğrulamasında iyileştirmeler.
  • 137582169 - İstenmeyen işlemlerin başlatılmasına ilişkin bir sorun giderildi. Fazladan 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 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ı.
    • Merkezi günlük kaydı işlevi kullanmak için konsol günlükleri güncellendi.
  • 138321133, 138320563: Gelecekteki kota geliştirmelerini etkinleştirmek için kota arabelleğinde yapılan temel dahili değişiklik.

3.0.3

23 Temmuz Salı günü, Edge Microgateway'de aşağıdaki düzeltmeleri 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 bilgileri şunları içerir:
    • 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.
    • ClientId.
    • 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 satır sonu işaretçisi.

    Boş özellik değerleri boş köşeli 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 düzeltilmiştir. Tüm Apigee Edge Microgateway modülleri bu sürece dahil edildi. microgateway-config, microgateway-core, microgateway-plugins ve microgateway için 28 Haziran ile 2 Temmuz tarihli kayıtları inceleyin. Kod kalitesi değişiklikleri içeren tüm modüller, müşteri kullanım alanları için Edge Microgateway'in yürütülmesini doğrulayan dahili araçlarla test edilmiştir.

3.0.1

21 Haziran 2019 Cuma günü, Edge Microgateway'de 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 deneysel)
  • 134751883 - Yük altında yeniden yükleme sırasında Edge Microgateway çöküyor
  • 134518428 - Filtre kalıbı yanlışsa Edge Microgateway için ürün uç noktası değeri 5XX değerini döndürür
  • 135113408 - Beklenmedik bir şekilde işten ayrılan çalışanlar yeniden başlatılmalıdır
  • 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 birlikte verilen hatırlanan modülü kullanın
  • 135367906 - Güvenlik denetimi

Sürüm 2.5.x

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

(Sabit 2.5.38, 07.06.2019)

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

(2.5.37'de 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 OAuth jetonu belirtmenize olanak tanır. Ayrıca bkz. Sertifikaları yönetme.

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

mgdebug işaretini edgemicroctl ile kullanabilirsiniz. Kubernetes entegrasyon görevleri bölümünü de inceleyin.

(2.5.35'te Eklendi) edgemicroctl için bir Windows derlemesini etkinleştirin.

(2.5.31'de Eklendi) Yeni Edgemicro-auth/token API

İstemciyi/sırrı Base64 Kodlanmış Temel Yetkilendirme başlığı olarak iletmenize olanak veren yeni bir Edgemicro-auth/token API'si eklendi. Doğrudan hamiline ait jeton alma konusuna bakın.

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

Edge Microgateway'in Private Cloud'da uçta OAuth2 erişim jetonu kullanacak şekilde yapılandırılmasının düzgün çalışmaması (jetona uyulmadığı) bir sorun düzeltildi.

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 bir Docker container'ı çalıştırırken NODE_EXTRA_CA_CERTS parametresini kullanabilirsiniz. Ayrıntılar için Node.js'nin güvenmediği bir CA kullanma bölümünü inceleyin.

Docker: TLS desteği

(Ek 2.5.29) Docker container'ında çalışan Edge Microgateway, artık Edge Microgateway sunucusuna gelen istekler (kuzeydeki istekler) ve Edge Microgateway'den bir hedef uygulamaya giden istekler (güne bağlı istekler) için TLS'yi desteklemektedir.

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

Bu örneklerde, sertifikaları yüklemek için /opt/apigee/.edgemicro container ekleme noktasını nasıl kullanacağınızı göreceksiniz. Bu noktalar, Edge Microgateway yapılandırma dosyasında başvurulacaktır.

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

(Ek 2.5.27'de eklendi) Edge Microgateway'i bir 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ı

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

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

(Ek 2.5.27) upgradekvm komutuyla OAuth jetonu kullanabilirsiniz. Ayrıntılar için KVM'yi Yeni Sürüme Geçirme 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 bir 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 edinmek için Yerel proxy modunu kullanma başlıklı makaleye göz atın.

Bağımsız modu kullanma

(Ek 2.5.25) Tüm Apigee Edge bağımlılıklarından tamamen bağlantısız olarak Edge Microgateway'i çalıştırabilirsiniz. Bağımsız mod olarak adlandırılan bu senaryo, Edge Microgateway'i 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.

Anahtarları iptal etme

(Ek 2.5.19) Edge Microgateway 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 konusuna 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 Microgateway'i bir hizmet veya Kubernetes kümesinde dağıtılan hizmetlerin önüne bir yardımcı ağ geçidi olarak dağıtabilirsiniz. Edge Microgateway'i Kubernetes ile entegre etmeye genel bakış sayfasını inceleyin.

TCP Nodelay seçeneği için destek

(2.5.16'da Eklendi) Edge Micro yapılandırmasına yeni bir yapılandırma ayarı (nodelay) eklendi.

Varsayılan olarak TCP bağlantıları, verileri göndermeden önce arabelleğe almak için Nagle algoritmasını kullanır. nodelay öğesinin true değerine 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 dokümanlarına da bakın.

nodelay özelliğini 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

Kalıcı 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 belirtmenizi ve Sonsuza kadar arka plan işlemini başlatmanızı veya durdurmanızı sağlar. Ayrıca Sonsuza kadar izleme konusuna bakın

ParametreAçıklama
-f, --fileforever.json dosyasının konumunu belirtir.
-a, --actionstart veya stop. Başlangıç, varsayılan değerdir.

Örnekler:

Sonsuza kadar başlamak için:

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

Sonsuza kadar 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 için kullanılan herkese açık/özel anahtar çiftlerini döndürmenizi sağlayan yeni bir özellik eklendi. JWT anahtarlarını döndürme konusuna bakın.

İndirilen API proxy'lerini filtreleme

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

Ürünleri API proxy'si olmadan 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. 2.5.4 sürümünden itibaren Edge Microgateway bu ürün yapılandırmasını desteklemektedir.

Sonsuza kadar izleme desteği

Edge Microgateway'de, 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ı vardır. Bu dosya, Always-monitor adlı ve Forever programatik olarak yönetilen bir hizmeti yapılandırır. Süresiz izleme konusuna bakın.

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

Birden fazla Edge Microgateway örneği çalıştırıyorsanız bu örnekleri 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 sayfasını inceleyin.

Daima KSA seçeneği desteği

(Ek 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ği eklendi

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

JWT süresi 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 Önce 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 sayfasına göz atın.

(Ek 2.5.7) OAuth yapılandırmasındaki gracePeriod özelliği, sistem saatiniz ile JWT yetkilendirme jetonunda belirtilen Önce 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 sayfasına göz atın.

Hatalar düzeltildi v2.5.x

  • (Sorun 236) Önbelleği temizlerken yapılan yazım hatası düzeltildi.
  • (Sorun 234) Edge Microgateway 2.5.35 için yeniden yükleme çöküyor.
  • (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 olanlarla 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 kullanımdan kaldırılmış şifrelemeden şikayet ediyor. Bu sorun düzeltildi.
  • (Sorun 145) Kota, Edge Microgateway ile çalışmıyor. Bu sorun düzeltildi.
  • (Apigee Community sorunu: https://community.apigee.com/questions/33149/emg-jwt-token-verifyd-against-both-api-proxies-a.html#answer-33336) OAUTH'taki hem API proxy'lerine hem de Kaynak URI'sına göre doğrulanan JWT jetonu. Bu sorun düzeltildi.
  • (Apigee Topluluğu sorunu: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html) Microgateway OAuth ile çalışmıyor. Bu sorun düzeltildi.
  • Windows'da pidPath'i düzeltin.
  • (Sorun 157) Şu hata mesajına yol açan sorun düzeltildi: ReferenceError: deployProxyWithPassword tanımlanmamış.
  • (Sorun 169) Node.js bağımlılıklarını güncelleme (npm denetimi)
  • edgemicro-auth proxy'si artık Edge JWT politikalarını kullanmaktadır. Proxy artık JWT desteği sağlamak için Node.js'yi kullanmaz.

Sürüm 2.4.x

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

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

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

Örnek:

edgemicro configure -x /mypath …


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

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

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

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

Varsayılan olarak mikro ağ geçidi yapılandırma dosyası ./config/config.yaml dizinindedir. Başlatma, yapılandırma ve başlatma komutlarında artık -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 uy (PR 61)

Edge Microgateway bir güvenlik duvarının arkasına kuruluysa ve herkese açık bulutta Apigee Edge ile iletişim kuramıyorsa dikkate alınacak 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 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. (Aynı durum, proxy'yi yapılandırmak için kullanılan ortam değişkenlerinde TLS etkinse de geçerlidir).

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 hangi ana makinelerin Edge Microgateway proxy'lerini işlememesi gerektiğini 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 bir zaman aşımı belirleme (PR 57)

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

edgemicro:
    request_timeout: 10

Zaman aşımı, saniye olarak ayarlanmıştır. Zaman aşımı oluşursa Edge Microgateway bir 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ı kullanılarak geçersiz kılındı.

7. X-Forwarded-For üstbilgisi, analytics için client_ip değerini ayarlayabilir

Mevcut olduğunda 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 eklentisiyle ilgili değişiklikler

OAuth eklentisi, API Anahtarı doğrulamasını ve OAuth erişim belirteci 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 eklentilerine iki yeni işaret eklenmiştir:

  • 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 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 (PR 40) iyileştirildi

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

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'u true, HTTP için de false olarak ayarlayın. req.targetSecure politikası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 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 configuration 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ü

  • Edgemicro-auth proxy'sini düzgün bir şekilde çalıştırmak için ücretli bir kuruluşun gerekli olmasına neden olan sorun giderildi. Artık Edge Microgateway'i deneme kuruluşları ile de kullanabilirsiniz. (5. PR)
  • Akışın veri işlemeyi tamamlamamasına ancak 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 giderildi. (PR 110)
  • İstemci ile Edge Microgateway arasındaki çift yönlü SSL sorunu 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, temel yolun sonunda eğik çizgiye gerek yoktur. (48 PR)

Sürüm 2.3.5

Yeni özellikler ve geliştirmeler s.2.3.5

Proxy filtreleme

Bir Edge Microgateway örneğinin hangi mikro ağ geçidi duyarlı proxy'leri işleyeceğini filtreleyebilirsiniz. Edge Microgateway başladığında, ilişkili olduğu kuruluştaki tüm mikro ağ geçidi duyarlı proxy'leri indirir. Mikro ağ geçidinin hangi proxy'leri işleyeceğini sınırlandırmak 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ı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 aşağıdaki kodu mikro ağ geçidi yapılandırmasına 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 s.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ı kapatabilirsiniz:

disabled_config_poll_interval: true

Varsayılan olarak periyodik 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 alır. Varsayılan yoklama aralığı 600 saniyedir (beş dakika).

Eklentilerdeki 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 çıkışı

Varsayılan olarak günlük kaydı hizmeti artık indirilen proxy'ler, ürünler ve JWT'nin JSON'unu atlıyor. Edge Microgateway'i başlattığınızda DEBUG=* ayarını yaparak bu nesnelerin çıkışını varsayılan olarak ayarlayabilirsiniz. Örneğin:

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

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

Varsayılan olarak mikro ağ geçidi yapılandırma dosyası ./config/config.yaml dizinindedir. 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 toplama-istek eklentisi artık GET istekleri için askıda kalmıyor.
  • 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ı bir ZIP dosyası indirerek yüklemenize olanak tanıyor. 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 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 Microgateway'in 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 (endmicro_* adlı proxy'ler) yüklüyordu. Bu yeni özellik, Edge Microgateway'in yalnızca sizin belirttiğiniz proxy'leri 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 org/env kuruluşunuzda edgemicro_foo ve edgemicro_bar adlıler dahil 50 edgemicro_* proxy'niz olduğunu varsayalım. Mikro ağ geçidine yalnızca şu iki proxy'yi şu şekilde kullanmasını söyleyebilirsiniz:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

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

Eklentilerde hedef istek üstbilgileri ayarlama

Hedef istek üst bilgilerini eklemek veya değiştirmek istiyorsanız 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 (basit bir GET isteğinde olduğu gibi).

Gelen isteğin veri içerdiği ve hedef istekte istek başlıkları oluşturmak istediğiniz bir durumu ele alalım. Edge Microgateway'in önceki sürümlerinde, bu durumda hedef üstbilgilerinin güvenilir bir ş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 kodunu aşağıda bulabilirsiniz. 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 sağlanan örnek eklentilerde kullanılmıştır.

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

Sıfır kapalı kalma süresi yeniden yükleme özelliği

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

Buna ek olarak, üç yeni CLI komutu eklendi. Bu komutları, Edgemicro start komutunun yürütüldüğü dizinde ç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ırma yeniden yükleme

Edge Microgateway, düzenli olarak yeni bir yapılandırma yükler ve herhangi bir değişiklik olması durumunda yeniden yükleme 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 alır. Varsayılan yoklama aralığı 600 saniyedir (beş dakika). Mikro ağ geçidi yapılandırma dosyasındaki varsayılan değeri şu şekilde 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 Microgateway 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 bir pfx dosyasının yolu.
passphrase Özel anahtarın veya PFX'in parolasını içeren bir dize.
ca PEM biçiminde güvenilir 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 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'u kullanarak SSL'yi sürüm 3'e zorunlu kılabilirsiniz.
servername SNI (Server Name Indication) [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, yapılandırılabilir yeni uç noktalar bulunur. 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.

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 aşağıda verilmiştir:

İstemci SSL/TLS seçeneklerini belirtme

Yeni bir yapılandırma seçeneği kümesi kullanarak, hedeflere yönelik 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

Yükleme notu v2.0.11

Edge Microgateway'in önceki bazı sürümleri, yazılımı bir ZIP dosyası indirerek yüklemenize olanak tanıyor. 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.0.11 sürümü

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

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

Start komutu, yapılandırma dosyasında belirtilen bağlantı noktasını geçersiz kılmak için bir bağlantı noktası numarası belirtmenizi sağlar. PORT ortam değişkenini kullanarak da bir bağlantı noktası numarası belirtebilirsiniz. Ayrıntılar 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ızı sağlar. Doğru değerine ayarlanırsa Auth başlığı hedefe aktarılır. oauth özellikleri konusuna bakın.

Özel yetkilendirme hizmeti kullanma olanağı

Kimlik doğrulamayı işlemek için kendi özel hizmetinizi kullanmak istiyorsanız Edge Microgateway yapılandırma dosyasındaki authUri değerini hizmetinizi 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 2.0.4 sürümü 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ı desteklemektedir. 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 başlıklı makaleyi inceleyin.

npm global yükleme desteği

Artık Edge Microgateway'i npm -g (genel) 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 2.0.0 sürümü

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

Tek işlemli sunucu

Edge Microgateway artık tek bir işlem sunucusu. Artık iki işlem modeli kullanılmıyor. Bu modelde artık bir işlem (daha önce "aracı" olarak biliniyordu) Edge Microgateway'i başlatıyor. Yeni mimari, otomasyonu ve container mimarisine alma işlemini daha kolay hale getiriyor.

Adlandırılmış alan 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 config 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 Microgateway'i yapılandırmak ve başlatmak için Komut Satırı Arayüzü'nü (KSA) kullanırken söz konusu değişkenlerin 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.

Hatalar düzeltildi 2.0.0 sürümü

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

Sürüm 1.1.2

Edge Microgateway 1.1.2 sürümü 14 Mart 2016'da yayınlandı.

Yeni özellikler ve geliştirmeler s.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 Microgateway'i düğüm inceleyici gibi bir uzaktan hata ayıklayıcıyla çalışacak şekilde yapılandırabilirsiniz.

Yeni yapılandırma dosyasının konumu

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

Günlük dosyası yönlendirme

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 1.1.2 sürümü

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

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