یادداشت‌های انتشار Edge برای «ابر خصوصی» نسخه ۴.۵۱.۰۰

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

در تاریخ ۲۹ ژوئیه ۲۰۲۱، نسخه ۴.۵۱.۰۰ از «انتشار ویژگی Edge برای ابر خصوصی» را منتشر کردیم.

خلاصه انتشار

جدول زیر تغییرات این نسخه پخش را خلاصه می‌کند:

ویژگی‌های جدید

این نسخه شامل ویژگی‌های جدید زیر است:

○ پنجره بالاپری جدیدی تاریخ‌های پایان عمر (EOL) را به شما هشدار می‌دهد
○ امکان خروج کاربران از سیستم هنگام تغییر گذرواژه‌هایشان
○ تنظیم نسخه TLS برای SMTP
○ افزودن نوشتار pg-data-purge بهبودیافته برای پاک‌سازی اختیاری داده‌ها از جدول‌های حقیقت اصلی
○ افزودن sosreport، ابزار جدیدی برای تشخیص خرابی و جمع‌آوری داده‌ها در سطح سیستم.

برای کسب اطلاعات بیشتر درباره هریک از این ویژگی‌های جدید، به ویژگی‌های جدید مراجعه کنید.
سازگاری با نسخه قدیمی

مشکلات زیر که بر سازگاری با نسخه‌های قبلی تأثیر می‌گذارند در این نسخه از Apigee Edge برای «ابر خصوصی» معرفی شده‌اند:

  • «افزونه‌های مدیریت Java» (JMX) دیگر به‌طور پیش‌فرض برای واحد Apigee SSO (ورود به سیستم واحد) فعال نیست.
  • به‌دلیل رفع مشکل ۱۳۲۴۴۳۱۳۷ (همان‌طور که در یادداشت‌های انتشار Cloud عمومی در تاریخ ۱۹.۰۳.۰۱ توضیح داده شده است)، «پردازشگرهای پیام» اکنون سرایندهایی را که با X-Apigee-* شروع می‌شوند نادیده می‌گیرند. درنتیجه، باید هر کدی را که از سرایندهای X-Apigee-* استفاده می‌کند بازسازی کنید و آن سرایندها را با سرایندهای پشتیبانی‌شده جایگزین کنید.

  • نام فایل‌های گزارش Cassandra تغییر کرده است. اکنون این است:

    /opt/apigee/var/log/apigee-cassandra/system.log
نسخه‌های پخش گنجانده‌شده

از زمان انتشار ویژگی قبلی Edge for Private Cloud، نسخه‌های پخش زیر منتشر شده است و در این نسخه پخش گنجانده شده است:

○ Edge:
   20.08.03 (مسیریاب)
   20.09.18 (سرور مدیریت)
   21.03.08 (مسیریاب، سرور مدیریت، پردازشگر پیام)
بازنشستگی‌ها خالی
منسوخ‌سازی‌ها

با انتشار نسخه ۴.۵۱.۰۰:

  • 4.19.06: نسخه 4.19.06 از Apigee Edge برای «ابر خصوصی» اکنون منسوخ شده است.

برای اطلاعات دقیق‌تر درباره منسوخ شدن‌ها، ازجمله جدول زمانی برداشتن، به منسوخ شدن‌ها و بازنشستگی‌های Apigee مراجعه کنید.
مشکلات شناخته‌شده

این نسخه شامل مشکلات شناخته‌شده زیر است:

برای اطلاعات بیشتر درباره هریک از این مشکلات شناخته‌شده، ازجمله راهکارهای موقت، به مشکلات شناخته‌شده مراجعه کنید.

مسیرهای ارتقا

برای دستورالعمل‌های ارتقا به Edge for Private Cloud نسخه ۴.۵۱.۰۰، به به‌روزرسانی Apigee Edge نسخه ۴.۱۹.۰۶ یا ۴.۵۰.۰۰ به ۴.۵۱.۰۰ مراجعه کنید.

ویژگی‌های جدید

این بخش ویژگی‌های جدید این نسخه پخش را فهرست می‌کند. علاوه‌براین، این نسخهٔ پخش شامل همه ویژگی‌های موجود در نسخه‌های پخش «میانای کاربر Edge»، «مدیریت Edge»، و «درگاه» فهرست‌شده در نسخه‌های پخش گنجانده‌شده می‌شود.

علاوه‌بر بهبودهای زیر، این نسخهٔ پخش شامل بهبودهای متعددی در زمینه کارایی، عملکرد، امنیت، و پایداری نیز می‌شود.

پنجره بالاپری جدیدی درباره تاریخ‌های پایان عمر (EOL) برای Edge for Private Cloud به شما هشدار می‌دهد

مشتریان Edge for Private Cloud شش ماه قبل‌از تاریخ EOL نسخه نصب‌شده، پیام‌های هشدار را مشاهده خواهند کرد. پیام «پایان عمر» در هر جلسه مرورگر یک‌بار نشان داده می‌شود: اگر برگه یا مرورگر را ببندید، جلسه ازدست خواهد رفت. اگر سپس Apigee را در مرورگر دوباره باز کنید، پیام دوباره نمایش داده خواهد شد.

گزینه جدید برای خروج کاربران از سیستم هنگام تغییر گذرواژه

پرچم جدیدی به apigee.feature.clearSessionOnPasswordUpdate اضافه شد که به شما امکان می‌دهد پیکربندی کنید که آیا کاربران پس‌از تغییر گذرواژه از سیستم خارج شوند یا نه. پیش‌فرض این است که کاربران از سیستم خارج نمی‌شوند.

پرچم جدید برای تنظیم نسخه «امنیت لایه انتقال» برای SMTP

پرچم جدیدی به mail.smtp.ssl.protocols اضافه شده است که پروتکل SSL فعال برای اتصالات SMTP را مشخص می‌کند. این ویژگی به شما امکان می‌دهد پروتکل‌های SSL را براساس الزامات امنیتی‌تان پیکربندی کنید.

با افزودن ورودی زیر به فایل دارایی‌ها می‌توانید این پرچم را تنظیم کنید، /opt/apigee/customer/application/ui.properties:

conf_apigee.mail.smtp.ssl.protocols=ssl-protocol

مقادیر ممکن برای ssl-protocol عبارت‌اند از SSLv2Hello، SSLv3، TLSv1، TLSv1.1، و TLSv1.2.

ابزار تشخیص خرابی جدید، sosreport

Sosreport، ابزار جدیدی برای تشخیص خرابی و جمع‌آوری داده در سطح سیستم، اضافه شد.

پشتیبانی از نسخه‌های جدید نرم‌افزار اضافه شد

‫Apigee پشتیبانی از نسخه‌های نرم‌افزار زیر را اضافه کرده است:

پیکربندی پراکسی بازارسال.

پرچم‌های زیر اضافه شده است که به شما امکان می‌دهد پراکسی ارسال را پیکربندی کنید:

  • http.proxyHost
  • http.proxyPort
  • http.proxyUser
  • http.proxyPassword

به‌طور پیش‌فرض، مقادیر پرچم‌ها خالی است.

دستورگان pg-data-purge را بهبود داد تا جدول‌های حقیقت والد را از تجزیه‌وتحلیل پاک کند

برای اجرای دستورگان، فرمان زیر را وارد کنید:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql pg-data-purge org_name env_name number_of_days_to_retain [Delete-from-parent-fact - N/Y] [Confirm-delete-from-parent-fact - N/Y]

دستورگان گزینه‌های زیر را دارد:

  • Delete-from-parent-fact پیش‌فرض : خیر. داده‌های قدیمی‌تر از دوره نگهداری روز از جدول حقیقت والد نیز حذف خواهد شد.
  • skip-prompt. پیش‌فرض: خیر. اگر خیر باشد، پیش‌از حذف داده‌ها از واقعیت اصلی، برنامه از شما می‌خواهد حذف را تأیید کنید. اگر دستور پاک‌سازی خودکار است، روی «بله» تنظیم کنید.

گزینه تغییر برچسب کاربر در صفحه ورود به سیستم

پرچم جدیدی به‌نام apigee.feature.customLoginUserLabel به شما امکان می‌دهد برچسب کاربر را در صفحه ورود به سیستم براساس اولویت کاربر پیکربندی کنید. پیش‌فرض «نشانی ایمیل» است.

نرم‌افزار پشتیبانی‌شده

این نسخه شامل تغییرات زیر در نرم‌افزار پشتیبانی‌شده است:

پشتیبانی اضافه شد دیگر پشتیبانی نمی‌شود

این نسخه پخش از نسخه‌های نرم‌افزار زیر پشتیبانی می‌کند:

  • Red Hat Enterprise Linux (RHEL) 7.5،‏ 7.6،‏ 7.7،‏ 7.8،‏ 7.9،‏ 8.0
  • Amazon Linux AMI 2
  • ‫Postgres 10.17
  • Nginx 1.20.1

نسخه‌های نرم‌افزار زیر دیگر با این نسخه پخش پشتیبانی نمی‌شوند:

  • Red Hat Enterprise Linux (RHEL) 6.X
  • Amazon Linux AMI 1
  • Node.js 0.10.32

برای فهرست کامل پلاتفرم‌های پشتیبانی‌شده، به نرم‌افزار پشتیبانی‌شده و نسخه‌های پشتیبانی‌شده مراجعه کنید.

رفع اشکال‌ها

این بخش فهرست اشکالات «ابر خصوصی» را که در این نسخه اصلاح شده است ارائه می‌دهد. علاوه‌براین، این نسخهٔ پخش شامل همه رفع اشکال‌های موجود در نسخه‌های پخش «واسط کاربر Edge»، «مدیریت Edge»، و «درگاه» است که در نسخه‌های پخش گنجانده‌شده نشان داده شده است.

شناسه مشکل شرح
120421482

اکنون ایجاد KVM شامل بررسی‌های اضافی برای تأیید وجود محیط مشخص‌شده است.

درخواست‌های POST و GET که محیط‌های غیرموجود را هدف‌یابی می‌کنند خطای ۴۰۴ برمی‌گردانند.
112262604

وقتی انتقال خرابی Postgres انجام می‌شود، «سرور مدیریت Mint» باید به‌روزرسانی شود

یک دستورگان بهبودیافته برای تغییر جزئیات اتصال Postgres برای سرور Mint Management ایجاد شد. مدیریت انتقال پایگاه داده PostgreSQL را ببینید.
150844280

بدون اتصال اینترنت، «ورود به سیستم تک‌عاملی Apigee» سعی کرد کتابخانه قلم خارجی را درطول ورود به سیستم بارگیری کند.

قلم Google Sans برای سرایندها که پروانه منبع باز ندارد، با قلم Noto Sans جایگزین شده است.
161351690

خط‌مشی HMAC در انتخابگر خط‌مشی ظاهر نشد.

اکنون خط‌مشی در انتخابگر خط‌مشی نمایش داده می‌شود.
168149141

نصب درآمدزایی در سرور مدیریت دوم ناموفق بود.

برخی‌از مشکلات احتمالی ناشی از وضعیت مسابقه درطول نصب «سرور مدیریت Mint» برطرف شده است.
170089960

برچسب کاربر در صفحه ورود به سیستم تغییر نکرد

پرچم جدیدی به apigee.feature.customLoginUserLabel اضافه شده است. با این پرچم، می‌توانید برچسب کاربر را در صفحه ورود به سیستم پیکربندی کنید. پیش‌فرض برچسب موجود است، یعنی نشانی ایمیل..
170791446

در «میانای کاربری توسعه‌دهندگان»، نویسه غیرمجاز در نشانی ایمیل توسعه‌دهنده مانع ویرایش جزئیات توسعه‌دهنده شد.

این مشکل برطرف شده است.
173657467

اگر گره‌های Cassandra در مراکز داده دیگر ازکارافتاده بودند، «سرور مدیریت» بالا نمی‌آمد.

برای جلوگیری از این مشکل، اسکریپت فعال کردن اصالت‌سنجی Cassandra بهبود یافته است.
175638733

‫AWS Linux 1 درحال منسوخ شدن است

پشتیبانی از AWS Linux 2 اضافه شده است.
175942835

درخواست‌های GET به dailysummaryreports بدون محافظت CSRF مجاز بود

این مشکل برطرف شده است
178305317

کارخواه Consul connect از همه سرورهای Consul دردسترس برای انتقال خودکار استفاده نمی‌کرد

این مشکل برطرف شده است
180207712

مشتریان به‌دلیل نادرست بودن دارایی CASS_HOSTS نتوانستند گره‌های Cassandra جدید اضافه کنند.

اگر دارایی CASS_HOSTS نادرستی ارائه شود، راه‌اندازی Cassandra اکنون پیام خطای بهبودیافته‌ای برمی‌گرداند.
186503861

خط‌مشی «دعوت به اقدام سرویس» هنگام استفاده از عنصر مقادیر سرایند را به‌اشتباه تقسیم می‌کرد.

پیکربندی کلی (conf_http_HTTPHeader.{ANY}) برای کنترل رفتار پیش‌فرض چندارزشی و تکراری همه «سرایندها» اضافه شد. این پیکربندی فقط درصورتی اعمال می‌شود که پیکربندی سرصفحه خاصی وجود نداشته باشد.
182456858

سرور مدیریت همیشه به سرور Postgress منطقه محلی متصل نمی‌شد.

الگوریتم انتخاب Postgres در سرور «مدیریت» بهینه‌سازی شده است تا به گره Postgres در منطقه محلی متصل شود
182857918

پیام‌های گزارش وقتی «پردازنده پیام» به حد مجاز اتصال خود می‌رسد بهبود یافته است. این کار عیب‌یابی را ساده‌تر می‌کند.
183147699

توسعه dc-4 مشتری به‌دلیل نام منطقه سفارشی ناموفق بود.

دارایی جدیدی به‌نام REGION_MAPPING به شما امکان می‌دهد نام‌های منطقه سفارشی‌تان را به نام‌های منطقه استاندارد (dc-1،‏ dc2، و غیره) اختصاص دهید. مرجع فایل پیکربندی Edgeرا ببینید.
185285557

ویژگی اختیاری‌ای اضافه شد تا ایمیل‌های توسعه‌دهنده به حروف بزرگ و کوچک حساس نباشند.

این ویژگی به‌طور پیش‌فرض خاموش است، بنابراین ایمیل‌های توسعه‌دهنده همچنان به حروف بزرگ و کوچک حساس هستند (رفتار فعلی).
189743303

«میانای برنامه‌سازی کاربردی Analytics» با فیلتری برای کنار گذاشتن پراکسی‌های میانای برنامه‌سازی کاربردی خطایی برمی‌گرداند.

مشکلی در تجزیه فیلترها درحین اجرای گزارش‌های سفارشی برطرف شده است.
171240470

وقتی «احراز هویت Cassandra JMX» یا «پروتکل امن لایه انتقال» فعال بود، به‌روزرسانی مدیریت انجام نمی‌شد

ویژگی‌ای اضافه شد که هنگام اجرای راه‌اندازی یا به‌روزرسانی در سرور «مدیریت»، پیکربندی‌های SSL و اصالت‌سنجی Cassandra JMX را ارائه می‌دهد.
168560804

هنگام ایجاد جریان مشترک در «میانای کاربر Edge»، میانای کاربر خطای ۴۰۳ برای مجوزهای ناکافی برمی‌گرداند.

مقدار تعریف‌نشده‌ای که به «میانای برنامه‌سازی کاربردی» ارسال می‌شد اصلاح شد.
171985727

بهبودهایی در پیکربندی‌های JMX در Cassandra ایجاد شد تا پیکربندی‌ها از استانداردهای پیکربندی دیگر Apigee پیروی کنند و تغییرات درطول ارتقای Cassandra ملغی نشوند.
188526117

فرمان IP با مسیر مطلق پیشوندگذاری نشده است.

اکنون مسیر مطلق در فرمان گنجانده شده است.
123015330

شماره‌های قالب‌بندی‌نشده در فایل .properties عنصر باعث می‌شد عنصر شروع نشود

این مشکل برطرف شده است.
161934168

آسیب‌پذیری طراحی پروتکل PostgreSQL PassTheHash، توسط PostgreSQL به Postgres نسخه ۱۰.۱۷

این مشکل برطرف شده است.
185115206

بهبودهایی برای بهبود عملکرد پُرسمان‌های تجزیه‌وتحلیل در «سرور مدیریت» ایجاد شد
193870176

پیکربندی سطح «رهیاب» برای غیرفعال کردن گزینه‌های شنود «میزبان مجازی» در درگاه‌های استاندارد ۸۰ و ۴۴۳ اضافه شد.
197331224

اگر سازمان وجود نداشته باشد، «دریافت سازمان» به‌جای خطای ۴۰۴-پیدا نشد، خطای ۴۰۳-غیرمجاز برمی‌گرداند.
184573211

«افزونه‌های مدیریت Java» (JMX) دیگر به‌طور پیش‌فرض برای واحد Apigee SSO فعال نیست.

مشکلات امنیتی برطرف شد

در این نسخه پخش، مشکلات امنیتی شناخته‌شده زیر برطرف شده است. برای جلوگیری از این مشکلات، جدیدترین نسخه Edge Private Cloud را نصب کنید.

شناسه مشکل شرح
CVE-2018-16131

آسیب‌پذیری: [محروم‌سازی از سرویس (DoS)] در پروژه unified-experience/navbar (SNYK-JAVA-COMTYPESAFEAKKA-32493) پیدا شد. این مشکل برطرف شده است.
CVE-2020-7676

آسیب‌پذیری «دستورگان‌نویسی بین‌سایتی» (XSS) در jQuery. آسیب‌پذیری در jQuery که دستورگان‌نویسی بین‌سایتی (XSS) را گزارش می‌کرد برطرف شد.
CVE-2016-5388

آسیب‌پذیری در Tomcat servlet. سرویس‌دهنده Tomcat نسخه ۸.۰.۵۳ آسیب‌پذیری امنیتی داشت. ارتقا دادن Tomcat servlet به ‫۸.۵.۳۴ این آسیب‌پذیری را برطرف کرد.

مشکلات شناخته‌شده

جدول زیر مشکلات شناخته‌شده در این نسخه پخش را فهرست می‌کند:

شناسه مشکل شرح
194249507

‫apigee-mirror در Red Hat Enterprise Linux (RHEL) 8.0 کار نمی‌کند.

به‌عنوان راهکار موقت، apigee-mirror را روی سروری که نسخه پایین‌تری از RHEL یا سیستم‌عامل پشتیبانی‌شده دیگری برای Apigee اجرا می‌کند نصب کنید. سپس می‌توانید از آینه برای افزودن بسته‌ها استفاده کنید، حتی اگر Apigee را روی سرورهای RHEL 8.0 نصب کرده باشید.

برای فهرست کامل مشکلات شناخته‌شده، مشکلات شناخته‌شده Edge for Private Cloud را ببینید.

مرحله بعدی

برای شروع کار با Edge for Private Cloud 4.51.00، از پیوندهای زیر استفاده کنید:

نصب‌های جدید:

نمای کلی نصب جدید

نصب‌های موجود

‫Apigee Edge نسخه 4.19.06 یا 4.50.00 را به نسخه 4.51.00 به‌روز کنید.