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

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

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

• معالج الرسائل: الجمعة 1 مايو 2020
• ‫API Management: الاثنين 20 أبريل 2020
• إدارة تحقيق الربح: الاثنين 20 نيسان (أبريل) 2020
• إصدار تصحيح لواجهة برمجة التطبيقات API Management: الاثنين 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)

• GenerateJWT relative start time for token

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

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

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

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

  (132918033)

وظائف نماذج الرسائل

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

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

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

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

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

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

سياسة JSONtoXML: حذف إعلان XML، وتنسيق الناتج

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

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

• <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)

سياسة MessageLogging: رسالة Syslog

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

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

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

متغيّر التدفق virtualhost.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)

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

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