העברה לממשק המשתמש של Edge

בקטע הזה מוסבר איך לעבור מהממשק הקלאסי לממשק Edge עם IDP כמו LDAP או SAML.

מידע נוסף זמין בדפים הבאים:

• אימות IDP באמצעות ממשק המשתמש של Edge
• אימות IDP בממשק המשתמש הקלאסי

מי יכול לבצע את ההעברה

כדי לעבור לממשק המשתמש של Edge, אתם צריכים להתחבר בתור המשתמש שהתקין את Edge במקור או בתור משתמש Root. אחרי שמריצים את תוכנית ההתקנה של ממשק המשתמש של Edge, כל משתמש יכול להגדיר אותם.

לפני שמתחילים

לפני שמעבירים את הארגון מהממשק הקלאסי לממשק Edge, כדאי לקרוא את ההנחיות הכלליות הבאות:

• גיבוי הצמתים הקיימים בממשק המשתמש הקלאסי

  לפני העדכון, מומלץ לגבות את השרת הקיים של ממשק המשתמש הקלאסי של Apigee.

• יציאות/חומות אש

  כברירת מחדל, ממשק המשתמש הקלאסי משתמש ביציאה 9000. ממשק המשתמש של Edge משתמש ביציאה 3001.

• מכונה וירטואלית חדשה

  אי אפשר להתקין את ממשק המשתמש של Edge באותה מכונה וירטואלית שבה מותקן ממשק המשתמש הקלאסי.

  כדי להתקין את ממשק המשתמש של Edge, צריך להוסיף מכונה חדשה להגדרות האישיות. אם אתם רוצים להשתמש באותו מחשב כמו ב-Classic UI, אתם צריכים להסיר את Classic UI לגמרי.

• ספק זהויות (LDAP או SAML)

  ממשק המשתמש של Edge מאמת משתמשים באמצעות IDP של SAML או LDAP:

  • ‫LDAP: ב-LDAP, אתם יכולים להשתמש ב-IDP חיצוני של LDAP או בהטמעה הפנימית של OpenLDAP שמותקנת עם Edge.
  • ‫SAML: ה-IDP של SAML חייב להיות IDP חיצוני.

  מידע נוסף זמין במאמר התקנה והגדרה של ספקי זהויות.

• אותו IDP

  ההנחה בקטע הזה היא שתשתמשו באותו IdP אחרי ההעברה. לדוגמה, אם אתם משתמשים כרגע ב-LDAP IDP חיצוני עם ממשק המשתמש הקלאסי, תמשיכו להשתמש ב-LDAP IDP חיצוני עם ממשק המשתמש של Edge.

העברה באמצעות IdP פנימי של LDAP

כשעוברים מהממשק הקלאסי לממשק של Edge בהגדרה שמשתמשת בהטמעה הפנימית של LDAP‏ (OpenLDAP) בתור IDP, צריך לפעול לפי ההנחיות הבאות:

• הגדרת קישור עקיף

  מתקינים את ממשק המשתמש של Edge באמצעות ההוראות האלה, עם השינוי הבא בקובץ התצורה השקט:

  מגדירים את LDAP לשימוש בחיפוש ובקישור (עקיף), כמו בדוגמה הבאה:

  SSO_LDAP_PROFILE=indirect
  SSO_LDAP_BASE_URL=ldap://localhost:10389
  SSO_LDAP_ADMIN_USER_DN=uid=admin,ou=users,ou=global,dc=apigee,dc=com
  SSO_LDAP_ADMIN_PWD=Secret123
  SSO_LDAP_SEARCH_BASE=dc=apigee,dc=com
  SSO_LDAP_SEARCH_FILTER=mail={0}
  SSO_LDAP_MAIL_ATTRIBUTE=mail

• אימות בסיסי ל-Management API

  האימות הבסיסי של ממשקי ה-API ממשיך לפעול כברירת מחדל לכל משתמשי ה-LDAP כשמופעל מודול SSO ב-Apigee. אפשר גם להשבית את האימות הבסיסי, כמו שמתואר במאמר השבתת האימות הבסיסי ב-Edge.

• אימות OAuth2 ל-Management API

  אימות מבוסס-אסימון מופעל כשמפעילים את ה-SSO.

• תהליך חדש של שם משתמש וסיסמה

  צריך ליצור משתמשים חדשים באמצעות ממשקי API כי תהליכי הסיסמאות לא יפעלו יותר בממשק המשתמש של Edge.

העברה באמצעות IdP חיצוני של LDAP

כשעוברים מהממשק הקלאסי לממשק Edge בהגדרה שמשתמשת בהטמעה חיצונית של LDAP כ-IDP, צריך לפעול לפי ההנחיות הבאות:

• הגדרות LDAP

  מתקינים את ממשק המשתמש של Edge לפי ההוראות האלה. אפשר להגדיר קישור ישיר או עקיף בקובץ התצורה השקט.

• הגדרת שרת הניהול

  אחרי שמפעילים את ה-SSO ב-Apigee, צריך להסיר את כל המאפיינים החיצוניים של LDAP שמוגדרים בקובץ /opt/apigee/customer/application/management-server.properties ולהפעיל מחדש את שרת הניהול.

• אימות בסיסי ל-Management API

  אימות בסיסי פועל למשתמשי מכונה אבל לא למשתמשי LDAP. השלבים האלה יהיו קריטיים אם תהליך ה-CI/CD שלכם עדיין משתמש באימות בסיסי כדי לגשת למערכת.

• אימות OAuth2 ל-Management API

  משתמשי LDAP יכולים לגשת ל-Management API רק באמצעות אסימונים.

העברה באמצעות IDP חיצוני של SAML

כשעוברים לממשק המשתמש של Edge, אין שינויים בהוראות ההתקנה של SAML IDP.