# Rôles personnalisés

## Overview

**Rôles personnalisés** est une fonctionnalité optionnelle dans RealmJoin Portal et permet de créer des rôles internes supplémentaires RealmJoin. Vous pouvez attribuer des permissions 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 RealmJoin Portal offre la vérification de la syntaxe et la mise en évidence, et validera 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 syntaxe / Erreurs

L’éditeur vérifiera la syntaxe pendant que vous tapez. Si une erreur de syntaxe est détectée, un message d’erreur **Afficher x erreurs** et une icône de bug 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 mettre automatiquement le JSON en forme en cliquant sur **Formater** dans le coin supérieur droit de la page.

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

### Auto-complétion

L’éditeur peut proposer l’auto-complétion de mots-clés connus (comme les permissions) à 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" + "Space" à tout moment pour invoquer l’auto-complétion.

## Règles

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

Les rôles sont सूचीé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 changer l’utilisateur principal [27e589a7]",
      "Description": "Règle par défaut permettant aux membres d’un groupe Supporter de changer 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 de libre-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îne).

### Autorisations

Une permission est une chaîne unique identifiant une certaine action dans RealmJoin Portal. **Autorisations** est une liste (tableau) de permissions.

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

### Groupes

Une liste (tableau) d’ID d’objet de groupe Entra. Donnés [autorisations](#permissions) sera attribué à tous les utilisateurs qui sont membres de ces groupes.

### Utilisateurs

Une liste (tableau) d’ID d’objet d’utilisateur Entra. Donnés [autorisations](#permissions) sera attribué à ces utilisateurs.


---

# Agent Instructions: 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:

```
GET https://docs.realmjoin.com/fr/parametres-realmjoin/permission/custom-roles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.