تثبيت خدمة الدخول المُوحَّد (SSO) على Edge

الإصدار 4.17.09 من Edge for Private Cloud

يمكنك تثبيت نُسخ متعددة من Edge SSO لضمان التوفّر العالي في سيناريوهَين:

  • في بيئة مركز بيانات واحد، يمكنك تثبيت مثيلَين من Edge SSO لإنشاء بيئة عالية التوفّر، ما يعني أنّ النظام سيستمر في العمل في حال توقُّف إحدى وحدات Edge SSO.
  • في بيئة تتضمّن مركزَي بيانات، ثبِّت Edge SSO في كلا المركزَين لكي يستمر النظام في العمل في حال تعطُّل إحدى وحدات Edge SSO.

تثبيت وحدتَي Edge SSO في مركز البيانات نفسه

يمكنك نشر مثيلَين من Edge SSO على عُقد مختلفة في مركز بيانات واحد لإتاحة التوفّر العالي. في هذا السيناريو:

  • يجب ربط كلا مثيلَي Edge SSO بخادم Postgres نفسه. تنصح Apigee باستخدام خادم Postgres مخصّص لخدمة Edge SSO وعدم استخدام خادم Postgres نفسه الذي ثبّته مع Edge.
  • تحتاج إلى جهاز موازنة الحمل أمام مثيلَي Edge SSO:
    • يجب أن يتيح جهاز موازنة الحمل ثبات ملفات تعريف الارتباط التي ينشئها التطبيق، ويجب أن يكون اسم ملف تعريف الارتباط للجلسة JSESSIONID.
    • اضبط جهاز موازنة الحمل لإجراء فحص حالة TCP أو HTTP على Edge SSO. بالنسبة إلى بروتوكول TCP، استخدِم عنوان URL الخاص بخدمة الدخول المُوحَّد (SSO) في Edge:

      http_or_https://edge_sso_IP_DNS:9099

      حدِّد المنفذ كما تم ضبطه في خدمة الدخول المُوحَّد (SSO) في Edge. المنفذ 9099 هو المنفذ التلقائي.

      بالنسبة إلى HTTP، أدرِج /healthz:

      http_or_https://edge_sso_IP_DNS:9099/healthz
    • تعتمد بعض إعدادات جهاز موازنة الحمل على ما إذا كنت قد فعّلت HTTPS على Edge SSO. يُرجى الاطّلاع على الأقسام التالية لمزيد من المعلومات.

استخدام وصول HTTP إلى Edge SSO

إذا كنت تستخدم وصول HTTP إلى Edge SSO، اضبط جهاز موازنة الحمل على:

  • استخدام وضع HTTP للاتصال بخدمة الدخول المُوحَّد (SSO) في Edge
  • الاستماع على المنفذ نفسه الذي يستخدمه Edge SSO

    يستمع Edge SSO تلقائيًا لطلبات HTTP على المنفذ 9099. يمكنك اختياريًا استخدام SSO_TOMCAT_PORT لضبط منفذ الدخول المُوحَّد (SSO) في Edge. إذا استخدمت SSO_TOMCAT_PORT لتغيير منفذ الدخول الموحّد في Edge من المنفذ التلقائي، تأكَّد من أنّ جهاز موازنة الحمل يستمع إلى هذا المنفذ.

على سبيل المثال، في كل مثيل من مثيلات Edge SSO، يمكنك ضبط المنفذ على 9033 عن طريق إضافة ما يلي إلى ملف الإعداد:

SSO_TOMCAT_PORT=9033

بعد ذلك، يمكنك ضبط جهاز موازنة الحمل للاستماع على المنفذ 9033 وإعادة توجيه الطلبات إلى جهاز Edge SSO على المنفذ 9033. عنوان URL العلني لخدمة Edge SSO في هذا السيناريو هو:

http://LB_DNS_NAME:9033

استخدام الوصول عبر HTTPS إلى Edge SSO

يمكنك ضبط مثيلات Edge SSO لاستخدام HTTPS. في هذا السيناريو، اتّبِع الخطوات الواردة في ضبط apigee-sso للوصول إلى HTTPS. كجزء من عملية تفعيل HTTPS، يمكنك ضبط SSO_TOMCAT_PROFILE في ملف إعداد Edge SSO كما هو موضّح أدناه:

SSO_TOMCAT_PROFILE=SSL_TERMINATION 

يمكنك أيضًا ضبط المنفذ الذي تستخدمه Edge SSO للوصول إلى HTTPS:

SSO_TOMCAT_PORT=9443

إذا كنت تستخدم وصول HTTPS إلى Edge SSO، اضبط جهاز موازنة الحمل على:

  • استخدام وضع TCP، وليس وضع HTTP، للاتصال بـ Edge SSO
  • الاستماع على المنفذ نفسه الذي يستخدمه Edge SSO كما هو محدّد في SSO_TOMCAT_PORT

بعد ذلك، يمكنك ضبط جهاز موازنة الحمل لإعادة توجيه الطلبات إلى جهاز Edge SSO على المنفذ 9433. عنوان URL العلني لخدمة Edge SSO في هذا السيناريو هو:

https://LB_DNS_NAME:9443

تثبيت Edge SSO في مراكز بيانات متعددة

في بيئة مراكز بيانات متعددة، يمكنك تثبيت نسخة Edge SSO في كل مركز بيانات. بعد ذلك، يعالج مثيل واحد من Edge SSO جميع الزيارات. في حال توقُّف مثيل Edge SSO، يمكنك التبديل إلى مثيل Edge SSO الثاني.

قبل تثبيت Edge SSO في مركزَي بيانات، يجب توفُّر ما يلي:

  • عنوان IP أو اسم النطاق لخادم Postgres الرئيسي

    في بيئة مراكز البيانات المتعددة، يتم عادةً تثبيت خادم Postgres واحد في كل مركز بيانات وضبطهما في وضع النسخ المتماثل "الرئيسي-الاحتياطي". في هذا المثال، يحتوي مركز البيانات 1 على خادم Postgres الرئيسي ويحتوي مركز البيانات 2 على الخادم الاحتياطي. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد النسخ المتماثل الرئيسي/الاحتياطي لـ Postgres.
  • إدخال واحد في نظام أسماء النطاقات يشير إلى مثيل واحد للدخول المُوحَّد في Edge على سبيل المثال، يمكنك إنشاء إدخال نظام أسماء النطاقات في النموذج أدناه يشير إلى مثيل الدخول المُوحَّد (SSO) في Edge في مركز البيانات 1:

    my-sso.domain.com => apigee-sso-dc1-ip-or-lb

عند تثبيت Edge SSO في كل مركز بيانات، يمكنك ضبط كليهما لاستخدام Postgres Master في مركز البيانات 1:

## Postgres configuration.
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
 PG_PORT=5432

يمكنك أيضًا ضبط كليهما لاستخدام إدخال نظام أسماء النطاقات كعنوان URL متاح للجميع:

# Externally accessible URL of Edge SSO.
SSO_PUBLIC_URL_HOSTNAME=my-sso.domain.com
# Default port is 9099.
SSO_PUBLIC_URL_PORT=9099

إذا توقّف Edge SSO في مركز البيانات 1، يمكنك التبديل إلى مثيل Edge SSO في مركز البيانات 2:

  • حوِّل خادم Postgres الاحتياطي في مركز البيانات 2 إلى خادم رئيسي كما هو موضّح في التعامل مع تجاوز الفشل في قاعدة بيانات PostgreSQL.
  • عدِّل سجلّ نظام أسماء النطاقات لتوجيه my-sso.domain.com إلى مثيل Edge SSO في مركز البيانات 2:
    my-sso.domain.com => apigee-sso-dc2-ip-or-lb
  • عدِّل ملف الإعداد لخدمة الدخول المُوحَّد (SSO) في Edge في مركز البيانات 2 ليشير إلى خادم Postgres الرئيسي الجديد في مركز البيانات 2:
    ## Postgres configuration.
    PG_HOST=IP_or_DNS_of_PG_Master_in_DC2
  • أعِد تشغيل Edge SSO في مركز البيانات 2 لتعديل إعداداته:
    /opt/apigee/apigee-service/bin/apigee-service apigee-sso restart