シングル・サインオン (SSO)

GUI を使用する場合

GUI を使用して SSO を構成できます。

1. App ID ダッシュボードの**「Cloud Directory」>「シングル・サインオン」**タブに移動します。

2. **「シングル・サインオンを有効にする」を「使用可能」**に切り替えます。

3. ユーザーがアクティブ状態にない時間がどれだけ経過すれば SSO セッションの有効期限が切れるか、その時間を設定します。 セッションの有効期限が切れると、ユーザーはもう一度サインインしなければなりません。 この時間は分単位で指定し、非アクティブでいられる最大許容時間は 10,080 分 (7 日間) です。 デフォルトの時間は 1440 分で、これは 1 日に相当します。

4. 「ログアウト・リダイレクト URI (Logout redirect URI)」ボックスにリダイレクト URI を追加し、+ 記号をクリックします。 信頼できるアプリケーションだけを登録するよう、確認してください。 URI を登録することによって、App ID が許可ワークフローにこの URI を含めることを許可することになります。

5. 保存 をクリックします。

API を使用する場合

SSO 構成管理 API を使用して 3 つの設定を定義することによって、機能を有効にできます。

以下に呼び出し例を示します。

{
  "isActive": true,
  "inactivityTimeoutSeconds": 86400,
  "logoutRedirectUris": [
    "http://my-first-app.com/after_logout",
    "http://my-second-app.com/after_logout"
  ]
}

API を使用する場合

ユーザーをサインアウトさせるには、該当する情報を使用して以下の API 呼び出しを実行し、ユーザーのブラウザーをリダイレクトします。

https://<region>.appid.cloud.ibm.com/oauth/v4/<tenantID>/cloud_directory/sso/logout?redirect_uri=<redirectURI>&client_id=<clientID>

SSO セッションが終了しても、セッションに保管された有効なアクセス・トークンを持つユーザーは、そのトークンの期限が切れるまで資格情報の入力を求められない可能性があります。 デフォルトで、トークンは 1 時間後に有効期限が切れます。

Node.JS サーバー SDK を使用する場合

また、App ID Node.js サーバー SDK を使用して、リダイレクトの処理を自動的に行うこともできます。

1. logoutSSO をメソッドとして設定します。 以下に例を示します。

   let webAppStrategy = new WebAppStrategy(.....);
   ....
   webAppStrategy.logoutSSO();
   

2. ログアウトを構成します。

   app.get('/logoutSSO', (req, res) => {
      res.clearCookie("refreshToken");
      webAppStrategy.logoutSSO(req,res, { "redirect_uri": "https://my-app.com/after_logout" });
      });