بدءًا من الإصدار 4.54.00 من OPDK، تم تحديث بنية الدخول المُوحَّد (SSO). تم الآن تضمين وسيط الهوية (Dex) مباشرةً في مكوّن apigee-openldap، ما يلغي الحاجة إلى تثبيت وحدة apigee-sso منفصلة قديمة.
لتفعيل خدمة Apigee SSO وضبطها، عليك تنفيذ ما يلي:
- إنشاء مستخدم آلة لواجهة مستخدم New Edge: أنشئ مستخدم آلة مطلوبًا لواجهة مستخدم New Edge لاستدعاء واجهات برمجة التطبيقات للإدارة.
- ضبط الخصائص في ملف الإعداد الشائع: أنشئ ملف إعداد واحدًا يحتوي على الخصائص المطلوبة لكلٍّ من خدمة OpenLDAP (الدخول المُوحَّد) وواجهة مستخدم New Edge.
- إنشاء قاعدة بيانات الدخول المُوحَّد في Postgres: أنشئ قاعدة بيانات للدخول المُوحَّد في مثيل Apigee PostgreSQL.
- تطبيق إعدادات الدخول المُوحَّد في OpenLDAP: طبِّق ملف الإعداد لبدء خدمة Apigee SSO المدمَجة على عقدة OpenLDAP.
- ضبط واجهة مستخدم New Edge: عدِّل خصائص واجهة مستخدم New Edge لاستخدام خدمة Apigee SSO الجديدة.
يتم وصف كل خطوة من هذه الخطوات في الأقسام التالية.
إنشاء مستخدم آلة لواجهة المستخدم
تتطلّب واجهة مستخدم New Edge مستخدم آلة لاستدعاء واجهات برمجة التطبيقات للإدارة
في الخلفية لإجراء عمليات معيّنة. يتم استخدام نص برمجي مثبَّت مسبقًا في عقدة
apigee-openldap لهذا الغرض.
يمكنك الاطّلاع على مزيد من المعلومات عن النص البرمجي ومستخدمي الآلة في مقالة استخدام النص البرمجي apigee-machine-user.
استخدِم الأمر التالي في عقدة apigee-openldap
لإنشاء مستخدم آلة لواجهة مستخدم New Edge، وتأكَّد
من استخدام بيانات الاعتماد نفسها تمامًا عند تحديد السمة
في ملف الإعداد في الخطوة اللاحقة.
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh add -u ui-machine-user@apigee.com -p Secret123
ضبط الخصائص في ملف الإعداد الشائع
قبل أن تتمكّن من تفعيل خدمة Apigee SSO وواجهة مستخدم New Edge، عليك تحديد ملف إعداد شائع (على سبيل المثال، /opt/silent.conf). يمكنك تغيير هذا المسار واسم الملف حسب ما هو مطلوب لبيئتك.
أضِف خصائص الإعداد الأساسية التالية إلى ملف /opt/silent.conf:
# ========================================== # SSO Enablement # ========================================== ENABLE_SSO=y # ========================================== # SSO Hostname/IP and Port config for Dex # ========================================== SSO_PUBLIC_URL_SCHEME=http SSO_PUBLIC_URL_HOSTNAME=localhost SSO_PUBLIC_URL_PORT=9099 # ========================================== # Static Client UI credentials # ========================================== MANAGEMENT_UI_SSO_CLIENT_ID=unifiedui MANAGEMENT_UI_SSO_CLIENT_SECRET=secret123 # ========================================== # Management UI & SSO redirect URLs # ========================================== MANAGEMENT_UI_SCHEME=http MANAGEMENT_UI_IP=localhost MANAGEMENT_UI_PORT=3001 # ========================================== # Management Server parameters (Required for SSO registration) # ========================================== MSIP=localhost ADMIN_EMAIL=admin@apigee.com APIGEE_ADMINPW=Secret123 # ========================================== # Machine user for UI # ========================================== UI_MACHINE_USER=ui-machine-user@apigee.com UI_MACHINE_PWD=Secret123 # ========================================== # Postgres connection parameters # ========================================== PG_HOST=postgres_host PG_USER=apigee PG_PWD=postgres_password # ========================================== # Other UI Parameters # ========================================== # Set to sso to enable SSO, default value is basic. AUTH_MODE=sso # Y to use internal LDAP for authentication, N to use external IDP SSO_LOCAL_LDAP=y MANAGEMENT_UI_APP_ENV=OPDK MANAGEMENT_UI_SSO_ENABLED=y MANAGEMENT_UI_SSO_CSRF_SECRET=secret MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24 MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24 MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5
توزيع خصائص الدخول المُوحَّد
يتم توزيع خصائص Apigee SSO على ملفات الإعداد التالية:
-
/opt/silent.conf(أو ملف الإعداد المخصّص): يحتوي على خصائص الإعداد الأساسية للدخول المُوحَّد وواجهة مستخدم New Edge. -
/opt/apigee/customer/application/openldap.properties: يحتوي على خصائص إعداد إضافية للدخول المُوحَّد لميزات اختيارية، مثل SAML وHTTPS.
يحلّل النص البرمجي setup-sso في مكوّن apigee-openldap المتغيّرات من كلا الملفَين أعلاه. اعتمادًا على حالة الاستخدام، عليك ضبط الخصائص ذات الصلة في ملفات الإعداد.
الخطوات التالية اختيارية حسب بيئتك:
إنشاء قاعدة بيانات الدخول المُوحَّد في Postgres
على العقدة التي يتم تشغيل apigee-postgresql عليها (العقدة الرئيسية في الإعداد الأساسي والاحتياطي)، أنشئ قاعدة بيانات للدخول المُوحَّد:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-sso-db
تطبيق إعدادات الدخول المُوحَّد في OpenLDAP
بما أنّ خدمة Apigee SSO مضمّنة في مكوّن الدليل، ليس عليك تثبيت حزمة مستقلة. ما عليك سوى تطبيق ملف الإعداد على عقدة OpenLDAP.
لتفعيل خدمة Apigee SSO وبدءها:- سجِّل الدخول إلى العقدة التي تستضيف
apigee-openldap. - نفِّذ الأمر
setup-ssoمع تمرير ملف الإعداد:/opt/apigee/apigee-service/bin/apigee-service apigee-openldap setup-sso -f /opt/silent.conf
ضبط واجهة مستخدم New Edge
بعد تشغيل خدمة Apigee SSO، عليك ضبط واجهة مستخدم New Edge للتواصل معها.
بعد تفعيل موفِّر هوية خارجي على واجهة مستخدم New Edge، تستخدِم واجهة مستخدم New Edge بروتوكولَي OIDC/OAuth2 للاتصال بخادم الإدارة. ليس عليك القلق بشأن انتهاء صلاحية الرموز المميّزة بين واجهة مستخدم New Edge وخادم إدارة Edge. تتم إعادة تحميل الرموز المميّزة منتهية الصلاحية تلقائيًا.
- سجِّل الدخول إلى العقدة التي تستضيف واجهة مستخدم New Edge.
- تأكَّد من توفُّر ملف
/opt/silent.confعلى هذه العقدة. - طبِّق الإعداد باستخدام النص البرمجي
setup:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f /opt/silent.conf