أنت الآن بصدد الاطّلاع على مستندات 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.
خيارات الفلترة في واجهة مستخدم الإدارة
في صفحات "خوادم وكيل API" و"المنتجات" و"المطوّرون" و"التطبيقات" في واجهة مستخدم الإدارة، تتوفّر خيارات فلترة جديدة للبحث.
أداة "التتبُّع بلا إنترنت"
تتيح لك أداة "التتبُّع بلا إنترنت" عرض جلسات التتبُّع التي تم حفظها سابقًا وتحليلها. جلسة التتبُّع المحفوظة هي في الأساس "تسجيل" لجلسة تتبُّع، ويمكن أن تكون مفيدة في الحالات التي تتطلّب تحديد المشاكل وإجراء المزيد من التحليل. تشبه واجهة مستخدم أداة "التتبُّع بلا اتصال" واجهة مستخدم أداة "التتبُّع المباشر".
لمزيد من المعلومات، يُرجى الاطّلاع على استخدام أداة "التتبُّع بلا إنترنت".
أدوار المستخدمين المعروضة في "إعدادات المستخدم"
في صفحة "إعدادات المستخدم" ضمن واجهة مستخدم الإدارة (اسم المستخدم > إعدادات المستخدم)، يتم الآن عرض أدوار المستخدم.
تحسينات على واجهة مستخدم إدارة Edge
يتضمّن هذا الإصدار عددًا من التحسينات الصغيرة على سهولة الاستخدام والتناسق في واجهة مستخدم إدارة Edge.
خدمات الإحصاءات
في ما يلي الميزات والتحسينات الجديدة في "خدمات Edge Analytics".
تتوفّر بيانات ستة أشهر
عند إنشاء تقارير إحصائية باستخدام واجهة مستخدم الإدارة أو واجهة برمجة التطبيقات، لا يمكن الوصول تلقائيًا إلى البيانات الأقدم من ستة أشهر من التاريخ الحالي. إذا أردت الوصول إلى بيانات أقدم من ستة أشهر، يُرجى التواصل مع فريق دعم Apigee Edge.
المتغيّرات المُضافة إلى الإحصاءات
يتم تمرير المتغيّرات الجديدة التالية إلى "إحصاءات Edge"، وهي تظهر في مرحلة 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 | لم تتم ترقية مخطط Cassandra 4.15.01 |
| 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 أو ترقيتها لإكمال عملية تثبيت/ترقية ميزة تحقيق الربح:
|
| CORERT-318 | قد تتوقف أحيانًا طلبات البيانات من واجهة برمجة التطبيقات التي تتضمّن حمولات كبيرة (مئات الكيلوبايت). لحلّ هذه المشكلة، اضبط قيمة السمة التالية في ملف router.properties:HTTPServer.streaming.buffer.limit=0 (الإعداد التلقائي هو 10). |