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

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

أصدرنا يوم الثلاثاء 30 آب (أغسطس) 2016 إصدارًا جديدًا من Apigee Edge for Public Cloud.

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

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

حمولات JSON في "تعيين" إرسال رسالة وإظهار الخطأ

عند ضبط حمولة JSON باستخدام سياسة تعيين الرسالة أو رفع الخطأ، يُجري المستخدمون أحيانًا مطلوب لاستخدام الحلول البديلة لضمان تنسيق رسالة JSON بشكل صحيح في وقت التشغيل، مثل بداية الحمولة بشرطة مائلة للخلف "\" أو تحديد changePrefix وvariableSuffix على عنصر الحمولة، حتى في حال عدم استخدام أي متغيرات في الرسالة.

من خلال هذا التحسين، ليست هناك حاجة إلى أي حلول بديلة لضمان تنسيق رسالة JSON بالشكل المناسب يمكن تحديد المتغيرات باستخدام أقواس متعرجة بدون إنشاء ملف JSON غير صالح. على سبيل المثال، يؤدي ما يلي إلى إدراج قيمة message.content في رسالة JSON:

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

وإذا استخدمت أحد الحلول البديلة، سيستمر الرمز الخاص بك في العمل كما هو. يمكنك أيضًا استخدام changePrefix وvariableSuffix بدلاً من الأقواس المعقوفة للإشارة إلى المتغيرات.

الاطّلاع على <Set><Payload> العنصر في سياسة تعيين الرسائل سياسة رفع الأخطاء المستندات المرجعية. (APIRT-1160)

تحسينات على سياسة XML إلى JSON

تم تحسين سياسة XML إلى JSON باستخدام الإمكانات التالية. يمكنك ضبط تعمل السياسة على:

  • التعامل مع بعض عناصر XML كصفائف أثناء التحويل، ما يؤدي إلى وضع القيم بشكل مربّع الأقواس '[ ]' في مستند JSON.
  • إزالة مستويات التدرج الهرمي لمستند XML أو إزالتها في مستند JSON النهائي

لمزيد من المعلومات، يمكنك مراجعة ملف XML إلى سياسة JSON. (APIRT-1144)

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

عند تحديد مسارات الموارد في منتج واجهة برمجة التطبيقات، يمكنك تضمين أحرف البدل في أماكن متعددة في مسار المورد. على سبيل المثال، يسمح /team/*/invoices/** بطلبات البيانات من واجهة برمجة التطبيقات مع أي قيمة واحدة بعد /team وأي مسارات للموارد بعد invoices/. عنوان URI مسموح به في طلب بيانات من واجهة برمجة التطبيقات سيكون proxyBasePath/team/finance/invoices/company/a.

في حال توقُّف مسارات موارد منتجات واجهة برمجة التطبيقات الحالية عن العمل بعد هذا الإصدار كما هو متوقع، السمة التالية في مؤسستك للعودة إلى السابق السلوك: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

الدوال المشفّرة في JavaScript

تتوفّر مجموعة جديدة من دوال crypto العالية الأداء في JavaScript لإنشاء العناصر التالية والحصول عليها وتحديثها باستخدام كائنات: MD5 وSHA-1 وSHA256 وSHA512. يتيح لك الكائن crypto أيضًا الحصول على العنصر التاريخ بتنسيقات مختلفة. لمزيد من المعلومات، يُرجى الاطّلاع على نموذج كائن JavaScript. (APIRT-2886)

إصدار ملف JAR للشرح في Java جارٍ التحقّق

عند تحميل مورد Java JAR إلى خادم وكيل لواجهة برمجة التطبيقات، يتم عرض رمز حالة HTTP 400 (بدلاً من 500) في حال كان إصدار مورد Java غير متوافق مع Edge المتوافق Java، والمدرج في البرامج المتوافقة المتوافقة مع الأجهزة الجوّالة. (MGMT-3420)

التحقّق من صحة موارد الخادم الوكيل لواجهة برمجة التطبيقات

عندما يكون لديك ملفات موارد خادم وكيل لواجهة برمجة التطبيقات (مثل JavaScript أو Java JAR) مخزنة في ملف على نطاق المؤسسة أو على نطاق المؤسسة، فإن إطار عمل التحقق لم يعد يتطلب منك أيضًا تضمين هذه الموارد على مستوى الخادم الوكيل لواجهة برمجة التطبيقات في حزمة خادم وكيل للاستيراد لاجتياز التحقق من الصحة. يتم الآن التحقق من صحة المورد في وقت النشر، وليس في وقت الاستيراد. (MGMT-1430)

ضبط المهلة للخوادم الوكيلة الفردية لواجهة برمجة التطبيقات

يمكنك إعداد الخوادم الوكيلة لواجهة برمجة التطبيقات لانتهاء المهلة بعد وقت محدد (مع انتهاء مهلة بوابة 504). الحالة). إنّ حالة الاستخدام الأساسية هي لعملاء Private Cloud الذين لديهم خوادم وكيلة لواجهة برمجة التطبيقات تتولى نقل أطول للتنفيذ. على سبيل المثال، لنفترض أنك تحتاج إلى خوادم وكيلة محددة لتنتهي المهلة خلال 3 دقائق. يمكنك استخدام سمة api.timeout جديدة في إعدادات الخادم الوكيل لواجهة برمجة التطبيقات وإليك كيفية إجراء ذلك: يمكنك أن تفعل ذلك باستخدام مثال مدته 3 دقائق:

  1. أولاً، تأكَّد من ضبط جهاز موازنة الحمل وجهاز التوجيه ومعالج الرسائل على الانتهاء بعد 3 دقائق.
  2. ثم اضبط الخوادم الوكيلة ذات الصلة لتنتهي خلال 3 دقائق. حدد القيمة في مللي ثانية. على سبيل المثال:
    <ProxyEndpoint name="default">
      <HTTPProxyConnection>
        <BasePath>/v1/weather</BasePath> 
        <Properties> 
          <!-- api.timeout is in milliseconeds -->
          <Property name="api.timeout">180000</Property>
        </Properties>
        ...
  3. ومع ذلك، تجدر الإشارة إلى أنّ رفع مهلات النظام قد يؤدي إلى حدوث مشاكل في الأداء، لأنّه تستخدم جميع الخوادم الوكيلة التي لا تشتمل على إعداد api.timeout أدوات موازنة الحمل الجديدة والأعلى مستوى لانتهاء مهلة معالج الرسائل. لذا، يمكنك إعداد الخوادم الوكيلة الأخرى لواجهة برمجة التطبيقات التي لا تتطلب مهلات أطول. لاستخدام مهلات أقل. على سبيل المثال، يؤدي ما يلي إلى انتهاء مهلة الخادم الوكيل لواجهة برمجة التطبيقات بعد 1 الدقيقة:
    <Property name="api.timeout">60000</Property>

يمكن لعملاء Cloud، الذين لا يمكنهم تعديل مهلات Edge، أيضًا ضبط مهلة الخادم الوكيل لواجهة برمجة التطبيقات، طالما أن المهلة أقل من مهلة معالج رسائل Edge القياسية التي تبلغ 57 ثوانٍ.

لا يمكنك تعبئة القيمة بمتغير. تتم تغطية هذا العقار في مرجع خصائص نقطة النهاية (APIRT-1778)

بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) لتسجيل الرسائل السياسة

يمكن ضبط <KeyStore> و<TrustStore> في SSLInfo على سياسة تسجيل الرسائل، السماح ببروتوكول TLS/SSL أحادي الاتجاه مع خدمة تسجيل. يمكنك تهيئة SSLInfo على سياسة تسجيل الرسائل بنفس الطريقة التي تفعله على الوكيل TargetEndpoint (نقطة النهاية المستهدفة): ومع ذلك، لا يتوافق بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) لتسجيل الرسائل إلا مع بروتوكول TCP. (APIRT-1858)

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

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

معرّف المشكلة الوصف
SECENG-609 تعذُّر إجراء استدعاءات وقت التشغيل أثناء حذف مخزن الثقة المرتبط أو عند حذف الشهادة الصالحة في Truststore
MGMT-3404 من المهم جدًا عرض/استرداد سجلات Node.js ونشر الخوادم الوكيلة بطيئة
MGMT-3400 فشل الاتصال بواجهة برمجة تطبيقات إدارة المستخدمين /userroles إذا كان المستخدم الذي يجري الاستدعاء لديه "+" تسجيل الدخول بالاسم
MGMT-3368 java.lang.ArrayIndexOutOfBoundsException: 1، عند استيراد حزمة خادم وكيل لواجهة برمجة التطبيقات يحتوي على دليل موارد أو عقدة أو موارد
MGMT-3364 OAuthV2: التحقُّق من إعادة التوجيه إلى إعادة توجيه
MGMT-3319 لا يعمل الإدخال في قائمة يحتوي على قيمة فارغة في أحد الإدخالات. للمؤسسات (CPS وغير CPS)
MGMT-3226 يجب ألا يسحب طلب البحث على مستوى المؤسسة/البيئة جميع البيانات التي تتسبب في حدوث واجهة برمجة التطبيقات إخفاق
كان Release_160302 يحتوي على خطأ حيث تم إدراج قائمة الموارد على مستوى المؤسسة/البيئة. إذا كان الحجم التراكمي للموارد أكبر من 16 ميغابايت، فإن هذا الحل سيحل المشكلة بها.
AXAPP-2429 واجهة برمجة تطبيقات "إحصاءات Google" التي تستخدم response_status_code تؤدي إلى إرجاع إمكانية الوصول إلى البيانات "خطأ"
AXAPP-2386 إصلاح محتوى التقارير الفارغة في تقارير البريد الإلكتروني اليومية ضمن "إحصاءات Google"
AXAPP-2347 عدم تلقّي رسائل إلكترونية يومية حول ملخّص الإحصاءات
APIRT-3141 تعذّرت وسائل شرح Java عند استدعاء الدالة ExecutionResult() الجديدة بسبب الدالة الإنشائية تم ضبط إعدادات خصوصيته على "خاص"
APIRT-3140 سياسة واجهة برمجة التطبيقات لا تعمل في طلبات واجهة برمجة التطبيقات head
APIRT-3131 عرض كلمة createBy غير صحيحة لخادم وكيل واجهة برمجة التطبيقات عند استخدام ميزة تحقيق الربح من خلال موفِّر مصادقة خارجي
APIRT-3121 التغيير الذي تم إجراؤه على ملف الموارد التنظيمية ليس فعّالاً بنسبة% 100
APIRT-3117 وصلت MP إلى 100% من استخدام وحدة المعالجة المركزية (CPU) وتوقفت عن عرض بيانات الزيارات.
APIRT-3016 جهاز التوجيه "انتهت مهلة المكالمة" الأخطاء في عمليات النشر
APIRT-2975 تعذّر تحميل حزمة الشهادة
APIRT-2955 تعذُّر إخفاء سمات معيّنة لبيانات استجابة JSON لشكوى بشأن FHIR عنوان نوع المحتوى "application/json+fhir"
APIRT-2946 لا تخفي سياسة OAuthV2-RefreshToken السمات في حال ضبط العرض على خطأ
APIRT-2908 يجب فرض بروتوكول TLS1.2 على طلب البيانات من واجهة برمجة التطبيقات الداخلية بعد تحديث TLS1.2. مضيف افتراضي
APIRT-2901 ردود Gzipped التي يتم عرضها من ذاكرة التخزين المؤقت تكون مضغوطة مرّتين
APIRT-2873 طرح أعضاء نواب المجلس NullPointerException المتعلق بـVerifyAPIKey بعد حذف products/developers/proxies
APIRT-2871 ظهور سياسات IOIncentive مرتين في Trace
APIRT-2825 خطأ نحوي في استجابة الخطأ في الوصول إلى الرمز
APIRT-2750 ارتفاع عدد الزيارات إلى مؤسسة معيّنة
APIRT-2685 لا يمكن أن تتدفق حركة المرور في حال حدوث خطأ غير معروف.
APIRT-2647 "لم يُرجع البث المباشر للإدخال أي وحدات بايت" خطأ في nonprod/dev
APIRT-2630 ظهور مشاكل من حين لآخر عند محاولة قراءة القيمة من ذاكرة التخزين المؤقت
APIRT-2620 تجميع سلاسل المحادثات المنفصلة لبعض خطوات الحظر
APIRT-2610 java.lang.ClassCastException مع سياسة ذاكرة التخزين المؤقت للاستجابة
APIRT-2608 خطأ في تحليل العناوين التي تم تعديلها بتاريخ آخر تعديل في سياسات "ذاكرة التخزين المؤقت للاستجابة"
APIRT-2605 "مؤسسة" و"environment" لا ينبغي السماح باستبدال المتغيرات عبر السياسات
APIRT-2566 سياسة OAuthV2 تعرض عنوان WWW-Authenticate مكتوبًا بشكل غير صحيح
APIRT-2491 تعذّر تحديث TargetServer بسبب انتهاء مهلة RPC بين الإدارة م/ث
APIRT-2386 يتم إنشاء نطاق سلسلة فارغ في منتج واجهة برمجة تطبيقات يحتوي على حقل OAuth مسموح به فارغ النطاقات
APIRT-2383 يبدو أن سياسات تحويل XSL لا تسجل أي بيانات "خطأ"
APIRT-2364 عدم تعديل متغيّرات مسار خطأ OAuth عند ظهور الخطأ
APIRT-2216 الأحداث المُرسَلة من الخادم - مشاكل في بث الأحداث في الإنتاج
APIRT-2079 تصحيح الأخطاء في استدعاء cURL الذي لا يتوقف بعد انتهاء المهلة المحدّدة للعرض الذي تم إنشاؤه الجلسة
APIRT-1495 الحماية من تهديدات XML لا ترصد أنواع المحتوى المختلفة
APIRT-347 لم يتم التحقق من سياسة XSL بشكل صحيح عند الاستيراد (لم يتم تحديد النتائج إلى إخراج المتغيّرات كما هو موثَّق)