4.52.00.03 - Edge for Private Cloud یادداشت های انتشار

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

در 25 اکتبر 2023، نسخه جدیدی از Apigee Edge را برای Private Cloud منتشر کردیم.

توجه: این نسخه تا 25 اکتبر 2024 پشتیبانی می شود.

رویه به روز رسانی

اگر در حال به‌روزرسانی از نسخه قبلی Edge برای Private Cloud هستید، این بخش نحوه نصب این نسخه را توضیح می‌دهد. اگر نیاز به به‌روزرسانی از نسخه قبلی دارید، به اعمال چندین نسخه وصله مراجعه کنید.

به‌روزرسانی این نسخه، مؤلفه‌های موجود در فهرست RPM‌های زیر را به‌روزرسانی می‌کند:

  • edge-gateway-4.52.00-0.0.60200.noarch.rpm
  • edge-management-server-4.52.00-0.0.60200.noarch.rpm
  • edge-message-processor-4.52.00-0.0.60200.noarch.rpm
  • edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
  • edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
  • edge-router-4.52.00-0.0.60200.noarch.rpm
  • apigee-sso-4.52.00-0.0.21316.noarch.rpm
  • edge-analytics-4.52.00-0.0.40100.noarch.rpm
  • edge-management-ui-4.52.00-0.0.20029.noarch.rpm
  • edge-ui-4.52.00-0.0.20233.noarch.rpm
  • apigee-service-4.52.00-0.0.1500.noarch.rpm
  • apigee-mirror-4.52.00-0.0.1032.noarch.rpm
  • apigee-tomcat-9.0.82-0.0.939.noarch.rpm
  • apigee-configutil-4.52.00-0.0.624.noarch.rpm

می‌توانید نسخه‌های RPM را که در حال حاضر نصب کرده‌اید بررسی کنید تا ببینید آیا باید به‌روزرسانی شوند، با وارد کردن:

apigee-all version

برای به روز رسانی نصب خود، رویه زیر را در گره های Edge انجام دهید:

  1. در تمام گره های Edge:

    1. مخازن یام را تمیز کنید: 
      sudo yum clean all
    2. آخرین فایل Edge 4.52.00 bootstrap_4.52.00.sh را در /tmp/bootstrap_4.52.00.sh دانلود کنید: 
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
    3. ابزار Edge 4.52.00 apigee-service و وابستگی ها را نصب کنید:
      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

      که در آن uName و pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده اید. اگر pWord حذف کنید، از شما خواسته می شود آن را وارد کنید.

    4. از دستور source برای اجرای اسکریپت apigee-service.sh استفاده کنید: 
      source /etc/profile.d/apigee-service.sh
  2. در تمام گره‌های Edge، اسکریپت update.sh را برای فرآیند edge اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. اسکریپت update.sh را برای SSO در همه گره ها اجرا کنید: 
    4. /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  4. در تمام گره های رابط کاربری، اسکریپت update.sh را برای رابط کاربری اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  5. اگر از تجربه New Edge استفاده می کنید، دستور زیر را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

مشکلات امنیتی رفع شد

در زیر لیستی از مشکلات امنیتی شناخته شده است که در این نسخه رفع شده است. برای جلوگیری از این مشکلات، آخرین نسخه Edge را برای Private Cloud نصب کنید.
شناسه شماره توضیحات
279065506 در URL تغییر مسیر برای OAuth2، آنتروپی پارامتر حالت بهبود یافته است تا آن را غیرقابل پیش بینی کند تا از آسیب پذیری Cross Site Request Forgery (CSRF) جلوگیری شود."،
279065586 سیاست های امنیتی محتوا را در هدر اضافه کرد تا یک لایه امنیتی اضافی برای سایت ها از حملات سمت مشتری فراهم کند.

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

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

  • Red Hat Enterprise Linux (Intel 64-bit): نسخه 8.8
  • اوراکل لینوکس (اینتل 64 بیتی): نسخه های 7.9، 8.7 و 8.8
  • راکی لینوکس 8
  • تامکت 9.0.82

برای مشاهده لیست کامل نرم افزارهای پشتیبانی شده Edge for Private Cloud را ببینید.

محرومیت ها و بازنشستگی ها

هیچ رد یا بازنشستگی جدیدی در این نسخه وجود ندارد.

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

این نسخه ویژگی های جدید زیر را معرفی می کند:

حداکثر تعداد کاراکترها را برای نام سازمان و محیط تنظیم کنید

با این نسخه، می توانید حداکثر تعداد کاراکترها را برای نام سازمان و محیط در هنگام ایجاد یک سازمان یا محیط جدید محدود کنید. مقدار پیش‌فرض برای حداکثر تعداد کاراکترها 255 است. برای تنظیم حداکثر کمتر، ویژگی‌های زیر را در فایل ویژگی‌های مربوطه تنظیم کنید:

  • در فایل ویژگی سازمان، org.name.max.length را تنظیم کنید.
  • در فایل ویژگی سازمان، env.name.max.length تنظیم کنید.

اگر هر یک از این ویژگی ها روی مقدار کمتر از 0 یا بیشتر از 255 تنظیم شود، سیستم به ترتیب از حداکثر مقدار 1 یا 255 استفاده می کند.

انقضای نشانه های دسترسی را تنظیم کنید

با این نسخه، می‌توانید انقضای توکن‌های دسترسی را با تنظیم ویژگی conf_keymanagement_oauth_access_token_expiry_time_in_millis روی زمان انقضای مورد نظر بر حسب میلی‌ثانیه تنظیم کنید. این ویژگی به طور پیش فرض غیرفعال است. برای فعال کردن آن، conf_keymanagement_oauth_access_token_is_apply_limit در پردازشگر پیام روی true تنظیم کنید.

این ویژگی به مدیران Apigee کنترل بهتری بر روی انقضای توکن های دسترسی ایجاد شده در Apigee می دهد.

رفع اشکال

این بخش اشکالات Private Cloud را که در این نسخه رفع شده اند فهرست می کند.

شناسه شماره توضیحات
290242749

هنگامی که متغیر ServiceCallout.response در DataMasking استفاده می شد، خط مشی ها در ردیابی قابل مشاهده نبودند.

این رفع شده است.
260397807

مشکلی در الگوهای ایمیل مانع از ارسال کاراکترهای چند بایتی در ایمیل شد.

این رفع شده است.
234544436

مشکلی وجود داشت که در آن هنگام تغییر سازمان در رابط کاربری Edge جدید، منوی سمت چپ ناپدید می شد.

این رفع شده است.
293268203

وابستگی های تجزیه و تحلیل به طور خودکار در گره های سرور مدیریت ارتقا نمی یافتند.

این رفع شده است.
261616264

چک بوت استرپ اضافه شد تا اطمینان حاصل شود که postgresql در طول فرآیند ارتقا حذف/حذف نشده است.

279065586

در URL تغییر مسیر برای OAuth2، آنتروپی پارامتر حالت بهبود یافته است تا آن را غیرقابل پیش بینی کند تا از آسیب پذیری Cross Site Request Forgery (CSRF) جلوگیری شود.

283310836

پیام خطا هنگام تجزیه XML های بزرگ بهبود یافته است.

245936798

یک مشکل با نام سازمان و محیط باعث ایجاد Postgresql شد پرس و جوها برای شکست.

این با مدیریت بهبود یافته درگیری‌های نام نمایه postgres برای نام‌های طولانی سازمان و محیط برطرف شده است.
293733533

کتابخانه شخص ثالث Spring در اجزای Edge Gateway از نسخه 5.3.20 به نسخه 5.3.27 به روز شده است.

294363158

یک رگرسیون باعث می شد که برخی از ابعاد اضافی در منوهای کشویی صفحات تجزیه و تحلیل و نظارت Edge UI نشان داده شود.

این رفع شده است.
297889765

مصنوعات تولید شده توسط apigee-mirror اکنون دارای مالکیت صحیح هستند.

294989027

بهبود عملکرد برخی از APIهای Stats.

مسائل شناخته شده

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

اعمال چندین نسخه پچ

این بخش نحوه اعمال چندین نسخه وصله را توضیح می‌دهد، در صورتی که در حال به‌روزرسانی از نسخه Edge برای Private Cloud هستید که زودتر از نسخه انتشار پچ قبلی است.

هر نسخه وصله حاوی به‌روزرسانی‌هایی برای اجزای خاص Edge برای Private Cloud، مانند edge-management-server است. برای اعمال چندین نسخه وصله، باید هر مؤلفه Edge را که در نسخه وصله‌ای موجود است دیرتر از نسخه نصب‌شده فعلی‌تان به‌روزرسانی کنید. می‌توانید این مؤلفه‌ها را با نگاه کردن به یادداشت‌های انتشار Edge for Private Cloud برای همه نسخه‌های جدیدتر از نسخه فعلی خود و بررسی فهرست RPM برای آن نسخه‌ها پیدا کنید. برای پیوند به تمام یادداشت‌های انتشار Edge for Private Cloud، به یادداشت‌های انتشار Apigee مراجعه کنید.

توجه: فقط باید هر مؤلفه را یک بار با نصب RPM برای آخرین نسخه مؤلفه موجود در انتشارات پچ، به روز کنید. دستورالعمل‌های یادداشت‌های انتشار مربوط به آن نسخه را برای به‌روزرسانی مؤلفه دنبال کنید.

توجه: ارتقاء یک مؤلفه به طور خودکار آخرین نسخه وصله یک مؤلفه را نصب می کند. اگر می‌خواهید به یک نسخه پچ که جدیدترین نیست ارتقا دهید، باید نسخه تاربال خود را از مخزن Apigee با استفاده از Apigee mirror نگهداری کنید و از این آینه برای نصب Apigee استفاده کنید. برای اطلاعات بیشتر، به استفاده از یک مخزن محلی Edge برای نگهداری نسخه Edge خود مراجعه کنید.

،

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

در 25 اکتبر 2023، نسخه جدیدی از Apigee Edge را برای Private Cloud منتشر کردیم.

توجه: این نسخه تا 25 اکتبر 2024 پشتیبانی می شود.

رویه به روز رسانی

اگر در حال به‌روزرسانی از نسخه قبلی Edge برای Private Cloud هستید، این بخش نحوه نصب این نسخه را توضیح می‌دهد. اگر نیاز به به‌روزرسانی از نسخه قبلی دارید، به اعمال چندین نسخه وصله مراجعه کنید.

به‌روزرسانی این نسخه، مؤلفه‌های موجود در فهرست RPM‌های زیر را به‌روزرسانی می‌کند:

  • edge-gateway-4.52.00-0.0.60200.noarch.rpm
  • edge-management-server-4.52.00-0.0.60200.noarch.rpm
  • edge-message-processor-4.52.00-0.0.60200.noarch.rpm
  • edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
  • edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
  • edge-router-4.52.00-0.0.60200.noarch.rpm
  • apigee-sso-4.52.00-0.0.21316.noarch.rpm
  • edge-analytics-4.52.00-0.0.40100.noarch.rpm
  • edge-management-ui-4.52.00-0.0.20029.noarch.rpm
  • edge-ui-4.52.00-0.0.20233.noarch.rpm
  • apigee-service-4.52.00-0.0.1500.noarch.rpm
  • apigee-mirror-4.52.00-0.0.1032.noarch.rpm
  • apigee-tomcat-9.0.82-0.0.939.noarch.rpm
  • apigee-configutil-4.52.00-0.0.624.noarch.rpm

می‌توانید نسخه‌های RPM را که در حال حاضر نصب کرده‌اید بررسی کنید تا ببینید آیا باید به‌روزرسانی شوند، با وارد کردن:

apigee-all version

برای به روز رسانی نصب خود، رویه زیر را در گره های Edge انجام دهید:

  1. در تمام گره های Edge:

    1. مخازن یام را تمیز کنید: 
      sudo yum clean all
    2. آخرین فایل Edge 4.52.00 bootstrap_4.52.00.sh را در /tmp/bootstrap_4.52.00.sh دانلود کنید: 
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
    3. ابزار Edge 4.52.00 apigee-service و وابستگی ها را نصب کنید:
      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

      که در آن uName و pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده اید. اگر pWord حذف کنید، از شما خواسته می شود آن را وارد کنید.

    4. از دستور source برای اجرای اسکریپت apigee-service.sh استفاده کنید: 
      source /etc/profile.d/apigee-service.sh
  2. در تمام گره‌های Edge، اسکریپت update.sh را برای فرآیند edge اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. اسکریپت update.sh را برای SSO در همه گره ها اجرا کنید: 
    4. /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  4. در تمام گره های رابط کاربری، اسکریپت update.sh را برای رابط کاربری اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  5. اگر از تجربه New Edge استفاده می کنید، دستور زیر را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

مشکلات امنیتی رفع شد

در زیر لیستی از مشکلات امنیتی شناخته شده است که در این نسخه رفع شده است. برای جلوگیری از این مشکلات، آخرین نسخه Edge را برای Private Cloud نصب کنید.
شناسه شماره توضیحات
279065506 در URL تغییر مسیر برای OAuth2، آنتروپی پارامتر حالت بهبود یافته است تا آن را غیرقابل پیش بینی کند تا از آسیب پذیری Cross Site Request Forgery (CSRF) جلوگیری شود."،
279065586 سیاست های امنیتی محتوا را در هدر اضافه کرد تا یک لایه امنیتی اضافی برای سایت ها از حملات سمت مشتری فراهم کند.

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

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

  • Red Hat Enterprise Linux (Intel 64-bit): نسخه 8.8
  • اوراکل لینوکس (اینتل 64 بیتی): نسخه های 7.9، 8.7 و 8.8
  • راکی لینوکس 8
  • تامکت 9.0.82

برای مشاهده لیست کامل نرم افزارهای پشتیبانی شده Edge for Private Cloud را ببینید.

محرومیت ها و بازنشستگی ها

هیچ رد یا بازنشستگی جدیدی در این نسخه وجود ندارد.

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

این نسخه ویژگی های جدید زیر را معرفی می کند:

حداکثر تعداد کاراکترها را برای نام سازمان و محیط تنظیم کنید

با این نسخه، می توانید حداکثر تعداد کاراکترها را برای نام سازمان و محیط در هنگام ایجاد یک سازمان یا محیط جدید محدود کنید. مقدار پیش‌فرض برای حداکثر تعداد کاراکترها 255 است. برای تنظیم حداکثر کمتر، ویژگی‌های زیر را در فایل ویژگی‌های مربوطه تنظیم کنید:

  • در فایل ویژگی سازمان، org.name.max.length را تنظیم کنید.
  • در فایل ویژگی سازمان، env.name.max.length تنظیم کنید.

اگر هر یک از این ویژگی ها روی مقدار کمتر از 0 یا بیشتر از 255 تنظیم شود، سیستم به ترتیب از حداکثر مقدار 1 یا 255 استفاده می کند.

انقضای نشانه های دسترسی را تنظیم کنید

با این نسخه، می‌توانید انقضای توکن‌های دسترسی را با تنظیم ویژگی conf_keymanagement_oauth_access_token_expiry_time_in_millis روی زمان انقضای مورد نظر بر حسب میلی‌ثانیه تنظیم کنید. این ویژگی به طور پیش فرض غیرفعال است. برای فعال کردن آن، conf_keymanagement_oauth_access_token_is_apply_limit در پردازشگر پیام روی true تنظیم کنید.

این ویژگی به مدیران Apigee کنترل بهتری بر روی انقضای توکن های دسترسی ایجاد شده در Apigee می دهد.

رفع اشکال

این بخش اشکالات Private Cloud را که در این نسخه رفع شده اند فهرست می کند.

شناسه شماره توضیحات
290242749

هنگامی که متغیر ServiceCallout.response در DataMasking استفاده می شد، خط مشی ها در ردیابی قابل مشاهده نبودند.

این رفع شده است.
260397807

مشکلی در الگوهای ایمیل مانع از ارسال کاراکترهای چند بایتی در ایمیل شد.

این رفع شده است.
234544436

مشکلی وجود داشت که در آن هنگام تغییر سازمان در رابط کاربری Edge جدید، منوی سمت چپ ناپدید می شد.

این رفع شده است.
293268203

وابستگی های تجزیه و تحلیل به طور خودکار در گره های سرور مدیریت ارتقا نمی یافتند.

این رفع شده است.
261616264

چک بوت استرپ اضافه شد تا اطمینان حاصل شود که postgresql در طول فرآیند ارتقا حذف/حذف نشده است.

279065586

در URL تغییر مسیر برای OAuth2، آنتروپی پارامتر حالت بهبود یافته است تا آن را غیرقابل پیش بینی کند تا از آسیب پذیری Cross Site Request Forgery (CSRF) جلوگیری شود.

283310836

پیام خطا هنگام تجزیه XML های بزرگ بهبود یافته است.

245936798

یک مشکل با نام سازمان و محیط باعث ایجاد Postgresql شد پرس و جوها برای شکست.

این با مدیریت بهبود یافته درگیری‌های نام نمایه postgres برای نام‌های طولانی سازمان و محیط برطرف شده است.
293733533

کتابخانه شخص ثالث Spring در اجزای Edge Gateway از نسخه 5.3.20 به نسخه 5.3.27 به روز شده است.

294363158

یک رگرسیون باعث می شد که برخی از ابعاد اضافی در منوهای کشویی صفحات تجزیه و تحلیل و نظارت Edge UI نشان داده شود.

این رفع شده است.
297889765

مصنوعات تولید شده توسط apigee-mirror اکنون دارای مالکیت صحیح هستند.

294989027

بهبود عملکرد برخی از APIهای Stats.

مسائل شناخته شده

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

اعمال چندین نسخه پچ

این بخش نحوه اعمال چندین نسخه وصله را توضیح می‌دهد، در صورتی که در حال به‌روزرسانی از نسخه Edge برای Private Cloud هستید که زودتر از نسخه انتشار پچ قبلی است.

هر نسخه وصله حاوی به‌روزرسانی‌هایی برای اجزای خاص Edge برای Private Cloud، مانند edge-management-server است. برای اعمال چندین نسخه وصله، باید هر مؤلفه Edge را که در نسخه وصله‌ای موجود است دیرتر از نسخه نصب‌شده فعلی‌تان به‌روزرسانی کنید. می‌توانید این مؤلفه‌ها را با نگاه کردن به یادداشت‌های انتشار Edge for Private Cloud برای همه نسخه‌های جدیدتر از نسخه فعلی خود و بررسی فهرست RPM برای آن نسخه‌ها پیدا کنید. برای پیوند به تمام یادداشت‌های انتشار Edge for Private Cloud، به یادداشت‌های انتشار Apigee مراجعه کنید.

توجه: فقط باید هر مؤلفه را یک بار با نصب RPM برای آخرین نسخه مؤلفه موجود در انتشارات پچ، به روز کنید. دستورالعمل‌های یادداشت‌های انتشار مربوط به آن نسخه را برای به‌روزرسانی مؤلفه دنبال کنید.

توجه: ارتقاء یک مؤلفه به طور خودکار آخرین نسخه وصله یک مؤلفه را نصب می کند. اگر می‌خواهید به یک نسخه پچ که جدیدترین نیست ارتقا دهید، باید نسخه تاربال خود را از مخزن Apigee با استفاده از Apigee mirror نگهداری کنید و از این آینه برای نصب Apigee استفاده کنید. برای اطلاعات بیشتر، به استفاده از یک مخزن محلی Edge برای نگهداری نسخه Edge خود مراجعه کنید.