درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
v2.1.1
در ۷ ژوئن ۲۰۲۳، نسخه ۲.۱.۱ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
مشکلات برطرف شد
- مشکلی که در آن سهمیهها بهجای اینکه در سطح «محصول» همرسانی شوند، بهطور نادرست بین عملیاتها تکرار میشدند برطرف شد.
v2.1.0
در ۵ ژوئن ۲۰۲۳، نسخه ۲.۱.۰ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
مشکلات برطرف شد
- ادعای
application_idبه پاسخ/verifyApiKeyاضافه شد.
v2.0.7
در تاریخ ۹ مارس ۲۰۲۳، نسخه ۲.۰.۷ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
ویژگیها و بهبودها
- اکنون «توکنهای وب JSON» میتوانند ادعایی بهنام
customattributesاضافه کنند که مقدار را در سرصفحهای بهنامx-apigee-customattributesبه هدف منتقل میکند (اگرappend_metadata_headersپیکربندی شده باشد کهtrueباشد).
مشکلات برطرف شد
- مشکلی برطرف شد که در آن کلید api نامعتبر میتوانست ورودیهای گزارش و سوابق تجزیهوتحلیل جعلی ایجاد کند.
- بررسی نسخه منسوخشده در پراکسی برداشته شد که باعث ایجاد مشکلاتی در نسخههای جدیدتر Apigee میشد.
v2.0.6
در تاریخ ۱۸ اکتبر ۲۰۲۲، نسخه ۲.۰.۶ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
مشکلات برطرف شد
- نسخه امنیتی برای رفع آسیبپذیری «محرومسازی از سرویس» (DoS) در کتابخانه وابستگی. به CVE-2022-28948 مراجعه کنید.
v2.0.5
در تاریخ ۳ مارس ۲۰۲۲، نسخه ۲.۰.۵ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
مشکلات برطرف شد
- نسخه امنیتی برای رفع خطر «محرومسازی از سرویس» (DoS) در کتابخانه prometheus. CVE-2022-21698 را ببینید.
v2.0.4
در تاریخ ۳ دسامبر ۲۰۲۱، نسخه ۲.۰.۴ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
ویژگیها و بهبودها
- فهرست نسخههای پشتیبانیشده Envoy و Istio برای فرمان CLI
samplesبهروز شده است. اکنون این نسخهها برای نمونهها پشتیبانی میشوند:- نسخههای Envoy از ۱.۱۸ تا ۱.۲۰
- نسخههای Istio از ۱.۱۰ تا ۱.۱۲
مشکلات برطرف شد
- برای جلوگیری از بروز خطا، بررسی تهی بودن برای بار کردن کلید خصوصی بلوک PEM اضافه شد. (مسئله شماره ۳۶۰)
- خطاهای مجوز سرویس از دور اکنون در سطح «اشکالزدایی» ثبت میشوند. خطاهای واکشی کد برای کلیدهای میانای برنامهسازی کاربردی از این دستهبندی مستثنا هستند. در این صورت، خطاها در سطح «خطا»
ثبت میشوند تا حتی اگر سطح گزارش «اشکالزدایی» برای
apigee-remote-service-envoyغیرفعال باشد، قابل مشاهده باشند. همچنین تنظیم سطوح گزارش سرویس از دور را ببینید. (مشکل شماره ۱۰۴)
v2.0.3
در تاریخ ۲۱ سپتامبر ۲۰۲۱، نسخه ۲.۰.۳ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
مشکلات برطرف شد
- مشکل ثبت گزارش تجزیهوتحلیل با پاسخهای مستقیم برطرف شد. این مشکل فقط تحت شرایط خاصی رخ میداد. برای مثال:
- برای درخواستهایی که نیاز به بررسی اصالتسنجی/مجوز ندارند،
authContextتولید نشد و فراداده پویا تهی بود که باعث شد ورودی گزارش دسترسی نادیده گرفته شود. - پاسخ ردشده بهجای کد HTTP از کد RPC استفاده کرده است و باعث شده است گزارشها در «واسط کاربر Apigee» بهعنوان موفقیت نشان داده شود.
- برای درخواستهایی که نیاز به بررسی اصالتسنجی/مجوز ندارند،
v2.0.2
در تاریخ ۷ ژوئن ۲۰۲۱، نسخه 2.0.2 «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
مشکلات برطرف شد
- شرایط مسابقهای که میتوانست باعث خطاهای ۴۰۳ و وحشت شود وقتی ادعاهای JWT محدودههای تهی بودند برطرف شد.
v2.0.0
روز سهشنبه، ۶ آوریل ۲۰۲۱، نسخه ۲.۰.۰ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
ویژگیها و بهبودها
| ویژگی | شرح |
|---|---|
| پشتیبانی از محیط چند مستأجره |
اکنون میتوانید آداپتور را فعال کنید تا چندین محیط را در سازمان Apigee سرویسدهی کند. این ویژگی به شما امکان میدهد از یک «آداپتور Apigee برای Envoy» منسوب به یک سازمان Apigee برای سرویسدهی به چندین محیط استفاده کنید. پیشاز این تغییر، یک آداپتور همیشه به یک محیط Apigee متصل بود. برای اطلاعات بیشتر درباره این ویژگی، پشتیبانی از محیط چند مستأجره را ببینید. |
| پشتیبانی از Envoy v3 API | |
| پشتیبانی از فراداده Envoy |
Envoy نسخه ۱.۱۶ و بالاتر امکان ارسال فراداده این ویژگی فقط برای Envoy 1.16+ و Istio 1.9+ پشتیبانی میشود.
با این تغییر، پیکربندی زیر دیگر به فایل پیکربندی Envoy ( 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
اگر میخواهید سرصفحهها را به درخواستهای مورد خاصی پیوست کنید، کافی است دارایی
|
جدا کردن پراکسی remote-token از پراکسی remote-service |
کارگزاری remote-service به دو کارگزاری جداگانه بازسازی شده است. نسخه v2.0.x، تدارک
دو پراکسی API نصب خواهد کرد: remote-service و remote-token. نقطههای پایانی
این تغییر باعث ایجاد تفکیک مفیدی در عملکردها میشود. اکنون، پراکسی remote-service
فقط برای ارتباطات داخلی «آداپتور» استفاده میشود، درحالیکه پراکسی remote-token
گردش کار نمونهای از OAuth را ارائه میدهد که میتوانید آن را سفارشیسازی کنید. هرگز کارگزار رمز دور سفارشی شما را
بازنویسی نخواهیم کرد، حتی اگر از فرمان |
| پشتیبانی از ضبط دادهها |
فقط برای Apigee X و Apigee hybrid دردسترس است. اکنون «آداپتور» از انتقال فراداده Envoy به ویژگی ضبط داده Apigee پشتیبانی میکند، که دادههای ضبطشده در متغیرهایی را که مشخص میکنید به تجزیهوتحلیل Apigee ارسال میکند تا در گزارشهای سفارشی استفاده شود. |
| کنترل دسترسی نقشمحور لازم نیست | همانطور که قبلاً در بخش پشتیبانی از فراداده Envoy ذکر شد، اکنون درخواستهای غیرمجاز را بدون نیاز به فیلتر RBAC جداگانه فوراً رد میکنیم. چون از RBAC استفاده نمیشود، مشتریان اکنون این کدهای وضعیت HTTP را بهصورت مناسب از «آداپتور» دریافت خواهند کرد:
اگر میخواهید درخواستهای غیرمجاز ادامه یابد، میتوانید با تنظیم
|
سرصفحههای x-apigee-* دیگر بهطور پیشفرض پیوست نمیشوند |
همانطور که قبلاً در بخش پشتیبانی از فراداده Envoy ذکر شد،
سرایندهای |
| تطبیق سفارشی درخواست با هدف سرویس راه دور |
معناشناسی دارایی پیکربندی
برای ملغی کردن مقدار این سرایند بااستفاده از فراداده Envoy، میتوانید عنصر فراداده 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 |
| Analytics برای درخواستهای ردشده بلافاصله ثبت میشود | «آداپتور Envoy» اکنون درخواستهای ردشده را بلافاصله در تجزیهوتحلیلها ثبت میکند بهجای اینکه منتظر بماند درخواست در گزارش دسترسی برگردد. این روش کارآمدتر است و نیازی به پیوست کردن فراداده به درخواست ندارد. |
| پشتیبانی UDCA برداشته شده است | جاریسازی به «عامل جمعآوری دادههای جهانی» (UDCA) در Apigee hybrid و Apigee X دیگر برای تجزیهوتحلیل لازم نیست زیرا با بارگذاری مستقیم جایگزین شده است. این تغییر فقط پشتیبانی قدیمی را برای این گزینه برمیدارد. |
| پشتیبانی mTLS برای Edge for Private Cloud در دستورات CLI مربوط به آمادهسازی/پیوندها اضافه شد |
کاربران Apigee Edge for Private Cloud میتوانند گواهینامههای TLS سمت کارخواه و گواهینامه ریشه را بهترتیب ازطریق |
| پشتیبانی mTLS بین آداپتور و زمان اجرای Apigee |
میتوانید گواهینامههای TLS سمت کارخواه را در بخش |
مشکلات برطرف شد
- مشکلی رفع شد که در آن چندین پیکربندی عملیات با منبع API یکسان شناسههای سطل سهمیه یکسانی را همرسانی میکردند و باعث تعارض در محاسبه سهمیه میشدند. (نسخه #34)
- مشکلی برطرف شد که در آن عملیات بدون فعل مشخص باعث رد شدن درخواست میشد (رفتار موردانتظار این است که اگر فعلی مشخص نشده باشد، همه فعلها مجاز باشند). (مشکل #39)
v1.4.0
در روز چهارشنبه، ۱۶ دسامبر ۲۰۲۰، نسخه ۱.۴.۰ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
پلاتفرمهای پشتیبانیشده
ما فایلهای اجرایی برای MacOS، Linux، و Windows منتشر میکنیم.
تصاویر docker را از distroless Google، Ubuntu، و Ubuntu با Boring Crypto منتشر میکنیم.
در این نسخه از پلاتفرمهای زیر پشتیبانی میکنیم:
- Apigee hybrid نسخه 1.3.x، 1.4.x (تاریخ انتشار در انتظار)، Apigee Edge برای «ابر عمومی»، Apigee Edge برای «ابر خصوصی»، و Apigee در Google Cloud
- نسخههای Istio 1.5، 1.6، 1.7، 1.8
- نسخههای Envoy 1.14، 1.15، 1.16
ویژگیها و بهبودها
| ویژگی | شرح |
|---|---|
کارگزار remote-service دیگر نیازی به
ارتباط با محصول میانای برنامهسازی کاربردی که از «هدفهای سرویس از دور» استفاده میکند ندارد. |
ازآنجاییکه این ارتباط دیگر لازم نیست، تغییرات زیر را درنظر داشته باشید:
|
| نقش «سرپرست سازمان Apigee» دیگر برای آمادهسازی لازم نیست. |
بهجای اینکه اجازه سرپرست سازمان را برای آمادهسازی لازم بدانید، اکنون میتوانید از
«میانای برنامهسازی کاربردی نقشهای IAM» بهجای «سازنده» و «پیادهکننده» استفاده کنید. برای آمادهسازی موفقیتآمیز باید هر دو نقش را اعطا کنید.
|
سایر مشکلات و اصلاحات
- مشکلی برطرف شد که در آن، آمادهسازی مجدد Apigee بدون گزینه
--rotateبا خطا از برنامه خارج میشد. - CLI تدارک اکنون اطلاعات اعتباری حساب سرویس Analytics را از فایل
config.yamlمشخصی میخواند و دوباره استفاده میکند (مشکل شماره ۱۳۳).
v1.3.0
روز دوشنبه، ۲۳ نوامبر، نسخه ۱.۳.۰ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
پلاتفرمهای پشتیبانیشده
ما فایلهای اجرایی برای MacOS، Linux، و Windows منتشر میکنیم.
تصاویر docker را از distroless Google، Ubuntu، و Ubuntu با Boring Crypto منتشر میکنیم.
در این نسخه از پلاتفرمهای زیر پشتیبانی میکنیم:
- Apigee hybrid نسخه 1.3.x، 1.4.x (تاریخ انتشار در انتظار)، Apigee Edge برای «ابر عمومی»، Apigee Edge برای «ابر خصوصی»، و Apigee در Google Cloud
- نسخههای Istio 1.5، 1.6، 1.7، 1.8
- نسخههای Envoy 1.14، 1.15، 1.16
ویژگیها و بهبودها
| ویژگی | شرح |
|---|---|
| پشتیبانی از «گروههای عملیات» محصول API. | «گروههای عملیاتی» منابع و اجرای سهمیه مرتبط را در یک پراکسی یا
سرویس ازراهدور با روشهای HTTP پیوند میدهند.
(فقط برای Apigee در Google Cloud و Apigee hybrid اعمال میشود) |
| پشتیبانی از پراکسی ارسال پویای نمونههای تولیدشده را بردارید. | بهدلیل این تغییر، اگر نام میزبان با میزبان هدف سرویس راه دور که در محصول API تنظیم شده است متفاوت باشد، کارخواهان باید سرایند HOST را اضافه کنند. برای مثال:
curl -i http://localhost:8080/httpbin/headers -H "HOST:httpbin.org" ایجاد محصول API را ببینید. |
| از حسابهای سرویس و «هویت بار کاری» پشتیبانی میکند. | برای اینکه دادههای تجزیهوتحلیل هنگام
اجرای آداپتور خارج از خوشه ترکیبی Apigee در Apigee بارگذاری شود، باید از
پارامتر analytics-sa با فرمان apigee-remote-service-cli provision
استفاده کنید. علاوهبراین، اکنون این آداپتور از «هویت بار کاری» در Google Kubernetes
Engine (GKE) پشتیبانی میکند. فرمان آمادهسازی را ببینید.
(فقط برای Apigee در Google Cloud و Apigee hybrid اعمال میشود) |
مشخصه پیکربندی jwt_provider_key جدید. |
این کلید به فایل پیکربندی اضافه میشود.
این کلید payload_in_metadata ارائهدهنده JWT را در
پیکربندی Envoy
یا صادرکننده JWT در پیکربندی Istio نشان میدهد. |
ویژگی پیکربندی KeepAliveMaxConnectionAge اکنون
به ۱ دقیقه پیشفرض است. |
پیشفرض قبلی ۱۰ دقیقه بود. این تغییر امکان مقیاسبندی روانتر را فراهم میکند. این مقدار برای طول عمر جاریسازی گزارش دسترسی نیز استفاده میشود. فایل پیکربندی را ببینید. |
| فرمانهای «خط فرمان» برداشته شد. | فرمانهای CLI زیر منسوخ شدهاند. توصیه میکنیم بهجای آن از
میاناهای برنامهسازی کاربردی Edge
برای بهروزرسانی هدفهای سرویس از دور برای محصولات میانای برنامهسازی کاربردی استفاده کنید:
|
| فرمان جدید خط فرمان اضافه شد. | فرمان:
apigee-remote-service-cli samples templates گزینههای دردسترس را
که میتوانید با پرچم |
| فرمان CLI موجود تغییر کرد. | تغییری در فرمان apigee-remote-service-cli samples create
ایجاد شد. پرچمهای ویژه الگوهای Envoy یا Istio بهدقت بررسی میشوند و
درصورت استفاده نادرست از پرچمها، خطا برگردانده میشود. گزینه الگوی native منسوخ شده است. برای دریافت فهرستی از الگوهای دردسترس، از فرمان apigee-remote-service-cli samples templates استفاده کنید.
همچنین مرجع CLI را ببینید.
|
پاسخ نقطه پایانی /token اکنون از
مشخصات OAuth2 پیروی میکند. |
پارامتر access_token به پاسخ اضافه شد و پارامتر token منسوخ شده است. |
نسخه ۱.۲.۰
روز چهارشنبه، ۳۰ سپتامبر، نسخه ۱.۲.۰ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
پلاتفرمهای پشتیبانیشده
ما فایلهای اجرایی برای MacOS، Linux، و Windows منتشر میکنیم.
تصاویر docker را از distroless Google، Ubuntu، و Ubuntu با Boring Crypto منتشر میکنیم.
در این نسخه از پلاتفرمهای زیر پشتیبانی میکنیم:
- نسخه ترکیبی Apigee 1.3.x
- نسخههای Istio 1.5، 1.6، 1.7
- نسخههای Envoy 1.14، 1.15
ویژگیها و بهبودها
| ویژگی | شرح |
|---|---|
| پشتیبانی از Apigee در Google Cloud | اکنون میتوانید از «وقثدهنده Apigee برای Envoy» با Apigee در Google Cloud استفاده کنید. میتوانید آداپتور را در خوشه خود اجرا کنید یا با اجرای خدمات از دور برای Envoy بهعنوان باینری بومی یا در یک محفظه. آداپتور را در Apigee بااستفاده از فرمان آمادهسازی آمادهسازی کنید. |
| بارگذاری مستقیم برای دادههای Analytics | اکنون میتوانید «وقثدهنده Apigee» را پیکربندی کنید تا دادههای Analytics را مستقیماً در Apigee بارگذاری کند. اگر از Apigee hybrid استفاده میکنید، این ویژگی جدید امکان استقرار دادن آداپتور در خوشه Kubernetes خودش را، خارج از خوشهای که Apigee hybrid در آن نصب شده است، فراهم میکند. برای فعال کردن بارگذاری مستقیم، از پرچم جدید
--analytics-sa با فرمان provision استفاده کنید.
فرمان آمادهسازی را ببینید.
|
| پساز بار شدن دادههای محصول API از Apigee، بررسی سلامت «آماده» برمیگرداند | تا زمانی که دادههای محصول API از Apigee بارگیری نشود، بررسی سلامت Kubernetes وضعیت «آماده» را برنمیگرداند. این تغییر به مقیاسبندی و ارتقا کمک میکند، زیرا تا زمانی که آداپتور جدید آماده نشود، هیچ ترافیکی به آن ارسال نخواهد شد. |
سایر مشکلات و اصلاحات
- مشکلی برای رفع بنبست احتمالی همگامسازی سهمیه برطرف شد (مشکل شماره ۱۷).
- گزارمانهای Prometheus به مشخصات غلاف منتقل شد (Issue #69).
- مشکلی رفع شد که باعث میشد خطاهای درستیسنجی بهطور نادرست منتشر شوند (مشکل شماره ۶۲).
نسخه ۱.۱.۰
روز چهارشنبه، ۲۶ اوت، نسخه ۱.۱.۰ «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
پلاتفرمهای پشتیبانیشده
ما فایلهای اجرایی برای MacOS، Linux، و Windows منتشر میکنیم.
تصاویر docker را از distroless Google، Ubuntu، و Ubuntu با Boring Crypto منتشر میکنیم.
در نسخه ۱.۱.۰ از پلاتفرمهای زیر پشتیبانی میکنیم:
- نسخه ۱.۳ Apigee hybrid
- نسخههای Istio 1.5، 1.6، 1.7
- نسخههای Envoy 1.14، 1.15
ویژگیها و بهبودها
| ویژگی | شرح |
|---|---|
| درستیسنجی پیوندها | فرمان جدیدی بهنام apigee-remote-service-cli bindings verify به
«خط فرمان» اضافه شد. این فرمان تأیید میکند که محصول API محدود مشخصشده و
برنامههای توسعهدهنده مرتبط آن نیز محصول سرویس از دور مرتبط با خود دارند. به
تأیید یک پیوند مراجعه کنید. |
| تولید نمونهها | فرمان جدیدی بهنام apigee-remote-service-cli samples create به
«خط فرمان» اضافه شد. این فرمان فایلهای پیکربندی نمونه برای
استقرار Envoy یا Istio بومی ایجاد میکند. فایلهای پیکربندی
که با این فرمان تولید میکنید جایگزین فایلهای نمونهای میشود که
با «آداپتور Envoy» در نسخههای قبلی نصب شدهاند. فرمان نمونهها را ببینید. |
| اصالتسنجی OAuth2 | اکنون وقتی اصالتسنجی چندعاملی (MFA) برای Apigee Edge فعال باشد،
آداپتور از اصالتسنجی OAuth2 استفاده میکند. هرزمان که از پرچم
--legacy استفاده میکنید، از پرچم --mfa نیز استفاده کنید. |
| محتوی بدون توزیع | اکنون آداپتور بهجای scratch از تصویر بدون توزیع Google (gcr.io/distroless/base) برای پایه تصویر پیشفرض Docker استفاده میکند. |
سایر مشکلات و اصلاحات
- مشکل «میانای خط فرمان» برای دستورات پیوند در OPDK برطرف شد. (#۲۹)
- وقتی اتصال قطع میشود، سهمیه ممکن است گیر کند (apigee/apigee-remote-service-envoy. (#31)
- تصاویر Docker اکنون با کاربر غیرریشه (۹۹۹) ساخته میشوند.
- نمونههای Kubernetes کاربر را ملزم میکند که نباید ریشه باشد.
- دیگر برای دستورات curl دربرابر نقطههای پایان پراکسی به
--http1.1نیاز نیست. پرچم از مثالها برداشته شده است.
نسخه ۱.۰.۰
روز جمعه، ۳۱ ژوئیه، نسخه «دردسترس عموم» «وقثدهنده Apigee برای Envoy» را منتشر کردیم.
پلاتفرمهای پشتیبانیشده
ما فایلهای اجرایی برای MacOS، Linux، و Windows منتشر میکنیم.
تصاویر docker را از ابتدا، Ubuntu، و Ubuntu با Boring Crypto منتشر میکنیم.
در نسخه ۱.۰.۰ از پلاتفرمهای زیر پشتیبانی میکنیم:
- نسخه ۱.۳ Apigee hybrid
- نسخههای Istio 1.5، 1.6
- نسخههای Envoy 1.14، 1.15
افزودهها و تغییرات
بین نسخه v1.0-beta4 و GA، تغییرات و افزودههای زیر در این آداپتور ایجاد شده است:
رفتن به ساختهای Boring
اکنون ساخت جدیدی دردسترس است که از کتابخانههای Go BoringSSL سازگار با FIPS استفاده میکند.
- تغییرات پرچم سطح گزارش
پرچمهای سطح گزارشگیری برای سرویس apigee-remote-service-envoy بهمنظور یکپارچگی تغییر کرده است:
پرچم قدیمی پرچم جدید log_levellog-leveljson_logjson-log - پرچمهای جدید CLI
پرچمهای جدیدی به فرمانهای
token«خط فرمان» اضافه شد:پرچم شرح --legacyاگر از Apigee Edge Cloud استفاده میکنید، این پرچم را تنظیم کنید. --opdkاگر از Apigee Edge برای «ابر خصوصی» استفاده میکنید، این پرچم را تنظیم کنید.