הפעלת SAML בממשק המשתמש של Edge

Edge for Private Cloud גרסה 4.19.01

אחרי שמתקינים את מודול ה-SSO של Edge, צריך להגדיר שממשק המשתמש של Edge יתמוך ב-SAML. ממשק המשתמש של Edge מותקן בדרך כלל באותו צומת שבו נמצא שרת ניהול הקצה (Edge Management), כלומר צומת זהה ל-apigee-sso.

אחרי שמפעילים את SAML בממשק המשתמש של Edge, ממשק המשתמש של Edge משתמש ב-OAuth כדי להתחבר לניהול שרת. לא צריך לדאוג שתוקף אסימוני ה-OAuth יפוג בין ממשק המשתמש של Edge לבין ה-Edge שרת ניהול. אסימונים שפג תוקפם עוברים רענון באופן אוטומטי.

כדי להגדיר את ממשק המשתמש של Edge צריך ליצור קובץ תצורה:

IP1=hostname_or_IP_of_apigee_SSO

# Comma separated list of URLs for the Edge UI,
# in the format:  http_or_https://IP_or_hostname_of_UI:9000.
# You can have multiple URLs when you have multiple installations
# of the Edge UI or you have multiple data centers.
EDGEUI_PUBLIC_URIS=http_or_https://IP_or_hostname_of_UI:9000

# Publicly accessible URLs for Edge UI.
EDGEUI_SSO_REGISTERED_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS

# Required variables
# Default is "n" to disable SAML support.
EDGEUI_SSO_ENABLED=y

# Information about apigee-sso.
# Externally accessible IP or DNS of apigee-sso.
SSO_PUBLIC_URL_HOSTNAME=$IP1
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on apigee-sso.
SSO_PUBLIC_URL_SCHEME=http

# SSO admin credentials as set when you installed apigee-sso.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=Secret123

# The name of the OAuth client used to connect to apigee-sso.
# The default client name is edgeui.
EDGEUI_SSO_CLIENT_NAME=edgeui
# Oauth client password using uppercase, lowercase, number, and special chars.
EDGEUI_SSO_CLIENT_SECRET=ssoClient123

# If set, the existing EDGEUI client is deleted and new one is created.
# The default value is "n".
# Set to "y" when you configure SAML and change the value of
# any of the EDGEUI_* properties.
EDGEUI_SSO_CLIENT_OVERWRITE=y

כדי להגדיר את ממשק המשתמש של Edge ולהפעיל תמיכה ב-SAML:

  1. מריצים את הפקודה הבאה: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile

כדי לשנות את הערכים האלה מאוחר יותר, מעדכנים את קובץ התצורה ומריצים שוב את הפקודה.