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

19 Ağustos 2026: Docker container resmi güncellemesi (etiket: 3.3.11-sec.1)

Apigee, 19 Ağustos 2026'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

Kapsayıcı güncellemeleri:

Docker kapsayıcı güncellemesinde düzeltilen güvenlik sorunları

• GHSA-5p4m-2wfm-xmqj
• CVE-2026-13595
• CVE-2026-27456
• CVE-2026-12590
• CVE-2026-53614
• CVE-2026-53612
• CVE-2025-14104
• CVE-2026-53615
• CVE-2026-53613
• CVE-2026-34743

1 Temmuz 2026 — İlk sürüm

Apigee, 1 Temmuz 2026'da Edge Microgateway 3.3.11'de aşağıdaki düzeltmeleri yayınladı.

Bileşen sürümleri

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

Düzeltilen güvenlik sorunları

• CVE-2026-7383
• CVE-2026-9076
• CVE-2026-34180
• CVE-2026-34181
• CVE-2026-34182
• CVE-2026-34183
• CVE-2026-42764
• CVE-2026-42766
• CVE-2026-42767
• CVE-2026-42769
• CVE-2026-45445
• CVE-2026-45446
• CVE-2026-45447
• CVE-2026-53550

3.3.10

Apigee, 27 Mayıs 2026'da Edge Microgateway'de aşağıdaki düzeltmeleri yayınladı.

Bileşen sürümleri

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

Düzeltilen güvenlik sorunları

• CVE-2026-41907
• CVE-2026-4800
• CVE-2026-2950
• CVE-2026-42338

3.3.9

Apigee, 1 Nisan 2026'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

Hata düzeltmeleri ve geliştirmeler:

Bileşen sürümleri:

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

Düzeltilen güvenlik sorunları

• CVE-2025-13465
• CVE-2026-24842
• CVE-2026-26996
• CVE-2026-2391
• CVE-2026-27904
• CVE-2026-27601
• CVE-2026-27903
• CVE-2026-26960
• CVE-2024-22365
• CVE-2026-24001
• CVE-2025-15284
• CVE-2025-64756
• CVE-2026-31802
• CVE-2026-29786
• CVE-2026-25547

3.3.8

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

Hata düzeltmeleri ve geliştirmeler:

Bileşen sürümleri:

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

Düzeltilen güvenlik sorunları

• CVE-2025-59343
• CVE-2025-64756

3.3.7

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

Hata düzeltmeleri ve geliştirmeler:

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

Düzeltilen güvenlik sorunları

• CVE-2024-12905
• CVE-2025-46653

3.3.6

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

Bileşen sürümleri:

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

Düzeltilen güvenlik sorunları

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

3.3.5

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

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

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

You are using a version of NodeJS that is not supported

Düzeltilen güvenlik sorunları

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

3.3.4

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

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

Düzeltilen güvenlik sorunları

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

3.3.3

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

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

Düzeltilen güvenlik sorunları

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

3.3.2

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

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

Düzeltilen güvenlik sorunları

Yok.

3.3.1

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

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

Düzeltilen güvenlik sorunları

3.3.0

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

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

Hata düzeltmeleri ve geliştirmeler:

npm install apigeetool@0.15.1

Sürüm 3.2.x

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

3.2.3

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

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

Düzeltilen güvenlik sorunları

3.2.2

15 Temmuz 2021'de Apigee, Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

Düzeltilen güvenlik sorunları

3.2.1

Apigee, 5 Mart 2021'de Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

edgemicro:
 enable_GET_req_body: true

3.2.0

Apigee, 21 Ocak 2021'de Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

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

Hata düzeltmeleri ve geliştirmeler:

Sürüm 3.1.x

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

3.1.8

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

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

3.1.7

Apigee, 24 Eylül 2020'de Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

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

Hata düzeltmeleri ve geliştirmeler:

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

3.1.6

Apigee, 20 Ağustos 2020'de Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

3.1.5

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

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

Hata düzeltmeleri ve geliştirmeler:

3.1.4

Apigee, 23 Nisan 2020'de Edge Microgateway'de aşağıdaki düzeltmeyi yayınladı.

Hata düzeltmesi:

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

3.1.3

Apigee, 15 Nisan 2020'de Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

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

3.1.2

Apigee, 16 Mart 2020'de Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

Bileşen sürümleri:

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

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 geliştirildi. Ayrıca, Edge Microgateway ile Apigee Edge arasındaki mevcut HTTP proxy desteğiyle ilgili sorunlar da düzeltildi. Ayrıntılı bilgi için:
  • Apigee Edge ile iletişim için HTTP proxy kullanma
  • Hedef iletişimi için HTTP proxy kullanma
• 149101890 - Hedef sunucu veya yük dengeleyici bağlantısını kapattığında oluşan durumlar için günlük bildirimi kodu ERROR'dan INFO'ya değiştirildi.
• 150746985 - Yapılandırma dosyasında redisBasedConfigCache: true veya quotaUri: https://%s-%s.apigee.net/edgemicro-auth bulunması durumunda edgemicro verify komutunun düzgün çalışmamasına neden olan 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 iyileştirme yapıldı.
• 151588764 - Node.js v8 desteği sonlandırıldığından, Edge Microgateway'i Docker container'da çalıştırmak için kullanılan Docker görüntüsündeki Node.js sürümünü 12 olarak güncelleyin.
• 151306049 - Edge Microgateway CLI komutları tarafından kullanılan Apigee Edge yönetim API'lerini listelemek için dokümanlarda güncelleme yapıldı. Edge Microgateway hangi yönetim API'lerini kullanır? başlıklı makaleyi inceleyin.

3.1.1

Apigee, 20 Şubat 2020'de Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

Bileşen sürümleri:

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

Hata düzeltmeleri ve geliştirmeler:

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

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

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

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

  HTTP_PROXY=http://10.128.0.20:3128

• 146320620 - Yeni bir yapılandırma parametresi olan edgemicro.headers_timeout eklendi. Bu özellik, HTTP ayrıştırıcının tam HTTP üstbilgilerini almayı bekleyeceği süreyi (milisaniye cinsinden) sınırlar. Örneğin:

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

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

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

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

3.1.0

Apigee, 21 Ocak 2020'de Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

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

Hata düzeltmeleri ve geliştirmeler:

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

  Örneğin:

  2020-01-20T02:52:53.040Z [warn][localhost:8000][5][foo-eval][test][hello/][]
  [DbpGIq9jKfzPX8jvXEivhA0LPwE][f372cc30-3b2f-11ea-845f-a627f][quota][remote quota not
  available so processing locally, setting quota-failed-open for identifier: AppQuota60.Quota60]
  [GET][][][][]

• 145023519 - Edge Microgateway bir API proxy'sinde değişiklik algıladığında devam eden veya yeni işlemlerin etkilenmesine neden olan sorun düzeltildi. Artık bir proxy'de değişiklik yapıldığında Edge Microgateway önbelleği yeniler ve çalışan düğümleri yeniden başlatılır. Bu değişiklikle birlikte, devam eden işlemler ve mikro ağ geçidine gönderilen yeni API çağrıları etkilenmez.
• 146378327 - sourceRequest, targetRequest ve targetResponse günlük düzeyi INFO düzeyine değiştirildi.
• 146019878 - Edge Analytics'te "API Proxy Performansı" için hesaplanan gecikme ile Edge Microgateway sourceResponse/targetResponse günlük etkinlikleri arasındaki fark düzeltildi. Artık Edge Analytics ve Microgateway günlük etkinliklerindeki gecikme süresi aynıdır.
• 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 yolu davranışını yapılandırma bölümünde açıklandığı gibi Apigee Edge ile aynı kalıp eşleştirme özelliğini kullanıyor.

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

  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

Apigee, 8 Kasım 2019'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

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

Hata düzeltmeleri ve geliştirmeler:

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

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

  

  Not: "/", "/*" ve "/**" kaynak yolunun davranışını yapılandırma başlıklı makalede açıklandığı gibi, features.isSingleForwardSlashBlockingEnabled yapılandırma özelliği Edge Microgateway için desteklenmez.

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

  edgemicro:
    home: ../gateway
    port: 8000
    max_connections: -1
    max_connections_hard: -1
    logging:
      level: info
      dir: /var/tmp
      stats_log_interval: 60
    plugins:
      dir: ../plugins
      sequence:
        - oauth
        - quota
  quotas:
    bufferSize:
      hour: 20000
      minute: 500
      default: 10000
    useDebugMpId: true
    failOpen: true
  ...

• 141750056 - Redis'i kota destekli depolama alanı olarak kullanmanıza olanak tanıyan yeni bir özellik eklendi. useRedis doğruysa volos-quota-redis modülü kullanılır. Doğru olduğunda kota yalnızca Redis'e bağlanan Edge Microgateway örnekleriyle sınırlanır. Yanlışsa destek deposu olarak volos-quota-apigee modülü kullanılır ve kota sayacı genel olur. Ayrıntılar için Kota yapılandırma seçenekleri başlıklı makaleyi inceleyin. Örneğin:

  edgemicro:
  ...
  quotas:
    useRedis: true
    redisHost: localhost
    redisPort: 6379
    redisDb: 1

• 140574210 - edgemicro-auth proxy'si tarafından oluşturulan jetonların varsayılan geçerlilik süresi 108.000 milisaniyeden (1,8 dakika) 1.800 saniyeye (30 dakika) çıkarıldı.
• 143551282 - SAML'nin etkinleştirildiği kuruluşları desteklemek için edgemicro genkeys komutu, ‑‑token parametresini içerecek şekilde güncellendi. Bu parametre, kimlik doğrulama için kullanıcı adı/şifre yerine OAuth jetonu kullanmanıza olanak tanır. Ayrıntılı bilgi için Anahtar oluşturma başlıklı makaleyi inceleyin.

3.0.9

Apigee, 11 Ekim 2019'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

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

Hata düzeltmeleri ve geliştirmeler:

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

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

  quotas :
   failOpen : true

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

• 142093764 - Kota aşımını önlemek için edgemicro-auth proxy'sinde yapılandırma değişikliği yapıldı. Bu değişiklik, kota türünü calendar olarak ayarlamayı amaçlamaktadı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şlemci) kimliğinin günlüğe kaydedilmesini sağlayan yeni bir özellik eklendi. Bu özelliği kullanmak için edgemicro-auth proxy'nizi 3.0.7 veya 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

Apigee, 26 Eylül 2019'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

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

Hata düzeltmeleri ve geliştirmeler:

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

  Bu özellik, eski jetonun önbellekte kaldığı ve bekleme süresi sona erene kadar yeniden kullanıldığı bir bekleme süresi ayarlamanıza olanak tanır. Bu özellik, geçici bağlantı hatası durumunda Edge Microgateway'in istekleri işlemeye devam etmesini sağlar. Bağlantı devam ettiğinde ve başarılı bir API anahtarı doğrulama çağrısı yapıldığında yeni bir JWT alınır ve önbellekteki eski JWT'nin yerini alır.

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

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

     oauth:
       failOpen: true
       failopenGraceInterval: time_in_seconds
       cacheKey: true
       ...

     Örneğin:

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

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

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

3.0.7

Apigee, 12 Eylül 2019'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

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

Hata düzeltmeleri ve geliştirmeler:

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

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

  oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    gracePeriod: 10
    useUpstreamResponse: true

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

  edge_config:
    quotaUri: https://%s-%s.apigee.net/edgemicro-auth

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

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

  edgemicro:
      keepAliveTimeout

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

  edgemicro:
      keep_alive_timeout

• 139526406 - Bir geliştirici uygulamasında birden fazla ürün varsa yanlış kota sayımına neden olan hata düzeltildi. Kota artık birden fazla ürün içeren bir uygulamadaki 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

Apigee, 29 Ağustos 2019'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

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

  Örneğin:

  edgemicro:
    keep_alive_timeout: 600

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

  edge_config:
    quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
  

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

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

  stack_trace: false

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

3.0.5

Apigee, 15 Ağustos 2019'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

• 139005279 - edgemicro status komutunun doğru sayıda çalışan işlemi döndürmemesine neden olan sorun düzeltildi.
• 138437710 - ExitCounter sınıfında, uygun günlüğün yazılmasını engelleyen bir sorun düzeltildi.

• 139064652 - Etkinlik ve sistem günlükleri için trace 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 eklendi. Şu anda, kullanılabilir günlük düzeyleri info, warn ve error'dir.
• 139064616 - Günlük çıkışı, tüm konsol günlük ifadeleri için standartlaştırıldı. Console logging ifadeleri artık şu özellikleri içeriyor:
• Zaman damgası
• Bileşen adı
• İşlem Kimliği
• Konsol günlüğü mesajı

• 138413755 - Şu CLI komutları için JWT anahtarı ve gizli anahtarla ilgili günlük mesajlarını iyileştirin: cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey ve configure.

• 138413577 - Arka uç hizmeti zaman aşımları için hata işleme ekleyin ve iyileştirin.
• 138413303 - Yanıt ve soket zaman aşımları için hata işleme ekleme ve iyileştirme.
• 138414116 - "Bağlantı reddedildi" hataları için hata işleme özelliği eklendi ve iyileştirildi.

3.0.4

Apigee, 1 Ağustos 2019'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

• 134445926 - Dahili Edge Microgateway kimlik doğrulamasında iyileştirmeler yapıldı.
• 137582169 - İstenmeyen işlemlerin başlatılmasına neden olan sorun giderildi. Ek işlemler, eklentilerin yeniden yüklenmesine ve aşırı bellek kullanılmasına neden oldu. Edge Microgateway artık işlem sayısını beklenen sınır içinde tutuyor.
• 137768774 - Günlük mesajı iyileştirmeleri:
  • Temizlenmiş işlem (istek) günlükleri.
  • Gerekli yerlere 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 işlevi kullanacak şekilde güncellendi.
• 138321133, 138320563 - Gelecekteki kota geliştirmelerini etkinleştirmek için kota arabelleğinde temel bir dahili değişiklik yapıldı.

3.0.3

Apigee, 23 Temmuz 2019'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

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

  Boş özellik değerleri, boş 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 kalitesinde iyileştirmeler yapıldı.

3.0.2

Apigee, 3 Temmuz 2019'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

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

3.0.1

Apigee, 21 Haziran 2019'da Edge Microgateway'de aşağıdaki düzeltmeleri ve geliştirmeleri yayınladı.

• 134834551 - Edge Microgateway için desteklenen Node.js sürümlerini değiştirme
  (Node.js desteklenen sürümler: 8 ve 12; 7, 9 ve 11 sürümleri deneyseldir)
• 134751883 - Edge Microgateway, yük altında yeniden yüklenirken kilitleniyor
• 134518428 - Edge Microgateway için ürün uç noktası, filtre kalıbı yanlışsa 5XX döndürüyor
• 135113408 - Çalışanlar beklenmedik bir şekilde işten ayrılırlarsa yeniden başlatılmalıdır
• 134945852 - tokenCacheSize, oauth eklentisinde kullanılmıyor
• 134947757 - set cacheTTL in oauth plug-in
• 135445171 - OAuth'taki ek süre hesaplaması doğru değil
• Edge Microgateway yüklemesiyle birlikte 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

(2.5.38 sürümünde düzeltildi, 06/07/2019)

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

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

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

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

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

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

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

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

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

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

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

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

Docker: TLS desteği

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

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

• Kuzeye doğru örnek TLS yapılandırması
• Güney yönlü TLS yapılandırması örneği

Bu örneklerde, sertifikaları yüklemek için kapsayıcı ekleme noktasının /opt/apigee/.edgemicro nasıl kullanılacağını göreceksiniz. Bu sertifikalara daha sonra Edge Microgateway yapılandırma dosyasında başvurulur.

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

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

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

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

Docker: Güncellenen eklenti talimatları

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

• 1. seçenek: Eklentiler dizinini bir birime bağlama (Yeni)
• B seçeneği: Eklentileri kapsayıcıya yerleştirme (Güncellendi)

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

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

Edge Analytics'te API'leri ayırma

(2.5.26'da eklendi) Yeni analiz eklentisi işaretleri, belirli bir API yolunu Edge Analytics gösterge tablolarında ayrı bir proxy olarak görünecek şekilde ayırmanıza olanak tanır. Örneğin, sağlık durumu kontrolü API'lerini gerçek API çağrılarıyla karıştırmamak için bunları ayırabilirsiniz. Daha fazla bilgi için Yolları analizlerin dışında bırakma başlıklı makaleyi inceleyin.

Yerel proxy yapılandırma

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

Bağımsız modu kullanma

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

Anahtarları iptal etme

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

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]

Docker desteği

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

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

Kubernetes desteği

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

TCP nodelay seçeneği desteği

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

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

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

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

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

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

Örnekler:

Forever'ı başlatmak için:

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

Forever'ı durdurmak için:

edgemicro forever -a stop

JWT anahtar rotasyonu

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

İndirilen API proxy'lerini filtreleme

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

API proxy'leri olmadan ürün belirtme

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

Sürekli izleme desteği

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

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

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

Forever CLI seçeneği için destek

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

Örneğin:

edgemicro forever ~/mydir/forever.json

Yeniden yükleme komutuna configUrl seçeneğinin eklenmesi

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

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

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

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

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

• (236 numaralı sorun) Önbelleği temizleme işlemindeki yazım hatası düzeltildi.
• (234 numaralı sorun) Edge Microgateway 2.5.35 için yeniden yükleme sırasında kilitlenme.
• (135 numaralı sorun) -v seçeneği kullanılırken "secure" adlı geçersiz sanal ana makine referansı hatası. Bu düzeltme, dağıtımdan önce edgemicro-auth proxy'sini değiştirerek sanal ana makinelerin "-v" işaretinde belirtilenlerle tam olarak eşleşmesini sağlar. Ayrıca, sanal ana makine için istediğiniz sayıda ve istediğiniz adla sanal ana makine belirtebilirsiniz (artık varsayılan ve güvenli ile sınırlı değildir).
• (141 numaralı sorun) edgemicro reload komutu, yapılandırma dosyası seçeneği -c'yi desteklemiyor. Bu sorun düzeltildi.
• (142 numaralı sorun) Edge Microgateway, yükleme sırasında kullanımdan kaldırılan şifreleme hakkında hata veriyor. Bu sorun düzeltildi.
• (145 numaralı sorun) Kota, Edge Microgateway ile çalışmıyor. Bu sorun düzeltildi.
• (Apigee Community sorunu: EMG - JWT jetonu, OAUTH'taki hem API proxy'lerine hem de kaynak URI'sine göre doğrulanıyor) JWT jetonu, OAUTH'taki hem API proxy'lerine hem de kaynak URI'sine göre doğrulanıyor. Bu sorun düzeltildi.
• (Apigee Community sorunu: Microgateway, üstbilgide OAuth jetonu olmadan bile çalışıyor) Microgateway, OAuth ile çalışmıyor. Bu sorun düzeltildi.
• Windows'da pidPath düzeltildi.
• (157 numaralı sorun) Aşağıdaki hata mesajına neden olan sorun düzeltildi: ReferenceError: deployProxyWithPassword is not defined.
• (169 numaralı sorun) Node.js bağımlılıklarını güncelleme (npm denetimi)
• edgemicro-auth proxy'si artık Edge JWT politikalarını kullanıyor. Proxy artık JWT desteği sağlamak için Node.js'ye bağlı değildir.

Sürüm 2.4.x

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

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

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

Örnek:

edgemicro configure -x /mypath …

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

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

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

Mikro ağ geçidi yapılandırma dosyası varsayılan olarak ./config/config.yaml konumundadır. 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. Özel bulut yüklemeleri için özel bir yapılandırma dizininin tanınmamasına neden olan sorun düzeltildi.

Örnek:

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

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

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

1. seçenek:

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

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

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

2. Seçenek:

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

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

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

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

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

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

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

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

edgemicro:
    request_timeout: 10

Zaman aşımı süresi saniye cinsinden ayarlanır. Zaman aşımı oluşursa Edge Microgateway, 504 durum koduyla yanıt verir.

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

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

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

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

8. OAuth eklentisi değişiklikleri

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

OAuth eklentileri iki yeni işaret ekler:

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

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

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

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

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

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

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

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

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

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

-t, --token <token>

Örneğin:

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

2.4.3 sürümünde düzeltilen hatalar

• edgemicro-auth proxy'sinin düzgün şekilde çalışması 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. (PR 5)
• Akışın verileri işlemeyi bitirmemesine rağmen son işleyicilerin yine de yürütülmesine neden olan sorun düzeltildi. Bu durum, kısmi bir yanıt gönderilmesine neden oldu. (PR 71)
• Özel bulut yüklemeleri için özel yapılandırma dizininin tanınmamasına neden olan sorun düzeltildi. (PR 110)
• İstemci ile Edge Microgateway arasındaki çift yönlü SSL ile ilgili sorun düzeltildi. (PR 70)
• API anahtarı doğrulamasının düzgün çalışması için proxy temel yolunda sondaki eğik çizginin gerekli olduğu sorun düzeltildi. Artık temel yolun sonunda eğik çizgiye gerek yoktur. (PR 48)

Sürüm 2.3.5

Yeni özellikler ve geliştirmeler v.2.3.5

Proxy filtreleme

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

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

Analytics'te veri maskeleme

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

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

Sürüm 2.3.3

Yeni özellikler ve geliştirmeler v.2.3.3

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

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

Bu özelliği mikro ağ geçidi yapılandırmasında devre dışı bırakabilirsiniz:

disabled_config_poll_interval: true

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

Hedef URL'leri eklentilerde yeniden yazma

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

Yeni eklenti işlevi imzası

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

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

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

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

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

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

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

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

Hata düzeltmeleri (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ığı şekilde çalışıyor.
• accumulate-request eklentisi, GET istekleri için artık kilitlenmiyor.
• accumulate-response eklentisinde, yanıt gövdesinin olmaması nedeniyle hatalara yol açan bir sorun düzeltildi.

Sürüm 2.3.1

Yükleme notu

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

npm install -g edgemicro

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

Yeni özellikler ve geliştirmeler v.2.3.1

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

Proxy'leri filtreleme

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

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

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

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

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

Hedef istek başlıklarını eklentilerde ayarlama

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

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

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

Bu işlemin nasıl yapılacağını gösteren örnek eklenti kodunu aşağıda bulabilirsiniz. onend_request içinde ayarlanan başlıklar hedefe gönderilir:

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


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

  return {

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

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


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

  };

}

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

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

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

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

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

• edgemicro status - Edge Microgateway'in çalışıp çalışmadığını kontrol eder.
• edgemicro stop - Edge Microgateway kümesini durdurur.
• edgemicro reload - Edge Microgateway 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, yeni bir yapılandırmayı düzenli olarak yükler ve herhangi bir değişiklik olursa yeniden yükleme işlemi gerçekleştirir. Yoklama, Edge'de yapılan değişiklikleri (ürünlerde, mikro ağ geçidi farkında olan proxy'lerde vb. yapılan değişiklikler) ve yerel yapılandırma dosyasında yapılan değişiklikleri alır. Varsayılan yoklama aralığı 600 saniyedir (beş dakika). Varsayılan değeri, mikro ağ geçidi yapılandırma dosyasında aşağıdaki gibi değiştirebilirsiniz:

edgemicro:
    config_change_poll_interval: [seconds]

KSA'ya sürüm bilgileri eklendi

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

edgemicro --version

Yeni Edge Microgateway sunucusu SSL seçenekleri

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

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

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

edgemicro:
  logging:
    to_console: true

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

Sürüm 2.1.2

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

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

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

• edgeconfig:verify_api_key_url
• edgeconfig:products

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

Sürüm 2.1.1

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

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

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

Sürüm 2.1.0

Yeni özellikler ve geliştirmeler (v.21.0)

Yeni özellikler ve geliştirmeler şunlardır:

İstemci SSL/TLS seçeneklerini belirtme

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

Sürüm 2.0.11

Yükleme notu v2.0.11

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

npm install -g edgemicro

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

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

Yeni özellikler ve geliştirmeler şunlardır:

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

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

İsteğe bağlı olarak kimlik doğrulama başlıklarını koruma

Yeni bir yapılandırma ayarı olan keepAuthHeader, istekte gönderilen yetkilendirme başlığını korumanıza olanak tanır. Doğru değerine ayarlanırsa Auth üstbilgisi hedefe iletilir. oauth attributes (OAuth özellikleri) konusunu inceleyin.

Özel yetkilendirme hizmeti kullanabilme

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

Sürüm 2.0.4

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

Yeni özellikler ve geliştirmeler v2.0.4

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

Ürünlerde kaynak yolları için destek

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

npm global install desteği

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

Sürüm 2.0.0

Edge Microgateway v2.0.0, 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şlem sunucusu

Edge Microgateway artık tek bir işlem sunucusudur. Artık iki süreçli bir model kullanılmıyor. Bu modelde bir süreç (önceden "aracı" olarak bilinirdi) Edge Microgateway'i, ikinci süreç ise Edge Microgateway'i başlatıyordu. Yeni mimari, otomasyonu ve kapsayıcılaştırmayı kolaylaştırır.

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

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

Yeni ortam değişkenleri

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

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

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

Küme modu

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

2.0.0 sürümünde düzeltilen hatalar

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

Sürüm 1.1.2

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

Yeni özellikler ve geliştirmeler v.1.1.2

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

Performans İyileştirme

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

Uzaktan hata ayıklayıcı desteği

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

Yeni yapılandırma dosyası konumu

Edge Microgateway'i yapılandırdığınızda agent/config/default.yaml dosyası artık ~./edgemicro/config.yaml'ye 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ığı belirtmenize olanak tanır.

Hatalar düzeltildi v1.1.2

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