ロールマッピング¶

ロールマッピングは SSO の高度な機能であり、ID プロバイダー（IdP）から返されるユーザー属性に基づいて、動的に Guance のロール権限を割り当てます。有効化すると、従業員が初めて SSO ログインした際に、自動的にマッチするロールが付与されるため、手動での割り当ては不要になります。

有効化の効果¶

• 有効：ユーザーがログインするたびに、IdP から返される属性フィールドに基づいてロールを動的にマッチングします。どのルールにもマッチしないユーザーはすべてのロールが剥奪され、ログインできなくなります。

• 無効：ユーザーは初回ログイン時に割り当てられたデフォルトロールを保持し、その後の IdP 属性の変更は Guance の権限に影響しません。

マッピングの追加¶

1. 管理 > メンバー管理 > SSO 管理 > ロールマッピング に移動します。
2. マッピングを追加 をクリックして、新しいマッピング関係を作成します。
3. 現在のワークスペースで設定済みの SAML または OIDC の ID プロバイダーを選択します。
4. 属性フィールド を定義します：IdP が返すユーザー属性名で、IdP の実際の設定と完全に一致する必要があります（大文字小文字を区別）。
5. 属性値 を定義します：その属性の期待値で、複数の値はカンマで区切ります。
6. ロールを選択します：マッチングに成功した場合に付与する Guance ロール（管理者/標準メンバー/読み取り専用メンバー/カスタムロール）。
7. 保存します。

設定例¶

部署ごとにロールを割り当てる場合：

IdP が返すユーザー属性が次のとおりだとします。

{
  "department": "技術部",
  "groups": ["devops", "admin"]
}

Guance で設定します。

マッピングルールの管理¶

以下の操作でマッピングルールを管理できます。

検索とフィルター¶

• 検索：ロール、属性フィールド、属性値のキーワードで検索できます。
• フィルター：ID プロバイダーでフィルターし、特定の IdP のルールを素早く特定できます。

ルールの編集¶

ルール右側の編集ボタンをクリックすると、属性フィールド、属性値、またはロールを変更できます。

ルールを変更した後、既にログインしているユーザーは次回ログイン時に再検証されます。変更後にユーザーがどのルールにもマッチしなくなった場合、すべてのロールが剥奪され、ログインできなくなります。

ルールの削除¶

単一削除または一括削除に対応しています。

ルールを削除すると、元々そのルールにマッチしていたユーザーは次回ログイン時にロールがマッチせず、すべてのロールが剥奪されてログインできなくなります。影響を受けるユーザー範囲を事前に確認するか、代替ルールを設定してから削除することをお勧めします。

関連情報¶

以下もあわせてご参照ください。