Apigee Adapter for Envoy sürüm notları

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

v2.1.1

7 Haziran 2023'te Apigee Adapter for Envoy'un 2.1.1 sürümünü yayınladık.

Düzeltilen sorunlar

  • Kotaların ürün düzeyinde paylaşılması yerine işlemler arasında yanlış şekilde kopyalanmasına neden olan sorun düzeltildi.

v2.1.0

5 Haziran 2023'te Apigee Adapter for Envoy'un 2.1.0 sürümünü yayınladık.

Düzeltilen sorunlar

  • application_id talebi, /verifyApiKey yanıtına eklendi.

v2.0.7

9 Mart 2023'te Apigee Adapter for Envoy'un 2.0.7 sürümünü yayınladık.

Özellikler ve iyileştirmeler

  • JWT'ler artık customattributes adlı bir talep ekleyebilir. Bu talep, değeri x-apigee-customattributes adlı bir başlıkta hedefe iletir (append_metadata_headers, true olarak yapılandırılmışsa).

Düzeltilen sorunlar

  • Geçersiz bir API anahtarının sahte günlük girişleri ve analiz kayıtları oluşturmasına neden olan sorun düzeltildi.
  • Apigee'nin yeni sürümlerinde sorunlara neden olan bir proxy'de, desteği sonlandırılan sürüm kontrolü kaldırıldı.

v2.0.6

18 Ekim 2022'de Apigee Adapter for Envoy'un 2.0.6 sürümünü yayınladık.

Düzeltilen sorunlar

  • Bağımlı kitaplıktaki hizmet reddi (DoS) güvenlik açığını gidermek için yayınlanan güvenlik sürümü. CVE-2022-28948 başlıklı makaleyi inceleyin.

v2.0.5

3 Mart 2022'de Apigee Adapter for Envoy'un 2.0.5 sürümünü yayınladık.

Düzeltilen sorunlar

  • Prometheus kitaplığındaki hizmet reddi (DoS) riskini gidermek için güvenlik sürümü. CVE-2022-21698 başlıklı makaleyi inceleyin.

v2.0.4

3 Aralık 2021'de Apigee Adapter for Envoy'un 2.0.4 sürümünü yayınladık.

Özellikler ve iyileştirmeler

  • CLI samples komutu için desteklenen Envoy ve Istio sürümlerinin listesi güncellendi. Aşağıdaki sürümler artık örnekler için desteklenmektedir:
    • Envoy 1.18 - 1.20 sürümleri
    • Istio 1.10 - 1.12 sürümleri

Düzeltilen sorunlar

  • Panik durumunu önlemek için PEM bloğu özel anahtar yüklemesi için bir nil kontrolü eklendi. (360 numaralı sorun)
  • Uzak hizmet yetkilendirme hataları artık hata ayıklama düzeyinde kaydediliyor. API anahtarları için jeton getirme hataları bu sınıflandırmanın dışında tutulur. Bu durumda, apigee-remote-service-envoy için hata ayıklama günlüğü düzeyi devre dışı olsa bile hataların görünmesi için hatalar hata düzeyinde günlüğe kaydedilir. Ayrıca Uzaktan hizmet günlük kaydı düzeylerini ayarlama başlıklı makaleyi inceleyin. (104 numaralı sorun)

v2.0.3

21 Eylül 2021'de Apigee Adapter for Envoy'un 2.0.3 sürümünü yayınladık.

Düzeltilen sorunlar

  • Doğrudan yanıtlarla ilgili bir analiz günlüğü sorunu düzeltildi. Bu sorun yalnızca belirli durumlarda meydana geliyordu. Örneğin:
    • Kimlik doğrulama/yetkilendirme kontrolü gerektirmeyen istekler için authContext oluşturulmadı ve dinamik meta veriler boş olduğundan erişim günlüğü girişi yoksayıldı.
    • Reddedilen yanıtta HTTP kodu yerine RPC kodu kullanıldığından kayıtlar Apigee kullanıcı arayüzünde başarılı olarak gösteriliyordu.

v2.0.2

7 Haziran 2021'de Apigee Adapter for Envoy'un 2.0.2 sürümünü yayınladık.

Düzeltilen sorunlar

  • JWT talepleri kapsamları nil olduğunda 403 hatalarına ve paniklere neden olabilecek bir yarışma durumu düzeltildi.

v2.0.0

6 Nisan 2021 Salı günü, Apigee Adapter for Envoy'un 2.0.0 sürümünü yayınladık.

Özellikler ve iyileştirmeler

Özellik Açıklama
Çok kiracılı ortam desteği

Artık bağdaştırıcıyı bir Apigee kuruluşundaki birden fazla ortamda hizmet verecek şekilde etkinleştirebilirsiniz. Bu özellik, birden fazla ortama hizmet vermek için bir Apigee kuruluşuyla ilişkili bir Apigee Adapter for Envoy kullanmanıza olanak tanır. Bu değişiklikten önce bir bağdaştırıcı her zaman bir Apigee ortamına bağlıydı. Bu özellik hakkında daha fazla bilgi için Çok kiracılı ortam desteği başlıklı makaleyi inceleyin.
Envoy v3 API desteği
Envoy meta veri desteği

Envoy 1.16+, başlık kullanmaya gerek kalmadan ext_authz meta verilerinin gönderilmesine olanak tanır. Bu ve ilgili değişiklikleri kullanarak artık reddedilen istekler için daha iyi HTTP yanıt kodları sağlıyoruz ve Envoy'a RBAC filtresi yüklememiz gerekmiyor. İnceleyin:

Bu özellik yalnızca Envoy 1.16+ ve Istio 1.9+ sürümlerinde desteklenir.

Bu değişiklikle birlikte, aşağıdaki yapılandırma artık Envoy yapılandırma dosyasına (envoy-config.yaml) eklenmiyor: 

additional_request_headers_to_log:
    - x-apigee-accesstoken
    - x-apigee-api
    - x-apigee-apiproducts
    - x-apigee-application
    - x-apigee-clientid
    - x-apigee-developeremail
    - x-apigee-environment

Özel bir durum için isteklere başlık eklemek istiyorsanız adaptörün config.yaml dosyasında append_metadata_headers:true özelliğini ayarlamanız yeterlidir.
remote-token proxy'sini remote-service proxy'sinden ayırma

Uzak hizmet proxy'si iki ayrı proxy olarak yeniden düzenlendi. v2.0.x, provisioning iki API proxy'si yükler: remote-service ve remote-token. /token ve /certs uç noktaları, remote-service proxy'sinden remote-token proxy'sine taşındı.

Bu değişiklik, işlevlerin yararlı bir şekilde ayrılmasını sağlar. Artık remote-service proxy'si yalnızca dahili bağdaştırıcı iletişimleri için kullanılırken remote-token proxy'si, özelleştirebileceğiniz örnek bir OAuth iş akışı sağlar. provision --force-proxy-install komutu kullanılsa bile özel remote-token proxy'niz hiçbir zaman üzerine yazılmaz.

Veri yakalama desteği

Yalnızca Apigee X ve Apigee Hybrid için kullanılabilir.

Adaptör artık Envoy meta verilerinin Apigee'nin veri yakalama özelliğine iletilmesini destekliyor. Bu özellik, belirttiğiniz değişkenlerde yakalanan verileri özel raporlarda kullanılmak üzere Apigee Analytics'e gönderir.
RBAC gerekmez

Daha önce Envoy meta veri desteği bölümünde belirtildiği gibi, artık yetkisiz istekleri ayrı bir RBAC filtresi gerektirmeden anında reddediyoruz. RBAC kullanılmadığından, istemciler artık bu HTTP durum kodlarını Adaptör'den uygun şekilde alacak:

  • 401 Yetkilendirilmedi
  • 403 Yasak
  • 429 Too Many Requests
  • 500 Dahili Sunucu Hatası

Yetkisiz isteklerin devam etmesine izin vermek istiyorsanız bunu bağdaştırıcının auth:allow_unauthorized:true dosyasında config.yaml ayarlayarak yapabilirsiniz.

x-apigee-* üstbilgileri artık varsayılan olarak eklenmiyor

Envoy meta veri desteği bölümünde daha önce belirtildiği gibi, x-apigee-* üstbilgileri artık varsayılan olarak eklenmiyor. Bu seçenekleri eklemek istiyorsanız config.yaml dosyasında append_metadata_headers:true değerini ayarlayın. Bu yapılandırma tamamen isteğe bağlıdır ve yalnızca üst akış hedef hizmetine üstbilgileri yönlendirmek istediğinizde kullanmanız gerekir.

İsteği uzak hizmet hedefiyle özel olarak eşleştirme

api_header yapılandırma özelliğinin semantiği, önceki target_header özelliğiyle aynı kalır (varsayılan değer, hedef ana makine adıdır) ve belirtilen üstbilginin içeriği, API Ürünü işleminde (yalnızca Apigee Hybrid ve Apigee X) API Ürünü uzak hizmet hedefi özelliği veya apiSource alanıyla eşleşir.

Envoy meta verilerini kullanarak bu başlık değerini geçersiz kılmak için Envoy'dan bağdaştırıcıya apigee_api meta veri öğesini ileterek API ürününün uzak hizmet hedefi veya API ürün işlemi API kaynağını doğrudan belirtebilirsiniz. Yapılandırmak için Envoy yapılandırma dosyasına (Adapter'ın KSA'sını kullanarak oluşturabilirsiniz) aşağıdakine benzer bir kod ekleyin: 

typed_per_filter_config:
  envoy.filters.http.ext_authz:
    "@type": type.googleapis.com/envoy.extensions.filters.http.ext_authz.v3.ExtAuthzPerRoute
    check_settings:
      context_extensions:
        apigee_api: httpbin.org
Reddedilen isteklerle ilgili analizler hemen kaydedilir

Envoy Adaptörü artık reddedilen istekleri, erişim günlüğünde döndürülmesini beklemek yerine gerektiği gibi hemen analizlere kaydedecek. Bu yöntem daha verimlidir ve isteğe herhangi bir meta verinin eklenmesini gerektirmez.
UDCA desteği kaldırıldı

Apigee hybrid ve Apigee X'te Apigee'nin Universal Data Collection Agent'ına (UDCA) veri akışı artık doğrudan yükleme ile değiştirildiği için analiz için gerekli değildir. Bu değişiklik, bu seçeneğin eski desteğini kaldırır.

Edge for Private Cloud'da sağlama/bağlama CLI komutlarına mTLS desteği eklendi

Private Cloud için Apigee Edge kullanıcıları, KSA'yı kullanarak ürün bağlamalarını sağlarken veya listelerken istemci taraflı TLS sertifikaları ve kök sertifikaları sırasıyla ‑‑tls‑cert, ‑‑tls‑key ve ‑‑tls‑ca aracılığıyla sağlayabilir.

Bağdaştırıcı ile Apigee çalışma zamanı arasında mTLS desteği

Bağdaştırıcı ile Apigee çalışma zamanı arasında mTLS kullanmak için bağdaştırıcının config.yaml dosyasının tenant bölümünde istemci tarafı TLS sertifikaları sağlayabilirsiniz. Bu değişiklik, desteklenen tüm Apigee platformları için geçerlidir. Ayrıca, Apigee Edge Private Cloud platformu için analizlerde mTLS'yi etkinleştirir. Daha fazla bilgi için Bağdaştırıcı ile Apigee çalışma zamanı arasında mTLS yapılandırma başlıklı makaleyi inceleyin.

Düzeltilen sorunlar

  • Aynı API kaynağına sahip birden fazla işlem yapılandırmasının aynı kota grubu tanımlayıcılarını paylaşarak kota hesaplamasında çakışmalara neden olduğu sorun düzeltildi. (Sorun #34)
  • Belirtilen fiillerin olmadığı işlemlerin isteğin reddedilmesine neden olduğu sorun düzeltildi (Beklenen davranış, belirtilmemişse tüm fiillere izin verilmesidir). (Sorun #39)

v1.4.0

16 Aralık 2020 Çarşamba günü, Apigee Adapter for Envoy'un 1.4.0 sürümünü yayınladık.

Desteklenen platformlar

MacOS, Linux ve Windows için ikili dosyalar yayınlıyoruz.

Google'ın distroless, Ubuntu ve Ubuntu with Boring Crypto'dan Docker görüntüleri yayınlıyoruz.

Bu sürümde aşağıdaki platformlar desteklenir:

  • Apigee Hybrid 1.3.x, 1.4.x (yayın tarihi bekleniyor), Apigee Edge for Public Cloud, Apigee Edge for Private Cloud ve Google Cloud'da Apigee
  • Istio 1.5, 1.6, 1.7, 1.8 sürümleri
  • Envoy 1.14, 1.15, 1.16 sürümleri

Özellikler ve iyileştirmeler

Özellik Açıklama
remote-service proxy'sinin artık Uzak Hizmet Hedefleri'ni kullanan bir API ürünüyle ilişkilendirilmesi gerekmiyor.

Bu ilişkilendirme artık gerekli olmadığından aşağıdaki değişikliklere dikkat edin:

  • Artık sağlama sırasında uzaktan hizmet API ürünü oluşturulmuyor.
  • bindings verify CLI komutu artık geçerli değil ve kullanımdan kaldırıldı.
Artık Apigee Organization Admin rolü, sağlama için gerekli değildir.

Artık sağlama için kuruluş yöneticisi izni gerekmez. Bunun yerine IAM rolleri API Oluşturucu ve Dağıtıcı'yı kullanabilirsiniz. Başarılı bir şekilde sağlama yapmak için bu rollerin her ikisini de vermeniz gerekir.
(Yalnızca Google Cloud'daki Apigee ve Apigee Hybrid için geçerlidir)

Diğer sorunlar ve düzeltmeler

  • --rotate seçeneği olmadan Apigee'nin yeniden sağlanmasının hatayla çıkılmasına neden olan sorun düzeltildi.
  • Hazırlama KSA'sı artık belirli bir config.yaml dosyasındaki Analytics hizmet hesabı kimlik bilgilerini okuyup yeniden kullanıyor (133 numaralı sorun).

v1.3.0

23 Kasım Pazartesi günü, Apigee Adapter for Envoy'un 1.3.0 sürümünü yayınladık.

Desteklenen platformlar

MacOS, Linux ve Windows için ikili dosyalar yayınlıyoruz.

Google'ın distroless, Ubuntu ve Ubuntu with Boring Crypto'dan Docker görüntüleri yayınlıyoruz.

Bu sürümde aşağıdaki platformlar desteklenir:

  • Apigee Hybrid 1.3.x, 1.4.x (yayın tarihi bekleniyor), Apigee Edge for Public Cloud, Apigee Edge for Private Cloud ve Google Cloud'da Apigee
  • Istio 1.5, 1.6, 1.7, 1.8 sürümleri
  • Envoy 1.14, 1.15, 1.16 sürümleri

Özellikler ve iyileştirmeler

Özellik Açıklama
API ürün OperationGroups için destek. OperationGroups, kaynakları ve ilişkili kota zorunluluğunu bir proxy veya uzak hizmetteki HTTP yöntemleriyle bağlar.
(Yalnızca Google Cloud'daki Apigee ve Apigee Hybrid için geçerlidir)
Örnek oluşturmada dinamik yönlendirme proxy'si desteği kaldırıldı. Bu değişiklik nedeniyle, ana makine adı API ürününde ayarlanan uzak hizmet hedef ana makinesinden farklıysa istemciler HOST üstbilgisini eklemelidir. Örneğin: 
curl -i http://localhost:8080/httpbin/headers -H "HOST:httpbin.org"

API ürünü oluşturma başlıklı makaleyi inceleyin.

Hizmet hesaplarını ve Workload Identity'yi destekler. Adaptörü Apigee Hybrid kümesi dışında çalıştırırken analiz verilerinin Apigee'ye yüklenmesine izin vermek için analytics-sa komutuyla apigee-remote-service-cli provision parametresini kullanmanız gerekir. Ayrıca bağdaştırıcı artık Google Kubernetes Engine'de (GKE) Workload Identity'yi destekliyor. Provision komutu başlıklı makaleyi inceleyin.
(Yalnızca Google Cloud'daki Apigee ve Apigee Hybrid için geçerlidir)
Yeni jwt_provider_key yapılandırma özelliği. Bu anahtar yapılandırma dosyasına eklenir. Bu, Envoy yapılandırmasındaki JWT sağlayıcısının payload_in_metadata anahtarını veya Istio yapılandırmasındaki RequestAuthentication JWT yayınlayıcısını temsil eder.
KeepAliveMaxConnectionAge yapılandırma özelliği artık varsayılan olarak 1 dakika olarak ayarlanıyor. Önceki varsayılan süre 10 dakikaydı. Bu değişiklik, daha sorunsuz ölçeklendirme yapılmasını sağlar. Bu değer, erişim günlüğü akışının kullanım ömrü için de kullanılır. Yapılandırma dosyası başlıklı makaleyi inceleyin.
Kaldırılan CLI komutları. Aşağıdaki CLI komutlarının desteği sonlandırıldı. API ürünleri için uzak hizmet hedeflerini güncellemek üzere bunun yerine Edge API'lerini kullanmanızı öneririz:
  • apigee-remote-service-cli bindings add
  • apigee-remote-service-cli bindings remove
Yeni CLI komutu eklendi. Komut: 
apigee-remote-service-cli samples templates

samples create komutunda --template işaretiyle kullanabileceğiniz seçenekleri listeler. KSA referansı bölümüne bakın.
Mevcut CLI komutu değiştirildi. apigee-remote-service-cli samples create komutunda değişiklik yapıldı. Envoy veya Istio şablonlarına özgü işaretler sıkı bir şekilde kontrol edilir ve yanlış kullanılan işaretlerle ilgili hatalar döndürülür. native şablon seçeneğinin desteği sonlandırıldı. Kullanılabilir şablonların listesini almak için apigee-remote-service-cli samples templates komutunu kullanın. Ayrıca CLI referansı bölümüne bakın.
/token uç nokta yanıtı artık OAuth2 spesifikasyonuna uygun. Yanıt parametresine access_token parametresi eklendi ve token parametresinin desteği sonlandırıldı.

v1.2.0

30 Eylül Çarşamba günü, Apigee Adapter for Envoy'un 1.2.0 sürümünü yayınladık.

Desteklenen platformlar

MacOS, Linux ve Windows için ikili dosyalar yayınlıyoruz.

Google'ın distroless, Ubuntu ve Ubuntu with Boring Crypto'dan Docker görüntüleri yayınlıyoruz.

Bu sürümde aşağıdaki platformlar desteklenir:

  • Apigee Hybrid 1.3.x sürümü
  • Istio 1.5, 1.6, 1.7 sürümleri
  • Envoy 1.14 ve 1.15 sürümleri

Özellikler ve iyileştirmeler

Özellik Açıklama
Google Cloud'da Apigee desteği Artık Google Cloud'da Apigee ile Apigee Adapter for Envoy'u kullanabilirsiniz. Adaptörü kendi kümesinde veya Envoy için Uzak Hizmet'i yerel bir ikili dosya ya da kapsayıcı olarak çalıştırarak kullanabilirsiniz. Provision komutunu kullanarak Apigee'de bağdaştırıcıyı sağlama.
Analiz verileri için doğrudan yükleme Artık Apigee Adapter'ı, analiz verilerini doğrudan Apigee'ye yükleyecek şekilde yapılandırabilirsiniz. Apigee Hybrid kullanıyorsanız bu yeni özellik, bağdaştırıcıyı Apigee Hybrid'in yüklü olduğu kümenin dışında, kendi Kubernetes kümesine dağıtmanıza olanak tanır. Doğrudan yüklemeyi etkinleştirmek için provision komutuyla yeni --analytics-sa işaretini kullanın. Provision komutuna bakın.
API ürün verileri Apigee'den yüklendikten sonra sağlık durumu kontrolü "Hazır" döndürüyor API ürün verileri Apigee'den yüklenene kadar Kubernetes durum kontrolü "Hazır" yanıtını döndürmez. Bu değişiklik, yeni oluşturulan bağdaştırıcı hazır olana kadar trafiğin bu bağdaştırıcıya gönderilmemesini sağlayarak ölçeklendirme ve yükseltme işlemlerine yardımcı olur.

Diğer sorunlar ve düzeltmeler

  • Olası bir kota senkronizasyonu kilitlenmesini (17 numaralı sorun) gidermek için bir sorun düzeltildi.
  • Prometheus ek açıklamaları, pod spesifikasyonuna taşındı (69 numaralı sorun).
  • Yanlış şekilde verilen doğrulama hatalarını (62 numaralı sorun) gidermek için bir sorun düzeltildi.

v1.1.0

26 Ağustos Çarşamba günü, Apigee Adapter for Envoy'un 1.1.0 sürümünü yayınladık.

Desteklenen platformlar

MacOS, Linux ve Windows için ikili dosyalar yayınlıyoruz.

Google'ın distroless, Ubuntu ve Ubuntu with Boring Crypto'dan Docker görüntüleri yayınlıyoruz.

1.1.0 sürümünde aşağıdaki platformlar desteklenir:

  • Apigee Hybrid 1.3 sürümü
  • Istio 1.5, 1.6, 1.7 sürümleri
  • Envoy 1.14 ve 1.15 sürümleri

Özellikler ve iyileştirmeler

Özellik Açıklama
Bağlamaları doğrulama KSA'ya yeni bir komut apigee-remote-service-cli bindings verify eklendi. Bu komut, belirtilen bağlı API ürününün ve ilişkili geliştirici uygulamalarının da kendileriyle ilişkili bir uzak hizmet ürününe sahip olduğunu doğrular. Bağlantıyı doğrulama başlıklı makaleyi inceleyin.
Örnek oluşturma KSA'ya yeni bir komut apigee-remote-service-cli samples create eklendi. Bu komut, yerel Envoy veya Istio dağıtımları için örnek yapılandırma dosyaları oluşturur. Bu komutla oluşturduğunuz yapılandırma dosyaları, önceki sürümlerde Envoy için bağdaştırıcı ile yüklenen örnek dosyaların yerini alır. Örnekler komutuna bakın.
OAuth2 kimlik doğrulaması Adaptör artık Apigee Edge için çok öğeli kimlik doğrulama (MFA) etkinleştirildiğinde OAuth2 kimlik doğrulamasını kullanıyor. --legacy işaretini her kullandığınızda --mfa işaretini kullanın.
Distroless kapsayıcı Adaptör artık varsayılan Docker görüntü tabanı için scratch yerine Google'ın distroless (gcr.io/distroless/base) görüntüsünü kullanıyor.

Diğer sorunlar ve düzeltmeler

  • OPDK'daki bağlama komutlarıyla ilgili bir CLI sorunu düzeltildi. (#29)
  • Bağlantı kaybedildiğinde kota takılabilir (apigee/apigee-remote-service-envoy. (#31)
  • Docker görüntüleri artık root olmayan kullanıcı (999) ile oluşturuluyor.
  • Kubernetes örnekleri, kullanıcının root olmamasını zorunlu kılar.
  • Proxy uç noktalarına yönelik curl komutları için artık --http1.1 gerekli değildir. İşaret, örneklerden kaldırıldı.

v1.0.0

31 Temmuz Cuma günü, Apigee Adapter for Envoy'un GA sürümünü yayınladık.

Desteklenen platformlar

MacOS, Linux ve Windows için ikili dosyalar yayınlıyoruz.

Sıfırdan, Ubuntu ve Boring Crypto ile Ubuntu olmak üzere Docker görüntüleri yayınlıyoruz.

1.0.0 sürümünde aşağıdaki platformlar desteklenir:

  • Apigee Hybrid 1.3 sürümü
  • Istio 1.5, 1.6 sürümleri
  • Envoy 1.14 ve 1.15 sürümleri

Eklemeler ve değişiklikler

v1.0-beta4 sürümü ile GA arasında bağdaştırıcıda aşağıdaki eklemeler ve değişiklikler yapıldı:

  • Go Boring builds

    Artık FIPS uyumlu Go BoringSSL kitaplıklarını kullanan yeni bir derleme mevcut.

  • Günlük düzeyi işaret değişiklikleri

    Tutarlılık için apigee-remote-service-envoy hizmetinin günlük kaydı düzeyi işaretleri değiştirildi:

    Eski bayrak Yeni işaret
    log_level log-level
    json_log json-log
  • Yeni KSA işaretleri

    CLI token komutlarına yeni işaretler eklendi:

    İşaret Açıklama
    --legacy Apigee Edge Cloud kullanıyorsanız bu işareti ayarlayın.
    --opdk Apigee Edge for Private Cloud kullanıyorsanız bu işareti ayarlayın.