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)، يمكنك استرداد هذه القيم من متغيّر ضبطته في مسار خادم وكيل API. يتيح لك ذلك تغيير قيم عناوين 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 أدوار 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 من "خرائط Google"
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 عدم توفّر المضيفات والتطبيقات الافتراضية في معالجات الرسائل بعد بدء التشغيل
115614498 API Runtime هل تحتاج إلى دعم ILB في 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 تؤدي إلى حدوث مشاكل في توفّر MP
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: تم الخروج من الملف 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 من MP إلى الهدف
110535186 API Runtime ServiceCallout بدون عنصر Response وHTTPTargetConnection يشير إلى الوكيل: في بعض الأحيان لا يتم إجراء أي مكالمة
132443137 API Runtime تغيير سلوك "معالج الرسائل" لتجاهل العناوين التي تبدأ بـ X-Apigee-* نتيجةً لذلك، عليك إعادة هيكلة أي رمز برمجي يستخدم رؤوس X-Apigee-* واستبدال هذه الرؤوس برؤوس مدعومة.
125709964 API Runtime لا تعمل عملية إبطال ذاكرة التخزين المؤقت باستخدام purgeChildEntries على النحو المتوقّع