أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
في يوم الثلاثاء 19 أيار (مايو) 2015، أطلقنا إصدارًا ربع سنويًا من Apigee Edge لـ Private Cloud.
أصبح اسم المنتج السابق "Apigee Edge On-premises" أو "OPDK" الآن "Apigee Edge for Private Cloud".
إذا كانت لديك أسئلة، يُرجى الانتقال إلى دعم عملاء Apigee.
للحصول على قائمة بجميع ملاحظات إصدار Apigee Edge، يُرجى الاطّلاع على ملاحظات إصدار Apigee.
الميزات والتحسينات الجديدة
في ما يلي الميزات والتحسينات الجديدة في هذا الإصدار.
OpenLDAP - التثبيت والترقية
أصبح OpenLDAP الآن خادم LDAP الوحيد المتوافق مع Edge لعمليات التثبيت الجديدة والترقية.
خدمات واجهة برمجة التطبيقات
في ما يلي الميزات والتحسينات الجديدة في خدمات Edge API.
WebSockets
لتفعيل اتصالات الويب في الوقت الفعلي بين عميل الويب والخادم، يتيح Edge استخدام بروتوكول WebSocket. يمكن أن يلعب Edge دور العميل أو الخادم في اتصالات WebSocket. للحصول على معلومات عن إعداد بروتوكول WebSockets واستخدامه في Edge، يُرجى الاطّلاع على دليل Apigee Edge for Private Cloud Using WebSockets.
إتاحة مقدّم المصادقة الخارجي لإدارة واجهة برمجة التطبيقات
يتم دمج Edge مع Active Directory وأنظمة LDAP أو موفّري مصادقة خارجيين آخرين يحتويان على المستخدمين الإداريين لواجهات برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على دليل Edge for Private Cloud إعداد المصادقة الخارجية.
الشراكة بين العلامات التجارية في واجهة المستخدم الخاصة بالإدارة
يمكنك وضع علامتك التجارية على واجهة مستخدم إدارة Edge مع شعارك المخصّص الذي يظهر بجانب شعار Apigee. لمزيد من المعلومات، يُرجى الاطّلاع على "إضافة شعار مخصّص إلى قائمة واجهة مستخدم Apigee" في دليل عمليات Apigee Edge لخدمات السحابة الخاصة.
سجلّات Node.js في أداة تتبُّع الأخطاء
عند تصحيح أخطاء أدوات الربط لواجهة برمجة التطبيقات 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 للسحابة الإلكترونية الخاصة.
تقييد وصول مشرف النظام إلى نطاقات بريد إلكتروني معيّنة
يمكنك حصر العضوية في دور "المشرف العام" أو دور "المشرف العام للقراءة فقط" بالمستخدمين في نطاقات بريد إلكتروني معيّنة. لتفعيل هذه الميزة، أضِف النطاقات المسموح بها إلىملف 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.
خيارات الفلترة في واجهة مستخدم الإدارة
في صفحات "العناصر الوكيلة لواجهات برمجة التطبيقات" و"المنتجات" و"المطوّرون" و"التطبيقات" في واجهة مستخدم الإدارة، تتوفّر خيارات فلترة جديدة للبحث.
أداة التتبّع بلا إنترنت
تتيح لك أداة "التتبّع بلا إنترنت" عرض جلسات التتبّع التي تم حفظها سابقًا وتحليلها. جلسة التتبّع المحفوظة هي في الأساس "تسجيل" لجلسة تتبّع، ويمكن أن تكون مفيدة في الحالات التي يلزم فيها تحديد المشاكل وحلّها وإجراء مزيد من التحليل. واجهة مستخدم أداة "التتبّع بلا إنترنت" مشابهة لواجهة مستخدم أداة "التتبّع".
لمزيد من المعلومات، يُرجى الاطّلاع على استخدام أداة "التتبُّع بلا إنترنت".
أدوار المستخدمين المعروضة في "إعدادات المستخدم"
في صفحة "إعدادات المستخدم" ضمن واجهة مستخدم الإدارة (اسم المستخدم > إعدادات المستخدم)، يتم الآن عرض أدوار المستخدم.
تحسينات على واجهة مستخدِم إدارة Edge
يتضمّن هذا الإصدار عددًا من التحسينات البسيطة على سهولة الاستخدام والتناسق في واجهة مستخدِم إدارة Edge.
خدمات "إحصاءات Google"
في ما يلي الميزات والتحسينات الجديدة في "خدمات تحليلات الحافة".
تتوفّر بيانات ستة أشهر
عند إنشاء تقارير الإحصاءات باستخدام واجهة مستخدم الإدارة أو واجهة برمجة التطبيقات، لا يمكن الوصول تلقائيًا إلى البيانات الأقدم من ستة أشهر من التاريخ الحالي. إذا أردت الوصول إلى بيانات تعود إلى أكثر من ستة أشهر، يُرجى التواصل مع فريق دعم Apigee.
المتغيّرات التي تمت إضافتها إلى الإحصاءات
يتمّ تمرير المتغيّرات الجديدة التالية إلى تحليلات Edge، والتي تظهر في مرحلة AX من نافذة تتبُّع الوكيل API.
- 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.
- أداء الخادم الوكيل (جديد): تعرِض هذه البطاقة أنماط زيارات خادم وكيل واجهة برمجة التطبيقات وأوقات المعالجة. تستبدل لوحة بيانات "أداء وكيل واجهة برمجة التطبيقات". اطّلِع على أداء وكيل واجهة برمجة التطبيقات.
- تكوين الزيارات (معدَّل): تم تعديل شكل لوحة البيانات وأسلوبها ومحتوى بشكل كامل. تقيس هذه البطاقة المساهمة النسبية لأبرز واجهات برمجة التطبيقات والتطبيقات والمطوّرين والمنتجات في برنامج واجهات برمجة التطبيقات العام. اطّلِع على تركيبة الزيارات.
- تحليل الأخطاء (معدَّل): تم تعديل المظهر والأسلوب والمحتوى بالكامل. تعرِض هذه السمة معدّلات الأخطاء للخوادم الوكيلة وأهداف واجهة برمجة التطبيقات. اطّلِع على لوحة بيانات تحليل رمز الخطأ.
-
تمّت إعادة تسمية لوحات البيانات الحالية التالية:
- تمت إعادة تسمية أداء نقطة النهاية إلى أداء الاستهداف: تعرِض أنماط الزيارات ومقاييس الأداء لاستهداف الخلفية لوكيل واجهة برمجة التطبيقات. اطّلِع على استهداف الأداء.
- تمت إعادة تسمية تفاعل الشركاء إلى تفاعل المطوّرين : يعرض لك هذا التقرير مطوّري التطبيقات المسجّلين الذين يحقّقون أكبر عدد من الزيارات إلى واجهة برمجة التطبيقات. بالنسبة إلى كل مطوّر، يمكنك معرفة مَن يتسبّب في أكبر عدد من الزيارات إلى واجهة برمجة التطبيقات وأكبر عدد من الأخطاء. اطّلِع على تفاعل المطوّرين.
خدمات المطوّرين
في ما يلي الميزات والتحسينات الجديدة في "خدمات مطوّري تطبيقات Edge".
إتاحة Swagger 2.0 لميزة 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 | لا يمكن إضافة مستخدم لديه عنوان بريد إلكتروني يتضمّن نطاقًا أعلى من المستوى 3 (TLD) .acn |
| MGMT-1362 | لا تعمل الرسالة الإلكترونية "نسيت كلمة المرور" إذا كان عنوان البريد الإلكتروني يحتوي على
'_' تم إصلاح مشكلة إعادة ضبط كلمة المرور في Private Cloud مع عناوين البريد الإلكتروني التي تحتوي على خط تحتي. |
| CORERT-613 | تعذُّر تأكيد الاتصال باستخدام طبقة المقابس الآمنة بسبب "unrecognized_name" |
| APIRT-1346 | OAuth2.0 - يتم عرض القيمة المجزّأة في استجابة رمز الدخول عندما يكون hash.oauth.tokens.enabled صحيحًا |
يتضمّن هذا الإصدار أيضًا إصلاحات للأخطاء من الإصدارات التالية:
| Edge Cloud | Edge for Private Cloud |
|---|---|
المشاكل المعروفة
يتضمّن هذا الإصدار المشاكل المعروفة التالية.
| معرّف المشكلة | الوصف |
|---|---|
| لا ينطبق |
لم يتم تضمين نصَّين برمجيَّين من Cassandra يستخدمهما برنامج التثبيت في تثبيت تحقيق الربح أو ترقيته. لحلّ هذه المشكلة، شغِّل الأوامر التالية بعد تثبيت Cassandra أو ترقيته لإكمال عملية تثبيت ميزة تحقيق الربح أو ترقيتها:
|
| CORERT-318 | يمكن أن تتعطل أحيانًا طلبات البيانات من واجهة برمجة التطبيقات التي تحتوي على حِزم بيانات كبيرة (مئات الكيلوبايت). لحلّ هذه
المشكلة، اضبط قيمة السمة التالية في ملف router.properties:HTTPServer.streaming.buffer.limit=0 (الإعداد التلقائي هو 10) |