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

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

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

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

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

  • edge-gateway-4.19.06-0.0.20094.noarch.rpm
  • edge-management-server-4.19.06-0.0.20094.noarch.rpm
  • edge-message-processor-4.19.06-0.0.20094.noarch.rpm
  • edge-postgres-server-4.19.06-0.0.20094.noarch.rpm
  • edge-qpid-server-4.19.06-0.0.20094.noarch.rpm
  • edge-router-4.19.06-0.0.20094.noarch.rpm
  • apigee-mtls-4.19.06-0.0.20189.noarch.rpm
  • apigee-mtls-consul-4.19.06-0.0.20128.noarch.rpm
  • apigee-cassandra-2.1.16-0.0.2508.noarch.rpm
  • edge-ui-4.19.06-0.0.20164.noarch.rpm
  • edge-management-ui-static-4.19.06-0.0.20018.noarch.rpm
  • apigee-sso-4.19.06-0.0.20080.noarch.rpm
  • apigee-setup-4.19.06-0.0.1122.noarch.rpm

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

apigee-all version

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

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

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

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

    4. به‌روزرسانی ابزار apigee-setup: 
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. برای اجرای دستورگان apigee-service.sh، از فرمان source استفاده کنید: 
      source /etc/profile.d/apigee-service.sh

  2. به‌روزرسانی همه گره‌های Cassandra:

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

    که در آن configFile فایل پیکربندی‌ای را که برای نصب Apigee Edge for Private Cloud استفاده کرده‌اید مشخص می‌کند. برای مثال، /opt/silent.conf.

  3. در همه گره‌های Edge، update.sh را برای edge فرایند اجرا کنید. برای انجام این کار، فرمان زیر را در هر گره اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

  4. به‌روزرسانی میانای کاربر Edge:

    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  5. برنامه update.sh را برای «ورود به سیستم یکپارچه» در همه گره‌ها اجرا کنید. در هر گره، فرمان زیر را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  6. اگر از تجربه «Edge جدید» استفاده می‌کنید، فرمان زیر را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  7. اگر از Apigee mTLS استفاده می‌کنید، رویه شرح‌داده‌شده در ارتقای Apigee mTLS را دنبال کنید.

    برای اطلاعات بیشتر، مقدمه‌ای بر Apigee mTLS را ببینید.

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

بدون تغییر.

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

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

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

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

درحال رمزگذاری گذرواژه‌های JMX

اکنون می‌توانید گذرواژه‌های JMX را رمزگذاری کنید. برای جزئیات بیشتر، فعال کردن رمزگذاری گذرواژه JMX و فعال کردن اصالت‌سنجی JMX برای Cassandra را ببینید. (150633039)

اشکالات رفع شد

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

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

گواهینامه‌های apigee-mtls فقط ۳۰ روز اعتبار داشتند.

گواهینامه‌های جدید اکنون برای یک سال معتبر هستند. برای ارتقا دادن گواهینامه ۳۰ روزه قدیمی با گواهینامه جدید که یک سال اعتبار دارد، ارتقا دادن Apigee MTLS را ببینید.
147736003

کتابخانه قدیمی در enterprise.apigee.com باعث مشکلات امنیتی شده بود.

کتابخانه به‌روز شد.
150594487

مجموعه‌ای از منابع Java در سطح سازمان باعث می‌شد پردازشگرهای پیام نتوانند سازمان‌ها را بار کنند.
149739904

پوشاندن داده‌ها برای سرصفحه‌های HTTP به حروف حساس بود.

این مشکل برطرف شده است: پوشش داده دیگر به حروف بزرگ و کوچک حساس نیست.
130416715

آسیب‌پذیری احتمالی به‌دلیل سرایند «True-Client-IP»

این نسخهٔ پخش عنصر جدیدی به نام «خط‌مشی کنترل دسترسی» IgnoreTrueClientIPHeader را معرفی می‌کند که این مشکل را برطرف می‌کند. عنصر IgnoreTrueClientIPHeader را ببینید.
161858295

برخی‌از متغیرهای بی‌صدا غلط املایی داشتند.

متغیر نصب بی‌صدا SSO_JWT_SIGNING_KEY_FILEPATH دیگر غلط املایی ندارد.
160951701

نصب mTLS به‌دلیل مشکل سرور Consul انجام نمی‌شد.

باینری Consul از نسخه ۱.۶.۲ به جدیدترین نسخه پایدار، نسخه ۱.۸.۰، ارتقا یافت.
132654321

گزارش‌های ممیزی کاربرانی را که نقش‌هایشان به‌روز شده بود نشان نمی‌داد.

پس‌از انجام تغییرات نقش برای کاربران موجود یا افزودن کاربر موجود به سازمان، گزارش ممیزی «کاربر نامشخص به‌روزرسانی شد» را نشان می‌داد که مانع از دیدن اینکه کنش روی چه کسی انجام شده است می‌شد.
160916451

نصب mTLS به‌دلیل قدیمی بودن نسخه باینری Consul انجام نمی‌شد.

باینری Consul از نسخه ۱.۶.۲ به جدیدترین نسخه پایدار، نسخه ۱.۸.۰، ارتقا یافته است.

‫apigee-mtls اکنون سرورهای دارای چندین رابط شبکه و نشانی را به‌درستی مدیریت می‌کند.
161764596

‫apigee-tomcat هنگام اعمال به‌روزرسانی‌های وصله به‌روزرسانی نمی‌شد.

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

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

برای مستندات جدید، غیرفعال کردن پروتکل‌های «امنیت لایه انتقال» را ببینید.

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

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

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

مشکل استخر اتصال خط‌مشی Ldap

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

راهکار موقت:

برای تغییر دادن ویژگی‌های استخر اتصال LDAP، مراحل زیر را برای تنظیم تغییر سراسری در همه خط‌مشی‌های LDAP انجام دهید.

  1. اگر فایل پیکربندی ازقبل وجود ندارد، فایل ویژگی‌های پیکربندی را ایجاد کنید: 
    /opt/apigee/customer/application/message-processor.properties
  2. مورد زیر را به فایل اضافه کنید (مقادیر مشخصه‌های Java Naming and Directory Interface (JNDI) را براساس الزامات پیکربندی منبع LDAP جایگزین کنید). 
    bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
-Dcom.sun.jndi.ldap.connect.pool.prefsize=2
-Dcom.sun.jndi.ldap.connect.pool.initsize=2
-Dcom.sun.jndi.ldap.connect.pool.timeout=120000
-Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"
  3. مطمئن شوید فایل /opt/apigee/customer/application/message-processor.properties متعلق به apigee:apigee باشد.
  4. هر پردازشگر پیام را بازراه‌اندازی کنید.

برای تأیید اینکه دارایی‌های استخر اتصال JNDI شما تأثیرگذار است، می‌توانید با tcpdump رفتار استخر اتصال LDAP را درطول زمان مشاهده کنید.