> 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/automatisierung/runbooks/runbook-permissions.md).

# Runbook-Berechtigungen

Wie der Zugriff auf bestimmte Runbooks gewährt/verweigert wird.

{% embed url="<https://www.youtube.com/watch?v=bLi_k_Yzhyw>" %}

## Umfang

Hier geht es darum, wie der Zugriff auf bestimmte Runbooks in einem Azure Tenant gewährt/verweigert wird. Wenn Sie nach Antworten dazu suchen, welche MS Graph API-Berechtigungen benötigt werden, um eine bestimmte Aktion als Runbook auszuführen, werfen Sie bitte einen Blick auf unsere [Anforderungen](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation/azure-ad-roles-and-permissions.md).

## Übersicht

"Runbook Permissions" definieren die Sichtbarkeit von Runbooks für bestimmte Benutzer. Bestimmte Runbooks können auch global blockiert/ausgeblendet werden.

Wie bei der [Runbook Customizations](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-customization.md), das Festlegen dieser Berechtigungen erfolgt, indem als RealmJoin-Admin im Webportal von RealmJoin eine JSON-formatierte Konfiguration bereitgestellt wird unter <https://portal.realmjoin.com/settings/runbooks-permissions> .

### Über diesen Leitfaden

Wir geben eine kurze Beschreibung der Syntax und erstellen dann Schritt für Schritt ein vollständiges Beispiel. Sie können auch direkt zum vollständigen Beispiel gehen und dort beginnen [dort](#targetentitygroups).

## Konfigurationssyntax

### Runbook-Namen

Runbooks werden über ihre Namen referenziert, wie sie im Azure Automation Account angezeigt werden, z. B. `rjgit-group_general_remove-group`.

Platzhalter ('\*') können verwendet werden, um mehrere Runbooks abzugleichen. Mehrere Platzhalter können in demselben String verwendet werden, z. B. `rjgit-*_security_*`. Dies würde auf alle der folgenden Beispiele zutreffen:

* `rjgit-org_security_list-inactive-users`
* `rjgit-device_security_enable-or-disable-device`

Das Präfix `rjgit-` kennzeichnet Runbooks, die aus unserem öffentlichen GitHub-Repository importiert werden. Kundenspezifische Runbooks haben kein Präfix, z. B. `user_userinfo_custom-runbook`

### Entra ID Groups

Entra ID-Gruppen werden über ihre Objekt-ID referenziert, wie z. B. `91688d11-9a34-42cd-8d1e-ce617d6c1234`. Derzeit können nur Sicherheitsgruppen verwendet werden.

## JSON-Struktur und Beispiel

Wir erstellen Schritt für Schritt ein vollständiges Konfigurationsbeispiel.

Eine JSON-Konfiguration besteht aus mehreren Abschnitten, aber alle Abschnitte sind optional und können weggelassen werden.

Es ist erlaubt, Kommentare mit dem Präfix "//" hinzuzufügen.

### EnabledRunbookPatterns

Dieser Abschnitt enthält eine Liste von Runbooks, die verwendet werden dürfen. Wenn dieser Abschnitt weggelassen wird, sind standardmäßig alle Runbooks aktiviert/erlaubt.

Wenn Sie diesen Abschnitt definieren, sind nur die in diesem Abschnitt genannten Runbooks für jede Rolle / Support und Admin verwendbar.

#### Beispiel

* Nur bestimmte, einzelne Runbooks zulassen, indem Sie ihren vollständigen Namen angeben

  `rjgit-group_general_remove-group`
* Alle gerätebezogenen Runbooks aus unserem gemeinsamen Repository zulassen

  `rjgit-device_*`
* Alle gemeinsamen Benutzer-Runbooks zulassen

  `rjgit-user_*`
* Alle kundenspezifischen (lokalen), benutzerbezogenen Runbooks zulassen

  `user_*`

Dies schließt implizit viele gruppenbezogene und alle organisationsbasierten Runbooks aus. Bitte beachten Sie das.

```
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ]
}
```

### DisabledRunbookPatterns

Eine Liste von Runbooks, die global deaktiviert / verboten sind. Wenn dieser Abschnitt weggelassen oder leer ist, sind alle aktivierten Runbooks (angegeben über [EnabledRunbookPatterns](#enabledrunbookpatterns)) verwendbar.

Einträge in diesem Abschnitt haben Vorrang vor Einträgen in [EnabledRunbookPatterns ](#enabledrunbookpatterns)- die Runbooks werden für niemanden in diesem Tenant ausgeblendet/nicht verwendbar sein.

#### Beispiel

Wir verwenden den `EnabledRunbookPatterns` Abschnitt von zuvor erneut.

* Deaktivieren Sie alle gemeinsamen (`rjgit-`) Runbooks in der `Sicherheit` Kategorie.

```
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ],
  "DisabledRunbookPatterns": [
    "rjgit-*_security_*"
  ]
}
```

### Rollen

In diesem Abschnitt können Sie einer Entra ID-Gruppe eine Liste von Runbooks zuweisen. Dies ermöglicht es, mehrere Support-/Operatorrollen in Ihrem Tenant zu definieren.

Wenn dieser Abschnitt weggelassen wird, haben alle RealmJoin-Supportmitarbeiter und Administratoren Zugriff auf alle in den vorherigen Abschnitten angegebenen Runbooks.

{% hint style="warning" %}
Wenn dies aktiviert ist, sehen alle Benutzer, die keiner Rolle angehören, keine Runbooks.
{% endhint %}

#### Beispiel

Machen wir mit dem, was wir bisher haben, weiter und erstellen eine Gerätesupport-Rolle `DeviceAdmin` und eine Benutzersupport-Rolle `UserAdmin`.

Wir wenden diese Rollen auf mehrere Entra ID-Gruppen an und geben für jede Rolle eine Liste zulässiger Runbooks an. Bitte beachten Sie – dadurch wird die Benutzersupport-Rolle auf nur eine kleine Menge von Runbooks beschränkt.

Fügen wir Kommentare ("//") neben der Objekt-ID der Gruppe hinzu, die dem Leser helfen, indem sie die Namen der Entra ID-Gruppen angeben.

```json
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ],
  "DisabledRunbookPatterns": [
    "rjgit-*_security_*"
  ],
  "Roles": {
    "DeviceAdmin": {
      "Groups": [
        "9cbfc0af-c217-41e9-b790-3043788f1234", // 1. Gerätesupport-AAD-Gruppe
        "5555c0af-c217-41e9-b790-3043788f1234"  // 2. Gerätesupport-AAD-Gruppe - anderes Team
      ],
      "AllowedRunbookPatterns": [
        "rjgit-device_*"
      ]
    },
    "UserAdmin": {
      "Groups": [
        "1234c0af-c217-41e9-b790-3043788f1234" // Benutzersupport-AAD-Gruppe
      ],
      "AllowedRunbookPatterns": [
        "rjgit-user_general_assign-or-unassign-license",
        "rjgit-user_mail_*",
        "user_*"
      ]
    }
  }
}
```

Jetzt kann die `UserAdmin` Rolle:

* Lizenzen allen Benutzern in Ihrem Tenant zuweisen
* E-Mail-Adressen aller Benutzer in Ihrem Tenant ändern

Die `DeviceAdmin` Rolle kann

* jedes Gerät in Ihrem Tenant löschen

### TargetEntityGroups

Vielleicht haben Sie einige wichtige VIP-Benutzer. Es sollte nicht möglich sein, dass irgendein Supportmitarbeiter das Gerät eines VIPs löscht oder die E-Mail-Adresse eines VIPs ändert. Wir können "Targeting" verwenden, um Rollen für kritische Benutzer auf dedizierte Teams zu beschränken.

"Devices" werden über ihren primären/zugewiesenen Benutzer angesprochen, nicht jedoch über das Geräteobjekt in Entra ID. Dadurch lässt sich ein rein benutzerbasiertes Gruppenmodell beibehalten.

Wir gehen davon aus, dass Entra ID-Gruppen existieren, die kritische VIP-Benutzer enthalten. Mithilfe dieses Abschnitts können wir einige weitergehende kritische Rollen und Runbooks für diese spezifischen Entra ID-Gruppen (Ziele) sorgfältig eingrenzen.

Wenn Sie diesen Abschnitt weglassen, werden natürlich alle Benutzer/Gruppen/Geräte in Ihrem Tenant gleich behandelt.

Wenn Sie TargetEntityGroups definieren, sollte dies keinerlei Auswirkungen auf andere Gruppen haben, die im Abschnitt nicht erwähnt werden.

#### Vollständiges Beispiel

Nehmen wir die Gruppe `0000c0af-c217-41e9-b790-3043788f0000` ist unsere Gruppe der VIP-Benutzer.

Wir führen eine neue Entra ID-Gruppe ein `4444c0af-c217-41e9-b790-3043788f4444` die unterstützendes Personal enthält, das berechtigt wurde, VIP-Benutzer zu verwalten. Dieses unterstützende Personal sollte außerdem alle anderen grundlegenden Supportberechtigungen haben, daher fügen wir es den vorhandenen Rollen hinzu.

"Restricting" einer Rolle gewährt einem Supportmitarbeiter keine neuen Rollen.

```json
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ],
  "DisabledRunbookPatterns": [
    "rjgit-*_security_*"
  ],
  "Roles": {
    "DeviceAdmin": {
      "Groups": [
        "9cbfc0af-c217-41e9-b790-3043788f1234", // 1. Gerätesupport-AAD-Gruppe
        "5555c0af-c217-41e9-b790-3043788f1234"  // 2. Gerätesupport-AAD-Gruppe - anderes Team
        "4444c0af-c217-41e9-b790-3043788f4444"  // VIP-Support-Team
      ],
      "AllowedRunbookPatterns": [
        "rjgit-device_*"
      ]
    },
    "UserAdmin": {
      "Groups": [
        "1234c0af-c217-41e9-b790-3043788f1234", // Benutzersupport-AAD-Gruppe
        "4444c0af-c217-41e9-b790-3043788f4444"  // VIP-Support-Team
      ],
      "AllowedRunbookPatterns": [
        "rjgit-user_general_assign-or-unassign-license",
        "rjgit-user_mail_*",
        "user_*"
      ]
    }
  },
  "TargetEntityGroups": {
    "0000c0af-c217-41e9-b790-3043788f0000": {  // VIP-Benutzer - Mit Vorsicht behandeln!
      "RestrictRoles": {
        "UserAdmin": [
          "4444c0af-c217-41e9-b790-3043788f4444" // VIP-Support
        ],
        "DeviceAdmin": [
          "4444c0af-c217-41e9-b790-3043788f4444" // VIP-Support
        ]
      }
    }
  }
}
```

#### **Beispiel: US-Supportmitarbeiter darauf beschränken, nur US-Benutzer zu verwalten**

In diesem Szenario haben wir in den USA ansässige Supportmitarbeiter, die nur Benutzer verwalten sollen, die sich in den USA befinden. Um diese Einschränkung durchzusetzen:

* Erstellen Sie eine Berechtigungsregel, die ausdrücklich **verweigert** US-Supportern die Möglichkeit, Runbooks auszuführen für **alle Benutzer**.
* Fügen Sie eine Ausnahmeregel hinzu, die ausdrücklich **erlaubt** die Ausführung von Runbooks nur für **US-Benutzer**.

Dadurch wird sichergestellt, dass US-Supporter ihre Berechtigungen strikt auf die vorgesehene Zielgruppe (US-Benutzer) beschränkt haben und versehentliche Interaktionen mit Benutzern außerhalb dieses Bereichs verhindert werden.

**Implementierung**

1. Im RealmJoin Portal muss eine Entra-Gruppe für Runbook Runner zugewiesen werden
   1. Einstellungen > Berechtigungen > Runbook-Runner-Berechtigungen
   2. Die Entra-Gruppe der US-Supporter muss Mitglied der Runbook Runners Group sein, um die allgemeine Runbook-Nutzung im RealmJoin Portal zu ermöglichen.
2. Hinzufügen einer neuen Rolle unter Einstellungen > Runbook-Berechtigungen
   1. Fügen Sie im Abschnitt Rollen die Rolle USSupporters mit ihrer Entra-Gruppe (Gruppenobjekt-ID) hinzu
   2. Fügen Sie AllowedRunbookPatterns für die USSupporters hinzu
3. Ändern Sie die TargetEntityGroups
   1. Die Gruppe All-Users muss die Rolle USSupporters mit einem leeren Wert einschränken (hier wird keine Entra-Gruppenobjekt-ID hinzugefügt). Dies ist eine implizite Verweigerung!
   2. Die Gruppe US Users muss die Rolle USSupporters auf die Entra-Gruppenobjekt-ID der US Supporters beschränken

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FZ56Ipx6VuZDjIeZO2MTC%2Fimage.png?alt=media&amp;token=e3f5fe54-0d17-46f0-a106-f51d548bde64" alt=""><figcaption><p>US-Supportmitarbeiter darauf beschränken, nur US-Benutzer zu verwalten</p></figcaption></figure>

Nachfolgend das vollständige Beispiel für dieses Szenario:

```json
{
  // Portalberechtigung:
  // Runbook-Runner-Rolle: US Supporters

  // Gruppenmitgliedschaften:
  // 3e1e7540-7f0c-483c-b9bf-500342e2467c: Alle Benutzer
  // c603278c-cc36-4661-bb7a-eecb7ab079f9: US-Supporter
  // 0f76d01e-cc6b-4553-bf1d-e4ccedd9c824: US-Benutzer

  "EnabledRunbookPatterns": [ // Allgemeine Aktivierung von Mail- und Security-Runbooks
    "rjgit-*_mail_*",
    "rjgit-*security*"
  ],
  "DisabledRunbookPatterns": [
    "*password*"
  ],

  "Roles": {
    "USSupporters": {
      "Groups": [
        "c603278c-cc36-4661-bb7a-eecb7ab079f9" // US-Supporter
      ],
      "AllowedRunbookPatterns": [ // zulässige Runbooks für diese Rolle - US-Supporter
        "rjgit-user_*",
        "rjgit-device_*",
        "rjgit-group_*"
      ]
    }
  },
  
  "TargetEntityGroups": {
    "3e1e7540-7f0c-483c-b9bf-500342e2467c": { // Alle Benutzer
      "RestrictRoles": {
        "USSupporters": [
          // generell keine Runbooks für US-Supporter zulassen
        ]
      }
    },
    "0f76d01e-cc6b-4553-bf1d-e4ccedd9c824": { // US-Benutzer
      "RestrictRoles": {
        "USSupporters": [
          "c603278c-cc36-4661-bb7a-eecb7ab079f9" // US-Supporter
        ]
      }
    }
  }
}
```

### SchedulingEnabledRunbookPatterns

Dieser Abschnitt enthält eine Liste von Runbooks, die als "planbar" markiert werden. RealmJoin Port ermöglicht es, Zeitpläne für diese Runbooks zuzuweisen / zu verwalten. Siehe [Runbook-Planung](https://docs.realmjoin.com/de/automatisierung/runbooks/scheduling.md).

Das folgende Beispiel beschreibt das Standardverhalten, wenn SchedulingEnabledRunbookPatterns nicht definiert sind:

```json
{
  "SchedulingEnabledRunbookPatterns": [
    "*_scheduled"
  ]
}
```

### SchedulingDisabledRunbookPatterns

Dieser Abschnitt enthält eine Liste von Runbooks, die auf die Blacklist gesetzt werden und daher nicht als "planbar" markiert werden. RealmJoin Port erlaubt es nicht, Zeitpläne für diese Runbooks zuzuweisen / zu verwalten. Siehe [Runbook-Planung](https://docs.realmjoin.com/de/automatisierung/runbooks/scheduling.md).

Ein Runbook, das sowohl in SchedulingEnabledRunbookPatterns als auch in SchedulingDisabledRunbookPatterns enthalten ist, wird **nicht** planbar sein.

Standardmäßig sind keine Runbooks auf der Blacklist. Das folgende Beispiel demonstriert nur die Syntax:

```json
{
  "SchedulingDisabledRunbookPatterns": [
    "rjgit-user_*"
  ]
}
```


---

# 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/automatisierung/runbooks/runbook-permissions.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.
