> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zhan-kai/infrastructure/limiting-the-scope-of-realmjoin-portal.md).

# RealmJoin Portal の範囲を制限する

RealmJoin Portal はサポートしています [Microsoft Entra ID の管理単位 (AU)](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/administrative-units).

### 制限付き管理の管理単位

RealmJoin から一部の機密性の高いグループを隠す/保護するには、 **Microsoft Entra ID に制限付き管理の管理単位を作成できます**。その制限付き AU を作成した後は、 **機密性の高いグループ** をその AU に割り当て、これらのグループを RealmJoin Portal（および RealmJoin Portal を使用するすべての人）から「隠す」ことができます。\
これは次のような場合に適しています。 **特に機密性の高いグループ** 保護したいグループ、たとえば権限/ロールの付与に使用されるグループや、特定の Conditional Access ポリシーなどからユーザーを除外するためのグループです。\
ユーザーとアプリケーションは **明示的に付与/追加される必要があります** 制限付き管理 AU によって「保護」されているグループとやり取りできるようにするには、その AU のスコープに含める必要があります。

制限付き管理の管理単位を利用するには、 **RealmJoin 側で必要な設定はありません**.

* Microsoft Entra ID の制限付き管理の管理単位について詳しくは、こちらをご覧ください [ここ](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/admin-units-restricted-management).
* 制限付き AU を作成するには、Microsoft のガイドに従ってください [ここ](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/admin-units-manage?tabs=admin-center).
* 保護したいグループを制限付き AU に追加する方法や、これらのグループとやり取りすることを許可したい管理者を追加する方法については、このガイドをご覧ください [ここ](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/admin-units-members-add?tabs=admin-center).

### RealmJoin Portal に専用の管理単位を割り当てる

RealmJoin Portal を完全に「カプセル化」するには、専用の AU（既定では非制限）を作成し、RealmJoin Portal アプリをその AU に割り当てることができます。\
その結果、RealmJoin Portal はその特定の AU 内でのみグループを作成し、その AU のスコープに明示的に含まれるグループとのみやり取りできるようになります。

* AU を作成するには、 [Microsoft のガイドに従ってください](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/admin-units-manage?tabs=admin-center)
* AU のスコープにグループを追加して、RealmJoin が引き続きこれらのグループとやり取りできるようにするには、 [このガイドをご覧ください](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/admin-units-members-add?tabs=admin-center)
* 管理単位スコープでロールを割り当てるには、 [このガイドをご覧ください](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/manage-roles-portal?tabs=admin-center#assign-roles-with-administrative-unit-scope)

#### RealmJoin が Administrative Units を使用できるようにする

1. Entra ID で AU を作成します（既定、制限なし）。
2. AU では、ロール「Group Administrator」を RealmJoin Portal アプリ（アプリケーション ID: 「b0130885-16be-4c6f-83de-5b1042b5d2e3」）に永続的に割り当てます。
3. Microsoft Graph API のアクセス許可を追加します `"AdministrativeUnit.Read.All"` （種類「Application」）を RealmJoin Portal アプリ（アプリケーション ID: 「b0130885-16be-4c6f-83de-5b1042b5d2e3」）に追加します。
4. 特にすでに RealmJoin Portal を使用している場合は、RealmJoin がやり取りできるようにすべきすべてのグループ（既存のアプリ グループや権限グループなど）を AU のスコープに移動してください。
5. チケットを作成し、 [RealmJoin Support](https://www.realmjoin.com/help/) 作成した AU の ObjectID を提供してください。
6. RealmJoin サポートからの確認を待ちます。
7. これで、次のアプリケーション権限は AU を認識しないため、RealmJoin Portal アプリ（アプリケーション ID: 「b0130885-16be-4c6f-83de-5b1042b5d2e3」）から安全に削除できます。\
   \
   `"Group.ReadWrite.All"` & `"GroupMember.ReadWrite.All"`\
   \
   代わりに Entra ロール「Group Administrator」が使用されます。事前にそのロールを追加したことを確認してください（手順 2）。

{% hint style="info" %}
Microsoft Graph API のアクセス許可は Graph 経由でのみ追加/削除できることにご注意ください！

次の [RealmJoin Portal の機能ページにある](https://portal.realmjoin.com/organization/features) Grant スクリプトを使用して、以下の `"AdministrativeUnit.Read.All"` アクセス許可を追加します。

* スクリプトをコピーし、マークされた $permissions セクションにアクセス許可を追加し、スクリプトを実行し、Portal で実行を確認します。
* RealmJoin は新しいアクセス許可を自動的に確認し、付与済みセクションに表示します。
* 削除するには `"Group.ReadWrite.All"` & `"GroupMember.ReadWrite.All"` 各アクセス許可の横にある「Revoke」オプションを使用して、その特定のアクセス許可専用のスクリプトを生成できます。
  {% endhint %}

<figure><img src="/files/59a2877207a61fc4fa9ef5423b5f69e99012ea64" alt=""><figcaption></figcaption></figure>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/ja/zhan-kai/infrastructure/limiting-the-scope-of-realmjoin-portal.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
