SAML¶
本文では、Guance ワークスペースで SAML 2.0 プロトコルに基づくシングルサインオン(SSO)を設定する方法について説明します。
事前準備¶
設定を始める前に、以下を準備してください。
| 準備項目 | 説明 |
|---|---|
| IdP 管理者権限 | エンタープライズ IdP(Azure AD、Okta、OneAuth、Keycloak など)で SAML アプリを作成する必要があります |
| メタデータ XML ファイル | IdP からエクスポートした SAML メタデータドキュメント。ログインURL、公開鍵証明書などの重要な情報が含まれます |
| 企業メールドメイン | SSO ユーザーを識別するためのメールサフィックス。例:example.com |
設定手順¶
ステップ 1:設定ページを開く¶
- 管理 > メンバー管理 > SSO 管理 > ユーザー SSO の順に進みます。
- SAML アクセスタイプを選択します。
- IdP を追加 をクリックします。
ステップ 2:基本情報を入力する¶
- IdP:ID 管理サービスを提供するプラットフォームで、ユーザーのアイデンティティと認証情報を管理します。ここで名前を定義します(❗️このカスタム表示名は、IdP エイリアスとしてログイン選択画面に表示されます。識別しやすい名前(例:
公司 Azure AD)を推奨します)。 - メタデータドキュメント:IdP が提供する XML 形式のメタデータファイルをアップロードします。システムがログインURLや公開鍵などの情報を自動的に解析します。
- 備考:カスタムの説明情報。この IdP に関する説明を記録するために使用します。
ステップ 3:フィールドマッピングを設定する¶
IdP が返すユーザー属性と Guance アカウント情報のマッピング関係を設定します。
| マッピングフィールド | 必須 | 説明 |
|---|---|---|
| ユーザー名 | 必須 | IdP が返すユーザー名属性名を入力し、ユーザー名を取得します |
| メール | 必須 | IdP が返すメール属性名を入力し、ユーザーのメールアドレスを取得します |
| 電話番号 | 任意 | IdP が返す電話番号属性名を入力し、アカウントに電話番号が未設定の場合に番号を補完します |
マッピング値には、実際の氏名、メールアドレス、電話番号ではなく、IdP が返す属性名を入力してください。IdP の実際の戻り値に基づいて設定してください。
電話番号の書き込みルール¶
SAML ログイン時、アカウントの電話番号は以下のルールで処理されます。
| アカウントの電話番号 | IdP の返却状況 | 処理方法 |
|---|---|---|
| 設定済み | 電話番号が返されるかどうかに関わらず | アカウントの既存番号を保持し、上書きもクリアもしません |
| 未設定 | 電話番号マッピングで番号を取得した場合 | IdP が返した番号をアカウントに書き込みます |
| 未設定 | 電話番号が返されない場合 | 電話番号は書き込まれず、ログインには影響しません |
SSO ユーザーは、アカウント設定で電話番号を設定または変更することもできます。アカウントに番号が保存された後、以降の SAML ログインではその番号は上書きもクリアもされません。
音声電話(IVR)通知は、アカウントに保存された電話番号を使用して発信します。IdP が電話番号を返さず、アカウントにも番号が設定されていない場合でも、ユーザーは通常どおりログインできますが、音声通知を受け取るには事前に電話番号を設定する必要があります。
ステップ 4:ログイン制御¶
- アクセス制限:企業メールドメイン(例:
example.com)を入力します。システムがログインメールのサフィックスが一致するかを検証します。初回ログインのメールアドレスで、ワークスペースメンバーアカウントを自動的に作成できます。 -
ロール付与:初回ログインの SSO ユーザーにデフォルトロール(管理者/標準メンバー/読み取り専用メンバー)を割り当てます。初回以外のログインユーザーには影響しません。
- ワークスペース内で SAML マッピング が有効になっている場合、システムはマッピングルールに従ってロールを優先的に割り当てます。ここで設定したデフォルトロールは、マッピングルールに一致しないユーザーにのみ適用されます。
-
セッション保持:SSO ログインセッションの無操作保持時間と最大保持時間を設定します。
セッション保持¶
SSO でログインする企業メンバーに、統一されたログイン保持時間を設定します。
| 設定項目 | 範囲 | デフォルト値 | 説明 |
|---|---|---|---|
| 無操作ログインセッション保持時間 | 180~1440 分 | 180 分 | ユーザーが無操作状態になってから自動的にログアウトされるまでの時間 |
| ログインセッション最大保持時間 | 0~7 日 | 7 日 | 操作の有無にかかわらず、この時間に達すると強制的にログアウトされます。0 はタイムアウトなしを意味します |
セッション保持時間を変更すると、既にログインしているメンバーには元の設定が保持され、新たにログインするメンバーには最新の設定が適用されます。
例
SSO ログイン保持時間を更新した場合:
- 既にログインしているメンバー:ログインセッションの有効期限は変更されません。
- 新たにログインするメンバー:最新のログイン保持時間の設定が適用されます。
例:
- SSO を初期設定したとき、無操作セッションの有効期限は 30 分でした。メンバー A がこの時点でログインした場合、その無操作セッションの有効期限は 30 分です。
- その後、管理者が無操作セッションの有効期限を 60 分に更新した場合でも、メンバー A の無操作セッションの有効期限は 30 分のままです。この後にログインしたメンバー B の無操作セッションの有効期限は 60 分になります。以降も同様です。
ステップ 5:SP 設定情報を取得する¶
IdP の追加が成功したら、編集ページをサービスプロバイダー詳細エリアまでスクロールし、Guance を SP(サービスプロバイダー)として設定するための情報を取得します。
| フィールド | 説明 |
|---|---|
| ログインURL | Guance SSO ログインエントリです。各 URL は 1 つのワークスペースにのみアクセスできます。形式:https://<auth-domain>/saml/login/sso_<id> |
| Metadata | Guance SP メタデータファイルです。ダウンロードして IdP にインポートできます |
| Entity ID | Guance SP の一意識別子です。IdP で設定する必要があります。通常は http://<auth-domain>/saml/metadata.xml |
| アサーションURL | IdP によるログイン成功後に Guance へ SAML アサーションを送信するアドレス(ACS URL)です。形式:https://<auth-domain>/saml/assertion/sso_<id> |
ステップ 6:IdP で SP 情報を設定する¶
ステップ 5 で取得した情報に基づいて、ご利用の IdP で以下の設定を行います。
- Entity ID:Guance が提供する Entity ID を入力します。
- ACS URL(アサーションURL):Guance が提供するアサーションURLを入力します。
- Name ID 形式:IdP がユーザーのメールアドレス(EmailAddress 形式)を返すように設定します。
- 署名証明書:Guance のメタデータ内の証明書をアップロードします(必要に応じて)。
よく使われる IdP の設定参考¶
ユーザーログインの検証¶
- SSO ログインページ を開き、完全な企業メールアドレスを入力します。
- そのアカウントに対応する IdP を選択し、企業認証ページの案内に従ってログインを完了します。
- 認証が成功したら、ワークスペース選択ページでアクセス権限のあるワークスペースに入ります。
既存の SSO アカウントの場合は、完全なメールアドレスに対応する SSO アイデンティティに基づいて IdP を特定します。SSO アイデンティティがまだ作成されていない場合は、アクセス制限に基づいてメールアドレスまたはドメインを照合します。詳細なルールはユーザーログインを参照してください。
注意事項¶
- ロールマッピングが有効な場合:ユーザーがロールマッピングルールに一致しない、またはロールマッピングが無効な場合、ログイン後に「アクセス権限がありません」と表示されます。
- IdP を削除すると、ユーザーが SSO でログインしても、削除された IdP に対応するワークスペースは表示されなくなります。
- 複数 IdP 設定:1 つのワークスペースで最大 10 個の IdP をサポートします。ユーザーはアカウントに基づいて利用可能な IdP が特定され、企業認証の完了後にワークスペースの権限に応じてアクセスします。
- アカウント連携:SSO への初回ログイン時に、メールアドレスが既存の Guance アカウントと一致する場合、自動的に連携され、履歴データが保持されます。
関連情報¶
以下のコンテンツもご参照ください。

