התקנת SSO ל-Edge לקבלת זמינות גבוהה

Edge for Private Cloud v4.18.05

מתקינים כמה מופעים של 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:
    • מאזן העומסים חייב לתמוך ב-cookie stickiness שנוצר על ידי האפליקציה, וקובץ ה-Cookie של הסשן חייב להיות בשם 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. מידע נוסף מופיע בקטעים הבאים.

שימוש בגישת HTTP ל-Edge SSO

אם אתם משתמשים בגישת HTTP ל-Edge SSO, הגדירו את מאזן העומסים כך:

  • שימוש במצב HTTP כדי להתחבר ל-Edge SSO
  • האזנה באותה יציאה כמו Edge SSO

    כברירת מחדל, Edge SSO מאזין לבקשות HTTP ביציאה 9099. אפשר גם להשתמש ב-SSO_TOMCAT_PORT כדי להגדיר את יציאת ה-SSO של Edge. אם השתמשתם ב-SSO_TOMCAT_PORT כדי לשנות את יציאת ה-SSO של 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, הגדירו את מאזן העומסים כך:

  • כדי להתחבר ל-Edge SSO, צריך להשתמש במצב TCP ולא במצב HTTP
  • האזנה באותה יציאה כמו 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 אחד בכל מרכז נתונים ומגדירים אותם במצב שכפול Master-Standby. בדוגמה הזו, מרכז הנתונים 1 מכיל את שרת Postgres הראשי ומרכז הנתונים 2 מכיל את שרת Postgres לגיבוי. מידע נוסף זמין במאמר הגדרת שכפול Master-Standby ל-Postgres.

  • רשומת DNS אחת שמפנה למכונה אחת של Edge SSO. לדוגמה, יוצרים רשומת DNS בפורמט הבא שמפנה למכונה של Edge SSO במרכז הנתונים 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

אתם גם מגדירים את שניהם כך שישתמשו ברשומת ה-DNS ככתובת ה-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 במרכז הנתונים השני ל-Master, כמו שמתואר במאמר טיפול ביתירות כשל של מסד נתונים ב-PostgreSQL.
  2. מעדכנים את רשומת ה-DNS כך שתפנה את my-sso.domain.com למכונה של Edge SSO במרכז הנתונים השני:
    my-sso.domain.com => apigee-sso-dc2-ip-or-lb
  3. מעדכנים את קובץ התצורה של Edge SSO במרכז נתונים 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