بدءًا من الإصدار 4.54.00 من Apigee Edge for Private Cloud، تمت إزالة واجهة المستخدم الكلاسيكية (edge-ui) وأصبحت واجهة New Edge UI (edge-management-ui) هي واجهة الإدارة التلقائية.
يقدّم هذا القسم إرشادات بشأن نقل البيانات من واجهة المستخدم الكلاسيكية إلى واجهة مستخدم Edge الجديدة، بما في ذلك عمليات النشر التي تستخدم IDP مثل LDAP أو SAML.
يمكنك الاطّلاع على ما يلي للحصول على مزيد من المعلومات:
المستخدمون الذين يمكنهم إجراء عملية النقل
لنقل البيانات إلى واجهة مستخدم Edge الجديدة، يجب أن تكون مُسجِّل الدخول كمستخدم ثبَّت Edge في الأصل أو كمستخدم جذر. بعد تشغيل أداة التثبيت لواجهة مستخدم Edge الجديدة، يمكن لأي مستخدم مصرَّح له ضبطها.
قبل البدء
قبل نقل البيانات من واجهة المستخدم الكلاسيكية إلى واجهة مستخدم Edge الجديدة، يُرجى قراءة الإرشادات العامة التالية:
- الاحتفاظ بنسخة احتياطية من إعدادات واجهة المستخدم الكلاسيكية الحالية
قبل الترقية إلى الإصدار 4.54.00، تنصح Apigee بالاحتفاظ بنسخة احتياطية من ملفات إعدادات واجهة المستخدم الكلاسيكية الحالية حتى تتمكّن من نقل الإعدادات المخصّصة (مثل SMTP وTLS ومهلة الجلسة وخصائص العلامة التجارية) إلى
/opt/apigee/customer/application/management-ui.properties. - المنافذ/جدران الحماية
كانت واجهة المستخدم الكلاسيكية تستخدم المنفذ 9000 تلقائيًا. تستخدم واجهة مستخدم Edge الجديدة المنفذ 3001 (يمكن ضبطه باستخدام
conf_uebe_port). - إزالة واجهة المستخدم الكلاسيكية
في حال تثبيت واجهة مستخدم Edge الجديدة على عقدة كانت تستضيف واجهة المستخدم الكلاسيكية في السابق، يجب إلغاء تثبيت واجهة المستخدم الكلاسيكية (
edge-ui) قبل تثبيت واجهة مستخدم Edge الجديدة (edge-management-ui). - المصادقة (المصادقة الأساسية أو LDAP أو SAML)
في الإصدار 4.54.00 من Edge for Private Cloud، تتيح واجهة مستخدم New Edge كلاً من المصادقة الأساسية (
AUTH_MODE=basic) ومصادقة موفِّر الهوية الخارجي من خلال الدخول المُوحَّد (SSO) في Apigee (AUTH_MODE=sso):- المصادقة الأساسية: تستخدم تنفيذ OpenLDAP الداخلي (
apigee-openldap) بدون الحاجة إلى الدخول المُوحَّد (SSO). - موفِّر الهوية في LDAP (باستخدام الدخول الموحّد في Apigee): يستخدم إما موفِّر هوية خارجي في LDAP أو تنفيذ OpenLDAP الداخلي (
apigee-openldap) مع الدخول الموحّد في Apigee. - موفِّر هوية SAML (باستخدام خدمة Apigee SSO): يستخدم موفِّر هوية SAML خارجيًا مع خدمة Apigee SSO.
لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت موفّري الهوية وضبطهم.
- المصادقة الأساسية: تستخدم تنفيذ OpenLDAP الداخلي (
- موفِّر الهوية نفسه
يفترض هذا القسم أنّك ستستخدم موفِّر الهوية نفسه بعد نقل البيانات. على سبيل المثال، إذا كنت تستخدم موفِّر هوية خارجيًا يستند إلى LDAP مع واجهة المستخدم الكلاسيكية، سيستمر استخدام موفِّر الهوية الخارجي نفسه مع واجهة مستخدم Edge الجديدة.
النقل باستخدام موفِّر هوية LDAP داخلي
إذا كنت تستخدم عملية التنفيذ الداخلية OpenLDAP (apigee-openldap)،
يمكنك إما استخدام المصادقة الأساسية مباشرةً في واجهة مستخدم New Edge (راجِع ضبط واجهة مستخدم New Edge)، أو
ضبط Apigee SSO باستخدام LDAP الداخلي باتّباع الإرشادات التالية:
- إعدادات LDAP وNew Edge UI
ثبِّت واضبط واجهة مستخدم New Edge وApigee SSO باستخدام ضبط واجهة مستخدم New Edge وتثبيت خدمة Apigee SSO وإعدادها وضبط موفِّر الهوية LDAP.
- المصادقة الأساسية لواجهة Management API
تستمر المصادقة الأساسية لواجهات برمجة التطبيقات في العمل تلقائيًا لجميع مستخدمي LDAP عند تفعيل الدخول الموحّد (SSO) في Apigee. يمكنك اختياريًا إيقاف المصادقة الأساسية، كما هو موضّح في إيقاف المصادقة الأساسية على Edge.
- مصادقة OAuth2 لواجهة Management API
يتم تفعيل المصادقة المستندة إلى الرموز المميزة عند تفعيل Apigee SSO.
النقل باستخدام موفِّر هوية LDAP خارجي
يُرجى اتّباع الإرشادات التالية عند نقل البيانات من واجهة المستخدم الكلاسيكية إلى واجهة New Edge في إعداد يستخدم تنفيذ LDAP خارجي كموفّر هوية (IDP):
- إعدادات LDAP
اضبط الدخول الموحّد (SSO) في Apigee وواجهة مستخدم Edge الجديدة باستخدام ضبط واجهة مستخدم Edge الجديدة، وتثبيت الدخول الموحّد (SSO) في Apigee وضبطه، وضبط موفِّر الهوية (IDP) في LDAP.
- إعدادات خادم الإدارة
بعد تفعيل Apigee SSO، أزِل أي خصائص قديمة خارجية لبروتوكول LDAP من واجهة المستخدم Classic UI من ملف
/opt/apigee/customer/application/management-server.propertiesوأعِد تشغيل "خادم الإدارة". - المصادقة الأساسية لواجهة Management API
تعمل المصادقة الأساسية لمستخدمي الأجهزة، ولكن ليس لمستخدمي LDAP الخارجيين. وهذا أمر بالغ الأهمية إذا كانت عملية CI/CD تستخدم المصادقة الأساسية للوصول إلى النظام.
- مصادقة OAuth2 لواجهة Management API
يصل مستخدمو LDAP الخارجيون إلى Management API باستخدام رموز OAuth2 المميزة.
نقل البيانات باستخدام موفِّر هوية خارجي مستند إلى SAML
عند نقل البيانات إلى واجهة مستخدم Edge الجديدة، لن يتم إجراء أي تغييرات على تعليمات التثبيت لموفِّر هوية SAML. يُرجى الاطّلاع على إعداد موفِّر الهوية عبر SAML.