4.15.04.00 - Apigee Edge لملاحظات إصدار Private Cloud

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

في الثلاثاء 19 مايو 2015، أطلقنا إصدارًا ربع سنوي من Apigee Edge for Private Cloud.

تم تغيير اسم المنتج السابق "Apigee Edge On-premises" أو "OPDK" ليصبح "Apigee Edge for Private Cloud".

إذا كانت لديك أسئلة، يُرجى التواصل مع فريق دعم Apigee Edge.

للاطّلاع على قائمة بجميع ملاحظات إصدار Apigee Edge، يُرجى الرجوع إلى ملاحظات إصدار Apigee.

الميزات والتحسينات الجديدة

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

‫OpenLDAP - التثبيت والترقية

أصبح OpenLDAP الآن خادم LDAP الوحيد الذي يتيحه Edge لعمليات التثبيت الجديدة وعمليات الترقية.

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

في ما يلي الميزات والتحسينات الجديدة في "خدمات Edge API".

WebSockets

لإتاحة الاتصالات في الوقت الفعلي بين عميل ويب وخادم، يتوافق Edge مع بروتوكول WebSocket. يمكن أن يلعب Edge دور العميل أو الخادم في اتصالات WebSocket. للحصول على معلومات حول إعداد WebSockets واستخدامها في Edge، يُرجى الاطّلاع على دليل Apigee Edge للسحابة الخاصة باستخدام WebSockets.

توفير موفِّر مصادقة خارجي لإدارة واجهة برمجة التطبيقات

تتكامل Edge مع Active Directory وموفّري المصادقة الخارجيين الآخرين/أنظمة LDAP التي تحتوي على مستخدمي مشرفي واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على دليل إعداد المصادقة الخارجية في Edge for Private Cloud.

شراكة بين العلامات التجارية في واجهة مستخدم الإدارة

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

سجلات Node.js في Trace

عند تصحيح أخطاء خوادم وكيل واجهة برمجة التطبيقات Node.js، يمكنك تفعيل ميزة "سجلّ Node.js" في عرض "التتبّع" ضمن محرّر خادم وكيل واجهة برمجة التطبيقات. لتفعيل هذه الميزة، اضبط apigee.feature.disableNodeJSLogs="false" في ملف apigee-base.conf أو apigee-onpremise.conf في عملية التثبيت. لمزيد من المعلومات عن سجلّ Node.js، راجِع تصحيح أخطاء خوادم وكيل Node.js وتحديد المشاكل وحلّها.

انتهاء صلاحية كلمة المرور

في الإصدار 4.15.01.x من Edge، كانت كلمات مرور Edge تنتهي صلاحيتها تلقائيًا بعد 30 يومًا. وهذا يعني أنّه سيتم حظر المستخدم إلا إذا غيّر كلمة المرور قبل انتهاء صلاحيتها. ومع ذلك، أدّى ذلك أيضًا إلى انتهاء صلاحية كلمة مرور مشرف النظام، ما أدّى إلى حظر وصول مشرف النظام إلى Edge.

عند الترقية إلى الإصدار 4.15.04.00، تتغيّر الإعدادات التلقائية بحيث لا تنتهي صلاحية كلمات المرور. إذا لزم الأمر، يمكنك ضبط كلمات مرور Edge لتنتهي صلاحيتها باستخدام النص البرمجي /opt/apigee4/bin/apigee-enable-pwlockout.sh. لمزيد من المعلومات، راجِع دليل العمليات في Apigee Edge for Private Cloud.

حصر وصول مشرف النظام على نطاقات بريد إلكتروني محدّدة

يمكنك حصر العضوية في أدوار مشرف النظام أو مشرف النظام للقراءة فقط على المستخدمين في نطاقات بريد إلكتروني محددة. لتفعيل هذه الميزة، أضِف النطاقات المسموح بها إلى الملف apigee4/conf/apigee/management-server/security.properties، كما هو موضّح في دليل عمليات Apigee Edge للسحابة الخاصة.

رسائل الخطأ في واجهة مستخدم الإدارة

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

متغيّرات أخطاء OAuthV2 الجديدة

يتم ضبط هذه المتغيرات الجديدة المرتبطة بالأخطاء من خلال سياسة OAuthV2:

  • oauthV2.<policy-name>.failed: اضبط هذا الحقل على "true" إذا تعذّر تنفيذ السياسة.
  • oauthv2.<policy_name>.<fault_name> - اسم الخطأ. على سبيل المثال، invalid_request
  • oauthv2.<policy_name>.<fault_cause>: سبب الخطأ. على سبيل المثال: انتهت صلاحية الرمز المميّز

راجِع http://apigee.com/docs/api-services/content/oauthv2-policy.

إنشاء منتج

عند إنشاء منتج جديد، يمكنك الآن تحديد اسم المنتج بالإضافة إلى الاسم المعروض.

راجِع http://apigee.com/docs/developer-services/content/creating-api-products.

واجهة المستخدم لإزالة المستخدمين من مؤسسة

في صفحة "مستخدمو المؤسسة" في واجهة المستخدم، تم استبدال الزر "حذف" بالزر "إزالة". ويساعد ذلك في توضيح أنّه عند إزالة مستخدم من مؤسسة، يظل حساب Apigee الخاص بهذا المستخدم نشطًا.

راجِع http://apigee.com/docs/api-services/content/managing-organization-users.

خيارات الفلترة في واجهة مستخدم الإدارة

في صفحات &quot;خوادم وكيل API&quot; و&quot;المنتجات&quot; و&quot;المطوّرون&quot; و&quot;التطبيقات&quot; في واجهة مستخدم الإدارة، تتوفّر خيارات فلترة جديدة للبحث.

أداة "عملية تتبُّع غير متصلة بالإنترنت"

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

لمزيد من المعلومات، يُرجى الاطّلاع على استخدام أداة &quot;التتبُّع بلا إنترنت&quot;.

أدوار المستخدمين المعروضة في "إعدادات المستخدم"

في صفحة "إعدادات المستخدم" ضمن واجهة مستخدم الإدارة (اسم المستخدم > إعدادات المستخدم)، يتم الآن عرض أدوار المستخدم.

تحسينات على واجهة مستخدم إدارة Edge

يتضمّن هذا الإصدار عددًا من التحسينات الصغيرة على سهولة الاستخدام والتناسق في واجهة مستخدم إدارة Edge.

خدمات الإحصاءات

في ما يلي الميزات والتحسينات الجديدة في "خدمات Edge Analytics".

تتوفّر بيانات ستة أشهر

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

المتغيّرات المُضافة إلى الإحصاءات

يتم تمرير المتغيّرات الجديدة التالية إلى &quot;إحصاءات Edge&quot;، وهي تظهر في مرحلة AX من نافذة تتبُّع وكيل واجهة برمجة التطبيقات.

  • apigee.edge.execution.is_target_error: تتيح لك تحديد ما إذا كانت أخطاء واجهة برمجة التطبيقات هي أخطاء من جهة الهدف (القيمة "1") أو أخطاء غير مرتبطة بالهدف في حال عدم نجاح استجابات HTTP (القيمة "0"). القيمة فارغة في حال تلقّي استجابة HTTP ناجحة.
  • apigee.edge.execution.is_policy_error: تتيح لك تحديد ما إذا كانت إحدى السياسات قد تعذّر تنفيذها (القيمة "1") أو لم يتعذّر تنفيذ أي سياسة في استجابة HTTP غير ناجحة (القيمة "0"). القيمة فارغة في حال تلقّي استجابة HTTP ناجحة.
    توفّر المتغيّرات ذات الصلة التالية تفاصيل عن السياسة التي تعذّر تنفيذها أولاً. تكون القيم فارغة إذا لم يتم انتهاك أي سياسة.
    • apigee.edge.execution.fault_policy_name: اسم السياسة التي تعذّر تنفيذها.
    • apigee.edge.execution.fault_flow_name: اسم التدفق في السياسة التي تعذّر تنفيذها (مثل PreFlow أو PostFlow أو تدفق يحدّده المستخدم).
    • apigee.edge.execution.fault_flow_state: الموقع الجغرافي الذي تم فيه ربط السياسة في التدفق. القيم المحتملة: PROXY_REQ_FLOW وTARGET_REQ_FLOW وTARGET_RESP_FLOW وPROXY_RESP_FLOW.

لوحات البيانات

  • تم نقل الرسوم البيانية للأداء الخاصة بواجهات برمجة التطبيقات والمطوّرين والمنتجات وتطبيقات المطوّرين. وكانت تظهر في أسفل الصفحات الرئيسية لهذه الكيانات. يمكنك الآن الوصول إلى الرسوم البيانية من خلال النقر على علامة التبويب الإحصاءات في أعلى كل صفحة.
  • يتضمّن هذا الإصدار أعمالاً رئيسية على لوحات البيانات الحالية أو الجديدة التالية:
    • لوحة بيانات Apigee (تمت المراجعة): تتضمّن ثلاثة رسومات بيانية للمقاييس: عدد الزيارات إلى الخادم الوكيل، وتفاعل المطوّرين، وتطبيقات المطوّرين. يوفّر كل رسم بياني عرض "مزيد من التفاصيل" يتيح لك التوغّل في كل مقياس. اطّلِع على لوحة بيانات Apigee.
    • أداء الخادم الوكيل (جديد): تعرض هذه اللوحة أنماط زيارات خادم API الوكيل وأوقات المعالجة. تحلّ محلّ لوحة بيانات أداء خادم وكيل واجهة برمجة التطبيقات. اطّلِع على أداء خادم وكيل لواجهة برمجة التطبيقات.
    • تركيبة الزيارات (تمت المراجعة): تمّت مراجعة شكل لوحة البيانات ومحتواها بالكامل. تقيس هذه البطاقة المساهمة النسبية لأهم واجهات برمجة التطبيقات والتطبيقات والمطوّرين والمنتجات في برنامج واجهات برمجة التطبيقات بشكل عام. اطّلِع على تركيبة الزيارات.
    • تحليل الأخطاء (تمت المراجعة): تمّت مراجعة المظهر والمحتوى بالكامل. تعرِض هذه اللوحة معدّلات الخطأ لوكلاء واجهة برمجة التطبيقات والأهداف. اطّلِع على لوحة بيانات تحليل رموز الأخطاء.
  • تمت إعادة تسمية لوحات البيانات الحالية هذه:
    • تمت إعادة تسمية أداء نقطة النهاية إلى الأداء المستهدَف: يعرض هذا القسم أنماط الزيارات ومقاييس الأداء الخاصة باستهدافات الخلفية لوكيل واجهة برمجة التطبيقات. اطّلِع على الأداء المستهدَف.
    • تمت إعادة تسمية مقياس تفاعل الشريك ليصبح تفاعل المطوّر: يعرض هذا المقياس المطوّرين المسجّلين لتطبيقاتك الذين يحقّقون أكبر عدد من الزيارات إلى واجهة برمجة التطبيقات. بالنسبة إلى كل مطوّر، يمكنك معرفة المطوّر الذي يحقّق أكبر عدد من الزيارات إلى واجهة برمجة التطبيقات وأكبر عدد من الأخطاء. اطّلِع على تفاعل المطوّرين.

خدمات المطوّرين

في ما يلي الميزات والتحسينات الجديدة في "خدمات المطوّرين في Edge".

التوافق مع الإصدار 2.0 من Swagger في SmartDocs

تتيح SmartDocs استيراد مستندات مواصفات Swagger 2.0، كما تحافظ على التوافق مع الإصدارات السابقة من Swagger 1.2. سيتوفّر دعم عناصر مخطط الأمان والمخططات المركزية في إصدار لاحق.

تحقيق الربح

في ما يلي الميزات والتحسينات الجديدة في ميزة تحقيق الربح على Edge. يمكنك أيضًا الاطّلاع على قسم "المشاكل المعروفة" للحصول على مزيد من المعلومات حول تحقيق الربح.

التعامل بشكل منفصل مع الشركات والمطوّرين

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

يُرجى الاطّلاع على إدارة الشركات والمطوّرين.

في تقارير تحقيق الربح، تظل الشركات هي الفلتر الأساسي، على الرغم من أنّ تصنيف الفلتر قد تغيّر من "مطوِّرو التطبيقات" إلى "الشركات".

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

تم إصلاح الأخطاء التالية في هذا الإصدار.

معرّف المشكلة الوصف
OPDK-954 4.15.01 لم تتم ترقية مخطط Cassandra
MGMT-1986 حدث خطأ في واجهة المستخدم أثناء إضافة مطوِّر
MGMT-1983 تعرض واجهة برمجة التطبيقات "الحصول على رمز تفويض OAuth 2.0" حالة غير صحيحة
MGMT-1962 خطأ في تسجيل الدخول إلى واجهة مستخدم الإدارة باستخدام كلمة مرور قوية
لم يعُد يحدث خطأ عند تسجيل الدخول إلى واجهة المستخدم باستخدام رموز خاصة معيّنة، مثل علامة النسبة المئوية.
MGMT-1894 لا تنتهي عملية تحميل صفحة "تطبيقات المطوِّر" الخاصة بعمود المطوِّر
MGMT-1872 تعذُّر تنزيل التقارير المخصّصة
MGMT-1777 لا يمكن إضافة مستخدم لديه عنوان بريد إلكتروني ينتهي بالنطاق الأعلى مستوى ‎ .acn
MGMT-1362 لا تعمل الرسالة الإلكترونية "نسيت كلمة المرور" إذا كان عنوان البريد الإلكتروني يتضمّن الرمز "_"
يتم إصلاح مشكلة إعادة ضبط كلمة المرور في "السحابة الخاصة" باستخدام عناوين البريد الإلكتروني التي تتضمّن شرطة سفلية.
CORERT-613 تعذُّر تأكيد الاتصال عبر طبقة المقابس الآمنة (SSL) بسبب "unrecognized_name"
APIRT-1346 ‫OAuth2.0 - يتم عرض القيمة المجزأة في استجابة رمز الدخول عندما تكون قيمة hash.oauth.tokens.enabled هي true

يتضمّن هذا الإصدار أيضًا إصلاحات للأخطاء من الإصدارات التالية:

Edge Cloud Edge for Private Cloud

المشاكل المعروفة

يتضمّن هذا الإصدار المشاكل المعروفة التالية.

معرّف المشكلة الوصف
لا ينطبق

لم يتم تضمين نصَّين برمجيَّين من Cassandra في الإصدار، وهما النصَّان اللذان يستخدمهما برنامج التثبيت في عملية التثبيت أو الترقية الخاصة بالتسييل.

لحلّ هذه المشكلة، شغِّل الأوامر التالية بعد تثبيت Cassandra أو ترقيتها لإكمال عملية تثبيت/ترقية ميزة تحقيق الربح:

  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/360-company-developers.txt
  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/320-update-notification-service_item.txt
CORERT-318 قد تتوقف أحيانًا طلبات البيانات من واجهة برمجة التطبيقات التي تتضمّن حمولات كبيرة (مئات الكيلوبايت). لحلّ هذه المشكلة، اضبط قيمة السمة التالية في ملف router.properties:
HTTPServer.streaming.buffer.limit=0 (الإعداد التلقائي هو 10).