في الإصدار 4.54.00 من Apigee Edge for Private Cloud، تمت إزالة واجهة المستخدم الكلاسيكية (المكوّن edge-ui) ولم تعُد متاحة. واجهة مستخدم Edge الجديدة (مكوّن edge-management-ui) هي واجهة المستخدم الوحيدة في Edge for Private Cloud.
لا يمكنك استخدام edge-ui في Edge for Private Cloud 4.54.00. إذا كنت قد خصّصت واجهة المستخدم الكلاسيكية من خلال ضبط الخصائص في
/opt/apigee/customer/application/ui.properties، لن تتمكّن واجهة مستخدم Edge الجديدة
من قراءة هذا الملف. بعد التحديث إلى الإصدار 4.54.00، عليك ضبط المواقع المكافئة في /opt/apigee/customer/application/management-ui.properties.
تسرد هذه الصفحة سمات واجهة المستخدم الكلاسيكية الموثّقة لـ ui.properties، والسمات المكافئة لواجهة مستخدم Edge الجديدة، وسمات واجهة المستخدم الكلاسيكية غير المتوافقة مع واجهة مستخدم Edge الجديدة.
تستخدم واجهة مستخدم New Edge آلية الرمز نفسه مع الإعداد (CwC) مثل مكونات Edge الأخرى. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة كيفية ضبط Edge.
مقارنة إعدادات واجهة المستخدم الكلاسيكية وواجهة مستخدم Edge الجديدة
تحلّ واجهة مستخدم Edge الجديدة محلّ مكوّن واجهة المستخدم الكلاسيكية وملف الخصائص واسم الخدمة والمنفذ التلقائي وتنسيق شهادة بروتوكول أمان طبقة النقل (TLS). راجِع الجدول التالي لتعديل نصوص التشغيل الآلي وقواعد جدار الحماية وملفات بروتوكول أمان طبقة النقل (TLS) قبل نقل مواقعك:
| الإعداد | واجهة المستخدم الكلاسيكية (الإصدار 4.53.01 والإصدارات الأقدم) | واجهة مستخدم Edge الجديدة (الإصدار 4.54.00) |
|---|---|---|
| اسم المكوّن | edge-ui |
edge-management-ui |
| ملف الخصائص | /opt/apigee/customer/application/ui.properties |
/opt/apigee/customer/application/management-ui.properties
|
| أمر إعادة التشغيل | apigee-service edge-ui restart |
apigee-service edge-management-ui restart |
| المنفذ التلقائي | 9000 | 3001 |
| إعدادات بروتوكول أمان طبقة النقل (TLS) | ملف تخزين مفاتيح Java (JKS) | ملفات المفتاح وشهادة PEM يُرجى الاطّلاع على ضبط بروتوكول أمان طبقة النقل (TLS) لواجهة مستخدم Edge الجديدة. |
ضبط خصائص واجهة مستخدم Edge الجديدة
اضبط خصائص إعدادات واجهة مستخدم Edge الجديدة في
/opt/apigee/customer/application/management-ui.properties وأعِد تشغيل خدمة edge-management-ui لتطبيق التغييرات.
لضبط موقع إلكتروني لواجهة مستخدم New Edge، اتّبِع الخطوات التالية:
-
افتح ملف
management-ui.propertiesفي محرِّر. إذا لم يكن الملف متوفّرًا، أنشِئه:vi /opt/apigee/customer/application/management-ui.properties
-
اضبط السمة. على سبيل المثال:
conf_uebe_disableGeoMap=true
- احفظ التغييرات.
-
تأكَّد من أنّ الملف مملوك للمستخدم
apigee:chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
-
أعِد تشغيل واجهة مستخدم Edge الجديدة:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
اتّبِع قواعد التنسيق التالية عند ضبط سمات واجهة مستخدم Edge الجديدة:
-
أسماء السمات حسّاسة لحالة الأحرف. على سبيل المثال،
conf_uebe_disableGeoMapصالح، ولكنconf_uebe_disablegeomapغير صالح. -
ضَع قيم السلسلة بين علامتَي اقتباس مزدوجتَين، على سبيل المثال
conf_uebe_branding_companyNameShort="My Company". -
لا تضع القيم المنطقية (
trueأوfalse) أو القيم الرقمية بين علامتَي اقتباس. إذا تم تضمين قيمة منطقية أو رقمية بين علامتَي اقتباس، لن تبدأ واجهة مستخدم Edge الجديدة.
للاطّلاع على القيمة الحالية لسمة، استخدِم الخيار -search. على سبيل المثال:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui \ configure -search conf_uebe_disableGeoMap
ربط خصائص واجهة المستخدم الكلاسيكية بواجهة مستخدم Edge الجديدة
توضّح الجداول التالية كل سمة متوافقة في واجهة المستخدم الكلاسيكية في ui.properties وما يعادلها من سمات واجهة المستخدم الجديدة في Edge في management-ui.properties. يعرض عمود القيمة التلقائية القيمة التلقائية في واجهة مستخدم Edge الجديدة.
ضبط خصائص الميزات
اربط مفاتيح تبديل ميزات واجهة المستخدم الكلاسيكية بخصائص conf_uebe_*
المقابلة في management-ui.properties:
| سمة واجهة المستخدم الكلاسيكية | New Edge UI property | تلقائي | ملاحظات |
|---|---|---|---|
conf_apigee_apigee.feature.disablegeomap |
conf_uebe_disableGeoMap |
false |
اضبط القيمة على true لإخفاء الخرائط الجغرافية. في واجهة المستخدم الكلاسيكية الخاصة بـ
Edge for Private Cloud، تم إيقاف "الخرائط الجغرافية" تلقائيًا. إذا لم تكن قد فعّلت ميزة التجميع الجغرافي، اضبط هذه السمة على true. يُرجى الاطّلاع على
تفعيل التجميع الجغرافي
والخرائط الجغرافية.
|
conf_apigee_apigee.feature.disablepasswordreset |
conf_uebe_disablePasswordReset |
false |
اضبط القيمة على true لإخفاء رابط إعادة ضبط كلمة المرور
في صفحة تسجيل الدخول.
|
conf_apigee-base_apigee.feature.enableforcerangelimit
|
conf_uebe_enableForceRangeLimit |
true |
اضبط القيمة على false للسماح بالتقارير المخصّصة لنطاق زمني
يزيد عن 14 يومًا.
|
conf_apigee-base_apigee.feature.enabletraceforinternaladdresses
|
conf_uebe_trace_for_internal_addresses |
false |
اضبط القيمة على true للسماح لأداة Trace بإرسال الطلبات إلى
عناوين IP المحلية أو الداخلية.
|
conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses
|
conf_uebe_openapi_for_internal_addresses |
false |
اضبط القيمة على true للسماح باستيراد مواصفات OpenAPI
من عناوين IP محلية أو داخلية.
|
conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses
|
conf_uebe_wsdl_for_internal_addresses |
false |
اضبط القيمة على true للسماح باستيراد ملفات WSDL من عناوين IP المحلية
أو الداخلية.
|
ضبط خصائص الجلسة وبروتوكول أمان طبقة النقل (TLS)
ربط مهلة الجلسة وخصائص بروتوكول أمان طبقة النقل (TLS) في واجهة مستخدم Classic بما يعادلها في واجهة مستخدم New Edge في management-ui.properties:
| موقع كلاسيكي في واجهة المستخدم | New Edge UI property | تلقائي | ملاحظات |
|---|---|---|---|
conf_application_session.maxage |
conf_uebe_authsessiontimeout |
12 (بالساعات) |
الوقت الذي تنتهي فيه صلاحية جلسة المستخدم بعد تسجيل الدخول حدِّد عدد الساعات (على سبيل المثال، 12 أو 0.5) أو مدة باستخدام وحدة h (ساعات) أو m (دقائق) (على سبيل المثال، 24h أو 90m). القيمتان 12 و12h متكافئتان. لا تتوافق وحدة d
(الأيام)، على سبيل المثال، استبدِل 1d بـ 24h. إذا لم تكن القيمة صالحة، يتم استخدام القيمة التلقائية التي تبلغ 12 ساعة ولا يتم الإبلاغ عن أي خطأ. ينطبق ذلك على الجلسات التي تستخدم المصادقة الأساسية.
|
conf_application_session.secure |
لا يلزم تقديم أي مستندات | لا ينطبق |
تضبط واجهة مستخدم Edge الجديدة علامة Secure على ملفات تعريف الارتباط للجلسة
تلقائيًا عند تفعيل بروتوكول أمان طبقة النقل (TLS)
(conf_uebe_usehttps=true) أو عند إنهاء بروتوكول أمان طبقة النقل (TLS) على جهاز
موازنة الحمل (conf_uebe_tlsoffload=true).
|
conf/application.conf+trustxforwarded |
conf_uebe_usehttps=true وconf_uebe_tlsoffload=true
|
false |
اضبط كلتا السمتَين عند إنهاء بروتوكول أمان طبقة النقل (TLS) على جهاز موازنة الحمل. يجب أن يعيد جهاز موازنة الحمل توجيه الطلبات إلى واجهة مستخدم New Edge عبر HTTP وأن يضبط العنوان X-Forwarded-Proto. يضبط الأمر configure-ssl هذه السمات عند استخدام MANAGEMENT_UI_SCHEME=https وMANAGEMENT_UI_TLS_OFFLOAD=y. راجِع
إعداد بروتوكول أمان طبقة النقل (TLS) لواجهة مستخدم New Edge.
|
conf/application.conf+play.ws.ssl.loose.acceptAnyCertificate
|
conf_uebe_skipverify |
false |
اضبط القيمة على true فقط إذا كان خادم الإدارة يستخدم شهادة موقَّعة ذاتيًا. راجِع مقالة
ضبط بروتوكول أمان طبقة النقل (TLS) لواجهة برمجة التطبيقات الإدارية.
|
ضبط خصائص الرسائل الإلكترونية ونماذجها
ربط خصائص مرسل البريد الإلكتروني والموضوع والعلامة التجارية وعنوان URL المضيف وانتهاء صلاحية الرابط في واجهة المستخدم الكلاسيكية بواجهة مستخدم New Edge:
| موقع كلاسيكي في واجهة المستخدم | New Edge UI property | تلقائي | ملاحظات |
|---|---|---|---|
conf_apigee_apigee.mgmt.mailfrom |
conf_apigee_apigee.mgmt.mailfrom |
Apigee <sales@apigee.com>، أو قيمة
SMTPMAILFROM المحدّدة في وقت التثبيت
|
بدون تغييرات |
conf_apigee-base_apigee.emails.passwordreset.subject
|
conf_apigee_apigee.emails.passwordReset.subject |
Password Reset Request |
يُرجى ملاحظة جزء السمة passwordReset المكتوب بنمط camelCase. |
conf_apigee-base_apigee.emails.useraddedexisting.subject
|
conf_apigee_apigee.emails.userAddedExisting.subject |
You Have Been Added to an Organization {organization}
|
يُرجى ملاحظة جزء السمة userAddedExisting المكتوب بنمط camelCase.
|
conf_apigee-base_apigee.emails.useraddednew.subject |
conf_apigee_apigee.emails.userAddedNew.subject |
An Account Has been Created for You at {companyNameShort}
|
لاحظ قسم السمة userAddedNew بتنسيق camelCase. |
conf_apigee_apigee.branding.companynameshort |
conf_uebe_branding_companyNameShort |
Apigee |
تضبط هذه السمة قيمة العنصر النائب {companyNameShort} في مواضيع الرسائل الإلكترونية ونماذجها.
|
conf_apigee_apigee.emails.hosturl |
conf_apigee_apigee.emails.hosturl |
بدون |
بدون تغييرات في حال عدم ضبطها، تستخدم روابط إعادة ضبط كلمة المرور عنوان URL لواجهة مستخدم New Edge الذي تم تحديده في وقت التثبيت، وتستخدم روابط دعوات المستخدمين اسم المضيف للطلب. اضبط هذه السمة إذا كان المستخدمون يصلون إلى واجهة مستخدم Edge الجديدة من خلال موازن تحميل أو اسم نظام أسماء نطاقات، مثل conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com".
|
conf_apigee_apigee.forgotpassword.emaillinkexpiryseconds
|
conf_apigee_apigee.forgotPassword.EmailLinkExpirySeconds
|
600 |
ينطبق ذلك على روابط إعادة ضبط كلمة المرور وروابط دعوات المستخدمين. |
تستخدِم واجهة مستخدم New Edge نماذج رسائل إلكترونية مضمّنة. لاستخدام النماذج التي خصّصتها لواجهة المستخدم الكلاسيكية:
-
أنشئ الدليل
/opt/apigee/edge-management-ui/email-templates. -
انسخ ملفات
password-reset.htmlوuser-added-existing.htmlوuser-added-new.htmlالمخصّصة من دليل النسخ الاحتياطي الذي أنشأته قبل التحديث (على سبيل المثال،/opt/apigee/customer/backup/) إلى/opt/apigee/edge-management-ui/email-templates. تكون أسماء ملفات النماذج والعناصر النائبة هي نفسها في واجهة المستخدم الكلاسيكية. -
تأكَّد من أنّ الدليل والملفات مملوكة للمستخدم
apigee. - أعِد تشغيل واجهة مستخدم Edge الجديدة.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تخصيص نماذج الرسائل الإلكترونية في Edge.
ضبط خصائص كلمات المرور التي يتم إنشاؤها تلقائيًا
ربط سمات كلمات المرور التي تم إنشاؤها تلقائيًا في واجهة المستخدم الكلاسيكية بواجهة مستخدم Edge الجديدة:
| موقع كلاسيكي في واجهة المستخدم | New Edge UI property | تلقائي |
|---|---|---|
conf_apigee-base_apigee.forgotPassword.underscore.minimum
|
conf_apigee_apigee.forgotPassword.underscore.minimum
|
0 |
conf_apigee-base_apigee.forgotPassword.specialchars.minimum
|
conf_apigee_apigee.forgotPassword.specialchars.minimum
|
0 |
conf_apigee-base_apigee.forgotPassword.lowecase.minimum
|
conf_apigee_apigee.forgotPassword.lowecase.minimum |
0 |
conf_apigee-base_apigee.forgotPassword.uppercase.minimum
|
conf_apigee_apigee.forgotPassword.uppercase.minimum |
0 |
ضبط إعدادات الاتصال بخادم الإدارة وخصائص المفتاح السري المشترك
ربط خصائص اتصال خادم إدارة واجهة المستخدم Classic وشهادات الاعتماد وسر التطبيق بواجهة مستخدم New Edge:
| موقع كلاسيكي في واجهة المستخدم | موقع جديد في واجهة مستخدم Edge | ملاحظات |
|---|---|---|
conf_apigee_apigee.mgmt.baseurl |
mgmt_baseurl |
عنوان URL لواجهة برمجة التطبيقات Management API، على سبيل المثال
https://FQ_domain_name:port/v1. لا يبدأ اسم السمة هذا بـ conf_. إذا كان خادم الإدارة يستخدم شهادة موقَّعة ذاتيًا، يجب أيضًا ضبط السياسة conf_uebe_skipverify=true.
|
conf_apigee_apigee.mgmt.credential |
conf_uebe_mgmtCredential |
بيانات اعتماد مسؤول إدارة النظم المشفّرة يجب تشفير بيانات الاعتماد مرة أخرى
لواجهة مستخدم New Edge باستخدام
./bin/management-ui --encrypt، راجِع
الإعدادات المطلوبة لبيانات اعتماد مشرف النظام المختلفة.
|
conf_apigee_mail.smtp.credential |
conf_apigee_mail.smtp.credential |
بيانات اعتماد SMTP المشفّرة |
conf_application_application.secret |
conf_uebe_applicationsecret |
السرّ المستخدَم لتشفير بيانات الاعتماد وملفات تعريف الارتباط للجلسة يتم إنشاؤه في وقت التثبيت. |
إزالة خصائص واجهة المستخدم الكلاسيكية التي لا تتطلّب أي إجراء
لا تتوفّر خصائص واجهة المستخدم الكلاسيكية التالية في واجهة مستخدم Edge الجديدة لأنّ السلوك مفعَّل دائمًا. لا تُدرِج هذه السمات في
management-ui.properties (وأزِلها من أي نصوص برمجية
للإعدادات المبرمَجة):
| موقع كلاسيكي في واجهة المستخدم | السلوك في واجهة مستخدم Edge الجديدة |
|---|---|
conf_apigee_apigee.feature.expireSessionCookiesInternally
|
يتم دائمًا التحقّق من انتهاء صلاحية الجلسة على الخادم. |
conf_apigee_apigee.feature.trackSessionCookies |
يتم دائمًا تخزين معلومات الجلسة في ذاكرة الخادم. في حال استخدام مثيلات متعددة من واجهة مستخدم New Edge خلف جهاز موازنة الحمل، عليك ضبط جهاز موازنة الحمل لاستخدام الجلسات الثابتة. |
إزالة خصائص واجهة المستخدم الكلاسيكية غير المتوافقة
لا تتوفّر سمات واجهة المستخدم الكلاسيكية التالية وليس لها سمات مكافئة
في واجهة مستخدم Edge الجديدة. لا تُدرِج هذه السمات في
management-ui.properties (وأزِلها من أي نصوص برمجية
للإعدادات المبرمَجة):
| سمة واجهة المستخدم الكلاسيكية | الوصف |
|---|---|
conf_apigee_apigee.feature.apitimeout،
conf_apigee_play.ws.timeout.idle،
conf_apigee_play.ws.timeout.connection
|
لا يمكن ضبط مهلة طلبات البيانات من Management API في واجهة مستخدم New Edge. |
conf_application_http.proxyhost،
conf_application_http.proxyport،
conf_application_http.proxyuser،
conf_application_http.proxypassword
|
لا تتيح واجهة مستخدم Edge الجديدة استخدام خادم وكيل لإعادة التوجيه لطلبات "أداة التتبُّع". |
conf_apigee-base_apigee.feature.enableconsentbanner،
conf_apigee-base_apigee.consentbanner.buttoncaption،
conf_apigee-base_apigee.consentbanner.body
|
لا يتوفّر بانر الموافقة في واجهة مستخدم New Edge. |
conf_apigee-base_apigee.feature.apiproxypaginationenabled،
conf_apigee-base_apigee.pagination.apiproxypaginationbatchsize
|
في واجهة مستخدم Edge الجديدة، يتم تحميل قائمة الخوادم الوكيلة لواجهة برمجة التطبيقات دائمًا في الصفحات. لا يمكن ضبط حجم الصفحة. |
conf_logger_settings_application_log_level،
conf_logger_settings_play_log_level،
conf_application_logger.application
|
لا يمكن ضبط مستوى السجلّ في واجهة مستخدم Edge الجديدة. تتم كتابة ملفات السجلّ في /opt/apigee/var/log/edge-management-ui.
|
bin_setenv_min_mem، bin_setenv_max_mem،
bin_setenv_meta_space_size،
bin_setenv_ext_jvm_opts
|
لا تعمل واجهة مستخدم New Edge في جهاز Java الافتراضي. لا تنطبق إعدادات ذاكرة Java. |
مراجعة مثال على نقل البيانات
يقارن المثال التالي ملف ui.properties لواجهة المستخدم الكلاسيكية
مع ملف management-ui.properties المكافئ لواجهة مستخدم
New Edge.
واجهة المستخدم الكلاسيكية، /opt/apigee/customer/application/ui.properties:
conf_apigee_apigee.feature.disablegeomap=false conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true" conf_application_session.maxage="1d" conf_apigee-base_apigee.emails.passwordreset.subject="Reset your My Company password" conf_apigee_apigee.branding.companynameshort="My Company" conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com"
واجهة مستخدم Edge الجديدة،
/opt/apigee/customer/application/management-ui.properties:
conf_uebe_disableGeoMap=false conf_uebe_trace_for_internal_addresses=true conf_uebe_authsessiontimeout=24 conf_apigee_apigee.emails.passwordReset.subject="Reset your My Company password" conf_uebe_branding_companyNameShort="My Company" conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com"
يُرجى العِلم أنّ القيمة المنطقية true غير مضمّنة في علامات اقتباس، وأنّ مهلة الجلسة 1d تم استبدالها بـ 24.
بعد حفظ الملف، أعِد تشغيل واجهة مستخدم New Edge باتّباع الخطوات التالية:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
قائمة التحقّق من الملخّص
استخدِم قائمة التحقّق التالية لإكمال عملية نقل البيانات إلى واجهة مستخدم Edge الجديدة في Apigee Edge للسحابة الخاصة 4.54.00:
-
احتفِظ بنسخة احتياطية من
/opt/apigee/customer/application/ui.propertiesوأي نماذج رسائل إلكترونية مخصّصة من/opt/apigee/edge-ui/email-templatesقبل الترقية. -
أضِف السمات التي تم ربطها إلى
/opt/apigee/customer/application/management-ui.propertiesبدون استخدام علامات اقتباس للقيم المنطقية أو الرقمية، واحذف سمات واجهة المستخدم الكلاسيكية غير المتوافقة. -
انسخ نماذج الرسائل الإلكترونية المخصّصة من
دليل النسخ الاحتياطي إلى
/opt/apigee/edge-management-ui/email-templates. -
أعِد تشفير بيانات اعتماد مشرف النظام
باستخدام
./bin/management-ui --encryptفي حال ضبطconf_uebe_mgmtCredential. -
اضبط ملكية الملف على
apigee:apigeeوأعِد تشغيلedge-management-ui.