在 Edge 界面中启用 SAML

适用于私有云的 Edge v4.18.05

安装 Edge SSO 模块后,您必须将 Edge 界面配置为支持 SAML。Edge 界面通常安装在与 Edge 管理服务器相同的节点上,也就是说,它与 apigee-sso 位于同一节点上。

在 Edge 界面上启用 SAML 后,Edge 界面会使用 OAuth 连接到管理服务器。您无需担心 Edge 界面和 Edge 管理服务器之间的 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

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