> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-ja/shisuru-2/integrations/group-mapping.md).

# グループ マッピング

Dispel のグループメンバーシップを、ID プロバイダーのグループと同期します。OAuth（OIDC）または SAML を使って、Microsoft Entra ID または Okta のグループを Dispel のグループにマッピングします。

## 概要

Dispel は、ID プロバイダー（IdP）のグループと Dispel グループを直接マッピングできるため、グループメンバーシップの管理を効率化できます。グループをマッピングすると、IdP で行われた変更は次回のスケジュール済み同期時に Dispel に反映され、通常は数分以内に適用されます。たとえば、IdP グループへのユーザーの追加や削除は、対応する Dispel グループのメンバーシップに反映されます。ただし、例外については [同期の仕組み](#how-sync-works)で説明します。この連携により、直感的に利用でき、監査性も備えた単一の集中管理ソリューションを通じて、ユーザーとグループを管理できます。

グループマッピングの設定は、次の 2 つの手順で行います。

1. [ID プロバイダーを設定する](https://docs.dispel.com/documentation/documentation-ja/shisuru-2/integrations/group-mapping/configure-your-identity-provider.md) ことで、Dispel がグループメンバーシップを読み取れるようにします。
2. [グループをマッピング](https://docs.dispel.com/documentation/documentation-ja/shisuru-2/integrations/group-mapping/map-groups.md) Dashboard で Dispel グループを管理します。

{% hint style="info" %}
Active Directory には独自のグループマッピングがあり、連携の一環として設定されます。詳しくは、 [AD グループを Dispel グループにマッピングする](https://docs.dispel.com/pages/980b98d7222da0c6d12dcb694032f562e8c0a459#id-8.-map-a-d-groups-to-dispel-groups).
{% endhint %}

## 対応している ID プロバイダー

| サインインプロトコル  | ID プロバイダー          | グループの照合方法                              |
| ----------- | ------------------ | -------------------------------------- |
| OAuth（OIDC） | Microsoft Entra ID | グループ名で照合                               |
| OAuth（OIDC） | Okta               | グループ名で照合                               |
| SAML        | Microsoft Entra ID | 検索して選択した Entra ID グループ自体（オブジェクト ID）で照合 |

## 同期の仕組み

* **同期はスケジュールに従って実行されます。** Dispel は数分ごとに IdP を確認するため、変更は 1 回の同期サイクル以内に反映されます。
* **IdP グループにユーザーを追加すると、そのユーザーは Dispel グループにも追加されます。** ユーザーがすでに Dispel 組織に所属している場合は、次回の同期時に追加されます。所属していない場合は招待され、SSO で初めてサインインした時点でアクセス権が付与されます。
* **IdP グループからユーザーを削除すると、次回の同期時に Dispel グループからも削除されます**ただし、別のマッピング済み IdP グループにもそのユーザーが含まれている場合を除きます。同期が実行されるまでは、Dispel へのアクセス権は維持されます。
* **IdP を読み取れない場合、同期によってユーザーが削除されることはありません。** グループを読み取れない場合は、後続の同期が成功するまで、そのメンバーはそのまま残ります。
* **SAML では、グループが空の場合や削除された場合でも、ユーザーは削除されません。** 同期では、空の結果を読み取り失敗の可能性があるものとして扱うため、そのグループの同期済みメンバーはアクセス権を維持します。OIDC では、空のグループまたは削除されたグループの同期済みメンバーが削除されます。

{% hint style="warning" %}
**SAML でマッピングされたグループの最後のメンバーを削除しても、そのユーザーのアクセス権は取り消されません。** グループは空の状態で返されるため、同期ではメンバーをそのまま残します。アクセス権を取り消すには、ユーザーを Dispel グループから手動で削除するか、Dispel でグループのマッピングを解除します。マッピングを解除すると、そのグループから同期された全員が削除されます。
{% endhint %}

## OIDC と SAML の比較

どちらのプロトコルもスケジュールに従って同期しますが、設定方法とメンバー削除時の動作は異なります。同期の違いについては、 [グループをマッピングした後の動作](https://docs.dispel.com/documentation/documentation-ja/shisuru-2/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group) を参照してください。設定の違いを以下にまとめます。

|                            | OAuth（OIDC）                                           | SAML                                      |
| -------------------------- | ----------------------------------------------------- | ----------------------------------------- |
| **使用する認証情報**               | Entra ID：SSO で使用するものと同じアプリ登録。Okta：Okta API トークン       | グループ同期専用の別個の Entra ID アプリ登録               |
| **グループのマッピング**             | IdP グループ名を入力                                          | Entra ID グループを検索し、マッピングするグループを選択          |
| **有効化するユーザー**              | Dispel（要リクエスト）                                        | SAML 設定でユーザー自身が有効化                        |
| **手動で追加したメンバー**            | 許可されません。マッピング済みグループには、同期されたメンバーのみを含める必要があります          | 許可されます。同期ではそのメンバーに変更を加えません                |
| **マッピング済みグループを読み取れない場合**   | 誰も削除されません                                             | 誰も削除されません                                 |
| **マッピング済みグループが空として返された場合** | そのグループを通じて同期された全員が削除されます                              | 誰も削除されません                                 |
| **マッピング済みグループが削除された場合**    | そのグループを通じて同期された全員が削除されます                              | 誰も削除されません。グループが完全に削除された場合は、マッピングを削除してください |
| **マッピングしたグループの名前が変更された場合** | そのグループを通じて同期された全員が削除されます。新しい名前にマッピングを更新するまで、この状態が続きます | 対応は不要です。マッピングはグループに追従します                  |
| **招待を承諾する前にグループから退出した場合**  | 組織でユーザー同期も有効にしている場合に限り、Dispelによってそのユーザーの招待が取り消されます    | そのユーザーの招待が取り消されます                         |

各変更の影響について詳しくは、次をご覧ください。 [グループをマッピングした後の動作](https://docs.dispel.com/documentation/documentation-ja/shisuru-2/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group).

## メリット

1. **アクセス管理の一元化**
   * 管理者はIdPでユーザーロールを直接管理できるため、アプリケーションごとに権限を設定する必要がなくなります。
   * アプリケーションの権限はIdPグループに紐付けられ、一貫性のある効率的なワークフローを実現します。
2. **プロビジョニングの自動化**
   * IdPで変更を行うと、次回のスケジュール同期後にユーザーのアクセス権が更新されます。
   * グループ同期では、メンバーシップの変更がスケジュールに従って適用されます。ただし、 [プロトコル固有の同期ルール](https://docs.dispel.com/documentation/documentation-ja/shisuru-2/integrations/group-mapping/map-groups.md#what-happens-after-you-map-a-group)が適用されます。空になったSAMLグループや削除されたSAMLグループの同期済みメンバーは、自動的には削除されません。
3. **セキュリティの強化**
   * 一元化された制御により、設定ミスや古い権限によるリスクを最小限に抑えます。
   * 権限は定期的にIdPグループのメンバーシップと同期されるため、手動で確認しなくても古いアクセス権が整理されます。
4. **拡張性**
   * 権限はグループ単位で管理されるため、多数のユーザーに対して簡単に変更を適用できます。
   * グループへのユーザーの追加や削除により、複数のアプリケーションのアクセス権を一括更新できるため、成長する組織の管理が簡素化されます。
5. **ユーザーエクスペリエンスの向上**
   * ユーザーにはグループへの割り当てに基づいて権限が自動的に付与されるため、追加の設定は不要です。
   * 認証後は、適切なロールがすでに設定されたアプリケーションにシームレスにアクセスできます。
6. **コンプライアンス対応と監査への備え**
   * ロールとグループのマッピングにより、明確で一貫性のある監査証跡を確保できます。
   * IdPではグループメンバーシップの変更が記録されることが多く、コンプライアンス目的でアクセス権限を追跡・検証しやすくなります。

グループマッピングを導入することで、組織は拡張性、安全性、効率性に優れたアクセス管理を実現できます。また、コンプライアンス対応を簡素化し、ユーザーにシームレスな体験を提供できます。

## 次の手順

[ステップ1：グループマッピング用にIDプロバイダーを設定する](https://docs.dispel.com/documentation/documentation-ja/shisuru-2/integrations/group-mapping/configure-your-identity-provider.md)

[ステップ2：Dispel Dashboardでグループをマッピングする](https://docs.dispel.com/documentation/documentation-ja/shisuru-2/integrations/group-mapping/map-groups.md)

## 関連項目

* [IDプロバイダー](https://docs.dispel.com/documentation/documentation-ja/shisuru/identity-providers.md)
* [Microsoft Entra ID](https://docs.dispel.com/documentation/documentation-ja/shisuru/identity-providers/microsoft-entra-id.md)
* [Okta](https://docs.dispel.com/documentation/documentation-ja/shisuru/identity-providers/okta.md)
* [組織グループ](https://docs.dispel.com/documentation/documentation-ja/yztoakusesuwosuru/groups/organization-groups.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dispel.com/documentation/documentation-ja/shisuru-2/integrations/group-mapping.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
