4.19.06.10 - Edge لملاحظات الإصدار الخاصة في السحابة الإلكترونية الخاصة

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

في 29 سبتمبر 2020، أطلقنا إصدارًا جديدًا من Apigee Edge 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. نزِّل ملف Edge 4.19.06 bootstrap_4.19.06.sh إلى /tmp/bootstrap_4.19.06.sh: 
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
    3. ثبِّت أداة apigee-service والإعدادات التابعة لإصدار Edge 4.19.06: 
      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. استخدِم الأمر source لتنفيذ النص البرمجي apigee-service.sh: 
      source /etc/profile.d/apigee-service.sh

  2. عدِّل جميع عُقد Cassandra:

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

    حيث يحدّد configFile ملف الإعداد الذي استخدمته لتثبيت Apigee Edge 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 صالحة لمدة 30 يومًا فقط.

أصبحت الشهادات الجديدة صالحة لمدة عام واحد. لترقية شهادة قديمة مدتها 30 يومًا باستخدام شهادة جديدة صالحة لمدة عام واحد، راجِع ترقية 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 الثنائي من الإصدار 1.6.2 إلى أحدث إصدار ثابت، وهو الإصدار 1.8.0.
132654321

لم تكن سجلّات التدقيق تعرض المستخدمين الذين تم تعديل أدوارهم.

بعد إجراء تغييرات في الأدوار للمستخدمين الحاليين أو إضافة مستخدم حالي إلى مؤسسة، كان سجل التدقيق يعرض "تعديل المستخدم غير محدّد"، ما كان يمنعك من معرفة المستخدم الذي تم تنفيذ الإجراء عليه.
160916451

تعذّر تثبيت mTLS بسبب إصدار قديم من ثنائي Consul.

تمت ترقية ملف Consul الثنائي من الإصدار 1.6.2 إلى أحدث إصدار ثابت، وهو 1.8.0.

تعالج apigee-mtls الآن بشكل صحيح الخوادم التي تتضمّن عدة واجهات وعناوين شبكة.
161764596

لم يتم تعديل apigee-tomcat عند تطبيق تحديثات الحزمة.

تم حلّ هذه المشكلة.
133145969

لم تتوفّر مستندات حول إيقاف البروتوكولات في واجهة المستخدم.

للاطّلاع على المستندات الجديدة، يُرجى الانتقال إلى إيقاف بروتوكولات TLS.

المشاكل المعروفة

يسرد الجدول التالي المشاكل المعروفة في هذا الإصدار:

معرّف المشكلة الوصف
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 بمرور الوقت.