20.04.06 - ملاحظات إصدار Apigee Edge for Public Cloud

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

في التواريخ التالية، بدأنا بإصدار تحديثات المكوّنات إلى Apigee Edge for Public Cloud:

  • معالج الرسائل: الجمعة 1 أيار (مايو) 2020
  • إدارة واجهة برمجة التطبيقات: الاثنين 20 نيسان (أبريل) 2020
  • إدارة تحقيق الربح: الاثنين 20 نيسان (أبريل) 2020
  • إصدار رمز تصحيح واجهة برمجة التطبيقات: الاثنين 22 حزيران (يونيو) 2020
  • إصدار رمز تصحيح إدارة تحقيق الربح: الاثنين 6 تموز (يوليو) 2020
  • تحديث أمان خادم الإدارة: الاثنين 24 آب (أغسطس) 2020
  • إصدار تصحيح من معالج الرسائل مع إصلاحات للأخطاء: الخميس 24 أيلول (سبتمبر) 2020
  • إصدار تصحيح من معالج الرسائل مع إصلاحات للأخطاء: الاثنين 26 تشرين الأول (أكتوبر) 2020
  • إصدار تصحيح من معالج الرسائل مع إصلاحات للأخطاء: الاثنين 1 شباط (فبراير) 2021

ميزات وأخبار جديدة

في ما يلي الميزات والتحديثات الجديدة في هذا الإصدار.

سياسات JWT

  • تشفير JWT

    تتيح لك سياسات JWT إنشاء الرموز المميّزة المشفَّرة وإثبات ملكيتها وفك ترميزها. عناصر جديدة على السياسات ما يلي:

    • <Type>: تتيح لك هذه الميزة تحديد ما إذا كانت الرموز المميّزة موقّعة أو مشفّرة.
    • <EncryptionAlgorithms>: يتيح لك هذا الخيار ضبط <Key>. و<Content> خوارزميات التشفير.

    (67165581)

  • إتاحة خوارزميات PSS في الرموز المميّزة الموقَّعة

    تتوافق الآن سياسات إنشاء JWT وJWS مع PS256 وPS384 وخوارزميات PS512، كما هو موضح في معيار IETF RFC 7518. (119856499)

  • إنشاء وقت بدء نسبي للرمز المميّز

    عند إنشاء JWT باستخدام سياسة GenerateJWT، يتيح العنصر <NotBefore> عليك تحديد فترة نسبية بين وقت إنشاء الرمز المميز وعندما يصبح صالحًا. على سبيل المثال، تعني القيمة 2h في <NotBefore> أنّ الرمز المميّز لن يكون صالحًا حتى بعد ساعتَين من إنشائه يمكنك ضبط وقت واحد (<NotBefore>) المللي ثانية (ميلي ثانية) أو الثواني (الثواني) أو الدقائق (m) أو الساعات (h) أو الأيام (d) أو الأسابيع (w). (126261970)

  • المفتاح العام/الشهادة المرجعية في خدمة VerifyJWT

    في سياسةVerifyJWT، يظهر <PublicKey> / يتيح لك العنصر <Certificate> الإشارة إلى الشهادة بتنسيق PEM التي يمكن من خلالها التحقق من توقيعات JWT الواردة. على سبيل المثال:

    <PublicKey>
      <Certificate ref='public.certificate_pem'/>
    </PublicKey>

    (132918033)

دوال نماذج الرسائل

جديد دوال نماذج الرسائل المتاحة مع هذا الإصدار:

  • firstnonull - يعرض قيمة أول وسيطة غير خالية (أقصى اليسار). (139698514)
  • xpath - يتيح لك تطبيق تعبير مسار XML (XPath) لتحليل متغيرات XML. (123246424)

سياسة assignMessage: يتيح لك AssignVariable إمكانية الإشارة إلى نموذج رسالة.

في سياسة assignMessage، يسمح العنصر <AssignVariable> / <Template> ref، مما يتيح لك إدخال نموذج محدد مسبقًا في وقت التشغيل الذي يمكن بدون الحاجة إلى تعديل السياسة (118396082)

الأسماء المستعارة المتعددة للشهادات

متى ضبط بروتوكول أمان طبقة النقل (TLS) واستخدام شهادات متعددة في ملف تخزين مفاتيح، ولكل منها باسم مستعار مختلف، تتيح لك Edge إمكانية الإشارة إلى أسماء مستعارة محددة للشهادات في إعداد <SSLInfo><KeyAlias>. ولتفعيل هذا السلوك المعدّل، إعداد سمة HTTPClient.choose.alias.by.keyalias جديدة على "صحيح" في ملف http.properties على معالِجات الرسائل. Edge لمستخدمي السحابة الإلكترونية العامة يجب الاتصال بـ يمكنك الحصول على الدعم لإضافة هذا الموقع. (142141620)

سياسة JSONtoXML: حذف إعلان XML وناتج المسافة البادئة

يمنحك خياران منطقيان جديدان في سياسة JSONtoXML مزيدًا من التحكم في ملف XML الإخراج.

  • <Options> <OmitXmlDeclaration> - عند الضبط على "صحيح" (القيمة التلقائية هي false)، يغفل العنصر <OmitXmlDeclaration> قيمة <?xml version="1.0" encoding="UTF-8"?> التلقائية إعلان XML الذي تم إنشاؤه من خلال السياسة
  • <Options> <Indent> - عند الضبط على "صحيح" (القيمة التلقائية هي "خطأ")، يضع العنصر <Indent> مسافة بادئة للمخرجات بتنسيق XML. على سبيل المثال، بدلاً من هذا الإخراج:

    <Array><n>1</n><n>2</n><n>3</n></Array>

    وينتج عنصر المسافة البادئة ما يلي:

    <Array>
     <n>1</n>
     <n>2</n>
     <n>3</n>
    </Array>

(65142394)

الردود لفحص المضيف الافتراضي

في حال تقديم طلب إلى عنوان IP لنقطة نهاية Apigee (لم يتم تحديد مضيف افتراضي)، عرَضَ Edge استجابة HTTP 200 ومستند HTML فارغًا من Apigee التلقائي. المضيف الظاهري المرتبط بعنوان IP هذا. لتجنب الانطباع غير الصحيح الذي قد تمثل هذه الاستجابة ثغرة أمنية محتملة يمكن استغلالها، يتم قطع الاتصال ولا يتم عرض أي استجابة. (140005396)

خصائص الخادم المستهدفة في عملية التتبُّع للمساعدة في تحديد المشاكل وحلّها

تساعد خصائص التتبّع الجديدة التالية في تحديد مشاكل الاتصال المستهدَفة وحلّها من خلال تعرض ما إذا تم تخزين HTTPClient للخادم الهدف في ذاكرة التخزين المؤقت: "isHttpClientCached" وisFromClientPool" (140574604)

سياسة تسجيل الرسائل: رسالة سجلّ النظام

في سياسة تسجيل الرسائل، نافذة جديدة العنصر <Syslog> / <PayloadOnly> (قيمة منطقية) تتيح لك تحديد ما إذا كان ستتم إضافة أي شيء تلقائيًا إلى <Message> التي تحددها. في حال ضبط <PayloadOnly> على "صحيح"، لم تتم إضافة أي شيء في البداية إلى تعريف الرسالة (بغض النظر عن <FormatMessage> الإعداد). في حال التعيين على "false" (الخطأ الافتراضي)، ستعمل يحدِّد الإعداد "<FormatMessage>" ما تتم إضافته مسبقًا. إلى رسالة السجل. (68722102)

انتهاء صلاحية سياسات ذاكرة التخزين المؤقت

عنصر انتهاء صلاحية جديد للسمة <TimeoutInSeconds> على سياسة Responsecache وسياسة Populatecache يعمل بالطريقة نفسها التي يعمل بها عنصر <TimeoutInSecs> الحالي. كان من المفترض أن يعمل في الأصل. يُرجى استخدام العنصر الجديد. <TimeoutInSecs> المتوقّفة نهائيًا لا يزال هناك عنصر للتوافق مع الأنظمة القديمة. إذا كان كلاً من <TimeoutInSecs> و<TimeoutInSeconds> تكوين العناصر، تستخدم Edge <TimeoutInSeconds>. (119172893)

متغيّر مسار defaulthost.aliases.values

مسار جديد لرسالة virtualhost.aliases.values للقراءة فقط يعرض المتغير مصفوفة بتنسيق JSON لجميع الأسماء المستعارة المضيف الظاهري الذي تم استدعاؤه في الطلب الوارد. (128453178)

مَعلمة جديدة لضمان حذف مراجعة الخادم الوكيل

تمّت إضافة مَعلمة طلب بحث force جديدة إلى السمة. حذف مراجعة خادم وكيل واجهة برمجة التطبيقات. في الحالات التي يتم فيها إدراج النسخة السابقة في List API Proxies API ولكن لا يمكن الاستعلام عنه بالفعل، فإن هذه المعلمة تضمن حذف نسخة الخادم الوكيل. (111691721)

على سبيل المثال:

DELETE /v1/organizations/myorg/apis/myproxy/revisions/2?force=true

متغيّر تدفق جديد لقيم الاسم المستعار للمضيف الافتراضي

يعرض متغيّر تدفق رسالة virtualhost.aliases.values الجديد للقراءة فقط تنسيق JSON مصفوفة من جميع الأسماء المستعارة التي تم تعيينها للمضيف الظاهري الذي تم استدعاؤه في الطلب الوارد. (128453178)

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

تم إصلاح الأخطاء التالية في هذا الإصدار. هذه القائمة مخصصة بشكل أساسي للمستخدمين الذين يتحققون لمعرفة ما إذا كان قد تم إصلاح طلبات الدعم الخاصة بهم. ليست مصممة لتقديم تفاصيل المعلومات لجميع المستخدمين.

معرّف المشكلة اسم المكوِّن الوصف
143313772 معالج الرسائل

تم إصلاح مشكلة في سياسة SpikeArrest التي حدثت عندما تكون ميزة "UseEffectiveCount" مفعَّلة وتتم إعادة تشغيل الجهاز.

(في إصدار التصحيح بتاريخ 2/1/21).

154428338 وقت تشغيل واجهة برمجة التطبيقات

تعذُّر معالج الرسائل في تحميل البيئات عند إعداد ملفات تخزين المفاتيح بأسماء أو أسماء مستعارة متشابهة.

لقد أصلحنا تعارضًا في البحث في التعبير العادي عند تحميل ملفات تخزين المفاتيح التي لها تسمية مشابهة اصطلاح. أدى ذلك إلى فشل معالج الرسائل في تحميل البيئات مرتبطة بملف تخزين المفاتيح، أو تعذُّر البدء عند وجود عدة ملفات تخزين مفاتيح متعارضة التي تم إرجاعها أثناء البحث.

149507805 إدارة واجهة برمجة التطبيقات

تفعيل النشر/الضبط عبر HTTP لجميع خوادم MGMT للإنتاج

يتم إجراء تعديلات الإعدادات عبر HTTP بدلاً من استدعاء الإجراءات عن بُعد، ما يؤدي إلى تحسين الموثوقية وتسجيل الأخطاء.

137217974 إدارة واجهة برمجة التطبيقات

عند إعداد وحدات MP عبر HTTP، يجب نشر الخطأ بشكل صحيح عند الخادم الهدف لا يزال قيد الاستخدام

نتيجةً لتحسين الموثوقية التي تم طرحها في المشكلة رقم 149507805، تم الإبلاغ عن أخطاء الاستجابة من حذف الخادم المستهدف بشكل غير صحيح الحالة 200 (تم بنجاح) عند إخفاق الحذف. مع هذا الإصلاح، الرد يتم الآن الإبلاغ عن الأخطاء بشكل صحيح على أنها الحالة 400 إذا فشل الحذف. لاحظ أنه قد يتعذر حذف الخادم الهدف إذا كان الخادم الهدف تتم الإشارة إليه من خادم وكيل منشور حاليًا. قبل حذف هدف تحقق للتأكد من عدم الإشارة إلى الخادم الهدف بواسطة أي الخوادم الوكيلة لواجهة برمجة التطبيقات المنشورة حاليًا

69765558 إدارة واجهة برمجة التطبيقات

واجهة برمجة تطبيقات Resource Permissions تعرض الخطأ 403

149545506 إدارة واجهة برمجة التطبيقات

إصلاح مشكلة أمان في واجهة برمجة التطبيقات لإضافة مستخدم إلى دور

131246911 إدارة واجهة برمجة التطبيقات بالنسبة إلى الرسائل الإلكترونية الخاصة بالمطوّرين في البوابة، يجب إتاحة النطاقات الأحدث، مثل *.games و *.asia

تمّ إصلاح مشكلة تأثُّر بعض أسماء النطاقات، مثل *.games و*.asia، وتسبب *.africa في تعذُّر إنشاء المطوّرين على Edge وذلك لأن أداة التحقق من النطاق لم تتعرف عليها. Edge متوفّر الآن فقط يتحقق من صحة تنسيق عنوان البريد الإلكتروني (يحتوي على الرمز "@").

142217645 إدارة واجهة برمجة التطبيقات

لا يمكن إزالة PUT v1/o/{org_name}/apiproducts/{product_name} الحصص

162299668 خادم الإدارة

تم إصلاح ثغرة أمنية محتمَلة.

135856488 خادم الإدارة

بطء في واجهة المستخدم

139407965 خادم الإدارة

تم إصلاح مشكلة سمحت بإنشاء KVM بدون اسم.

112488235 خادم الإدارة

تمت إضافة عملية التحقق لمنع إنشاء المضيفات الافتراضية باستخدام مسافات في الاسم. لا تكون أحرف المسافات صالحة للاستخدام في أسماء المضيفين الافتراضية.

132433193 إدارة تحقيق الربح

تم حلّ مشكلة متعلقة بتحديث التطبيق.

152514520 إدارة تحقيق الربح

تم إصلاح مشكلة في طلبات البيانات من واجهة برمجة التطبيقات الإدارية لحذف الكيانات.

128450374 وقت تشغيل واجهة برمجة التطبيقات

يجب أن تراعي سياسات JWT/JWS المتغيّرات التي لا يتم حلّها، وحدوث الخطأ المناسب إذا لم يتم تحديد المتغيّر

135354517 وقت تشغيل واجهة برمجة التطبيقات

إخفاق المؤسسة في Release_190301 بسبب التنفيذ الصارم لـ "سلسلة" نوع البيانات في BasicAuth

131763486 وقت تشغيل واجهة برمجة التطبيقات

يجب تجاهل المسار الأساسي للتدفق المشترك في معالج الرسائل

135972575 وقت تشغيل واجهة برمجة التطبيقات

تعرض Private Cloud 4.19.01 سلوكًا مختلفًا أثناء النشر باستخدام cancel=true&delay=300

سيتم تضمين هذا الحلّ في إصدار قادم من Edge for Private Cloud.

141601836 وقت تشغيل واجهة برمجة التطبيقات

إصلاح اسم المضيف في رسالة السجلّ

116834109 وقت تشغيل واجهة برمجة التطبيقات

تعذّر إتمام قيم غير صحيحة للمتغيّرات وerror.cause وError.name في Trace

130653816 وقت تشغيل واجهة برمجة التطبيقات

ظهور أخطاء 404 بين زيارات وقت التشغيل

132777537 وقت تشغيل واجهة برمجة التطبيقات

تعذُّر استخدام سياسة استخراج المتغيّرات في مسار JSONPath الصالح

133713555 وقت تشغيل واجهة برمجة التطبيقات

تغيير عنوان التاريخ في جهاز توجيه الحافة

133253435 وقت تشغيل واجهة برمجة التطبيقات

استخدام مرتفع لوحدة المعالجة المركزية (CPU) من خلال سلسلة محادثات Apigee-Main

111553402 وقت تشغيل واجهة برمجة التطبيقات

منتج واجهة برمجة التطبيقات يحتوي على أحرف غير صالحة في المسار لم يتم رصدها حتى وقت التشغيل

126240341 وقت تشغيل واجهة برمجة التطبيقات

تحسين العبارة العامة "تعذّر الإنشاء" رسالة عند حدوث خطأ في سياسة GenerateJWT

119854424 وقت تشغيل واجهة برمجة التطبيقات

يجب ألا يصبح حامل التحميل الذي يحتوي على خادم هدف واحد غير نشط عند تعذُّر الاتصال.

129275412 وقت تشغيل واجهة برمجة التطبيقات

إضافة عناوين HTTP إلى المضيف الافتراضي الاحتياطي لإجراء عمليات فحص لعناوين IP العامة

129351507 وقت تشغيل واجهة برمجة التطبيقات

تعذُّر فك ترميز سياسة BasicAuthentication عندما تحتوي كلمة المرور على نقطتين

65852874 وقت تشغيل واجهة برمجة التطبيقات

التأكد من أن HTTPClient لا يحاول إعادة استخدام اتصال له اتصال:إغلاق عنوان الاستجابة

138951646 وقت تشغيل واجهة برمجة التطبيقات

لا يعمل الحد الزمني في JavaScript للغة httpClient

139051927 وقت تشغيل واجهة برمجة التطبيقات

وقت استجابة مرتفع لمعالجة الطلبات

132443137 وقت تشغيل واجهة برمجة التطبيقات

تغيير سلوك معالج الرسائل للتعامل مع رؤوس x-apigee الداخلية غير المعروفة

138310777 وقت تشغيل واجهة برمجة التطبيقات

إرجاع رقم 504 عشوائيًا من خلال مكالمة النشر التي تتم في المسار المشترك

67170148 وقت تشغيل واجهة برمجة التطبيقات

الاختلافات في الوقت المنقضي والوقت المُستغرَق في وسائل شرح الخدمة

124049692 وقت تشغيل واجهة برمجة التطبيقات

NullPointerException في سياسة VerifyApiKey

135031506 وقت تشغيل واجهة برمجة التطبيقات

إضافة رسالة سجلّ لتنسيق مفتاح JWT غير المتوقّع

137312366 وقت تشغيل واجهة برمجة التطبيقات

التحقّق من صحة المحتوى حسب عنوان نوع المحتوى

109871907 وقت تشغيل واجهة برمجة التطبيقات

تأخيرات تنفيذ خدمة ServiceCallout بدون عنصر استجابة

143722867 وقت تشغيل واجهة برمجة التطبيقات

يجب أن يفرض JWT حدًّا قابلاً للضبط على عدد التكرارات لـ PBKDF2.

144286363 تتبُّع الأداء المختلط

قناع تصحيح الأخطاء في env.json لا يخفي بيانات الاستجابة في Apigee Hybrid

147769812 وقت تشغيل واجهة برمجة التطبيقات

توضيح سمات تجزئة OAuth على أنّها قابلة للتغيير في علامات الميزات

149037704 وقت تشغيل واجهة برمجة التطبيقات

تم إصلاح مشكلة حيث يمكن أن القيمة المخصّصة لمتغيّر التدفق proxy.url يمكنك عرض اسم مضيف بديل غير صحيح.

148972262 وقت تشغيل واجهة برمجة التطبيقات

يؤدي فك ترميزJWS إلى إرسال الحمولة إلى متغيّر سياق بطريقة غير مفيدة.

116580622 وقت تشغيل واجهة برمجة التطبيقات

الاستجابة غير متّسقة

149739904 وقت تشغيل واجهة برمجة التطبيقات

يجب أن يكون إخفاء البيانات في عناوين HTTP غير حسّاس لحالة الأحرف.

149431545 وقت تشغيل واجهة برمجة التطبيقات

لا يمكن استخدام GenerateJWT وVerifyJWT باستخدام SecretKey في أي ترميز باستثناء UTF-8.

155448596 رمز تصحيح واجهة برمجة التطبيقات

أذونات غير متوفّرة في دور مشرف apimonitoring التلقائي

تمت إضافة أذونات مفقودة إلى دور apimonitoringadmin.

158592076 رمز تصحيح واجهة برمجة التطبيقات

أذونات غير متوفّرة في دور مشرف المطوّر التلقائي

تمت إضافة أذونات غير متوفّرة إلى دور مشرف المطوّر.

152856311 رمز تصحيح واجهة برمجة التطبيقات

عمليات التحقق من رفض شهادات PKCS7 وDER في ملف تخزين المفاتيح وبرنامج Truststore أثناء إنشاء المضيف الافتراضي وتعديله

أثناء إنشاء المضيف الظاهري أو تحديثه، يتم فرض عمليات التحقق من الصحة على التحقّق مما إذا كانت الشهادات التي تمت إضافتها في الاسم المستعار لملف تخزين المفاتيح وملف تخزين الثقة في PEM وليس بتنسيقات غير متوافقة مثل PKCS7 وDER وما إلى ذلك.

155478545 رمز تصحيح إدارة تحقيق الربح

تم حلّ مشكلة كانت تتعلّق بالتعديلات على حالة الإشعارات عبر البريد الإلكتروني.

154121499 رمز تصحيح إدارة تحقيق الربح

مشكلة تحدث في واجهة برمجة التطبيقات /mint/org/orgname/delete-org-data حدث خطأ 404 في الحالة.

152356393 رمز تصحيح إدارة تحقيق الربح

تمت تبسيط عملية التحقق من طول اسم الشركة لتحقيق الربح. إنشاء شركة

138542921 رمز تصحيح إدارة تحقيق الربح

تم إصلاح مشكلة تعذُّر إنشاء خطة أسعار مع عدة طلبات السمات المخصّصة في حِزمة المنتج.

150948843 إدارة تحقيق الربح - رمز التصحيح

تم حلّ مشكلة متعلّقة بواجهة برمجة التطبيقات Monetization /sync-developers API. إلى حدوث صراعات مثابرة.

155443118 رمز تصحيح إدارة تحقيق الربح

تمت إزالة الحقل jsonMailProperties.

150948843 إدارة تحقيق الربح - رمز التصحيح

تم حلّ مشكلة متعلّقة بواجهة برمجة التطبيقات Monetization /sync-developers API. إلى حدوث صراعات مثابرة.