> 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/administration-et-parametres/permission/custom-roles.md).

# Rôles personnalisés

## Aperçu

**Rôles personnalisés** est une fonctionnalité optionnelle du portail RealmJoin et permet de créer des rôles internes RealmJoin supplémentaires. Vous pouvez attribuer des autorisations granulaires / atomiques à ces rôles et les lier à des groupes Entra ou à des utilisateurs dédiés.

{% hint style="info" %}
Si des rôles personnalisés sont nécessaires, veuillez **demander l’activation via le support RealmJoin**.
{% endhint %}

Les rôles personnalisés sont définis en JSON. L’éditeur JSON inclus dans le portail RealmJoin propose la vérification de la syntaxe et la coloration syntaxique, et vérifiera votre définition par rapport au schéma JSON des rôles personnalisés.

<figure><img src="/files/25acfe60cadfccd9659002fec8db933d8fc5a0de" alt=""><figcaption><p>Éditeur JSON des rôles personnalisés</p></figcaption></figure>

## Utilisation de l’éditeur

### Vérification de la syntaxe / Erreurs

L’éditeur vérifiera la syntaxe au fur et à mesure que vous tapez. Si une erreur de syntaxe est détectée, un message d’erreur **Afficher x erreurs** et une icône de bogue apparaîtront à côté de **Enregistrer.**

<figure><img src="/files/e1bbd60ae9c998fe5afd2cfb30fcc2c21f84af29" alt=""><figcaption><p>Message/bouton d’erreur JSON</p></figcaption></figure>

Cliquez sur ce message pour obtenir plus de détails sur l’erreur.

### Mise en forme

Vous pouvez formater automatiquement le JSON en cliquant **Formater** dans le coin supérieur droit de la page.

<figure><img src="/files/20a916ea56368c773320b3687f40d296e2dc2c86" alt=""><figcaption><p>Bouton de formatage</p></figcaption></figure>

### Auto-complétion

L’éditeur peut proposer l’auto-complétion des mots-clés connus (comme les autorisations) à partir du schéma.

<figure><img src="/files/375431730ac0aadf52b30950eda43028d035dc0a" alt=""><figcaption><p>Auto-complétion des mots-clés</p></figcaption></figure>

Vous pouvez appuyer sur « Ctrl » + « Espace » à tout moment pour lancer l’auto-complétion.

## Règles

Un rôle est décrit comme une paire d’autorisations et d’utilisateurs et/ou de groupes auxquels ces autorisations sont attribuées.

Les rôles sont répertoriés sous forme de tableau (liste) sous le mot-clé **Règles**.

Exemple d’ensemble de règles :

```json
{
  "Rules": [
    {
      "Name": "Par défaut : les Supporters peuvent modifier l’utilisateur principal [27e589a7]",
      "Description": "Règle par défaut permettant aux membres d’un groupe de Supporters de modifier l’utilisateur principal des appareils joints à RealmJoin. Veuillez conserver l’ID inclus dans son nom.",
      "Groups": [
        "f31f5765-f56f-47fa-9248-ac2d77221634",
        "422e6b7c-bd99-4082-be1c-88cbc2bb2734"
      ],
      "Permissions": [
        "CanChangeRealmJoinPrimaryUser"
      ]
    },{
      "Name": "Autoriser John à ajouter de nouveaux formulaires Self Service",
      "Users": [
        "b31f5765-f56f-47fa-9248-ac2d77221622"
      ],
      "Permissions": [
        "CanAddSelfServiceForms"
      ]
    }
  ]
}
```

### Nom et description

**Nom** est requis, **Description** est facultatif.

Les deux sont des champs de texte brut (chaînes).

### Autorisations

Une autorisation est une chaîne unique identifiant une certaine action dans le portail RealmJoin. **Autorisations** est une liste (tableau) d’autorisations.

Voir [Autorisations disponibles](/fr/administration-et-parametres/permission/custom-roles/available-permissions.md) pour obtenir une liste et une description des autorisations courantes.

### Groupes

Une liste (tableau) d’identifiants d’objets de groupe Entra. Étant donné [autorisations](#permissions) sera attribué à tous les utilisateurs qui sont membres de ces groupes.

### Utilisateurs

Une liste (tableau) d’identifiants d’objets d’utilisateur Entra. Étant donné [autorisations](#permissions) sera attribué à ces utilisateurs.


---

# 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/administration-et-parametres/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.