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

Edge for Private Cloud الإصدار 4.19.01

يمكنك تثبيت نُسخ متعددة من 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 مفتاحَي تشفير JWT نفسهما كما هو محدّد في السمتَين SSO_JWT_SIGNING_KEY_FILEPATH وSSO_JWT_VERIFICATION_KEY_FILEPATH في ملف الإعداد. يُرجى الاطّلاع على تثبيت Edge SSO وضبطه لمزيد من المعلومات حول ضبط هذه السمات.
  • تحتاج إلى جهاز موازنة الحمل أمام مثيلَي Edge SSO:
    • يجب أن يتيح جهاز موازنة الحمل ثبات ملفات تعريف الارتباط التي ينشئها التطبيق، ويجب أن يكون اسم ملف تعريف الارتباط للجلسة JSESSIONID.
    • اضبط جهاز موازنة الحمل لإجراء فحص حالة TCP أو HTTP على Edge SSO. بالنسبة إلى TCP، استخدِم عنوان URL الخاص بـ Edge SSO: 
      http_or_https://edge_sso_IP_DNS:9099

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

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

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

الوصول إلى Edge SSO عبر HTTP

إذا كنت تستخدم وصول 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

الوصول إلى Edge SSO من خلال HTTPS

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

SSO_TOMCAT_PROFILE=SSL_TERMINATION

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

SSO_TOMCAT_PORT=9443

بعد ذلك، اضبط جهاز موازنة الحمل على:

  • استخدِم وضع 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 على سبيل المثال، يمكنك إنشاء إدخال DNS في النموذج أدناه يشير إلى مثيل الدخول المُوحَّد (SSO) في Edge في مركز البيانات 1: 
    my-sso.domain.com => apigee-sso-dc1-ip-or-lb
  • يجب أن تستخدم كلتا النسختَين من Edge SSO مفتاحَي تشفير JWT نفسهما كما هو محدّد في السمتَين SSO_JWT_SIGNING_KEY_FILEPATH وSSO_JWT_VERIFICATION_KEY_FILEPATH في ملف الإعداد. يُرجى الاطّلاع على تثبيت Edge SSO وضبطه لمزيد من المعلومات حول ضبط هذه السمات.

عند تثبيت 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:

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