# Benutzerdefinierte Rollen

## Übersicht

**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 bestimmten Benutzern zuordnen.

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

Benutzerdefinierte Rollen sind als JSON definiert. Der im RealmJoin Portal enthaltene JSON-Editor bietet Syntaxprüfung und Hervorhebung und prüft Ihre Definition gegen das JSON-Schema 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 Sie tippen. Wenn ein Syntaxfehler erkannt wird, erscheint eine Fehlermeldung **x Fehler anzeigen** und ein 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 klicken.

<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 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 Regelensatz:

```json
{
  "Rules": [
    {
      "Name": "Standard: Unterstützer können den primären Benutzer ändern [27e589a7]",
      "Description": "Standardregel, die Mitgliedern einer Unterstützergruppe erlaubt, den primären Benutzer von mit RealmJoin verbundenen Geräten zu ändern. Bitte behalten Sie die ID bei, die in ihrem Namen enthalten ist.",
      "Groups": [
        "f31f5765-f56f-47fa-9248-ac2d77221634",
        "422e6b7c-bd99-4082-be1c-88cbc2bb2734"
      ],
      "Permissions": [
        "CanChangeRealmJoinPrimaryUser"
      ]
    },{
      "Name": "John erlauben, neue Self-Service-Formulare hinzuzufügen",
      "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 ein eindeutiger String, der eine bestimmte Aktion im RealmJoin Portal identifiziert. **Berechtigungen** ist eine Liste (Array) von Berechtigungen.

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

### Gruppen

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

### Benutzer

Eine Liste (Array) von Entra-Benutzerobjekt-IDs. Zugewiesen [Berechtigungen](#permissions) wird diesen Benutzern zugewiesen.


---

# Agent Instructions: 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:

```
GET https://docs.realmjoin.com/de/realmjoin-einstellungen/permission/custom-roles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.