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

החל מגרסה 4.54.00 של Apigee Edge for Private Cloud, ממשק המשתמש הקלאסי (edge-ui) הוסר וממשק המשתמש החדש של Edge (edge-management-ui) הוא ממשק הניהול שמוגדר כברירת מחדל. בקטע הזה מוסבר איך לבצע מיגרציה מהממשק הקלאסי לממשק החדש של Edge, כולל פריסות שמשתמשות ב-IDP כמו LDAP או SAML.

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

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

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

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

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

  • גיבוי ההגדרה הקיימת של ממשק המשתמש הקלאסי

    לפני שמשדרגים לגרסה 4.54.00, מומלץ לגבות את קובצי ההגדרות הקיימים של ממשק המשתמש הקלאסי, כדי שתוכלו להעביר הגדרות בהתאמה אישית (כמו SMTP, ‏ TLS, זמן קצוב לתפוגה של סשן ומאפייני מיתוג) אל /opt/apigee/customer/application/management-ui.properties.

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

    כברירת מחדל, ממשק המשתמש הקלאסי השתמש ביציאה 9000. ממשק המשתמש החדש של Edge משתמש ביציאה 3001 (אפשר להגדיר את היציאה באמצעות conf_uebe_port).

  • הסרת ממשק המשתמש הקלאסי

    אם מתקינים את ממשק המשתמש החדש של Edge בצומת שאירח בעבר את ממשק המשתמש הקלאסי, צריך להסיר את ממשק המשתמש הקלאסי (edge-ui) לפני שמתקינים את ממשק המשתמש החדש של Edge (edge-management-ui).

  • אימות (אימות בסיסי, LDAP או SAML)

    ב-Edge for Private Cloud 4.54.00, ממשק המשתמש החדש של Edge תומך גם באימות בסיסי (AUTH_MODE=basic) וגם באימות IDP חיצוני באמצעות מודול SSO ב-Apigee‏ (AUTH_MODE=sso):

    • אימות בסיסי: משתמש בהטמעה הפנימית של OpenLDAP‏ (apigee-openldap) בלי לדרוש כניסה יחידה.
    • ‫LDAP IDP (באמצעות מודול SSO ב-Apigee): משתמש ב-LDAP IDP חיצוני או בהטמעה פנימית של OpenLDAP (apigee-openldap) עם מודול SSO ב-Apigee.
    • ספק זהויות (IdP) של SAML (באמצעות מודול SSO ב-Apigee): משתמש בספק זהויות חיצוני של SAML עם מודול SSO ב-Apigee.

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

  • אותו IDP

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

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

אם אתם משתמשים בהטמעה הפנימית של OpenLDAP ‏ (apigee-openldap), אתם יכולים להשתמש באימות בסיסי ישירות בממשק המשתמש של New Edge (ראו הגדרת ממשק המשתמש של New Edge), או להגדיר מודול SSO ב-Apigee עם LDAP פנימי באמצעות ההנחיות הבאות:

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

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

  • הגדרות LDAP

    מגדירים את מודול ה-SSO ב-Apigee ואת ממשק המשתמש החדש של Edge באמצעות הגדרת ממשק המשתמש החדש של Edge, התקנה והגדרה של מודול ה-SSO ב-Apigee והגדרת ה-IDP של LDAP.

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

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

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

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

  • אימות OAuth2 ל-Management API

    משתמשי LDAP חיצוניים ניגשים ל-Management API באמצעות טוקנים של OAuth2.

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

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