> 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/de/bereitstellung/infrastructure/limiting-the-scope-of-realmjoin-portal.md).

# Eingrenzung des Umfangs des RealmJoin-Portals

Verwendung von administrativen Einheiten mit RealmJoin

RealmJoin Portal unterstützt [Microsoft Entra ID Administrative Units (AU)](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/administrative-units).

### Eingeschränkte Verwaltungs-Administrative Unit

Um einige sensible Gruppen vor RealmJoin zu verbergen/zu schützen, können Sie eine **eingeschränkte Verwaltungs-Administrative Unit in Microsoft Entra ID**. Nachdem Sie diese eingeschränkte AU erstellt haben, können Sie **sensible Gruppen** der AU zuweisen und diese Gruppen im RealmJoin Portal (und für alle, die das RealmJoin Portal verwenden) "verbergen".\
Dies ist eine gute Idee für **hochsensible Gruppen** die Sie schützen möchten, z. B. Gruppen, die zum Gewähren von Berechtigungen/Rollen verwendet werden, oder um Benutzer von bestimmten Conditional Access-Richtlinien usw. auszuschließen.\
Benutzer und Anwendungen **müssen explizit gewährt/hinzugefügt werden** zum Geltungsbereich der AU hinzugefügt werden, um mit Gruppen interagieren zu können, die durch die eingeschränkte Verwaltungs-AU "geschützt" sind.

Um eingeschränkte Verwaltungs-Administrative Units zu verwenden, gibt es **keine Einstellungen in RealmJoin erforderlich**.

* Weitere Informationen zu Restricted management administrative units in Microsoft Entra ID finden Sie [hier](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/admin-units-restricted-management).
* Um eine eingeschränkte AU zu erstellen, können Sie Microsofts Anleitung befolgen [hier](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/admin-units-manage?tabs=admin-center).
* Um Gruppen, die Sie schützen möchten, der eingeschränkten AU hinzuzufügen, sowie Administratoren, die mit diesen Gruppen interagieren dürfen sollen, beachten Sie bitte diese Anleitung [hier](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/admin-units-members-add?tabs=admin-center).

### Zuordnung einer dedizierten Administrative Unit zum RealmJoin Portal

Um RealmJoin Portal vollständig zu „kapseln“, können Sie eine dedizierte AU (standardmäßig nicht eingeschränkt) erstellen und die RealmJoin Portal-App dieser AU zuweisen.\
Dadurch erstellt RealmJoin Portal Gruppen nur in genau dieser AU – und kann auch nur mit Gruppen interagieren, die explizit im Geltungsbereich dieser AU liegen.

* Um eine AU zu erstellen, können Sie [Microsofts Anleitung](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/admin-units-manage?tabs=admin-center)
* Um Gruppen zum AU-Geltungsbereich hinzuzufügen, damit RealmJoin weiterhin mit diesen Gruppen interagieren kann, siehe bitte [diese Anleitung](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/admin-units-members-add?tabs=admin-center)
* Um Rollen mit Geltungsbereich der Administrative Unit zuzuweisen, siehe bitte [diese Anleitung](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 die Verwendung von Administrative Units ermöglichen

1. AU in Entra erstellen (Standard, nicht eingeschränkt).
2. Weisen Sie in der AU der RealmJoin Portal-App dauerhaft die Rolle „Group Administrator“ zu (Anwendungs-ID: „b0130885-16be-4c6f-83de-5b1042b5d2e3“).
3. Fügen Sie die Microsoft Graph-API-Berechtigung hinzu `"AdministrativeUnit.Read.All"` (Typ „Application“) zur RealmJoin Portal-App (Anwendungs-ID: „b0130885-16be-4c6f-83de-5b1042b5d2e3“).
4. Insbesondere wenn Sie das RealmJoin Portal bereits verwenden, verschieben Sie alle Gruppen, mit denen RealmJoin interagieren können soll, in den Geltungsbereich der AU (z. B. vorhandene App-Gruppen oder Berechtigungsgruppen).
5. Erstellen Sie ein Ticket mit dem [RealmJoin Support](https://www.realmjoin.com/help/) und geben Sie die Objekt-ID der von Ihnen erstellten AU an.
6. Warten Sie auf die Verifizierung durch den RealmJoin Support.
7. Nun können Sie die folgenden Anwendungsberechtigungen gefahrlos aus der RealmJoin Portal-App (Anwendungs-ID: „b0130885-16be-4c6f-83de-5b1042b5d2e3“) entfernen, da diese nicht AU-fähig sind:\
   \
   `"Group.ReadWrite.All"` & `"GroupMember.ReadWrite.All"`\
   \
   Stattdessen wird die Entra-Rolle „Group Administrator“ verwendet. Stellen Sie sicher, dass Sie die Rolle zuvor hinzugefügt haben (Schritt 2).

{% hint style="info" %}
Bitte beachten Sie, dass Sie die Microsoft Graph-API-Berechtigungen nur über Graph hinzufügen/entfernen können!

Sie können das Grant-Skript von der [RealmJoin Portal-Feature-Seite](https://portal.realmjoin.com/organization/features) unten gezeigt verwenden, um die `"AdministrativeUnit.Read.All"` Berechtigung hinzuzufügen.

* Kopieren Sie das Skript, fügen Sie die Berechtigung im markierten Abschnitt $permissions hinzu, führen Sie das Skript aus und bestätigen Sie die Ausführung im Portal.
* RealmJoin prüft die neue Berechtigung automatisch und zeigt sie im Abschnitt für gewährte Berechtigungen an.
* Zum Entfernen von `"Group.ReadWrite.All"` & `"GroupMember.ReadWrite.All"` können Sie die Option „Revoke“ neben den Berechtigungen verwenden, um ein Skript nur für diese spezielle Berechtigung zu generieren.
  {% endhint %}

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FchTHXBjBQhCOmcWhxvUi%2FUntitled%20picture.png?alt=media&amp;token=92c288d7-4d82-489d-9e81-13f68df6b67d" 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 by asking a question.

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

```
GET https://docs.realmjoin.com/de/bereitstellung/infrastructure/limiting-the-scope-of-realmjoin-portal.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.
