よくある質問¶
設定前の準備¶
会社で SAML と OIDC のどちらを使うべきか分からない場合、どう選択すればよいですか?
まず、お使いのアイデンティティプロバイダー(IdP)の種類を確認してください。
-
Azure AD、Okta、OneAuth、Keycloak などの標準的なエンタープライズ ID 管理製品の場合、通常両方に対応しています。SAML を優先的に選択することをお勧めします。設定がより簡単です(メタデータ XML をアップロードするだけです)。
-
自社構築システムや開発者プラットフォーム(Authing、Auth0 など)の場合、OIDC のみに対応している可能性があります。その場合は OIDC を選択してください。
-
不明な場合は、IT 管理者に問い合わせて、IdP が対応しているプロトコルの種類を確認してください。
IdP がアプリ作成の際に SP の Entity ID とコールバック URL を要求する一方、Guanceでは先に IdP メタデータのアップロードが必要です。どうすればよいですか?
一時的な URL を使用して先に設定します。
-
Entity ID:
https://auth.guance.com/saml/metadata.xml -
アサーション URL(ACS URL):
https://auth.guance.com/saml/assertion
IdP に上記の一時 URL を入力し、メタデータ XML をダウンロードしてからGuanceでアイデンティティプロバイダーを作成します。作成後、実際の Entity ID とアサーション URL を取得し、IdP に戻って置き換えます。
設定中¶
IdP メタデータをアップロードした後、Guanceで「解析失敗」または「形式エラー」と表示されます。
以下を確認してください。
-
ダウンロードしたファイルが SAML メタデータ XML であり、証明書ファイルや他の形式ではないことを確認します。
-
XML ファイルが完全かどうか確認します。IdP からダウンロードしたファイルがブラウザで途中までしか保存されないことがあるため、「名前を付けて保存」でダウンロードすることをお勧めします。
-
IdP で Entity ID と ACS URL が設定されていることを確認します。未設定のメタデータには重要なフィールドが欠けている可能性があります。
-
自己署名証明書を使用している場合は、証明書が期限切れでないことを確認します。
OIDC 設定で「アイデンティティプロバイダー URL」には何を入力すればよいですか?
IdP の Issuer URL(サービスディスカバリの URL)を入力します。一般的な形式は次のとおりです。
-
Keycloak:
https://keycloak.example.com/realms/<realm-name> -
Authing:
https://<app-id>.authing.cn/oidc -
Auth0:
https://<tenant>.auth0.com/ -
自社構築の OIDC:
https://auth.example.com
入力すると、Guanceは .well-known/openid-configuration エンドポイントを自動的に検出します。「設定を取得できません」と表示された場合は、URL が誤っているか、IdP でディスカバリサービスが有効になっていない可能性があります。その場合は、非標準の OIDC 設定に切り替えて、エンドポイントを手動で入力します。
OIDC のマッピング設定で「ユーザー名」フィールドには何を入力すればよいですか?
これは IdP が返すユーザー情報のフィールド名によって異なります。一般的な対応関係は次のとおりです。
| IdP の種類 | ユーザー名フィールド | メールフィールド | 携帯電話番号フィールド |
|---|---|---|---|
| Keycloak | preferred_username |
email |
phone_number |
| Authing | name または username |
email |
phone |
| Auth0 | name |
email |
phone_number |
| 自社構築システム | 実際のレスポンスに基づいて入力 | email |
実際のレスポンスに基づいて入力 |
不明な場合は、IdP でユーザー情報の取得をテストし、返された JSON のフィールド名を確認してください。
ロールマッピングを設定するとき、「属性フィールド」と「属性値」には何を入力すればよいですか?
これは、ユーザー認証時に IdP が返す属性によって異なります。次に例を示します。
シナリオ:部門ごとにロールを割り当てる
-
IdP が返すユーザー属性:
{"department": "技术部", "role": "admin"} -
Guanceでの設定:
-
属性フィールド:
department -
属性値:
技术部 -
割り当てるロール:スタンダードメンバー
-
シナリオ:ユーザーグループごとにロールを割り当てる
-
IdP が返すユーザー属性:
{"groups": ["admin", "developer"]} -
Guanceでの設定:
- 属性フィールド:
groups - 属性値:
admin(複数の値はカンマ区切りで指定できます。例:admin,developer) - 割り当てるロール:管理者
- 属性フィールド:
属性フィールド名は IdP が返すものと完全に一致している必要があります(大文字と小文字を区別します)。
ログインに関する問題¶
メールアドレスを入力しても、使用するアイデンティティプロバイダーが見つからない場合はどうすればよいですか?
管理者は以下の順序で確認してください。
- 入力したメールアドレスが完全な企業メールアドレスであることを確認し、そのメールアドレスに既存の SSO アイデンティティが属するアイデンティティプロバイダーを確認します。
- 対応するアイデンティティプロバイダーの設定が有効になっていること、所属するワークスペースが正常であることを確認します。
- SSO を初めて使用し、SSO アイデンティティがまだ作成されていない場合は、アクセス制限にそのメールアドレスまたはメールドメインが含まれているか確認します。
既存の SSO アカウントは、アカウントのアイデンティティに基づいてアイデンティティプロバイダーを検索します。具体的なルールはユーザーログインを参照してください。
IdP のログインページには正常に遷移できますが、ログイン後に Guanceへ戻ると「ユーザー情報を取得できません」と表示されます(OIDC)。どうすればよいですか?
以下を確認してください。
-
マッピングフィールドの誤り:「メール」マッピングフィールドが IdP が実際に返すフィールド名と一致しているか確認します(よくある誤りは、
mailを指定したのに IdP がemailを返すケースです)。 -
Scope の不足:認可リクエストの Scope に
emailが含まれていること、および IdP がメール情報の返却を許可していることを確認します。 -
ユーザー情報エンドポイントの誤り:非標準の OIDC の場合、設定ファイルの
userinfo_endpointが正しいか確認します。 -
Token 解析の失敗:IdP が使用する署名アルゴリズムが
HS256であることを確認します。Guanceは現在RS256をサポートしていません。
SAML ログインは成功しますが、ユーザーロールが正しくありません。
ロールマッピングの設定を確認します。
-
ロールマッピング機能が有効になっているか(トグルの状態)を確認します。
-
ユーザーの属性が IdP で正しく返されているか確認します(ブラウザの開発者ツールで SAML アサーションを確認するか、SAML デバッグツールを使用します)。
-
「属性フィールド」と「属性値」がアサーション内のものと完全に一致しているか確認します。
-
ユーザーが複数のルールに一致する場合は、想定どおりに最も高い権限のロールが割り当てられているか確認します。
SSO ログイン後、ユーザーに複数のワークスペースが表示されますが、切り替え時に「権限がありません」と表示されます。
これは次の理由によるものです。
-
ユーザーが IdP A を通じてワークスペース 1 にログインした。
-
ワークスペース 2 にも同じ IdP A が設定されているが、ロールマッピングのルールが異なる。
-
ユーザーがワークスペース 2 に切り替えると、Guanceがロールマッピングを再検証し、ユーザーがワークスペース 2 のルールに一致しないことが判明する。
この場合は、同じ IdP のロールマッピングルールをすべてのワークスペースで統一するか、ワークスペースをまたぐユーザー向けに共通のマッピングルール(統一されたユーザーグループ識別子など)を設定してください。
ユーザー管理¶
従業員が退職した場合、SSO 経由での Guanceへのログインを完全に禁止するにはどうすればよいですか?
2 か所で同時に削除する必要があります。
-
IdP 側:従業員のアカウントを削除または無効化し、企業認証を通過できないようにします。
-
Guance側:管理 > メンバー管理 > SSO 管理に移動し、SSO メンバー数をクリックして、該当ユーザーを見つけて削除します。
Guance側のみを削除した場合、従業員は SSO 経由でログインできてしまいます(アカウントが自動的に再作成されます)。IdP 側のみを削除した場合、従業員の Guance のログイン状態は、セッションが期限切れになるまで残る可能性があります。
SSO ユーザーは Guance に表示されるユーザー名を変更するにはどうすればよいですか?
SSO ユーザーのユーザー名は IdP が返すマッピングフィールドによって決まり、Guance側で直接変更することはできません。変更する場合:
-
IdP でユーザーの対応する属性(
preferred_usernameやnameなど)を変更します。 -
ユーザーが Guance に再ログインすると、同期して更新されます。
Guanceに異なる名称を表示する必要がある場合は、IdP 管理者に連絡して属性マッピングを調整するか、Guanceでロールマッピングを有効にする際に、表示名に影響しないフィールド(ユーザーグループなど)を使用して権限制御を行うことをお勧めします。
SSO ユーザーは自分で携帯電話番号を設定または変更できますか?
できます。アカウント設定 > ユーザー情報で携帯電話番号を設定または変更できます。IdP での操作は不要です。
アカウントに携帯電話番号がすでにある場合、その後の SAML ログインではその番号が保持されます。IdP が別の番号を返しても上書きされず、IdP が携帯電話番号を返さなくてもクリアされません。具体的なルールは携帯電話番号の書き込みルールを参照してください。
IdP が携帯電話番号を返さない場合、SAML ログインや音声通知に影響しますか?
SAML ログインには影響しません。SAML のフィールドマッピングでは、ユーザー名とメールは必須、携帯電話番号は任意です。
音声電話(IVR)通知は、アカウントに保存されている携帯電話番号を使用します。アカウントに番号がある場合は、その番号で通知を受信できます。アカウントに番号がない場合は、先にアカウント設定で携帯電話番号を追加する必要があります。
一部の従業員は SSO で、その他の従業員は通常のアカウントとパスワードでログインさせることはできますか?
できます。Guanceはハイブリッドログインモードをサポートしています。
-
SSO 管理で、SSO を利用する従業員向けに IdP とアクセス制限を設定します。
-
通常のアカウントを使用する従業員は、Guanceのアカウントとパスワード、または携帯電話番号の認証コードによる入口からログインします。
-
SSO を利用する従業員は、シングルサインオンのページで完全なメールアドレスを入力し、アカウントに対応する IdP を選択して企業認証を完了します。
アイデンティティプロバイダーのマッチング方法はユーザーログインを参照してください。
複数 IdP とワークスペース間¶
会社が別の会社を買収し、2 つの異なる Azure AD があります。両方を同じ Guance ワークスペースに設定できますか?
できます。Guanceの単一ワークスペースは最大 10 個の IdP をサポートしています。設定方法:
-
2 つの Azure AD をそれぞれ独立したアイデンティティプロバイダーとして追加します。
-
それぞれのメールドメイン(例:
@company-a.comと@company-b.com)を設定します。 -
2 つの IdP にそれぞれロールマッピングのルールを設定します(ルールは異なっていてもかまいません)。
ユーザーログイン時、Guanceは、完全なメールアドレスに対応する既存の SSO アイデンティティに基づいて IdP を優先的にマッチングします。SSO を初めて使用し、SSO アイデンティティがまだ作成されていない場合は、アクセス制限に基づいてメールアドレスまたはドメインでマッチングします。
「一度のログインで複数のワークスペースにアクセスできる」真のシングルサインオンを実現できますか?
できますが、次の条件を満たす必要があります。
-
複数のワークスペースに同じ IdP(または信頼された複数の IdP)が設定されていること。
-
ユーザーの IdP でのセッションが有効なままであること(期限切れでないこと)。
-
ユーザーが各ワークスペースで有効なロールを持っていること(ロールマッピングまたはデフォルトロールの割り当てによる)。
条件を満たすと、ユーザーは任意のワークスペースにログインし、セッションの有効期間中に上部のワークスペース切り替えから直接他のワークスペースへ移動できます。パスワードを再入力する必要はありません。
セキュリティとコンプライアンス¶
SSO ユーザーのログイン動作を監査するにはどうすればよいですか?
Guanceは以下の監査機能を提供しています。
-
SSO メンバーリスト:各 IdP 経由でログインしたメンバーの一覧と最終ログイン時刻を確認できます。
-
操作監査:管理 > 監査イベントでユーザーの操作記録(ログイン、ログアウト、重要な操作を含む)を確認できます。
-
通知メカニズム:SSO 設定が変更された場合、Owner と Administrator にメール通知が送信されます。