يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
أصدرنا يوم الثلاثاء 19 أيار (مايو) 2015 نسخة ربع سنوية من Apigee Edge لخدمة Private Cloud.
أصبح اسم المنتج السابق "Apigee Edge On-grounds" أو "OPDK" هو الآن "Apigee Edge لـ Private Cloud".
إذا كان لديك أسئلة، يُرجى الانتقال إلى خدمة دعم عملاء Apigee.
للحصول على قائمة بجميع ملاحظات إصدار Apigee Edge، يُرجى الاطّلاع على ملاحظات إصدار Apigee.
الميزات والتحسينات الجديدة
إليك الميزات والتحسينات الجديدة في هذا الإصدار.
OpenLDAP - التثبيت والترقية
أصبح بروتوكول OpenLDAP الآن هو خادم LDAP الوحيد المتوفر من خلال Edge لعمليات التثبيت الجديدة وعمليات الترقية.
خدمات واجهة برمجة التطبيقات
في ما يلي ميزات وتحسينات جديدة في خدمات واجهة برمجة تطبيقات Edge.
WebSockets
لإتاحة اتصالات الويب في الوقت الفعلي بين برنامج ويب وخادم، يتيح Edge بروتوكول WebSocket. ويمكن لبرنامج Edge أن يلعب دور العميل أو الخادم في اتصالات WebSocket. للحصول على معلومات حول إعداد WebSockets واستخدامه في Edge، يمكنك الاطّلاع على دليل Apigee Edge for Private Cloud Using WebSockets.
دعم موفِّر المصادقة الخارجي لإدارة واجهة برمجة التطبيقات
يتكامل Edge مع Active Directory وموفري المصادقة الخارجية/أنظمة LDAP التي تحتوي على المستخدمين المشرفين على واجهة برمجة التطبيقات. وللتعرّف على مزيد من المعلومات، يمكنك الاطّلاع على دليل ضبط إعدادات المصادقة الخارجية في السحابة الإلكترونية الخاصة باستخدام أداة Edge.
العلامات التجارية المشترَكة في واجهة مستخدم الإدارة
يمكنك وضع علامة تجارية لواجهة مستخدم إدارة Edge باستخدام شعارك المخصَّص الذي يظهر بجانب شعار Apigee. للتعرّف على مزيد من المعلومات، يُرجى الاطّلاع على القسم "إضافة شعار مخصّص إلى قائمة واجهة مستخدم Apigee" في دليل Apigee Edge الخاص بعمليات السحابة الإلكترونية الخاصة.
سجلات Node.js في التتبع
عند تصحيح أخطاء الخوادم الوكيلة لواجهة برمجة التطبيقات في Node.js، يمكنك تفعيل ميزة سجلّ Node.js في عرض التتبّع في محرِّر الخادم الوكيل لواجهة برمجة التطبيقات. لتفعيل هذه الميزة، يجب إعداد
apigee.feature.disableNodeJSLogs="false" إما في ملف apigee-base.conf أو
apigee-onground.conf في عملية التثبيت. للاطّلاع على مزيد من المعلومات حول سجلّ Node.js، راجِع تصحيح الأخطاء وتحديد المشاكل في خوادم Node.js الوكيلة وحلّها.
انتهاء صلاحية كلمة المرور
في Edge 4.15.01.x، انتهت صلاحية كلمات مرور Edge تلقائيًا بعد 30 يومًا. وهذا يعني أنّه يتم حظر وصول المستخدم إلى الحساب ما لم يغيّر كلمة المرور قبل انتهاء صلاحيتها. وقد تسبّب ذلك أيضًا في انتهاء صلاحية كلمة مرور مشرف النظام، ما أدّى إلى منع مشرف النظام من الوصول إلى شبكة Edge.
عند الترقية إلى الإصدار 4.15.04.00، سيتم تغيير الإعداد التلقائي بحيث لا تنتهي صلاحية كلمات المرور. يمكنك إذا لزم الأمر ضبط كلمات مرور Edge بحيث تنتهي صلاحيتها باستخدام النص البرمجي /opt/apigee4/bin/apigee-enable-pwlockout.sh. لمعرفة مزيد من المعلومات، يُرجى الاطّلاع على
دليل Apigee Edge الخاص بعمليات السحابة الإلكترونية الخاصة.
تقييد وصول مسؤول إدارة النظم إلى نطاقات بريد إلكتروني محددة
يمكنك قصر العضوية في أدوار القراءة فقط لمشرف النظم أو مسؤول إدارة النظم على المستخدمين في نطاقات بريد إلكتروني محددة. لتفعيل هذه الميزة، أضِف النطاقات المسموح بها إلى ملف apigee4/conf/apigee/management-server/security.properties، على النحو الموضّح في دليل عمليات السحابة الإلكترونية الخاصة لخدمة Apigee Edge.
رسائل الخطأ في واجهة مستخدم الإدارة
تمت إعادة تصميم عرض رسالة الخطأ في واجهة مستخدم الإدارة لاستخدام خصائص الشاشة بكفاءة أكبر.
متغيرات أخطاء OAuthV2 الجديدة
يتم ضبط المتغيّرات الجديدة المتعلّقة بالأخطاء من خلال سياسة OAuthV2:
- oauthV2.<policy-name>.failed - يمكنك ضبطها على "صحيح" في حال تعذُّر ضبط السياسة.
- 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.
خيارات الفلترة في واجهة مستخدم الإدارة
في صفحات وكلاء واجهة برمجة التطبيقات والمنتجات ومطوّري البرامج والتطبيقات في واجهة مستخدم الإدارة، تتوفّر خيارات فلترة جديدة للبحث.
أداة التتبُّع بلا إنترنت
تتيح لك أداة التتبُّع بلا اتصال بالإنترنت عرض وتحليل جلسات التتبُّع التي تم حفظها في السابق. وجلسة التتبُّع المحفوظة هي في الأساس "تسجيل" لجلسة تتبُّع، ويمكن أن تكون مفيدة في الحالات التي يتطلّب فيها تحديد المشاكل وحلّها وإجراء المزيد من التحليلات. وتكون واجهة المستخدم لأداة التتبُّع بلا إنترنت مشابهة لأداة التتبُّع "المباشر".
لمزيد من المعلومات، راجِع استخدام أداة التتبُّع بلا إنترنت.
أدوار المستخدِمِين المعروضة في "إعدادات المستخدِم"
في صفحة "إعدادات المستخدم" ضمن واجهة مستخدم الإدارة (اسم المستخدم > إعدادات المستخدم)، يتم الآن عرض أدوار المستخدم.
تحسينات واجهة المستخدم في إدارة Edge
يتضمّن هذا الإصدار عددًا من التحسينات البسيطة على سهولة الاستخدام والاتساق في واجهة مستخدم إدارة Edge.
خدمات التحليلات
في ما يلي ميزات وتحسينات جديدة في خدمات Edge Analytics.
تتوفر بيانات لمدة ستة أشهر
عند إنشاء تقارير الإحصاءات باستخدام واجهة مستخدم الإدارة أو واجهة برمجة التطبيقات، لا يمكن تلقائيًا الوصول إلى البيانات الأقدم من ستة أشهر من التاريخ الحالي. إذا أردت الوصول إلى البيانات الأقدم من ستة أشهر، يُرجى التواصل مع فريق دعم Apigee.
المتغيّرات المُضافة إلى الإحصاءات
يتم تمرير المتغيّرات الجديدة التالية إلى إحصاءات 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.
Dashboards
- تم نقل الرسوم البيانية للأداء لواجهات برمجة التطبيقات ومطوّري البرامج والمنتجات وتطبيقات المطوّرين. كانت تظهر عادةً في أسفل الصفحات الرئيسية لهذه العناصر. ويمكنك الآن الوصول إلى الرسوم البيانية من خلال اختيار علامة التبويب الإحصاءات في أعلى كل صفحة.
- يتضمّن هذا الإصدار أهم الأعمال على لوحات البيانات الحالية أو الجديدة:
- لوحة بيانات Apigee (تمّت مراجعتها): تتضمّن ثلاثة رسوم بيانية للمقاييس: زيارات الخادم الوكيل، وتفاعل المطوّرين، وتطبيقات المطوّرين. يوفّر كل رسم بياني طريقة عرض "مزيد من التفاصيل" تتيح لك التوغّل في كل مقياس. يُرجى الاطّلاع على لوحة بيانات Apigee.
- أداء الخادم الوكيل (جديد): يعرض أنماط زيارات الخادم الوكيل لواجهة برمجة التطبيقات وأوقات المعالجة. ستحلّ محلّ لوحة بيانات "أداء الخادم الوكيل لواجهة برمجة التطبيقات". يُرجى الاطّلاع على أداء الخادم الوكيل لواجهة برمجة التطبيقات.
- تصنيف الزيارات (تمّت مراجعته): تم إجراء مراجعة كاملة لشكل لوحة البيانات وأسلوبها ومحتواها. يقيس هذا المقياس المساهمة النسبية لأهم واجهات برمجة التطبيقات والتطبيقات والمطوّرين والمنتجات في برنامج واجهة برمجة التطبيقات الإجمالي. اطّلِع على تكوين عدد الزيارات.
- تحليل الأخطاء (تمّت مراجعته): تمت مراجعة الشكل والمضمون بالكامل. يعرض معدلات الأخطاء للخوادم الوكيلة والأهداف لواجهة برمجة التطبيقات. يُرجى الاطّلاع على لوحة بيانات تحليل رمز الخطأ.
-
تمت إعادة تسمية لوحات البيانات الحالية هذه:
- تمت إعادة تسمية أداء نقطة النهاية ليصبح الأداء المستهدَف: يعرض هذا الخيار أنماط الزيارات ومقاييس الأداء لأهداف خلفية الخادم الوكيل لواجهة برمجة التطبيقات. اطّلِع على الأداء المستهدَف.
- تم تغيير اسم تفاعُل الشركاء ليصبح تفاعل المطوّرين: يعرض لك هذا التقرير مطوّري التطبيقات المسجَّلين الذين يحقِّقون أكبر عدد من الزيارات من خلال واجهة برمجة التطبيقات. بالنسبة إلى كل مطوّر من مطوّري البرامج في مؤسستك، يمكنك معرفة مَن يحقِّق أكبر عدد من الزيارات من واجهة برمجة التطبيقات ومعظم الأخطاء. اطّلِع على تفاعل المطوّرين.
خدمات المطوّرين
في ما يلي ميزات وتحسينات جديدة في خدمات مطوّري برامج Edge.
توافق الإصدار 2.0 من Swagger 2.0 في "مستندات ذكية"
يدعم تطبيق Smart Docs استيراد مستندات مواصفات Swagger 2.0 ويحافظ على التوافق مع الأنظمة القديمة مع Swagger 1.2. وستتوفّر إمكانية استخدام كائنات أنظمة الأمان والمخططات المركزية في إصدار لاحق.
تحقيق الربح
إليك ميزات وتحسينات جديدة في تحقيق الربح في Edge. راجِع أيضًا قسم "المشاكل المعروفة" للحصول على المزيد من المعلومات حول تحقيق الربح.
التعامل بشكل منفصل مع الشركات والمطوّرين
يتم الآن التعامل مع الشركات والمطوّرين بشكل منفصل، ما يسمح بمزيد من المرونة في إضافة شركات متعددة إلى المطوّرين والعديد من المطوّرين إلى الشركات. توفّر واجهة المستخدم الإدارية الآن نوافذ منفصلة لكل من "الشركات" و "مطوّري البرامج" (يمكن الوصول إليها من القائمة "نشر").
يُرجى الاطّلاع على إدارة الشركات والمطوّرين.
في تقارير تحقيق الربح، تبقى الشركات فلترًا أساسيًا، على الرغم من تغيير تصنيف الفلتر من "مطوّري البرامج" إلى "الشركات".
الأخطاء التي تم إصلاحها
تم إصلاح الأخطاء التالية في هذا الإصدار.
| معرّف المشكلة | الوصف |
|---|---|
| OPDK-954 | لم تتم ترقية مخطّط "كاساندرا" 4.15.01 |
| MGMT-1986 | حدث خطأ في واجهة المستخدم أثناء إضافة مطوّر البرامج |
| MGMT-1983 | الحصول على واجهة برمجة تطبيقات رمز تفويض OAuth 2.0 تؤدي إلى إرجاع حالة خاطئة |
| MGMT-1962 | حدث خطأ أثناء تسجيل الدخول إلى واجهة مستخدم الإدارة باستخدام كلمة مرور قوية لم يعُد يتعذّر تسجيل الدخول إلى واجهة المستخدم باستخدام رموز خاصة معيّنة، مثل علامة النسبة المئوية. |
| MGMT-1894 | لا تنتهي أبدًا صفحة "تطبيقات المطوّرين" من التحميل لعمود المطوِّر. |
| MGMT-1872 | تعذُّر تنزيل التقارير المخصّصة |
| MGMT-1777 | تتعذّر إضافة مستخدم بعنوان بريد إلكتروني يحتوي على نطاق TLD من .acn |
| MGMT-1362 | لا يعمل البريد الإلكتروني "نسيت كلمة المرور" إذا كان عنوان البريد الإلكتروني يحتوي على
"_". يتم حل مشكلة إعادة ضبط كلمة المرور في Private Cloud مع عناوين البريد الإلكتروني التي تحتوي على شرطة سفلية. |
| CORERT-613 | إخفاقات تأكيد اتصال طبقة المقابس الآمنة بسبب "unrecognized_name" |
| APIRT-1346 | OAuth2.0: يتم عرض قيمة مجزّأة في استجابة رمز الدخول عندما تكون قيمة details.oauth.tokens.enabled على "صحيح". |
يحتوي هذا الإصدار أيضًا على إصلاحات للأخطاء من الإصدارات التالية:
| سحابة الحافة | Edge لـ Private Cloud |
|---|---|
المشاكل المعروفة
يحتوي هذا الإصدار على المشاكل المعروفة التالية.
| معرّف المشكلة | الوصف |
|---|---|
| لا ينطبق |
لم يتم تضمين نصَي Cassandra في الإصدار الذي يستخدمهما أداة التثبيت في عملية تثبيت أو ترقية تحقيق الربح. لحل هذه المشكلة، يمكنك تشغيل الأوامر التالية بعد تثبيت Cassandra أو الترقية لإكمال عملية تثبيت/ترقية ميزة تحقيق الربح:
|
| CORERT-318 | قد تتوقف أحيانًا بعض طلبات البيانات من واجهة برمجة التطبيقات ذات الحمولات الكبيرة (100s من كيلوبايت). لحلّ هذه المشكلة، يجب ضبط قيمة السمة التالية في ملفrouter.properties:HTTPServer.streaming.buffer.limit=0 (الإعداد التلقائي هو 10). |