4.17.05 - إصدار Edge الخاص بملاحظات الإصدار في السحابة الإلكترونية الخاصة

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

منذ الإصدار السابق من ميزات Edge for Private Cloud، تم طرح الإصدارات التالية وهي مضمّنة في هذا الإصدار من الميزات:

راجِع لمحة عن ترقيم الإصدارات للتعرّف على كيفية تحديد ما إذا كان إصدار معيّن من السحابة الإلكترونية مضمّنًا في إصدارك من Edge for Private Cloud.

نظرة عامة على الإصدار

يتضمّن هذا الإصدار عددًا من الميزات البارزة التي تساعدك في التحكّم بشكل أفضل في واجهات برمجة التطبيقات وتأمينها، بما في ذلك:

• تتيح عمليات النشر بدون توقّف التشغيل في التدفقات المشتركة.
• أصبح بإمكانك حذف بيانات تحقيق الربح الخاصة بمؤسسة.
• الميزات الجديدة الإضافية موضّحة أدناه.

في ما يتعلق بإيقاف الميزات نهائيًا، تم إيقاف ميزة الخزائن نهائيًا.

يتضمّن ما تبقّى من هذا الموضوع تفاصيل حول جميع الميزات الجديدة والتحديثات وإصلاحات الأخطاء التي يتضمّنها الإصدار.

الإيقاف النهائي والإيقاف

تم إيقاف الميزات التالية نهائيًا أو إزالتها في هذا الإصدار. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة الإيقاف النهائي لمتصفّح Edge.

تم إيقاف الميزة نهائيًا: إضافة مسارات في علامة التبويب "الأداء" الخاصة بخادم وكيل API

حتى هذا الإصدار، كان بإمكانك الانتقال إلى خادم وكيل لواجهة برمجة التطبيقات في واجهة مستخدم الإدارة، ثم الانتقال إلى علامة التبويب "الأداء"، وإنشاء مسارات مختلفة لإجراء مقارنة مستندة إلى الرسم البياني في علامة التبويب "الأداء" الخاصة بالخادم الوكيل وفي لوحة بيانات "المعاملات التجارية". تم إيقاف هذه الميزة نهائيًا ولم تعُد متاحة في واجهة المستخدم. للحصول على بديل لهذه الوظيفة، يُرجى الاطّلاع على مقالة "منتدى Apigee" التالية: بديل لواجهة برمجة التطبيقات الخاصة بالمعاملات التجارية. (EDGEUI-902)

تم إيقافها نهائيًا: عنوان URL الخاص بمعلومات الإصدار لبوابة "خدمات المطوّرين"

في الإصدارات السابقة من البوابة، لتحديد إصدار البوابة، كنت تفتح عنوان URL التالي في المتصفّح:

http://yourportal.com/buildInfo

في الإصدار 4.17.05، تمت إزالة هذا الرابط. لتحديد الإصدار، افتح إدخال القائمة التقارير > تقرير الحالة في Drupal. يظهر إصدار البوابة الإلكترونية في الجدول في الصف المسمّى تثبيت الملف الشخصي.

إيقاف ميزة "المتجر الآمن" (الخزائن) في Apigee نهائيًا

سيتم إيقاف نهائيًا مستودع Apigee الآمن، المعروف أيضًا باسم "الخزائن"، بعد عام واحد من تاريخ الإعلان عن الإيقاف النهائي الموضّح في صفحة الإيقاف النهائي. يتم إنشاء الخزائن التي توفّر مساحة تخزين مشفّرة لأزواج المفاتيح والقيم باستخدام واجهة برمجة التطبيقات الإدارية، ويتم الوصول إليها في وقت التشغيل باستخدام دوال في وحدة Node.js apigee-access.

بدلاً من استخدام وحدة التخزين الآمنة، استخدِم خرائط قيم المفاتيح (KVM) المشفّرة، كما هو موضّح في مقالة العمل باستخدام خرائط قيم المفاتيح. توفّر آلات KVM المشفّرة مستوى الأمان نفسه الذي توفّره الخزائن، كما أنّها تتيح المزيد من الخيارات لإنشاء البيانات واسترجاعها. (MGMT-3848)

الميزات والتحديثات الجديدة

في ما يلي الميزات والتحسينات الجديدة في هذا الإصدار. بالإضافة إلى التحسينات التالية، يتضمّن هذا الإصدار أيضًا العديد من التحسينات في سهولة الاستخدام والأداء والأمان والثبات.

السحابة الإلكترونية الخاصة

تمت إضافة مَعلمة إعدادات SMTP الجديدة المطلوبة إلى عملية التثبيت

يجب الآن استخدام المَعلمة SMTPMAILFROM في ملف إعداد تثبيت Edge. تحدّد هذه المَعلمة عنوان البريد الإلكتروني المستخدَم عندما يرسل Edge رسائل إلكترونية تلقائية، مثلاً عندما يطلب مستخدم إعادة ضبط كلمة مرور. لمزيد من المعلومات، راجِع مقالة تثبيت مكوّنات Edge على عقدة.

(EDGEUI-1020)

يمكنك الآن ضبط المهلة التي تستخدمها واجهة مستخدم Edge لطلبات إدارة Edge API

يمكنك الآن تحديد مدة المهلة المحدّدة لواجهة برمجة التطبيقات التي تستخدمها واجهة مستخدم Edge للتحكّم في المدة التي تنتظرها واجهة المستخدم إلى أن يتم عرض نتيجة طلب إدارة واجهة برمجة التطبيقات. تحدّد السمات التالية المهلة:

• تحدّد السمة conf_apigee_apigee.feature.apitimeout الوقت بالثواني الذي تنتظره واجهة المستخدم لكي يعود طلب إلى الخلفية، بغض النظر عن أي نشاط عليها. إذا لم يتم إكمال المكالمة في ذلك الوقت، ستعرض واجهة المستخدم خطأ انتهاء المهلة. القيمة التلقائية هي 180 ثانية (3 دقائق).
• يحدّد conf_apigee_play.ws.timeout.idle المدة التي تنتظرها واجهة المستخدم، بالمللي ثانية، لتلقّي نشاط على الخادم. يمكن ضبطها على القيمة نفسها مثل conf_apigee_apigee_apitimeout أو على قيمة أقل. ولن يكون لضبطها على قيمة أكبر أي تأثير. القيمة التلقائية هي 180000 مللي ثانية (3 دقائق).
• يحدّد conf_apigee_play.ws.timeout.connection المدة التي تنتظرها واجهة المستخدم إلى أن يتم إنشاء اتصال. يمكن ضبطها على القيمة نفسها مثل conf_apigee_apigee_apitimeout أو على قيمة أقل. ولن يكون لضبطها على قيمة أكبر أي تأثير. القيمة التلقائية هي 120000 مللي ثانية (دقيقتان).

لمزيد من المعلومات، يُرجى الاطّلاع على ضبط المهلة المستخدَمة من خلال واجهة مستخدم Edge لطلبات إدارة Edge API.

(EDGEUI-816)

تمت إضافة مهلة إعادة المحاولة لمعالج الرسائل إلى أجهزة التوجيه

تمت إضافة مهلة زمنية لكي تتوقّف أجهزة التوجيه عن إعادة محاولة إرسال طلب إلى "معالجات الرسائل" وتعرض رسالة خطأ.

لمزيد من المعلومات، يُرجى الاطّلاع على إعداد جهاز التوجيه لإعادة محاولة الاتصال بـ "معالج الرسائل".

(APIRT-2912)

تمت إضافة إجراء لتغيير مشرف النظام التلقائي

تمت الآن إضافة مستندات لتغيير مشرف النظام التلقائي.

يمكنك الاطّلاع على إدارة المستخدمين والأدوار والأذونات للحصول على مزيد من المعلومات.

(DOS-4895)

أضفنا مستندات حول فصل مهام تثبيت Edge بين مستخدم الجذر والمستخدم غير الجذر

توضّح المستندات الجديدة خطوات فصل مهام تثبيت Edge بين مستخدم الجذر والمستخدم غير الجذر.

يمكنك الاطّلاع على نظرة عامة حول تثبيت Edge لمزيد من المعلومات.

(DOS-4573)

تمّت إضافة سمة لضبط اسم المضيف للروابط في الرسائل الإلكترونية التي يتم إنشاؤها

يرسل Edge تلقائيًا رسائل إلكترونية ردًا على أحداث معيّنة، مثل إضافة مستخدم إلى مؤسسة. تحتوي العديد من هذه الرسائل الإلكترونية على رابط. على سبيل المثال، عند إضافة مستخدم جديد إلى مؤسسة، ترسل واجهة مستخدم Edge إلى المستخدم رسالة إلكترونية تحتوي على عنوان URL لتسجيل الدخول بالتنسيق التالي:

https://domain/login

يتم تحديد النطاق تلقائيًا بواسطة Edge، ويكون عادةً صحيحًا للمؤسسة. ومع ذلك، هناك احتمال أن يكون اسم النطاق الذي يتم إنشاؤه تلقائيًا غير صحيح عندما تكون واجهة مستخدم Edge خلف موازن تحميل. في هذه الحالة، يمكنك استخدام السمة conf_apigee_apigee.emails.hosturl لضبط جزء اسم النطاق من عنوان URL الذي تم إنشاؤه بشكل صريح.

لمزيد من المعلومات، اطّلِع على ضبط اسم المضيف للروابط في الرسائل الإلكترونية التي يتم إنشاؤها.

(EDGEUI-1044)

ضبط عنوان URL الأساسي الذي تعرضه واجهة مستخدم Edge لخادم وكيل API

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

في معظم الحالات، يكون عنوان URL المعروض في واجهة مستخدم Edge هو عنوان URL الصحيح لإجراء طلبات خارجية إلى الخادم الوكيل. ومع ذلك، في بعض الإعدادات، يكون عنوان URL المعروض غير صحيح. على سبيل المثال، يمكن أن يؤدي أي من الإعدادات التالية إلى عدم تطابق عنوان URL المعروض مع عنوان URL الفعلي المستخدَم لإجراء طلبات خارجية إلى الخادم الوكيل:

• يتم إنهاء طبقة المقابس الآمنة (SSL) في جهاز موازنة الحمل
• تتم عملية ربط المنافذ بين موازن الحمل وأجهزة توجيه Apigee
• جهاز موازنة الحمل تم ضبطه باستخدام إعادة كتابة المسار

يتيح الإصدار 4.17.05 والإصدارات الأحدث من Edge for Private Cloud سمة في المضيف الافتراضي باسم <BaseUrl> تتيح لك إلغاء عنوان URL المعروض في واجهة مستخدم Edge. في ما يلي مثال يعرض عنصر المضيف الافتراضي مع السمة الجديدة <BaseURL>. في هذا المثال، تظهر القيمة "http://myCo.com" في واجهة مستخدم Edge:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

في حال عدم ضبط <BaseUrl>، سيظهر عنوان URL التلقائي الذي تعرضه واجهة مستخدم Edge على النحو التالي: "http://DNS_name_or_IP:9005/"، بينما يكون الإعداد الفعلي لاسم المضيف المستعار هو "http://myCo.com".

يمكنك أيضًا ضبط عنوان URL الأساسي عند إنشاء مؤسسة باستخدام السمة VHOST_BASEURL مع الأداة apigee-provision.

يمكنك الاطّلاع على ضبط الوصول إلى واجهة برمجة التطبيقات باستخدام بروتوكول أمان طبقة النقل (TLS) في السحابة الخاصة للحصول على مزيد من المعلومات.

(EDGEUI-5008)

تمت إضافة مستندات حول تفعيل تسجيل تصحيح الأخطاء

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

يمكنك الاطّلاع على تفعيل ميزة تسجيل معلومات تصحيح الأخطاء لمزيد من المعلومات.

(APIRT-4018)

برنامج تثبيت جديد وبنية أوامر لأداة apigee-analytics-collector

على جميع عملاء Edge for Private Cloud إرسال إحصاءات إلى Apigee حول عدد الزيارات إلى خادم وكيل API باستخدام الإصدار التجريبي من أداة سطر الأوامر apigee-analytics-collector. ترسل هذه الأداة المساعدة تقرير عدد طلبات البيانات من واجهة برمجة التطبيقات إلى Apigee.

يحتوي هذا الإصدار من Edge على تعليمات تثبيت جديدة وبنية أوامر للأداة المساعدة apigee-analytics-collector. في هذا الإصدار، يمكنك الآن استخدام apigee-service لتثبيت الأداة المساعدة apigee-analytics-collector بدلاً من npm، واستدعاء الأداة المساعدة apigee-analytics-collector من خلال apigee-service بدلاً من استخدامها كأمر مستقل.

لمزيد من المعلومات، يُرجى الاطّلاع على تحميل بيانات زيارات واجهة برمجة التطبيقات إلى Apigee - الإصدار التجريبي.

دليل التثبيت التلقائي الجديد بعد تعديل بوابة "خدمات المطوّرين" لـ Nginx/Postgres من عملية تثبيت جديدة للإصدار 4.17.01

بعد تعديل عملية تثبيت جديدة للإصدار 4.17.01 الذي يستخدم Nginx/Postgres، تم تغيير الدليل الجذر من:

/opt/apigee/apigee-drupal

إلى:

/opt/apigee/apigee-drupal/wwwroot

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

التحقّق بشكل أكثر صرامة من صحة البيانات التي تدخلها الجهات

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

تشمل الكيانات المتأثرة ما يلي:

• المؤسسات
• البيئات
• خوادم وكيلة لواجهة برمجة التطبيقات
• مراجعات خادم وكيل واجهة برمجة التطبيقات
• أسماء السياسات في خادم وكيل لواجهة برمجة التطبيقات
• أرقام تعريف إعدادات قناع تتبُّع تصحيح الأخطاء
• أسماء الموارد (التعليق التوضيحي في Java وxsl وجميع الموارد)
• ملفات تخزين المفاتيح
• CRLstores
• مراجع الموارد
• الخوادم المستهدَفة

(MGMT-3840)

نشر مهام سير العمل المشتركة بدون توقّف

عندما تريد نشر تدفّقات مشتركة والتأكّد من عدم رفض أي زيارات واردة أو رفض عدد قليل منها أثناء عملية النشر، يمكنك الآن استخدام واجهة برمجة تطبيقات لإدارة عملية النشر بدون توقّف. وتكون العملية مطابقة تقريبًا لعملية النشر بدون توقّف لوكلاء API باستخدام واجهة Management API. ويكمن الاختلاف الوحيد في مورد واجهة برمجة التطبيقات الإدارية.

ينفّذ الاستدعاء التالي مراجعة سير العمل المشترك الموضّحة في معرّف الموارد المنتظم (URI)، ثم يلغي نشر المراجعة التي تم نشرها سابقًا (تتيح مَعلمة طلب البحث override=true ذلك):

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

تحقيق الربح

حذف بيانات تحقيق الربح لمؤسسة

قد تحتاج إلى حذف بيانات تحقيق الربح لمؤسستك في الحالات التالية:

• احذف مؤسستك. في هذه الحالة، عليك حذف بيانات تحقيق الربح قبل أن تتمكّن من حذف المؤسسة.
• محو بيانات تحقيق الربح من مؤسسة تجريبية تريد إعادة استخدامها في هذه الحالة، عليك مزامنة بيانات Apigee Edge بعد حذف بيانات تحقيق الربح.

لمزيد من المعلومات، يُرجى الاطّلاع على حذف بيانات تحقيق الربح من مؤسستك. (DEVRT-2581)

تمت إضافة واجهة برمجة تطبيقات لتفعيل ميزة تحقيق الربح في مؤسسة

يمكنك الآن استخدام واجهة برمجة تطبيقات لتفعيل ميزة تحقيق الربح في مؤسسة.

لمزيد من المعلومات، يُرجى الاطّلاع على تفعيل ميزة تحقيق الربح لمؤسسة.

(DEVRT-2383)

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

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

Private Cloud 4.17.05

Cloud 17.04.12 (واجهة المستخدم)

‫Cloud 17.04.05 (واجهة المستخدم)

Cloud 17.03.29 (UI)

‫Cloud 17.03.15.01 (واجهة المستخدم)

Cloud 17.03.15 (UI)

‫Cloud 17.03.13.02 (تحقيق الربح)

‫Cloud 17.03.13.01 (تحقيق الربح)

Cloud 17.03.13 (إدارة واجهات برمجة التطبيقات)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (API runtime)

Cloud 17.02.13 (إدارة واجهات برمجة التطبيقات)

‫Cloud 17.01.18 (واجهة المستخدم)

Cloud 17.01.16 (إدارة واجهات برمجة التطبيقات)

Cloud 17.01.16 (تحقيق الربح)