تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تثبيت واجهة مستخدم Edge الجديدة

يوضّح هذا المستند كيفية تثبيت واجهة مستخدم Edge في "Apigee Edge للسحابة الخاصة". واجهة مستخدم Edge هي الجيل التالي من واجهات المستخدم الخاصة بمتصفّح Edge.

المتطلبات الأساسية

لتجربة واجهة مستخدم Edge الجديدة في عملية تثبيت Apigee Edge for Private Cloud، عليك إجراء ما يلي:

ثبِّت واجهة مستخدم Edge على عقدة منفصلة. لا يمكنك تثبيته على عقدة تحتوي على مكونات Edge أخرى، بما في ذلك العقدة التي تتضمّن واجهة المستخدم الكلاسيكية الحالية. سيؤدي ذلك إلى عدم تمكُّن المستخدمين من تسجيل الدخول إلى واجهة المستخدم الكلاسيكية.
يجب أن تستوفي عقدة واجهة مستخدم Edge المتطلبات التالية:
- JAVA 1.8
- ذاكرة وصول عشوائي (RAM) بسعة 4 غيغابايت
- نظام ثنائي النواة
- مساحة قرص تبلغ 60 غيغابايت
- يجب أولاً تثبيت الإصدار 4.53.01 من أداة apigee-setup على العقدة كما هو موضّح في تثبيت أداة Edge apigee-setup.
- يجب أن يكون المنفذ 3001 مفتوحًا. هذا هو المنفذ التلقائي المستخدَم لطلبات Edge UI. في حال تغيير المنفذ باستخدام الخصائص الموضّحة في ملف إعداد UE الجديد، تأكَّد من أنّ المنفذ مفتوح.
فعِّل IDP خارجي على Edge. تتيح واجهة مستخدم Edge استخدام SAML أو LDAP كآلية مصادقة.
(موفِّر الهوية SAML فقط) لا تتوافق واجهة مستخدم Edge إلا مع الإصدار 1.2 من بروتوكول أمان طبقة النقل (TLS). بما أنّك تتصل بموفِّر الهوية المستند إلى SAML عبر بروتوكول أمان طبقة النقل (TLS)، يجب أن يتوافق موفِّر الهوية مع الإصدار 1.2 من بروتوكول أمان طبقة النقل (TLS) إذا كنت تستخدم SAML.

لمزيد من المعلومات عن واجهة مستخدم Edge، يُرجى الاطّلاع على واجهة مستخدم Edge الجديدة لـ Private Cloud.

نظرة عامة على عملية التثبيت

على مستوى عالٍ، تكون عملية تثبيت واجهة مستخدم Edge في Apigee Edge Private Cloud على النحو التالي:

إضافة عقدة جديدة إلى مجموعتك
تسجيل الدخول إلى العقدة الجديدة
تنزيل أداة apigee-setup
إنشاء ملف إعداد وتعديله باستخدام إعداداتك
تنفيذ الأداة المساعدة apigee-setup
تسجيل الدخول واختبار تجربة المستخدم الجديدة

عند تنفيذها على العقدة الجديدة، تعمل الأداة apigee-setup على ما يلي:

تثبيت واجهة المستخدم الأساسية الكلاسيكية، والتي تُسمى shoehorn، وإعداد واجهة المستخدم الكلاسيكية لاستخدام موفِّر هوية خارجي للمصادقة مع Edge
ملاحظة: لا يمكنك استخدام واجهة المستخدم الكلاسيكية المثبَّتة للاتصال بـ Edge. وهو ببساطة شرط لتثبيت واجهة مستخدم Edge الجديدة.
تثبيت واجهة مستخدم Edge الجديدة، وضبط واجهة مستخدم Edge لاستخدام موفِّر الهوية الخارجي للمصادقة مع Edge

اعتبارات قبل تثبيت واجهة المستخدم الجديدة في Edge

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

لا تتطلّب واجهة المستخدم الكلاسيكية، وهي واجهة المستخدم التلقائية التي ثبّتها مع Apigee Edge للسحابة الخاصة، موفِّر هوية خارجيًا. يمكن استخدام موفّر هوية أو المصادقة الأساسية. وهذا يعني أنّه يمكنك إجراء أحد الإجراءَين التاليَين:

فعِّل إمكانية استخدام موفِّر هوية خارجي على Edge وعلى كلّ من واجهة المستخدم الكلاسيكية وواجهة مستخدم Edge.
في هذا السيناريو، يتم تسجيل جميع مستخدمي واجهة المستخدم الكلاسيكية وواجهة مستخدم Edge في موفّر الهوية. للحصول على معلومات حول إضافة مستخدمين جدد إلى موفّر خدمة تحديد الهوية، يُرجى الاطّلاع على تسجيل مستخدمي Edge الجدد.
فعِّل إمكانية استخدام موفّر هوية خارجي على Edge، ولكن أبقِ المصادقة الأساسية مفعَّلة. تستخدم واجهة مستخدم Edge موفِّر الهوية، بينما تستخدم واجهة المستخدم الكلاسيكية المصادقة الأساسية.
في هذا السيناريو، يسجّل جميع مستخدمي واجهة المستخدم الكلاسيكية الدخول باستخدام بيانات اعتماد المصادقة الأساسية، حيث يتم تخزين بيانات الاعتماد في قاعدة بيانات Edge SymasLDAP. يتم تسجيل مستخدمي Edge UI في موفِّر الهوية ويسجّلون الدخول باستخدام SAML أو LDAP.

ومع ذلك، لا يمكن لمستخدم واجهة المستخدم الكلاسيكية تسجيل الدخول إلى واجهة مستخدم Edge إلى أن تتم إضافة هذا المستخدم إلى موفّر الهوية كما هو موضّح في تسجيل مستخدمي Edge الجدد.

تغييرات في إعدادات التثبيت مقارنةً بالإصدارات السابقة

يُرجى الانتباه إلى التغييرات التالية في إجراءات التثبيت من إصدارات Edge UI التجريبية.

تغييرات في إعدادات التثبيت من Edge 4.18.05

يتضمّن إصدار Edge 4.53.01 من واجهة مستخدم Edge التغييرات التالية على ملف الإعدادات مقارنةً بإصدار Edge 4.18.05:

نوع التغيير	المواقع المتأثرة
مُزال	MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS هذه السمة لها قيمة محدّدة مسبقًا تبلغ 0.5 (30 دقيقة) ولا يمكن تغييرها.
مضاف	يمكنك الآن استخدام الخصائص لتفعيل بروتوكول أمان طبقة النقل (TLS) على واجهة مستخدم Edge. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد بروتوكول أمان طبقة النقل (TLS) لواجهة مستخدم Edge.

تغييرات في إعدادات التثبيت من Edge 4.18.01

يتضمّن إصدار Edge 4.53.01 من واجهة مستخدم Edge التغييرات التالية على ملف الإعدادات مقارنةً بإصدار Edge 4.18.01:

نوع التغيير	المواقع المتأثرة
مضاف	# Shoehorn/Classic UI configurations. SHOEHORN_SCHEME SHOEHORN_IP SHOEHORN_PORT # Classic UI configurations. CLASSIC_UI_SCHEME CLASSIC_UI_IP CLASSIC_UI_PORT # Information about Edge SSO module. MANAGEMENT_UI_SKIP_VERIFY
مُزال	ROUTES_SHOEHORN ROUTES_CLASSICUI
تاريخ الاستبدال	MANAGEMENT_UI_USE_HTTPS تم استبداله بـ: MANAGEMENT_UI_SCHEME

نوع التغيير

المواقع المتأثرة

مضاف

# Shoehorn/Classic UI configurations.
SHOEHORN_SCHEME
SHOEHORN_IP
SHOEHORN_PORT

# Classic UI configurations.
CLASSIC_UI_SCHEME
CLASSIC_UI_IP
CLASSIC_UI_PORT

# Information about Edge SSO module.
MANAGEMENT_UI_SKIP_VERIFY

مُزال

ROUTES_SHOEHORN
ROUTES_CLASSICUI

تاريخ الاستبدال

MANAGEMENT_UI_USE_HTTPS

تم استبداله بـ:

MANAGEMENT_UI_SCHEME

ملف إعداد جديد لواجهة مستخدم Edge

يحتوي ملف الإعداد التالي على جميع المعلومات اللازمة لتثبيت واجهة مستخدم Edge الجديدة وضبطها. يمكنك استخدام ملف الإعداد نفسه لتثبيت واجهة shoehorn/Classic وواجهة Edge وضبط إعداداتهما.

# IP of the Edge Management Server.
# This node also hosts the Apigee SSO module and the current, or Classic, UI.
IP1=management_server_IP

# IP of the Edge UI node.
IP2=edge_UI_server_IP

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# Edge UI configuration.
#

# Enable the Edge UI.
EDGEUI_ENABLE_UNIFIED_UI=y
# Specify IP and port for the Edge UI.
# The management UI port must be open for requests to the Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
# Set to 'OPDK' to specify a Private Cloud deployment.
MANAGEMENT_UI_APP_ENV=OPDK
# Disable TLS on the Edge UI.
MANAGEMENT_UI_SCHEME=http

# Location of Edge UI.
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
MANAGEMENT_UI_SSO_REGISTERED_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
MANAGEMENT_UI_SSO_CSRF_SECRET=YOUR_CSRF_SECRET
# Duration of CSRF token.
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
# Defaults to 8760 hours, or 365 days.
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=8760

## SSO configuration for the Edge UI.
MANAGEMENT_UI_SSO_ENABLED=y

# Only required if MANAGEMENT_UI_SSO_ENABLED is 'y'
MANAGEMENT_UI_SSO_CLIENT_OVERWRITE=y

MANAGEMENT_UI_SSO_CLIENT_ID=newueclient
MANAGEMENT_UI_SSO_CLIENT_SECRET=your_client_sso_secret

#
# Shoehorn UI configuration
#
# Set to http even if you enable TLS on the Edge UI.
SHOEHORN_SCHEME=http
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000

#
# Edge Classic UI configuration.
# Some settings are for the Classic UI, but are still required to configure the Edge UI.
#

# These settings assume that Classic UI is installed on the Management Server.
CLASSIC_UI_IP=$MSIP
CLASSIC_UI_PORT=9000
CLASSIC_UI_SCHEME=http
EDGEUI_PUBLIC_URIS=$CLASSIC_UI_SCHEME://$CLASSIC_UI_IP:$CLASSIC_UI_PORT

# Information about publicly accessible URL for Classic UI.
EDGEUI_SSO_REGISTERED_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS

# Enable SSO
EDGEUI_SSO_ENABLED=y

# The name of the OAuth client used to connect to apigee-sso.
# The default client name is 'edgeui'.
# Apigee recommends that you use the same settings as you used
# when enabling your IDP on the Classic UI.
EDGEUI_SSO_CLIENT_NAME=edgeui
# Oauth client password using uppercase, lowercase, number, and special chars.
EDGEUI_SSO_CLIENT_SECRET=ssoClient123
# If set, existing EDGEUI client will deleted and new one will be created.
EDGEUI_SSO_CLIENT_OVERWRITE=y

# Apigee SSO Component configuration
# Externally accessible IP or DNS of Edge SSO module.
SSO_PUBLIC_URL_HOSTNAME=$IP1
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on the Apigee SSO module.
# If Apigee SSO uses a self-signed cert, you must also set MANAGEMENT_UI_SKIP_VERIFY to "y".
SSO_PUBLIC_URL_SCHEME=http
# MANAGEMENT_UI_SKIP_VERIFY=y
# SSO admin credentials as set when you installed Apigee SSO module.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=your_sso_admin_secret

#
##      SSO Configuration (define external IDP)           #
#
# Use one of the following configuration blocks to        #
# define your IDP settings:                               #
#  - SAML configuration properties                        #
#  - LDAP Direct Binding configuration properties         #
#  - LDAP Indirect Binding configuration properties       #

INSERT_IDP_CONFIG_BLOCK_HERE (SAML, LDAP direct, or LDAP indirect)

## SMTP Configuration (required)
#
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=your_email_password
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company myco@company.com"

تثبيت واجهة مستخدم Edge

بعد إنشاء ملف الإعداد وتعديله، يمكنك تثبيت واجهة مستخدم Edge الجديدة على العقدة الجديدة.

لتثبيت واجهة مستخدم Edge، اتّبِع الخطوات التالية:

أضِف عقدة جديدة إلى مجموعتك.
سجِّل الدخول إلى العقدة الجديدة بصفتك مشرفًا.
ثبِّت الإصدار 4.53.01 من الأداة apigee-setup على العُقدة، كما هو موضّح في تثبيت أداة Edge apigee-setup.
محو جميع المعلومات المخزّنة مؤقتًا باستخدام Yum من خلال تنفيذ الأمر التالي:
```
sudo yum clean all
```
أنشئ ملف الإعداد كما هو موضّح في ملف إعداد واجهة مستخدم Edge الجديد وتأكَّد من أنّ المستخدم "apigee" هو مالكه:
```
chown apigee:apigee configFile
```
تأكَّد من إجراء التعديلات التالية على ملف الإعداد:
- غيِّر قيمة السمة MANAGEMENT_UI_SSO_CSRF_SECRET في ملف الإعداد إلى سر CSRF.
  ملاحظة: لا تستخدِم القيمة التلقائية في مثال ملف الإعداد أعلاه لرمز CSRF السري. غيِّرها إلى قيمة فريدة لا يعرفها أحد غيرك.
- اضبط Edge لاستخدام أحد الخيارَين التاليَين (تتطلّب واجهة مستخدم Edge الجديدة موفِّر هوية خارجيًا):
  - SAML
  - LDAP
  لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة باستخدام موفّري خدمات الهوية الخارجيين.
اضبط موفِّر الهوية الخارجي باستخدام المستخدمين الذين تريد منحهم إذن الوصول إلى واجهة مستخدم Edge. لمزيد من المعلومات، يُرجى الاطّلاع على تسجيل مستخدمين جدد في Edge.
على العُقدة الجديدة، نفِّذ الأمر التالي:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
```
تثبِّت الأداة apigee-setup واجهة المستخدم الكلاسيكية. بالإضافة إلى واجهة المستخدم الكلاسيكية، يثبّت برنامج التثبيت واجهة مستخدم Edge.
سجِّل الدخول إلى واجهة مستخدم Edge من خلال فتح عنوان URL التالي في المتصفّح:
```
http://new_edge_UI_IP:3001
```
حيث new_edge_UI_IP هو عنوان IP للعقدة التي تستضيف واجهة مستخدم Edge الجديدة.

يطلب منك Edge إدخال بيانات اعتماد موفِّر الهوية الخارجي.
أدخِل بيانات الاعتماد.
تظهر واجهة مستخدم Edge الجديدة. للحصول على معلومات حول استخدام واجهة مستخدم Edge، راجِع واجهة مستخدم Edge الجديدة للسحابة الخاصة.

إذا لم تظهر واجهة مستخدم Edge، تأكَّد من أنّ المنفذ 3001 مفتوح للاتصالات الخارجية.

إلغاء تثبيت واجهة المستخدم الجديدة

لإلغاء تثبيت واجهة المستخدم الجديدة من عقدتها، عليك إلغاء تثبيت كل من واجهة مستخدم Edge الجديدة وواجهة المستخدم الكلاسيكية الأساسية (shoehorn) التي تم تثبيتها على العقدة أثناء عملية تثبيت واجهة المستخدم.

لإلغاء تثبيت واجهة مستخدم Edge الجديدة، اتّبِع الخطوات التالية:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall

لإلغاء تثبيت واجهة المستخدم الأساسية Classic UI (shoehorn)، اتّبِع الخطوات التالية:

/opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall

لإزالة جميع مكوّنات Edge من العُقدة:

أوقِف جميع خدمات Edge التي تعمل على الجهاز:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
محو ذاكرة التخزين المؤقت لـ yum:
```
sudo yum clean all
```
أزِل جميع حِزم RPM الخاصة بـ Apigee:
```
sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
```
أزِل دليل الجذر الخاص بالتثبيت:
```
sudo rm -rf /opt/apigee
```