تثبيت تطبيق Apigee الدخول المُوحَّد (SSO) للتعرُّف على مدى التوفُّر العالي

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

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

تثبيت وحدتَي الدخول المُوحَّد (SSO) في Apigee في مركز البيانات نفسه

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

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

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

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

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

الوصول عبر HTTP إلى الدخول المُوحَّد (SSO) في Apigee

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

  • استخدِم وضع HTTP للاتصال بخدمة الدخول المُوحَّد (SSO) في Apigee.

  • الاستماع على المنفذ نفسه الذي تستخدمه ميزة الدخول المُوحَّد (SSO) في Apigee

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

على سبيل المثال، في كل مثيل من مثيلات الدخول المُوحَّد (SSO) في Apigee، يمكنك ضبط المنفذ على 9033 من خلال إضافة ما يلي إلى ملف الإعداد:

SSO_TOMCAT_PORT=9033

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

http://LB_DNS_NAME:9033

الوصول عبر HTTPS إلى Apigee SSO

يمكنك ضبط مثيلات الدخول المُوحَّد (SSO) في Apigee لاستخدام HTTPS. في هذا السيناريو، اتّبِع الخطوات الواردة في مقالة ضبط الدخول المُوحَّد (SSO) في Apigee للوصول إلى HTTPS. في إطار عملية تفعيل HTTPS، يمكنك ضبط SSO_TOMCAT_PROFILE في ملف إعدادات الدخول الموحّد (SSO) في Apigee كما هو موضّح أدناه:

SSO_TOMCAT_PROFILE=SSL_TERMINATION

يمكنك أيضًا ضبط المنفذ الذي تستخدمه خدمة الدخول المُوحَّد (SSO) في Apigee للوصول إلى HTTPS:

SSO_TOMCAT_PORT=9443

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

  • استخدِم وضع TCP، وليس وضع HTTP، للاتصال بخدمة الدخول المُوحَّد (SSO) في Apigee.
  • الاستماع على المنفذ نفسه الذي يستخدمه الدخول الموحّد (SSO) في Apigee كما هو محدّد في SSO_TOMCAT_PORT

بعد ذلك، يمكنك ضبط جهاز موازنة الحمل لإعادة توجيه الطلبات إلى مثيل "الدخول الموحّد" في Apigee على المنفذ 9433. عنوان URL العلني لخدمة الدخول المُوحَّد (SSO) في Apigee في هذا السيناريو هو:

https://LB_DNS_NAME:9443

تثبيت الدخول المُوحَّد (SSO) في Apigee في مراكز بيانات متعددة

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

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

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

    في بيئة مراكز البيانات المتعددة، يتم عادةً تثبيت خادم Postgres واحد في كل مركز بيانات وضبطهما في وضع النسخ المتماثل "الرئيسي-الاحتياطي". في هذا المثال، يحتوي مركز البيانات 1 على خادم Postgres الرئيسي ويحتوي مركز البيانات 2 على خادم الاستعداد. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد النسخ المتماثل الرئيسي/الاحتياطي لـ Postgres.

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

عند تثبيت الدخول المُوحَّد (SSO) في Apigee في كل مركز بيانات، يمكنك ضبط كليهما لاستخدام Postgres Master في مركز البيانات 1:

## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
PG_PORT=5432

يمكنك أيضًا ضبط كلا مركزَي البيانات لاستخدام إدخال نظام أسماء النطاقات كعنوان URL يمكن الوصول إليه بشكل علني:

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

إذا تعطّلت خدمة الدخول الموحّد (SSO) في Apigee في مركز البيانات 1، يمكنك التبديل إلى مثيل الدخول الموحّد (SSO) في Apigee في مركز البيانات 2:

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