برای دردسترس بودن بالا، Apigee SSO را نصب کنید

You install multiple instances of Apigee SSO for high availability in two scenarios:

  • در محیط مرکز داده تکی، دو نمونه «شناسایی یگانه Apigee» نصب کنید تا محیطی با دسترسی‌پذیری بالا ایجاد شود، یعنی اگر یکی از ماژول‌های «شناسایی یگانه Apigee» ازکار بیفتد، سیستم به کار خود ادامه دهد.
  • در محیطی با دو مرکز داده، Apigee SSO را در هر دو مرکز داده نصب کنید تا اگر یکی از ماژول‌های Apigee SSO از کار افتاد، سیستم همچنان به کار خود ادامه دهد.

نصب دو ماژول Apigee SSO در یک مرکز داده

دو نمونه از Apigee SSO را در گره‌های مختلف در یک مرکز داده واحد برای پشتیبانی از دسترسی بالا مستقر می‌کنید. در این سناریو:

  • هر دو نمونه Apigee SSO باید به یک سرور Postgres متصل باشند. Apigee توصیه می‌کند از سرور Postgres اختصاصی برای «شناسایی یگانه Apigee» استفاده کنید و از همان سرور Postgres که با Edge نصب کرده‌اید استفاده نکنید.
  • هر دو نمونه Apigee SSO باید از جفت کلید JWT یکسانی استفاده کنند که توسط ویژگی‌های SSO_JWT_SIGNING_KEY_FILEPATH و SSO_JWT_VERIFICATION_KEY_FILEPATH در فایل پیکربندی مشخص شده است. برای اطلاعات بیشتر درباره تنظیم این ویژگی‌ها، به نصب و پیکربندی Apigee SSO مراجعه کنید.
  • به متعادل‌کننده بار در جلوی دو نمونه از Apigee SSO نیاز دارید:
    • متعادل‌کننده بار باید از چسبندگی کوکی تولیدشده توسط برنامه پشتیبانی کند و نام کوکی جلسه باید JSESSIONID باشد.
    • ترازکننده بار را برای انجام بررسی سلامت TCP یا HTTP در «ورود به سیستم Apigee» پیکربندی کنید. برای TCP، از نشانی وب Apigee SSO استفاده کنید: 
      http_or_https://edge_sso_IP_DNS:9099

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

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

      http_or_https://edge_sso_IP_DNS:9099/healthz
    • برخی‌از تنظیمات متعادل‌کننده بار به این بستگی دارد که آیا HTTPS را در Apigee SSO فعال کرده‌اید یا نه. برای اطلاعات بیشتر، بخش‌های زیر را ببینید.

دسترسی HTTP به Apigee SSO

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

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

  • به همان درگاه Apigee SSO گوش دهید.

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

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

SSO_TOMCAT_PORT=9033

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

http://LB_DNS_NAME:9033

دسترسی HTTPS به Apigee SSO

می‌توانید نمونه‌های Apigee SSO را برای استفاده از HTTPS برای ارتباطات امن پیکربندی کنید. در این سناریو، مراحل موجود در پیکربندی Apigee SSO برای دسترسی HTTPS را دنبال کنید. به‌عنوان بخشی از فرایند فعال کردن HTTPS، مقدار SSO_TOMCAT_PROFILE را در فایل پیکربندی Apigee SSO به‌صورت زیر تنظیم کنید:

SSO_TOMCAT_PROFILE=SSL_TERMINATION

به‌صورت اختیاری، درگاهی را که Apigee SSO برای دسترسی HTTPS استفاده می‌کند تنظیم کنید:

SSO_TOMCAT_PORT=9443

برای اطمینان از ارتباط صحیح بین «متعادل‌کننده بار» و Apigee SSO، «متعادل‌کننده بار» را به‌صورت زیر پیکربندی کنید:

  • برای اتصال به Apigee SSO، از حالت TCP استفاده کنید، نه حالت HTTP. این کار به اتصالات SSL اجازه می‌دهد بدون خاتمه در «متعادل‌کننده بار» عبور کنند.
  • به همان درگاهی که Apigee SSO گوش می‌دهد، گوش دهید، همان‌طور که توسط SSO_TOMCAT_PORT تعریف شده است (مثلاً، ۹۴۴۳).
  • درخواست‌ها را به نمونه Apigee SSO در همان درگاه (۹۴۴۳) بازارسال کنید.

مطمئن شوید که نشانی وب عمومی تنظیمات ساناد و درگاه «متعادل‌کننده بار» را منعکس می‌کند. نشانی وب عمومی Apigee SSO در این سناریو عبارت است از:

https://LB_DNS_NAME:9443

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

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

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

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

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

  • یک ورودی ساناد که به یک نمونه Apigee SSO اشاره می‌کند. برای مثال، یک ورودی ساناد در فرم زیر ایجاد می‌کنید که به نمونه Apigee SSO در مرکز داده ۱ اشاره می‌کند: 
    my-sso.domain.com => apigee-sso-dc1-ip-or-lb
  • هر دو نمونه Apigee SSO باید از جفت کلید JWT یکسانی استفاده کنند که توسط ویژگی‌های SSO_JWT_SIGNING_KEY_FILEPATH و SSO_JWT_VERIFICATION_KEY_FILEPATH در فایل پیکربندی مشخص شده است. برای اطلاعات بیشتر درباره تنظیم این ویژگی‌ها، به نصب و پیکربندی Apigee SSO مراجعه کنید.

وقتی Apigee SSO را در هر مرکز داده نصب می‌کنید، هر دو را برای استفاده از Postgres Master در مرکز داده ۱ پیکربندی می‌کنید:

## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
PG_PORT=5432

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

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

اگر Apigee SSO در مرکز داده ۱ ازکار بیفتد، می‌توانید به نمونه Apigee SSO در مرکز داده ۲ بروید:

  1. سرور Postgres Standby را در مرکز داده ۲ به Master تبدیل کنید، همان‌طور که در مدیریت کردن خرابی پایگاه داده PostgreSQL شرح داده شده است.
  2. گزارش ساناد را به‌روز کنید تا my-sso.domain.com به نمونه Apigee SSO در مرکز داده ۲ اشاره کند: 
    my-sso.domain.com => apigee-sso-dc2-ip-or-lb
  3. فایل پیکربندی Apigee SSO را در مرکز داده ۲ به‌روز کنید تا به سرور اصلی Postgres جدید در مرکز داده ۲ اشاره کند: 
    ## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC2
  4. Apigee SSO را در مرکز داده ۲ بازراه‌اندازی کنید تا پیکربندی آن به‌روز شود: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-sso restart