> 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é facultative 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 offre une vérification et une mise en évidence de la syntaxe 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 de votre saisie. Si une erreur de syntaxe est détectée, un message d’erreur **Afficher x erreurs** et une icône de bogue apparaîtra à 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.

### Formatage

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>

### Autocomplétion

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

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

Vous pouvez appuyer sur « Ctrl » + « Espace » à tout moment pour invoquer l’autocomplé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 listés dans un tableau (liste) sous le mot-clé **Règles**.

Exemple d’ensemble de règles :

```json
{
  "Règles": [
    {
      "Nom": "Par défaut : les supporters peuvent changer l’utilisateur principal [27e589a7]",
      "Description": "Règle par défaut permettant aux membres d’un groupe de supporters de changer l’utilisateur principal des appareils joints à RealmJoin. Veuillez conserver l’ID inclus dans son nom.",
      "Groupes": [
        "f31f5765-f56f-47fa-9248-ac2d77221634",
        "422e6b7c-bd99-4082-be1c-88cbc2bb2734"
      ],
      "Autorisations": [
        "CanChangeRealmJoinPrimaryUser"
      ]
    },{
      "Nom": "Autoriser John à ajouter de nouveaux formulaires d’auto-service",
      "Utilisateurs": [
        "b31f5765-f56f-47fa-9248-ac2d77221622"
      ],
      "Autorisations": [
        "CanAddSelfServiceForms"
      ]
    }
  ]
}
```

### Nom et Description

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

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

### Autorisations

Une autorisation est une chaîne unique identifiant une action spécifique 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 une liste et une description des autorisations courantes.

### Groupes

Une liste (tableau) d’identifiants d’objet de groupe Entra. Attribuées [permissions](#permissions) seront attribuées à tous les utilisateurs membres de ces groupes.

### Utilisateurs

Une liste (tableau) d’identifiants d’objet d’utilisateur Entra. Attribuées [permissions](#permissions) seront attribuées à 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.