‫4.53.00.02 - یادداشت‌های انتشار Edge for Private Cloud

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

در تاریخ ۱۹ دسامبر ۲۰۲۴، نسخه جدیدی از Apigee Edge for Private Cloud منتشر کردیم.

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

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

به‌روزرسانی این نسخه باعث به‌روزرسانی مؤلفه‌های فهرست‌شده در زیر خواهد شد:

• apigee-nginx-1.26.1-el8.x86_64.rpm
• apigee-nginx-1.26.1-el9.x86_64.rpm
• apigee-qpidd-8.0.6-0.0.2534.noarch.rpm
• apigee-sso-4.53.00-0.0.21506.noarch.rpm
• apigee-tomcat-9.0.86-0.0.948.noarch.rpm

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

apigee-all version

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

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

   1. مخازن Yum را پاک کنید:

      sudo yum clean all

   2. آخرین فایل Edge 4.53.00 bootstrap_4.53.00.sh را در /tmp/bootstrap_4.53.00.sh بارگیری کنید:

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

   3. ابزار و وابستگی‌های Edge 4.53.00 apigee-service را نصب کنید:

      sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

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

   4. برای اجرای دستورگان apigee-service.sh، از فرمان source استفاده کنید:

      source /etc/profile.d/apigee-service.sh

2. در همه گره‌های Qpid، متن update.sh را اجرا کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. در گره‌های SSO، رویه شرح‌داده‌شده در بخش مراحل به‌روزرسانی Apigee SSO از نسخه‌های قدیمی‌تر را دنبال کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

مراحل به‌روزرسانی Apigee SSO از نسخه‌های قدیمی‌تر

در Edge for Private Cloud نسخه ۴.۵۳.۰۰، کلیدها و گواهینامه‌های IDP که در عنصر apigee-sso استفاده می‌شوند اکنون ازطریق محل ذخیره کلید پیکربندی می‌شوند. باید کلید و گواهی‌ای را که قبلاً استفاده می‌کردید به یک keystore صادر کنید، آن را پیکربندی کنید، و سپس به‌طور معمول به‌روزرسانی SSO را انجام دهید.

1. کلید و گواهینامه موجود مورداستفاده برای پیکربندی IDP را شناسایی کنید:

   1. با جستجوی مقدار SSO_SAML_SERVICE_PROVIDER_CERTIFICATE در فایل پیکربندی نصب «ورود به سیستم با یک حساب کاربری» یا با پُرسمان کردن عنصر apigee-sso برای conf_login_service_provider_certificate، گواهینامه را بازیابی کنید.

      از فرمان زیر در گره SSO برای پُرسمان apigee-sso برای مسیر گواهی IDP استفاده کنید. در برونداد، مقدار را در خط آخر پیدا کنید.

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

   2. با جستجوی مقدار SSO_SAML_SERVICE_PROVIDER_KEY در فایل پیکربندی نصب «شناسایی یگانه» یا با پُرسمان کردن عنصر apigee-sso برای conf_login_service_provider_key، کلید را بازیابی کنید.

      از فرمان زیر در گره SSO برای پُرسمان apigee-sso برای مسیر کلید IDP استفاده کنید. در برونداد، مقدار را در خط آخر پیدا کنید.

      apigee-service apigee-sso configure -search conf_login_service_provider_key

2. کلید و گواهینامه را به یک انبار کلید صادر کنید:
   1. کلید و گواهی را به یک انبار کلید PKCS12 صادر کنید:

      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      پارامترها:

      • certificate_path: مسیر فایل گواهینامه بازیابی‌شده در مرحله ۱.الف.
      • ‫key_path: مسیر فایل کلید خصوصی که در «مرحله ۱.ب» بازیابی شده است.
      • ‫keystore_path: مسیر به انبار کلید جدیداً ایجادشده که حاوی گواهی و کلید خصوصی است.
      • ‫alias: نام مستعار استفاده‌شده برای جفت کلید و گواهی در انبار کلید.

      برای جزئیات بیشتر، به اسناد OpenSSL مراجعه کنید.

   2. (اختیاری) کلید و گواهینامه را از PKCS12 به انبار کلید JKS صادر کنید:

      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      پارامترها:

      • PKCS12_keystore_path: مسیر انبار کلید PKCS12 که در مرحله ۲.الف ایجاد شده است و حاوی گواهی و کلید است.
      • ‫destination_keystore_path: مسیر به انبار کلید JKS جدید که گواهینامه و کلید در آن صادر خواهد شد.
      • ‫alias: نام مستعار استفاده‌شده برای جفت کلید و گواهی در انبار کلید JKS.

   برای جزئیات بیشتر به اسناد keytool مراجعه کنید.

3. مالک فایل keystore برونداد را به کاربر «apigee» تغییر دهید:

   sudo chown apigee:apigee <keystore_file>

4. ویژگی‌های زیر را در فایل پیکربندی Apigee SSO اضافه کنید و آن‌ها را با مسیر فایل انبار کلید، گذرواژه، نوع انبار کلید، و نام مستعار به‌روز کنید:

   # Path to the keystore file
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks
   
   # Keystore password
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore
   
   # Keystore type
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12
   
   # Alias within keystore that stores the key and certificate
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert

5. نرم‌افزار Apigee SSO را در گره SSO طبق معمول بااستفاده از فرمان زیر به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

رفع اشکال‌ها

این بخش فهرست اشکالات «ابر خصوصی» را که در این نسخه اصلاح شده است ارائه می‌دهد.

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

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

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

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

منسوخ شدن و بازنشستگی

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

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

این بخش ویژگی‌های جدید این نسخه پخش را فهرست می‌کند.

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

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

اعمال کردن چندین نسخه وصله

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

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

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

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