API BaaS で SAML を有効にする

Edge for Private Cloud v4.18.01

Edge で SAML を有効にすると、API BaaS で SAML を有効にできます。API BaaS で SAML をサポートするには、Edge Management Server ノードに 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 ポータルと Stack の両方で 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

SAML サポートを有効にするように API BaaS を構成するには:

  1. 次のコマンドを実行して、BaaS Portal で 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 Portal を構成します。
    > /opt/apigee/apigee-service/bin/apigee-service baas-portal configure-sso -f configFile

    注: BaaS パスワードを設定したことがないユーザーは、ログインページで [Reset password] リンクを選択して、新しいパスワードを設定する必要があります。
  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