> 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 {% embed url="" %} ## Champ d'application Cela explique comment autoriser/refuser l'accès à certains runbooks dans un tenant Azure. Si vous cherchez des réponses concernant les autorisations d'API MS Graph nécessaires pour exécuter une certaine action en tant que runbook, veuillez consulter nos [exigences](/fr/automatisation/connecting-azure-automation/azure-ad-roles-and-permissions.md). ## Aperçu Les « Runbook Permissions » définissent la visibilité des runbooks pour certains utilisateurs. Certains runbooks peuvent également être bloqués/masqués globalement. Comme les [Runbook Customizations](/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 à . ### À propos de ce guide Nous donnerons une courte 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 couvrirait tous les exemples suivants : * `rjgit-org_security_list-inactive-users` * `rjgit-device_security_enable-or-disable-device` Le préfixe `préfixe rjgit-` indique les runbooks importés de notre dépôt GitHub public. Les runbooks spécifiques aux clients 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 allons construire 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 en utilisant le préfixe "//". ### Modèles de runbooks activés 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, alors seuls les runbooks mentionnés dans cette section seront utilisables par n'importe quel rôle / support et administrateur. #### Exemple * Autoriser uniquement certains runbooks individuels en donnant leur nom complet `rjgit-group_general_remove-group` * Autoriser tous les runbooks liés aux appareils de notre dépôt partagé `rjgit-device_*` * Autoriser tous les runbooks utilisateur partagés `rjgit-user_*` * Autoriser tous les runbooks utilisateur spécifiques au client (locaux) `user_*` Cela exclut implicitement de nombreux runbooks basés sur les groupes et tous ceux basés sur l'organisation. À garder à l'esprit. ``` { "EnabledRunbookPatterns": [ "rjgit-group_general_remove-group", "rjgit-device_*", "rjgit-user_*", "user_*" ] } ``` ### Modèles de runbooks désactivés Une liste de runbooks qui sont globalement désactivés / interdits. Si cette section est omise ou vide, tous les runbooks activés (fournis via [Modèles de runbooks activés](#enabledrunbookpatterns)) sont utilisables. Les entrées de cette section sont prioritaires sur les entrées de [Modèles de runbooks activés ](#enabledrunbookpatterns) - les runbooks seront masqués/ne seront pas utilisables pour quiconque dans ce tenant. #### Exemple Nous réutiliserons la `Modèles de runbooks activés` section précédente. * Désactiver tous les runbooks partagés (`préfixe rjgit-`) runbooks dans la `sécurité` . ``` { "EnabledRunbookPatterns": [ "rjgit-group_general_remove-group", "rjgit-device_*", "rjgit-user_*", "user_*" ], "DisabledRunbookPatterns": [ "rjgit-*_security_*" ] } ``` ### Rôles 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 tous les administrateurs ont accès à tous les runbooks définis 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 appareils `DeviceAdmin` et un rôle de support utilisateur `UserAdmin`. Nous appliquerons ces rôles à plusieurs groupes Entra ID et, pour chaque rôle, nous donnerons une liste de runbooks autorisés. Attention : cela limitera le rôle de support utilisateur à seulement un petit ensemble de runbooks. Ajoutons des commentaires ("//") à côté de l'ID d'objet du groupe afin d'aider le lecteur en indiquant les noms des groupes Entra ID. ```json { "EnabledRunbookPatterns": [ "rjgit-group_general_remove-group", "rjgit-device_*", "rjgit-user_*", "user_*" ], "DisabledRunbookPatterns": [ "rjgit-*_security_*" ], "Roles": { "DeviceAdmin": { "Groupes": [ "9cbfc0af-c217-41e9-b790-3043788f1234", // 1er groupe AAD de support appareils "5555c0af-c217-41e9-b790-3043788f1234" // 2e groupe AAD de support appareils - autre équipe ], "AllowedRunbookPatterns": [ "rjgit-device_*" ] }, "UserAdmin": { "Groupes": [ "1234c0af-c217-41e9-b790-3043788f1234" // Groupe AAD de support utilisateur ], "AllowedRunbookPatterns": [ "rjgit-user_general_assign-or-unassign-license", "rjgit-user_mail_*", "user_*" ] } } } ``` Désormais, 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` le rôle peut * effacer n'importe quel appareil de votre tenant ### Groupes d'entités cibles Peut-être avez-vous 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. Les « Devices » seront ciblés par leur utilisateur principal/assigné, mais pas par l'objet appareil dans Entra ID. Cela permet de s'en tenir à un modèle de groupe purement basé sur les utilisateurs. Nous supposons que des groupes Entra ID existent et contiennent des utilisateurs VIP critiques. À l'aide de 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 sur un pied d'égalité. Si vous définissez TargetEntityGroups, cela ne devrait avoir aucun impact sur tout autre groupe non mentionné dans la section. #### Exemple complet Supposons 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 le personnel de support qui a été autorisé à administrer les utilisateurs VIP. Ce personnel de support devrait également disposer de toutes les autres autorisations de support de base, nous les ajouterons donc aux rôles existants. Le fait de « 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": { "Groupes": [ "9cbfc0af-c217-41e9-b790-3043788f1234", // 1er groupe AAD de support appareils "5555c0af-c217-41e9-b790-3043788f1234", // 2e groupe AAD de support appareils - autre équipe "4444c0af-c217-41e9-b790-3043788f4444" // Équipe de support VIP ], "AllowedRunbookPatterns": [ "rjgit-device_*" ] }, "UserAdmin": { "Groupes": [ "1234c0af-c217-41e9-b790-3043788f1234", // Groupe AAD 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 - à traiter 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 américain à la gestion des seuls utilisateurs américains** Dans ce scénario, nous avons un personnel de support basé aux États-Unis qui ne devrait gérer que les utilisateurs situés aux États-Unis. Pour appliquer cette restriction : * Créez une règle d'autorisation qui **refuse** aux supporteurs américains la possibilité d'exécuter des runbooks sur **tous les utilisateurs**. * Ajoutez une règle d'exception qui **autorise** l'exécution des runbooks uniquement pour **les utilisateurs américains**. Cela garantit que les supporteurs américains disposent d'autorisations strictement limitées à leur public cible prévu (les utilisateurs américains) et empêche toute interaction accidentelle avec des utilisateurs en dehors de ce périmètre. **Mise en œuvre** 1. Un groupe Entra pour les exécuteurs de runbooks doit être attribué dans le portail RealmJoin 1. Paramètres > Autorisations > Autorisations des exécuteurs de runbooks 2. Le groupe Entra des supporteurs américains doit être membre du groupe des exécuteurs de runbooks pour autoriser l'opération générale des runbooks dans le portail RealmJoin. 2. Ajout d'un nouveau rôle sous Paramètres > Autorisations des runbooks 1. Dans la section Rôles, ajoutez le rôle USSupporters avec leur groupe Entra (ID d'objet du groupe) 2. Ajoutez les 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 supporteurs américains

Restreindre le personnel de support américain à la gestion des seuls utilisateurs américains

Voici l'exemple complet pour ce scénario : ```json { // Autorisation du portail : // Rôle d'exécuteur de runbooks : supporteurs américains // Appartenances aux groupes : // 3e1e7540-7f0c-483c-b9bf-500342e2467c : Tous les utilisateurs // c603278c-cc36-4661-bb7a-eecb7ab079f9 : supporteurs américains // 0f76d01e-cc6b-4553-bf1d-e4ccedd9c824 : utilisateurs américains "EnabledRunbookPatterns": [ // Activation générale des runbooks de messagerie et de sécurité "rjgit-*_mail_*", "rjgit-*security*" ], "DisabledRunbookPatterns": [ "*password*" ], "Roles": { "USSupporters": { "Groupes": [ "c603278c-cc36-4661-bb7a-eecb7ab079f9" // Supporteurs américains ], "AllowedRunbookPatterns": [ // runbooks autorisés pour ce rôle - supporteurs américains "rjgit-user_*", "rjgit-device_*", "rjgit-group_*" ] } }, "TargetEntityGroups": { "3e1e7540-7f0c-483c-b9bf-500342e2467c": { // Tous les utilisateurs "RestrictRoles": { "USSupporters": [ // en général, n'autorisez pas de runbooks pour les supporteurs américains ] } }, "0f76d01e-cc6b-4553-bf1d-e4ccedd9c824": { // Utilisateurs américains "RestrictRoles": { "USSupporters": [ "c603278c-cc36-4661-bb7a-eecb7ab079f9" // Supporteurs américains ] } } } } ``` ### Modèles de runbooks activés pour la planification Cette section contient une liste de runbooks qui seront marqués comme « planifiables ». RealmJoin Port permettra d'attribuer / de gérer des planifications pour ces runbooks. Voir [Planification des runbooks](/fr/automatisation/runbooks/scheduling.md). L'exemple suivant décrit le comportement par défaut si SchedulingEnabledRunbookPatterns n'est pas défini : ```json { "SchedulingEnabledRunbookPatterns": [ "*_scheduled" ] } ``` ### Modèles de runbooks désactivés pour la planification Cette section contient une liste de runbooks qui seront mis sur liste noire et ne seront pas marqués comme « planifiables ». RealmJoin Port n'autorisera pas l'attribution / la gestion de planifications pour ces runbooks. Voir [Planification des runbooks](/fr/automatisation/runbooks/scheduling.md). Un runbook présent à la fois dans SchedulingEnabledRunbookPatterns et SchedulingDisabledRunbookPatterns sera **pas** planifiable. Par défaut, aucun runbook n'est mis sur liste noire. L'exemple suivant montre 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 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/fr/automatisation/runbooks/runbook-permissions.md?ask=&goal= ``` `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.