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

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

في يوم الثلاثاء الموافق 3 كانون الأول (ديسمبر) 2019، بدأنا في طرح تحديث لهذا الإصدار من Apigee Edge for Public Cloud. (تم نشر هذا المقال في الأصل يوم الخميس 18 أبريل 2019).

الميزات والتحديثات الجديدة

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

معرّف المشكلة اسم المكوّن الوصف
بدأت Apigee في طرح التحديثات التالية في 1 أكتوبر 2019
110995050 API Runtime

موازنة التحميل: المزيد من التحكّم في إزالة الخوادم التي لا تعمل

عند إعداد موازن تحميل لخادم وكيل لواجهة برمجة التطبيقات، يمكنك تحديد عدد حالات فشل الاستجابة التي تحدث قبل إزالة خادم من عملية موازنة التحميل. يشير تعذُّر الاستجابة إلى أنّ Apigee لا يتلقّى أي استجابة من خادم مستهدف. وعند حدوث ذلك، يزداد عدد مرات التعذّر بمقدار واحد. عندما تتلقّى Apigee ردًا من هدف، حتى إذا كان الردّ عبارة عن خطأ HTTP (مثل 500)، يتم احتساب ذلك على أنّه ردّ من خادم الهدف، ويتم إعادة ضبط عدّاد حالات الفشل. للمساعدة في ضمان أنّ استجابات HTTP غير الصالحة (مثل 500) تؤدي أيضًا إلى زيادة عدد حالات الفشل لإزالة الخادم غير السليم من عملية موازنة الحمل في أقرب وقت ممكن، يمكنك إضافة عنصر <ServerUnhealthyResponse> جديد يتضمّن عناصر ثانوية <ResponseCode> إلى إعدادات موازنة الحمل. سيحتسب Edge أيضًا الردود التي تتضمّن هذه الرموز على أنّها أخطاء.

<HTTPTargetConnection>
  <LoadBalancer>
    <Algorithm>RoundRobin</Algorithm>
    <Server name="target1" />
    <Server name="target2" />
    <ServerUnhealthyResponse>
        <ResponseCode>500</ResponseCode>
        <ResponseCode>502</ResponseCode>
        <ResponseCode>503</ResponseCode>
    </ServerUnhealthyResponse>
    <MaxFailures>5</MaxFailures>
  </LoadBalancer>
</HTTPTargetConnection>
130416715 الأمان

تحسينات على سياسة AccessControl

تحدّد سياسة AccessControl عناوين IP التي يمكنها إجراء طلبات إلى خادم وكيل لواجهة برمجة التطبيقات. يمنح عنصر جديد في هذه السياسة مطوّري واجهات برمجة التطبيقات المزيد من التحكّم في تحديد عناوين IP التي يجب تقييمها.

<IgnoreTrueClientIPHeader>: اختيارية (القيمة التلقائية هي false). عند ضبط هذه السمة على "صحيح"، تتجاهل السياسة العنوان True-Client-IP وتقيِّم عناوين IP في العنوان X-Forwarded-For، وذلك وفقًا لسلوك تقييم X-Forwarded-For الذي ضبطته.

<AccessControl async="false" continueOnError="false"
    enabled="true" name="Access-Control-1">
    <DisplayName>Access Control-1</DisplayName>
    <IgnoreTrueClientIPHeader>true</IgnoreTrueClientIPHeader>
    ...
</AccessControl>
أصدرت Apigee التحديثات التالية في 18 نيسان (أبريل) 2019
117558815،
119856499،
110548137،
79526748،
72989449،
70712859،
69049041 		API Runtime JWS وJWT
أضفنا سياسات جديدة لتوفير دعم JWS، كما حسّنّا سياسات JWT الحالية.

لمزيد من التفاصيل، يُرجى الاطّلاع على هذه المشاركة في "المنتدى".

122610025 API Runtime السماح لسياسة RaiseFault أيضًا بضبط سبب الخطأ والمتغيرات العشوائية كما هو الحال في سياسة AssignMessage

يتوفّر عنصران جديدان في سياسة RaiseFault لجعل معالجة FaultRules أكثر دقة وفعالية.

  • ‫ShortFaultReason هي قيمة منطقية، وعند ضبطها على "صحيح"، يتم وضع اسم السياسة في المتغيّر fault.reason.
  • تتيح لك AssignVariable، المتوفّرة في FaultResponse، تعيين استجابة الخطأ إلى متغيّر لاستخدامه في سياسات أخرى في عملية سير خادم وكيل واجهة برمجة التطبيقات.
121149811 الاستهداف المستضاف الحدود المفروضة على "الاستهداف المستضاف"

يتم الآن فرض حدود على "الاستهداف المستضاف". يمكنك الاطّلاع على الحدود لمعرفة تفاصيل الحدود.

117659213 API Runtime تحديد نطاقات عناوين IP في سياسة AccessControl

يمكنك الآن استخدام متغيّرات نموذج الرسالة لضبط عناوين IP وأقنعة CIDR في سياسة AccessControl. على سبيل المثال، إذا أردت تخزين عنوان IP وقناع في خريطة قيم مفاتيح (KVM)، يمكنك استرداد هذه القيم من متغيّر ضبطته في مسار خادم وكيل واجهة برمجة التطبيقات. يتيح لك ذلك تغيير قيم عناوين IP بسهولة أكبر أثناء وقت التشغيل بدون الحاجة إلى تغيير إعدادات السياسة.

على سبيل المثال، بدلاً من:

<MatchRule action="DENY">
    <SourceAddress mask="24">198.51.100.1</SourceAddress>
</MatchRule>

يمكنك ضبط السياسة على النحو التالي، بافتراض أنّ القيم مخزّنة في KVM، وأنّك تستخدم سياسة KeyValueMapOperations لاسترداد القيم وتعيينها للمتغيرات الموضّحة هنا:

<MatchRule action="DENY">
    <SourceAddress mask="{kvm.mask.ref}">{kvm.ip.ref}</SourceAddress>
</MatchRule>
113599885 API Monitoring أدوار "مراقبة واجهة برمجة التطبيقات"

توفّر خدمة "مراقبة واجهة برمجة التطبيقات" دورَين: "مشرف خدمة مراقبة واجهة برمجة التطبيقات" و"مستخدم خدمة مراقبة واجهة برمجة التطبيقات"، كما هو موضّح في الوصول إلى خدمة "مراقبة واجهة برمجة التطبيقات". وقد أتحنا هذه الميزات في كانون الأول (ديسمبر) 2018.

132256772 API Runtime تمت إضافة العنوان X-Apigee.Message-Timeout إلى الطلب

يضيف Edge الآن العنوان X-Apigee.Message-Timeout إلى كل طلب. هذا العنوان مخصّص للاستخدام الداخلي من قِبل Edge. لا تعتمد على القيم في العناوين X-Apigee.* في خوادم وكيل واجهة برمجة التطبيقات، لأنّ هذه العناوين غير مخصّصة للاستخدام من قِبل العملاء ويمكن أن تزيلها Apigee أو تغيّرها في أي وقت.

78575018 السحابة الإلكترونية الخاصة / OPDK تخطّي خادم الإدارة لتخطّي تسجيل مستودع بيانات البوابة عند توفّر وحدات متعددة من البوابة

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

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

معرّف المشكلة اسم المكوّن الوصف
بدأت Apigee في طرح الإصلاحات التالية في 3 ديسمبر 2019
إصلاحات الأمان
بدأت Apigee في طرح الإصلاحات التالية في 29 تشرين الأول (أكتوبر) 2019
139381794 خادم الإدارة

التعامل مع أخطاء حذف ملف تخزين المفاتيح لضمان عدم تعذُّر طلب البيانات من واجهة برمجة التطبيقات
بدأت Apigee في طرح الإصلاحات التالية في 1 أكتوبر 2019
140761319 API Runtime

يتم دائمًا ضبط قيمة x-apigee.edge.execution.sense.action على null
139091614 API Runtime

في سياسة ResponseCache، يتم تنفيذ NIOTheread بدون رفض من مجموعة سلاسل المحادثات
131331305 الخدمات الأساسية

تتسبّب أدوات تصدير السجلّات المتعددة على موجّهات Apigee في ارتفاع معدّل استخدام وحدة المعالجة المركزية
136690640 API Runtime

أخطاء 404 متقطّعة في مؤسسات معيّنة
140948100 API Runtime

عدم تنفيذ Shared Flow الذي تم نشره على بعض معالِجات الرسائل
أصدرت Apigee الإصلاحات التالية في 13 أيلول (سبتمبر) 2019
132654321 خادم الإدارة عدم عرض البيانات في سجلّات التدقيق
131246911 خادم الإدارة بالنسبة إلى عناوين البريد الإلكتروني للمطوّرين في إحدى البوابات، فعِّل إمكانية استخدام نطاقات أحدث، مثل ‎ *.games و‎*.asia
أصدرت Apigee الإصلاحات التالية في 18 أبريل 2019
123844598 خادم الإدارة لا يمكن إعادة استيراد مفاتيح التطبيقات المحذوفة بعد مرور أكثر من 24 ساعة
123588156 API Runtime تعذُّر إزالة العنوان Content-Length من الاستجابة مع ظهور الرمز 304
122732400 API Runtime تجاوز api.timeout io.timeout.millis
122545281 API Runtime يجب أن تأخذ عملية إخفاء بيانات DebugSession بتنسيق JSON في الاعتبار الحالة التي يكون فيها jsonPayload عبارة عن مصفوفة
122355807 خادم الإدارة سلوك الأذونات غير صحيح للمستخدمين الذين لديهم أدوار متعددة
121393556 API Runtime تم ضبط x_apigee_fault_code على "org/codehaus/jackson/map/ObjectMapper"
120998548 واجهة مستخدم Edge خطأ إملائي في رسالة الخطأ: الشهادة غير صالحة أو لا يمكن الوثوق بها
120990929 API Runtime استجابة HTTP-413 من Nginx/Apigee-Router تكشف عن نوع الخادم
120799489 API Runtime عند استخدام httpClient مع دالة ردّ غير متزامنة في JavaScript، وهي httpComplete()، يتم إيقاف إخراج debugsession (التتبُّع)
120794339 API Runtime مقاييس الأداء التي انحرفت عن مسارها للمؤسسة
120277011 خادم الإدارة يجب التحقّق من صحة الإدخال: لا يمكن نشر الخادم الوكيل إذا كان اسم مضيف الخادم المستهدف يتضمّن **
119976417 API Monitoring تعرض خدمة "مراقبة واجهة برمجة التطبيقات" وقت استجابة مرتفعًا للخادم الوكيل، بينما تعرض "إحصاءات Google" وقت استجابة مرتفعًا للهدف
119947481 API Runtime في سيناريو الاستثناء، يتم تسجيل الحمولة التي سيتم إخفاؤها كنص عادي
119877164 السحابة الإلكترونية الخاصة / OPDK تُنشئ أجهزة التوجيه أخطاء، ويتوقف معالج الرسائل عن العمل مع تفعيل بروتوكول أمان طبقة النقل (TLS)

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

119816218 API Runtime تتجاهل ذاكرة التخزين المؤقت للاستجابة عنوان Expires إذا تم تحديد قيمته على 0 أو رقم سالب
119770242 API Runtime تعذّر الاتصال بين جهاز التوجيه وMP ما أدّى إلى توقّف الخدمة بالكامل: حدوث خطأ في PostClientFlow يؤدي إلى تكرار لا نهائي
119443145 خادم الإدارة يعرض خادم وكيل لواجهة برمجة التطبيقات الرمز 404 عند إعادة تسمية ProxyEndpoint وإعادة نشره
119260281 API Runtime خطأ السجلّ "تعذّر التحليل كسلسلة3000.0"
118743407 خادم الإدارة مدة نشر خادم وكيل Apigee
118447966 API Runtime خطأ في وسائل الشرح المستندة إلى JavaScript ضمن الإصدار 180608_07 من "منصة التسويق"
117549719 API Runtime عدم تطابق بين عنوان URI للطلب ومسار الأساس للوكيل
117219520 API Runtime MessageLogging: يستخدم برنامج تسجيل Syslog تنسيق تاريخ غير صحيح كإعداد تلقائي، ويعرض أجزاء من الثانية بشكل غير صحيح
117116435 API Runtime أخطاء متقطّعة من ملف JavaScript
117091520 API Runtime تعذُّر تنفيذ JavaCallouts بعد إصدار معالج الرسائل 18.06.08
116165318 API Runtime تؤدي عمليات النشر المتزامنة للحزمة نفسها إلى حدوث خطأ RepositoryException
116055025 Configstore Service معالجات الرسائل لا تتضمّن المضيفات والتطبيقات الافتراضية بعد بدء التشغيل
115614498 API Runtime Need support for ILB in OPDK

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

113972537 API Runtime أخطاء متعدّدة من الفئة P1 - تم إنشاء NullPointerException من رمز Node.js في خوادم Trireme الوكيلة - 500 Internal Server Error
113904969 دعم Apigee مشكلة في حذف خوادم وكيل واجهة برمجة التطبيقات في المؤسسات التجريبية
113554802 API Runtime تعذُّر التحقّق من صحة تأكيد SAML بسبب NullPointerException
113315737 خادم الإدارة تعذّر نشر الخادم الوكيل بسبب عدم توفّر سجلات النشر في Zookeeper
112767195 API Runtime أخطاء متقطّعة في DataStore أثناء الوصول إلى سياسة KVM
112162179 API Runtime قد يؤدي تخزين كائن JavaScript مؤقتًا بدون تحويله إلى سلسلة إلى حدوث حالات توقّف تام
111860576 API Runtime خطأ في سياسة الحصة
111671525 الاستهداف المستضاف رموز الاستجابة غير الناجحة من الأهداف المستضافة تؤدي إلى تشغيل مسار الخطأ في الخادم الوكيل
111523933 الإضافات(الموصلات) مشكلة في التخزين المؤقت لسياسة ExtensionCallout
111420263 API Runtime استثناء ConcurrentModification في MessageLogging
110843526 خادم الإدارة يجب أن تتحقّق واجهة Management API لإنشاء/تعديل نقطة ربط المسار من صحة المسار المشترَك
110805739 API Runtime لم يتم ضبط قيمة TTL على -1 في مسار CPS عندما تكون قيمة Reuserefreshtoken صحيحة ولم يتم ضبط انتهاء صلاحية الرمز المميّز لإعادة التحميل بشكل صريح
110429629 API Runtime تعرض سياسة BasicAuthentication المتغيّر request.headers.Authorization في DebugSession
110425503 API Runtime إعادة تحميل Nginx تؤدي إلى حدوث مشاكل في توفّر "الخريطة التفاعلية"
110311540 API Runtime إشعار NPE عند إيقاف "البرنامج الإضافي"
110161455 API Runtime يجب أن تستخدم AccessEntity طريقة البحث حسب اسم التطبيق بدلاً من البحث عن جميع التطبيقات لمؤسسات CPS
90695522 API Runtime context.proxyRequest.asForm generates java.lang.ArrayIndexOutOfBoundsException: 1
79734096 خادم الإدارة لم يعُد يتم فلترة سجلّات التدقيق للخوادم الوكيلة حسب الخوادم الوكيلة
78105568 خادم الإدارة لا تظهر عمليات نشر المسار المشترك في طلبات واجهة برمجة التطبيقات الإدارية /org/{org}/sharedflows/{sharedflow}/deployments بعد تعديل مسار مشترك تم نشره
77528868 Trireme تراجع Trireme: تم إنهاء الخادم script server.js برمز الحالة -1: لم يتم العثور على السمة 0
73766568 API Runtime أدّى التحديث من 170213_02 إلى 171117_01 إلى زيادة كبيرة في وقت الاستجابة للخادم الوكيل مع هدف Trireme/Node
72710481 API Runtime CacheServiceImpl/CacheMemoryLimiter NullPointerException
68861063 API Runtime التعامل مع NPE أثناء إيقاف أجهزة التوجيه
68833699 API Runtime عدم إزالة المعلومات عن خادم وكيل لواجهة برمجة التطبيقات أحيانًا من "شجرة تصنيف واجهات برمجة التطبيقات"
67377575 الاستهداف المستضاف عدم تطابق بين سجلّ الإحصاءات والمحتوى المُرسَل إلى العميل في خادم وكيل Node.js
112481174 الاستهداف المستضاف عدم تعذّر إلغاء نشر الخادم الوكيل بسبب خطأ في Turbo
117171470 الاستهداف المستضاف إصلاح رسالة الخطأ "app.yaml غير صالح"
67169139 API Runtime تنسيق الطابع الزمني لبروتوكول syslog في سياسة MessageLogging غير صحيح
67165418 API Runtime خطأ في الترخيص بشأن استخدام عدد أكبر من معالجات الرسائل حتى عند استخدام عدد أقل من العدد المرخّص

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

67165195 API Runtime لا تتحقّق ValidateSAMLAssertion من التوقيع على تأكيد مضمّن في استجابة موقَّعة
66214414 API Runtime يعرض المتغيّر currentstep.flowstate دائمًا القيمة SHARED_FLOW عند الرجوع إليه من مسار مشترك
65731656 API Runtime تعذُّر تنفيذ واجهة برمجة التطبيقات للحماية من التهديدات بشكل متقطع للطلب نفسه
133197060 API Runtime تلقّي رسالة الخطأ "57 Gateway timeout" من MP إلى الهدف
110535186 API Runtime ServiceCallout بدون عنصر Response وHTTPTargetConnection يشير إلى الخادم الوكيل: في بعض الأحيان لا يتم إجراء أي مكالمة
132443137 API Runtime تغيير سلوك "معالج الرسائل" لتجاهل العناوين التي تبدأ بـ X-Apigee-* نتيجةً لذلك، عليك إعادة هيكلة أي رمز يستخدم رؤوس X-Apigee-* واستبدال هذه الرؤوس برؤوس مدعومة.
125709964 API Runtime لا تعمل عملية إبطال ذاكرة التخزين المؤقت باستخدام purgeChildEntries على النحو المتوقّع