为 API BaaS 启用 SAML

Edge for Private Cloud v4.18.01

为 Edge 启用 SAML 后，您可以为 API BaaS 启用 SAML。如需为 API BaaS 提供 SAML 支持，您必须已在 Edge 管理服务器节点上安装并配置 Edge SSO 模块。

为 API BaaS 启用 SAML 的一般流程如下：

  1. 按照 Edge 的 SAML 安装和配置中的说明在 Edge 上配置 SAML。
  2. 安装 API BaaS 并确保安装正常运行。这包括创建 BaaS 组织。请参阅 API BaaS 安装。
  3. 对于所有现有 BaaS 用户（包括 BaaS 系统管理员和 BaaS 组织管理员），请在 IDP 中创建相应的用户。IDP 中用户的电子邮件地址必须与用于创建 BaaS 用户的电子邮件地址相同。
  4. 在 API BaaS 上配置 SAML。

在 API BaaS 上配置 SAML

如需在 API BaaS 上配置 SAML，您必须先在 BaaS 门户上启用 SAML，然后在 BaaS 堆栈上启用 SAML。

您首先需要创建一个配置文件来配置 SAML：

# IP address of BaaS Portal
IP1=11.111.11.111

# IP address of apigee-sso node
IP2=22.222.22.222

# Information about apigee-sso.
# Externally accessible IP or DNS of apigee-sso.
SSO_PUBLIC_URL_HOSTNAME=$IP2
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 "baas". 
BAAS_SSO_CLIENT_NAME=baas

# If set, the existing BAAS client is deleted and new one is created.
# The default value is "n".
# Set to "y" when you reconfigure SAML and change the value of 
# any of the BAAS_* properties.
BAAS_SSO_CLIENT_OVERWRITE=y

# API BaaS Portal properties:
BAAS_SSO_ENABLED=y

# Comma separated list of URLs for the BAAS portal, 
# in the format:  http_or_https://IP_or_hostname_of_UI:9000. 
# You can have multiple URLs when you have multiple installations
# of the BAAS portal or you have multiple data centers.
BAAS_PUBLIC_URIS=http_or_https://IP_or_hostname_of_BAAS:9000
BAAS_SSO_REGISTERED_PUBLIC_URIS=$BAAS_PUBLIC_URIS

# API BaaS Stack properties
BAAS_SSO_ENABLED=y

如需配置 API BaaS 以启用 SAML 支持，请执行以下操作：

  1. 运行以下命令，在 BaaS 门户上配置 SAML：
    > /opt/apigee/apigee-service/bin/apigee-service baas-portal configure-sso -f samlConfigFile

    其中 samlConfigFile 是 SAML 配置文件。
  2. 运行以下命令以重启门户：
    > /opt/apigee/apigee-service/bin/apigee-service baas-portal restart
  3. 运行以下命令，在所有 BaaS Stack 节点上配置 SAML：
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure-sso -f samlConfigFile

如需稍后更改这些值，请更新配置文件并再次运行这些步骤。

在 API BaaS 上停用 SAML

如需在 API BaaS 上停用 SAML，请执行以下操作：

  1. 修改您用于配置 SAM 的配置文件，以设置：
    BAAS_SSO_ENABLED=n
  2. 配置 BaaS 门户：
    > /opt/apigee/apigee-service/bin/apigee-service baas-portal configure-sso -f configFile

    注意：从未设置过 BaaS 密码的用户必须在登录页面上选择重置密码链接，以设置新密码。
  3. 运行以下命令以重启门户：
    > /opt/apigee/apigee-service/bin/apigee-service baas-portal restart
  4. 配置 BaaS 堆栈：
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure-sso -f configFile