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

# Autorisations des runbooks

Comment accorder/refuser l’accès à certains runbooks.

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

## Portée

Cela explique comment autoriser/refuser l'accès à certains runbooks dans un Tenant Azure. Si vous cherchez des réponses concernant les autorisations MS Graph API nécessaires pour exécuter une certaine action en tant que runbook, veuillez consulter nos [exigences](https://docs.realmjoin.com/fr/automatisation/connecting-azure-automation/azure-ad-roles-and-permissions.md).

## Aperçu

"Runbook Permissions" définit la visibilité des runbooks pour certains utilisateurs. Certains runbooks peuvent également être bloqués/masqués globalement.

Comme le [Personnalisations du runbook](https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-customization.md), la définition de ces autorisations se fait en fournissant une configuration au format JSON en tant qu'administrateur RealmJoin dans le portail web de RealmJoin à <https://portal.realmjoin.com/settings/runbooks-permissions> .

### À propos de ce guide

Nous donnerons une brève description de la syntaxe, puis construirons un exemple complet pas à pas. N'hésitez pas à aller directement à l'exemple complet et à commencer à partir de [là](#targetentitygroups).

## Syntaxe de configuration

### Noms des runbooks

Les runbooks sont référencés par leur nom tel qu'il apparaît dans le compte Azure Automation, par exemple `rjgit-group_general_remove-group`.

Des jokers ('\*') peuvent être utilisés pour faire correspondre plusieurs runbooks. Plusieurs jokers peuvent être utilisés dans la même chaîne, par exemple `rjgit-*_security_*`. Cela s'appliquerait à tous les exemples suivants :

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

Le préfixe `préfixe rjgit-` désigne les runbooks importés depuis notre dépôt GitHub public. Les runbooks spécifiques au client n'ont pas de préfixe, par exemple `user_userinfo_custom-runbook`

### Entra ID Groups

Les groupes Entra ID seront référencés à l'aide de leur ID d'objet, comme `91688d11-9a34-42cd-8d1e-ce617d6c1234`. Actuellement, seuls les groupes de sécurité peuvent être utilisés.

## Structure JSON et exemple

Nous construirons un exemple complet de configuration pas à pas.

Une configuration JSON se compose de plusieurs sections, mais toutes les sections sont facultatives et peuvent être omises.

Il est permis d'ajouter des commentaires à l'aide du préfixe "//".

### EnabledRunbookPatterns

Cette section contient une liste de runbooks autorisés à être utilisés. Si cette section est omise, tous les runbooks sont activés/autorisés par défaut.

Si vous définissez cette section, seuls les runbooks mentionnés dans celle-ci pourront être utilisés par n'importe quel rôle / support et administrateur.

#### Exemple

* Autorisez uniquement certains runbooks individuels en donnant leur nom complet

  `rjgit-group_general_remove-group`
* Autorisez tous les runbooks liés aux appareils de notre dépôt partagé

  `rjgit-device_*`
* Autorisez tous les runbooks utilisateur partagés

  `rjgit-user_*`
* Autorisez tous les runbooks utilisateur spécifiques au client (locaux)

  `user_*`

Cela exclut implicitement de nombreux runbooks liés aux groupes et tous les runbooks basés sur l'organisation. Soyez-en conscient.

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

### DisabledRunbookPatterns

Une liste de runbooks désactivés / interdits globalement. Si cette section est omise ou vide, tous les runbooks activés (donnés via [EnabledRunbookPatterns](#enabledrunbookpatterns)) sont utilisables.

Les entrées de cette section ont priorité sur celles de [EnabledRunbookPatterns ](#enabledrunbookpatterns)- les runbooks seront masqués / inutilisables pour quiconque dans ce Tenant.

#### Exemple

Nous réutiliserons la `EnabledRunbookPatterns` section précédente.

* Désactivez tous les runbooks partagés (`préfixe rjgit-`) runbooks dans la `sécurité` catégorie.

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

### Roles

Dans cette section, vous pouvez attribuer une liste de runbooks à un groupe Entra ID. Cela permet de définir plusieurs rôles de support/opérateur dans votre Tenant.

Si cette section est omise, tout le support RealmJoin et les administrateurs ont accès à tous les runbooks indiqués dans les sections précédentes.

{% hint style="warning" %}
Si activé, tous les utilisateurs n'appartenant à aucun rôle ne verront aucun runbook.
{% endhint %}

#### Exemple

En continuant avec ce que nous avons, créons un rôle de support des appareils `DeviceAdmin` et un rôle de support utilisateur `UserAdmin`.

Nous appliquerons ces rôles à plusieurs groupes Entra ID et, pour chaque rôle, fournirons une liste de runbooks autorisés. Attention : cela limitera le rôle de support utilisateur à un petit ensemble de runbooks seulement.

Ajoutons des commentaires ("//") à côté de l'ID d'objet du groupe pour aider le lecteur en donnant les noms des groupes Entra ID.

```json
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ],
  "DisabledRunbookPatterns": [
    "rjgit-*_security_*"
  ],
  "Roles": {
    "DeviceAdmin": {
      "Groups": [
        "9cbfc0af-c217-41e9-b790-3043788f1234", // 1er groupe Entra ID de support des appareils
        "5555c0af-c217-41e9-b790-3043788f1234"  // 2e groupe Entra ID de support des appareils - autre équipe
      ],
      "AllowedRunbookPatterns": [
        "rjgit-device_*"
      ]
    },
    "UserAdmin": {
      "Groups": [
        "1234c0af-c217-41e9-b790-3043788f1234" // groupe Entra ID de support utilisateur
      ],
      "AllowedRunbookPatterns": [
        "rjgit-user_general_assign-or-unassign-license",
        "rjgit-user_mail_*",
        "user_*"
      ]
    }
  }
}
```

À présent, le `UserAdmin` rôle peut :

* attribuer des licences à tous les utilisateurs de votre Tenant
* modifier les adresses e-mail de tous les utilisateurs de votre Tenant

Le `DeviceAdmin` rôle peut

* effacer n'importe quel appareil dans votre Tenant

### TargetEntityGroups

Vous avez peut-être des utilisateurs VIP cruciaux. Il ne devrait pas être possible pour n'importe quel membre du support d'effacer l'appareil d'un VIP ou de modifier l'adresse e-mail d'un VIP. Nous pouvons utiliser le « ciblage » pour restreindre les rôles sur les utilisateurs critiques à des équipes dédiées.

"Devices" seront ciblés par leur utilisateur principal/attribué, et non par l'objet appareil dans Entra ID. Cela permet de s'en tenir à un modèle de groupe purement basé sur l'utilisateur.

Nous supposons qu'il existe des groupes Entra ID contenant des utilisateurs VIP critiques. En utilisant cette section, nous pouvons délimiter avec soin certains rôles et runbooks plus critiques pour ces groupes Entra ID spécifiques (cibles).

Évidemment, si vous omettez cette section, tous les utilisateurs/groupes/appareils de votre Tenant sont traités à égalité.

Si vous définissez TargetEntityGroups, cela ne devrait avoir aucun impact sur les autres groupes non mentionnés dans la section.

#### Exemple complet

Supposons que le groupe `0000c0af-c217-41e9-b790-3043788f0000` est notre groupe d'utilisateurs VIP.

Nous introduisons un nouveau groupe Entra ID `4444c0af-c217-41e9-b790-3043788f4444` contenant du personnel de support autorisé à administrer les utilisateurs VIP. Ce personnel de support devrait également disposer de toutes les autres autorisations de support de base, nous allons donc l'ajouter aux rôles existants.

"Restreindre" un rôle n'accordera pas de nouveaux rôles à un membre du support.

```json
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ],
  "DisabledRunbookPatterns": [
    "rjgit-*_security_*"
  ],
  "Roles": {
    "DeviceAdmin": {
      "Groups": [
        "9cbfc0af-c217-41e9-b790-3043788f1234", // 1er groupe Entra ID de support des appareils
        "5555c0af-c217-41e9-b790-3043788f1234", // 2e groupe Entra ID de support des appareils - autre équipe
        "4444c0af-c217-41e9-b790-3043788f4444"  // équipe de support VIP
      ],
      "AllowedRunbookPatterns": [
        "rjgit-device_*"
      ]
    },
    "UserAdmin": {
      "Groups": [
        "1234c0af-c217-41e9-b790-3043788f1234", // groupe Entra ID de support utilisateur
        "4444c0af-c217-41e9-b790-3043788f4444"  // équipe de support VIP
      ],
      "AllowedRunbookPatterns": [
        "rjgit-user_general_assign-or-unassign-license",
        "rjgit-user_mail_*",
        "user_*"
      ]
    }
  },
  "TargetEntityGroups": {
    "0000c0af-c217-41e9-b790-3043788f0000": {  // Utilisateurs VIP - À manipuler avec précaution !
      "RestrictRoles": {
        "UserAdmin": [
          "4444c0af-c217-41e9-b790-3043788f4444" // Support VIP
        ],
        "DeviceAdmin": [
          "4444c0af-c217-41e9-b790-3043788f4444" // Support VIP
        ]
      }
    }
  }
}
```

#### **Exemple : Restreindre le personnel de support US à la gestion uniquement des utilisateurs US**

Dans ce scénario, nous avons du personnel de support basé aux États-Unis qui ne devrait gérer que les utilisateurs situés aux États-Unis. Pour imposer cette restriction :

* Créez une règle d'autorisation qui explicitement **refuse** aux US Supporters la possibilité d'exécuter des runbooks sur **tous les utilisateurs**.
* Ajoutez une règle d'exception qui spécifiquement **autorise** l'exécution des runbooks uniquement pour **les US Users**.

Cela garantit que les US Supporters disposent d'autorisations strictement limitées à leur public cible prévu (US Users) et empêche toute interaction accidentelle avec des utilisateurs hors de ce périmètre.

**Implémentation**

1. Un groupe Entra Runbook Runners doit être attribué dans le portail RealmJoin
   1. Paramètres > Permissions > Autorisations des exécuteurs de runbook
   2. Le groupe Entra US Supporters doit être membre du groupe Runbook Runners pour autoriser l'utilisation générale des runbooks dans le portail RealmJoin.
2. Ajout d'un nouveau rôle dans Paramètres > Autorisations des runbooks
   1. Dans la section Rôles, ajoutez le rôle USSupporters avec son groupe Entra (ID d'objet du groupe)
   2. Ajoutez AllowedRunbookPatterns pour les USSupporters
3. Modifiez les TargetEntityGroups
   1. Le groupe All-Users doit restreindre le rôle USSupporters avec une valeur vide (aucun ID d'objet de groupe Entra n'est ajouté ici). Il s'agit d'un refus implicite !
   2. Le groupe US Users doit restreindre le rôle USSupporters à l'ID d'objet du groupe Entra des US Supporters

<figure><img src="https://1100180853-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>Restreindre le personnel de support US à la gestion uniquement des utilisateurs US</p></figcaption></figure>

Voici l'exemple complet pour ce scénario :

```json
{
  // Autorisation du portail :
  // Rôle d'exécution de runbook : US Supporters

  // Appartenances aux groupes :
  // 3e1e7540-7f0c-483c-b9bf-500342e2467c: All-Users
  // c603278c-cc36-4661-bb7a-eecb7ab079f9: US Supporters
  // 0f76d01e-cc6b-4553-bf1d-e4ccedd9c824: US Users

  "EnabledRunbookPatterns": [ // Activation générale des runbooks de messagerie et de sécurité
    "rjgit-*_mail_*",
    "rjgit-*security*"
  ],
  "DisabledRunbookPatterns": [
    "*password*"
  ],

  "Roles": {
    "USSupporters": {
      "Groups": [
        "c603278c-cc36-4661-bb7a-eecb7ab079f9" // US Supporters
      ],
      "AllowedRunbookPatterns": [ // runbooks autorisés pour ce rôle - US Supporters
        "rjgit-user_*",
        "rjgit-device_*",
        "rjgit-group_*"
      ]
    }
  },
  
  "TargetEntityGroups": {
    "3e1e7540-7f0c-483c-b9bf-500342e2467c": { // All-Users
      "RestrictRoles": {
        "USSupporters": [
          // en général, n'autorisez aucun runbook pour les US Supporters
        ]
      }
    },
    "0f76d01e-cc6b-4553-bf1d-e4ccedd9c824": { // US Users
      "RestrictRoles": {
        "USSupporters": [
          "c603278c-cc36-4661-bb7a-eecb7ab079f9" // US Supporters
        ]
      }
    }
  }
}
```

### SchedulingEnabledRunbookPatterns

Cette section contient une liste de runbooks qui seront marqués comme « planifiables ». RealmJoin Port permettra d'assigner / gérer des planifications pour ces runbooks. Voir [Planification des runbooks](https://docs.realmjoin.com/fr/automatisation/runbooks/scheduling.md).

L'exemple suivant décrit le comportement par défaut si SchedulingEnabledRunbookPatterns ne sont pas définis :

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

### SchedulingDisabledRunbookPatterns

Cette section contient une liste de runbooks qui seront mis sur liste noire pour ne pas être marqués comme « planifiables ». RealmJoin Port ne permettra pas d'assigner / gérer des planifications pour ces runbooks. Voir [Planification des runbooks](https://docs.realmjoin.com/fr/automatisation/runbooks/scheduling.md).

Un runbook présent à la fois dans SchedulingEnabledRunbookPatterns et dans SchedulingDisabledRunbookPatterns **ne** sera planifiable.

Par défaut, aucun runbook n'est mis sur liste noire. L'exemple suivant illustre simplement la syntaxe :

```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/fr/automatisation/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.
