> 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)
* に従ってください。RealmJoin がこれらのグループと引き続きやり取りできるように、グループを AU のスコープに追加するには、 [このガイド](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 が管理単位を使用できるようにする

1. Entra で AU を作成します（既定、非制限）。
2. AU で、ロール "Group Administrator" を RealmJoin Portal アプリ（Application ID: "b0130885-16be-4c6f-83de-5b1042b5d2e3"）に永続的に割り当てます。
3. Microsoft Graph API の権限 `"AdministrativeUnit.Read.All"` （種類 "Application"）を RealmJoin Portal アプリ（Application ID: "b0130885-16be-4c6f-83de-5b1042b5d2e3"）に追加します。
4. 特にすでに RealmJoin Portal を使用している場合は、RealmJoin がやり取りできるようにする必要があるすべてのグループを AU のスコープに移動してください（例: 既存のアプリ グループや権限グループ）。
5. にチケットを作成し、 [RealmJoin サポート](https://www.realmjoin.com/help/) と、作成した AU の ObjectID を提供してください。
6. RealmJoin サポートからの確認をお待ちください。
7. これで、AU 対応ではないため、以下のアプリケーション権限を RealmJoin Portal アプリ（Application 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.
