نصب Edge SSO برای دردسترس بودن بالا

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 باید از جفت کلید JWT یکسانی استفاده کنند که توسط ویژگی‌های SSO_JWT_SIGNING_KEY_FILEPATH و SSO_JWT_VERIFICATION_KEY_FILEPATH در فایل پیکربندی مشخص شده است. برای اطلاعات بیشتر درباره تنظیم این ویژگی‌ها، به نصب و پیکربندی Edge SSO مراجعه کنید.
• به یک متعادل‌کننده بار در جلوی دو نمونه Edge SSO نیاز دارید:
  • متعادل‌کننده بار باید از چسبندگی کوکی تولیدشده توسط برنامه پشتیبانی کند و نام کوکی جلسه باید JSESSIONID باشد.
  • ترازکننده بار را پیکربندی کنید تا بررسی سلامت TCP یا HTTP را در Edge SSO انجام دهد. برای TCP، از نشانی وب Edge SSO استفاده کنید:

    http_or_https://edge_sso_IP_DNS:9099

    درگاه را همان‌طور که Edge SSO تنظیم کرده است مشخص کنید. درگاه ۹۰۹۹ پیش‌فرض است.

    برای HTTP، /healthz را اضافه کنید:

    http_or_https://edge_sso_IP_DNS:9099/healthz

  • برخی‌از تنظیمات متعادل‌کننده بار به این بستگی دارد که آیا HTTPS را در Edge SSO فعال کرده‌اید یا نه. برای اطلاعات بیشتر، بخش‌های زیر را ببینید.

دسترسی HTTP به Edge SSO

اگر از دسترسی HTTP به Edge SSO استفاده می‌کنید، ترازکننده بار را برای موارد زیر پیکربندی کنید:

• برای اتصال به Edge SSO، از حالت HTTP استفاده کنید.

• در همان درگاهی که Edge SSO گوش می‌دهد، گوش دهد.

  به‌طور پیش‌فرض، Edge SSO به درخواست‌های HTTP در درگاه ۹۰۹۹ گوش می‌دهد. به‌صورت اختیاری می‌توانید از SSO_TOMCAT_PORT برای تنظیم درگاه Edge SSO استفاده کنید. اگر از SSO_TOMCAT_PORT برای تغییر درگاه Edge SSO از پیش‌فرض استفاده کردید، مطمئن شوید که متعادل‌کننده بار روی آن درگاه گوش می‌دهد.

برای مثال، در هر نمونه Edge SSO، با افزودن کد زیر به فایل پیکربندی، درگاه را روی ۹۰۳۳ تنظیم می‌کنید:

SSO_TOMCAT_PORT=9033

سپس ترازکننده بار را پیکربندی می‌کنید تا به درگاه ۹۰۳۳ گوش دهد و درخواست‌ها را به یک نمونه Edge SSO در درگاه ۹۰۳۳ بازارسال کند. نشانی وب عمومی 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

سپس متعادل‌کننده بار را برای موارد زیر پیکربندی کنید:

• برای اتصال به Edge SSO، از حالت TCP استفاده کنید، نه حالت HTTP.
• به همان درگاهی که Edge SSO طبق تعریف SSO_TOMCAT_PORT گوش می‌دهد، گوش دهید.

سپس ترازکننده بار را پیکربندی می‌کنید تا درخواست‌ها را به نمونه Edge SSO در درگاه ۹۴۳۳ بازارسال کند. نشانی وب عمومی Edge SSO در این سناریو عبارت است از:

https://LB_DNS_NAME:9443

نصب Edge SSO در چندین مرکز داده

در محیطی با چند مرکز داده، یک نمونه Edge SSO را در هر مرکز داده نصب می‌کنید. سپس یک نمونه Edge SSO همه ترافیک را مدیریت می‌کند. اگر آن نمونه Edge SSO ازکار بیفتد، می‌توانید به نمونه Edge SSO دوم بروید.

قبل‌از نصب Edge SSO در دو مرکز داده، به موارد زیر نیاز دارید:

• نشانی IP یا نام دامنه سرور Master Postgres.

  در محیطی با چند مرکز داده، معمولاً یک سرور Postgres در هر مرکز داده نصب می‌کنید و آن‌ها را در حالت تکرار Master-Standby پیکربندی می‌کنید. برای این مثال، مرکز داده ۱ حاوی سرور Postgres اصلی است و مرکز داده ۲ حاوی آماده‌به‌کار است. برای اطلاعات بیشتر، راه‌اندازی تکرار اصلی-آماده‌به‌کار برای Postgres را ببینید.

• یک ورودی ساناد که به یک نمونه Edge SSO اشاره می‌کند. برای مثال، ورودی ساناد را در فرم زیر ایجاد می‌کنید که به نمونه Edge SSO در مرکز داده ۱ اشاره می‌کند:

  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 در مرکز داده ۱ پیکربندی می‌کنید:

## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
PG_PORT=5432

همچنین هر دو مرکز داده را پیکربندی می‌کنید تا از ورودی DNS به‌عنوان نشانی وب دردسترس عموم استفاده کنند:

# 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 در مرکز داده ۱ ازکار بیفتد، می‌توانید به نمونه Edge SSO در مرکز داده ۲ بروید:

1. سرور Postgres Standby را در مرکز داده ۲ به Master تبدیل کنید، همان‌طور که در مدیریت کردن خرابی پایگاه داده PostgreSQL شرح داده شده است.
2. گزارش ساناد را به‌روز کنید تا my-sso.domain.com به نمونه Edge SSO در مرکز داده ۲ اشاره کند:

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

3. فایل پیکربندی Edge SSO را در مرکز داده ۲ به‌روز کنید تا به سرور اصلی Postgres جدید در مرکز داده ۲ اشاره کند:

   ## Postgres configuration
   PG_HOST=IP_or_DNS_of_PG_Master_in_DC2

4. Edge SSO را در مرکز داده ۲ بازراه‌اندازی کنید تا پیکربندی آن به‌روز شود:

   /opt/apigee/apigee-service/bin/apigee-service apigee-sso restart