4.19.01.03 - Edge لملاحظات الإصدار في Private Cloud

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

في 10 آذار (مارس) 2020، أصدرنا نسخة جديدة من Apigee Edge لـ Private Cloud.

إجراء التحديث

لتحديث التثبيت، نفذ الإجراء التالي على عُقد Edge:

  1. على جميع عُقد Edge:

    1. عليك تنظيف مطعم Yum repos:
      sudo yum clean all
    2. يمكنك تنزيل أحدث إصدار من ملف Edge 4.19.01 bootstrap_4.19.01.sh إلى /tmp/bootstrap_4.19.01.sh:
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    3. ثبِّت الأداة المساعدة Edge 4.19.01 apigee-service والتبعيات التالية:
      sudo bash /tmp/bootstrap_4.19.01.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. تحديث أداة apigee validate:
    sudo /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  3. يمكنك استيراد الخادم الوكيل الجديد لتطبيق Smartالمستندات من smartdocs.zip في الدليل /opt/apigee/apigee-validate/bundles ونشره كنسخة جديدة. من المفترض أن يتم استيراد الخادم الوكيل الجديد إلى المؤسسة التي تم إعداد Smart Docs فيها حاليًا. يؤدي نشر الخادم الوكيل كنسخة جديدة إلى تسهيل العودة إلى الحالة السابقة، إذا لزم الأمر.

    ملاحظة: قبل النشر، تأكَّد من تطابُق <VirtualHost> في الخادم الوكيل الجديد مع إعدادات <VirtualHost> المضبوطة حاليًا في بيئتك. وفي حال عدم حدوث ذلك، يمكنك تعديل الخادم الوكيل قبل النشر.

  4. من واجهة مستخدم Edge، أنشئ وحدِّث KVM باسم “smartdocs_ للاطّلاع على القائمة البيضاء” كما هو موضّح في الشكل أدناه. يجب إنشاء KVM في المؤسسة والبيئة اللتين يتم استخدامهما حاليًا في الخادم الوكيل Smart Docs.

    ملاحظة: تأكّد من عدم وضع علامة في مربّع التشفير.

    • أضِف مفتاحًا باسم "is_ المضافة_إلى"، حيث تكون القيمة "نعم".
    • أضِف مفتاحًا ثانيًا باسم "allowed_hosts"، حيث تكون القيم هي أسماء مضيفين مفصولة بمسافات أو عناوين IP يتم استدعائها من Smart Docs. يجب أن تتضمن قيمة "allowed_hosts" أي مضيفات مضمنة في مواصفات OpenAPI تمت إضافتها إلى Smartالمستندات. على سبيل المثال، إذا كانت لديك مواصفات OpenAPI تستدعي mocktarget.apigee.net، ستحتاج إلى إضافة mocktarget.apigee.net إلى القيمة "allowed_hosts". إذا لم يتم تضمين المضيف في KVM، سيكون استجابة Smart Docs هي 400 Bad Request مع حمولة محتوى تبلغ Bad Request-Hostname not permitted.
    واجهة إنشاء KVM ملاحظة: في حال عدم إضافة وإعداد KVM هذا، لن يفرض الخادم الوكيل إضافة إلى القائمة البيضاء. وقد يؤدي ذلك إلى وصول غير مُصرح به إلى المضيفين وعناوين IP. يجب تضمين أسماء المضيفين وعناوين IP لنقاط نهاية واجهة برمجة التطبيقات التي تم توثيقها باستخدام Smartالمستندات في قيم "allowed_hosts".

البرامج المتوافقة

بلا عُري

عمليات الإيقاف والتقاعد

بلا عُري

الأخطاء التي تم إصلاحها

يسرد الجدول التالي الأخطاء التي تم إصلاحها في هذا الإصدار:

معرّف المشكلة الوصف
145340106

ثغرة أمنية في واجهة برمجة تطبيقات Apigee Smartالمستندات

تم تحديث الخادم الوكيل Apigee Smart Docs لمعالجة الثغرة الأمنية. يمكنك الاطّلاع على إجراء التحديث للحصول على مزيد من المعلومات والخطوات المطلوبة.