在 Edge 界面中启用 SAML

Edge for Private Cloud v4.19.01

安装 Edge SSO 模块后,您必须配置 Edge 界面以支持 SAML。Edge 界面通常安装在边缘管理服务器所在的节点上,这意味着它与 apigee-sso 位于同一节点上。

在边缘界面中启用 SAML 后,边缘界面会使用 OAuth 连接到管理服务器。您不必担心边缘界面和边缘管理服务器之间的 OAuth 令牌过期。系统会自动刷新过期的令牌。

您必须创建一个配置文件才能配置 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

以后如需更改这些值,请更新配置文件并再次运行该命令。