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

# Benutzerdefinierte Rollen

## Überblick

**Benutzerdefinierte Rollen** ist eine optionale Funktion im RealmJoin Portal und ermöglicht das Erstellen zusätzlicher interner RealmJoin-Rollen. Sie können diesen Rollen granulare / atomare Berechtigungen zuweisen und sie Entra-Gruppen oder einzelnen 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 prüft Ihre Definition anhand des JSON-Schemas für benutzerdefinierte Rollen.

<figure><img src="/files/81241891346eaa79df6e5e5708a618b7ebd5ee99" alt=""><figcaption><p>JSON-Editor für benutzerdefinierte Rollen</p></figcaption></figure>

## Verwendung des Editors

### Syntaxprüfung / Fehler

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

<figure><img src="/files/a1f9a69ea61c648c532c23c0bcdc378cbf759513" 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** in der oberen rechten Ecke der Seite anklicken.

<figure><img src="/files/61dbbdcc87d89964357a672b63036958c560b74c" alt=""><figcaption><p>Schaltfläche „Formatieren“</p></figcaption></figure>

### Auto-Vervollständigung

Der Editor kann bekannte Schlüsselwörter (wie Berechtigungen) aus dem Schema automatisch vervollständigen.

<figure><img src="/files/c81dcd2b1d07c7e54679e7e98f0d6f0e79cbb736" alt=""><figcaption><p>Schlüsselwort-Auto-Vervollständigung</p></figcaption></figure>

Sie können jederzeit „Strg“ + „Leertaste“ drücken, um die Auto-Vervollständigung aufzurufen.

## Regeln

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

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

Beispiel für einen Regelsatz:

```json
{
  "Regeln": [
    {
      "Name": "Standard: Supporter können den primären Benutzer ändern [27e589a7]",
      "Beschreibung": "Standardregel, die Mitgliedern einer Supporter-Gruppe erlaubt, den primären Benutzer von RealmJoin-verbundenen Geräten zu ändern. Bitte behalten Sie die ID bei, die in ihrem Namen enthalten ist.",
      "Gruppen": [
        "f31f5765-f56f-47fa-9248-ac2d77221634",
        "422e6b7c-bd99-4082-be1c-88cbc2bb2734"
      ],
      "Berechtigungen": [
        "CanChangeRealmJoinPrimaryUser"
      ]
    },{
      "Name": "Erlaube John, neue Self-Service-Formulare hinzuzufügen",
      "Benutzer": [
        "b31f5765-f56f-47fa-9248-ac2d77221622"
      ],
      "Berechtigungen": [
        "CanAddSelfServiceForms"
      ]
    }
  ]
}
```

### Name und Beschreibung

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

Beides sind reine 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](/de/verwaltung-and-einstellungen/permission/custom-roles/available-permissions.md) für eine Liste und Beschreibung häufiger Berechtigungen.

### Gruppen

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

### Benutzer

Eine Liste (Array) von Entra-Benutzerobjekt-IDs. Wenn angegeben [Berechtigungen](#permissions) werden sie 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 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/de/verwaltung-and-einstellungen/permission/custom-roles.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.