> 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/administration-and-einstellungen/permission/custom-roles.md).

# Benutzerdefinierte Rollen

Benutzerdefinierte Rollen von RealmJoin definieren granulare Berechtigungen als JSON und binden sich über den integrierten JSON-Editor an Entra-Gruppen oder Benutzer.

## Übersicht

**Benutzerdefinierte Rollen** ist eine optionale Funktion im RealmJoin Portal und ermöglicht das Erstellen zusätzlicher interner RealmJoin-Rollen. Diesen Rollen können Sie granulare / atomare Berechtigungen zuweisen und sie Entra-Gruppen oder dedizierten Benutzern zuordnen.

{% hint style="info" %}
Wenn benutzerdefinierte Rollen benötigt werden, bitte **die Aktivierung über den RealmJoin-Support anfordern**.
{% endhint %}

Benutzerdefinierte Rollen werden als JSON definiert. Der im RealmJoin Portal enthaltene JSON-Editor bietet Syntaxprüfung und Hervorhebung und überprüft Ihre Definition anhand des Custom Roles JSON-Schemas.

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FNifuPdTWlMiAniHWFyov%2Fimage.png?alt=media&amp;token=189d5359-6632-4d41-a9ca-14a886fce7c1" alt=""><figcaption><p>Custom Roles JSON-Editor</p></figcaption></figure>

## Verwendung des Editors

### Syntaxprüfung / Fehler

Der Editor überprüft die Syntax während der Eingabe. Wenn ein Syntaxfehler erkannt wird, erscheint eine Fehlermeldung **x Fehler anzeigen** und ein Fehler-Icon erscheint neben **Speichern.**

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F9KdtoXuHIptOvZot6fHy%2Fimage.png?alt=media&amp;token=6337d312-d237-48bf-a7fa-2e0ae3ffe67f" alt=""><figcaption><p>JSON-Fehlermeldung/-Schaltfläche</p></figcaption></figure>

Klicken Sie auf diese Meldung, um weitere Details zum Fehler zu erhalten.

### Formatierung

Sie können das JSON automatisch formatieren, indem Sie **Formatieren** oben rechts auf der Seite klicken.

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBcvly75klfY71hEA0oMj%2Fimage.png?alt=media&amp;token=009be309-82ff-4dac-828b-146c29def86e" alt=""><figcaption><p>Schaltfläche „Formatieren“</p></figcaption></figure>

### Auto-Vervollständigung

Der Editor kann bekannte Schlüsselwörter (wie Berechtigungen) aus dem Schema zur Auto-Vervollständigung anbieten.

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FwyhuLYTSuCJyhdK3K0lX%2Fimage.png?alt=media&amp;token=20ab28f4-6b98-4349-96fc-1586d609449a" alt=""><figcaption><p>Schlüsselwort-Auto-Vervollständigung</p></figcaption></figure>

Sie können jederzeit "Ctrl" + "Space" drücken, um die Auto-Vervollständigung aufzurufen.

## Regeln

Eine Rolle wird als Paar aus Berechtigungen und den Benutzern und/oder Gruppen beschrieben, denen diese Berechtigungen zugewiesen werden.

Rollen werden als Teil eines Arrays (Liste) unter dem Schlüsselwort aufgeführt **Regeln**.

Beispiel für einen Regelsatz:

```json
{
  "Rules": [
    {
      "Name": "Standard: Unterstützer können den primären Benutzer [27e589a7] ändern",
      "Description": "Standardregel, die Mitgliedern einer Unterstützergruppe erlaubt, den primären Benutzer von RealmJoin-verbundenen Geräten zu ändern. Bitte behalten Sie die ID bei, die im Namen enthalten ist.",
      "Groups": [
        "f31f5765-f56f-47fa-9248-ac2d77221634",
        "422e6b7c-bd99-4082-be1c-88cbc2bb2734"
      ],
      "Permissions": [
        "CanChangeRealmJoinPrimaryUser"
      ]
    },{
      "Name": "John das Hinzufügen neuer Self-Service-Formulare erlauben",
      "Users": [
        "b31f5765-f56f-47fa-9248-ac2d77221622"
      ],
      "Permissions": [
        "CanAddSelfServiceForms"
      ]
    }
  ]
}
```

### Name und Beschreibung

**Name** ist erforderlich, **Beschreibung** ist optional.

Beides sind einfache Textfelder (String).

### Berechtigungen

Eine Berechtigung ist eine eindeutige Zeichenfolge, die eine bestimmte Aktion im RealmJoin Portal identifiziert. **Berechtigungen** ist eine Liste (Array) von Berechtigungen.

Siehe [Verfügbare Berechtigungen](https://docs.realmjoin.com/de/administration-and-einstellungen/permission/custom-roles/available-permissions.md) für eine Liste und Beschreibung gängiger Berechtigungen.

### Gruppen

Eine Liste (Array) von Entra-Gruppenobjekt-IDs. Wenn angegeben [Berechtigungen](#permissions) werden allen Benutzern zugewiesen, die Mitglieder dieser Gruppen sind.

### Benutzer

Eine Liste (Array) von Entra-Benutzerobjekt-IDs. Wenn angegeben [Berechtigungen](#permissions) werden diesen Benutzern zugewiesen.


---

# 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/administration-and-einstellungen/permission/custom-roles.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.
