SSO 管理¶
Guance は SAML 2.0 および OIDC/OAuth 2.0 プロトコルに基づくシングルサインオン(SSO)をサポートしています。企業はローカルのアイデンティティプロバイダー(IdP)で従業員アカウントを一元管理でき、Guance と IdP の間でユーザー情報を同期する必要はありません。従業員は企業メールアドレスで Guance にログインし、事前に設定された権限に基づいてシステムにアクセスできます。
概念¶
| 用語 | 説明 |
|---|---|
| IdP(アイデンティティプロバイダー) | 企業内の統合認証システム。Azure AD、Okta、OneAuth、Keycloak、DingTalk、WeCom、自社構築 LDAP など |
| SP(サービスプロバイダー) | サービス受信側としての Guance プラットフォーム |
| ロールマッピング | IdP から返されるユーザー属性(部署、役職、ユーザーグループなど)に基づき、Guance のロール権限を自動的に割り当てます |
| Entity ID | SAML プロトコルにおいて、Guance が SP として使用する一意の識別子 |
| ACS URL | Assertion Consumer Service URL。SAML ログイン成功後、IdP が Guance にアサーションを送信するアドレス |
機能¶
-
IdP サポート:1 つのワークスペースにつき最大 10 個のアイデンティティプロバイダーを設定でき、企業内のさまざまな認証基盤に対応します。
-
ワークスペース間シングルサインオン:同じアイデンティティプロバイダーから認可を受けたユーザーは、ログイン状態の有効期間中に他の認可済みワークスペースへ移動でき、再認証は不要です。
-
動的権限:ロールマッピングにより、ユーザー属性に基づくきめ細かな権限制御を実現します。
-
アカウント自動連携:SSO 初回ログイン時に、メールアドレスが既存の Guance アカウントと一致する場合は自動的に連携され、履歴データが保持されます。
クイックスタート¶
設定の入り口¶
「管理 > メンバー管理 > SSO 管理 > ユーザー SSO」に移動します。
プロトコルタイプの選択¶
| プロトコル | ユースケース | 設定 |
|---|---|---|
| SAML 2.0 | Azure AD、ADFS、Okta、OneAuth、Keycloak などの標準 SAML サービスをすでに導入している企業 | SAML 設定ガイドを参照 |
| OIDC/OAuth 2.0 | 自社構築の認証システムまたはモダンなクラウド IdP を利用している企業 | OIDC 設定ガイドを参照 |
ユーザーログイン¶
アイデンティティプロバイダーを設定して有効化すると、従業員は企業メールアドレスを使用して SSO ログインページ からシングルサインオンを開始できます。
- 完全な企業メールアドレスを入力し、利用可能なアイデンティティプロバイダーを検索します。
- 使用するアイデンティティプロバイダーを選択し、企業認証ページに移動します。
- 企業認証ページの案内に従ってログインを完了します。
- 認証後のワークスペース選択ページで、アクセス権のあるワークスペースを選択します。
アイデンティティプロバイダーは以下のルールで照合されます。
- SSO アカウントを保有している場合:完全なメールアドレスに対応する SSO アイデンティティに基づき、そのアイデンティティに関連付けられた有効なアイデンティティプロバイダー設定が表示されます。同じメールドメインの異なる従業員は、それぞれのアイデンティティプロバイダーを使用できます。
- SSO を初めて利用する場合:アカウントに SSO アイデンティティがまだ作成されていない場合、アイデンティティプロバイダーのアクセス制限に基づいて、完全なメールアドレスまたはメールドメインで照合されます。
アイデンティティプロバイダーにバインドされているアカウントは、関連付けられた設定が無効化・削除された場合や、所属するワークスペースが無効になった場合は、管理者に連絡して設定を確認してください。ログイン後のワークスペースへのアクセスとロール権限は、引き続きそのワークスペースのメンバー認可とロールマッピングによって決定されます。
ロールマッピング¶
ユーザー属性に基づく動的な権限割り当てを実現します。
ロールマッピングの設定方法 を参照してください。
SSO 設定の管理¶
リスト操作¶
アイデンティティプロバイダーを追加すると、以下の操作で SSO 設定を管理できます。
| 操作 | 説明 | 注意事項 |
|---|---|---|
| 編集 | 設定情報や有効/無効状態を変更します | 既存の SSO メンバーのログイン体験に影響するため、非稼働時間に操作することを推奨します |
| 削除 | そのアイデンティティプロバイダーを削除します | 関連するメンバーはこの方法でログインできなくなるため、事前に通知し、他のログイン方法があることを確認してください |
| エクスポート | JSON ファイルとしてエクスポートします | ファイル名は現在のワークスペース内の他の IdP と重複しないようにしてください。他のワークスペースへのコピーに便利です |
| インポート | JSON ファイルからすばやく作成します | 形式仕様に準拠する必要があります。事前に 1 件エクスポートしてテンプレートとして使用することを推奨します |
SSO メンバーの表示¶
- メンバー数:SSO でログインしたすべてのメンバーの総数を表示します。
- メンバーリスト:メンバー数をクリックすると、認可済みの SSO メンバーの一覧を確認できます。
通知メカニズム¶
以下の操作を行うと、ワークスペースの Owner および Administrator にメール通知が送信されます。
- SSO 設定の追加/有効化
- 重要な設定の変更(ドメイン、ロールマッピングルール)
- SSO 設定の削除