# Roles personalizados

## Información general

**Roles personalizados** es una función opcional en RealmJoin Portal y permite crear roles internos adicionales de RealmJoin. Puede asignar permisos granulares / atómicos a estos roles y vincularlos a grupos de Entra o a usuarios específicos.

{% hint style="info" %}
Si se necesitan roles personalizados, por favor **solicite la activación a través del soporte de RealmJoin**.
{% endhint %}

Los Roles personalizados se definen como JSON. El editor JSON incluido en RealmJoin Portal ofrece comprobación de sintaxis y resaltado, y verificará su definición con el esquema JSON de Roles personalizados.

<figure><img src="/files/593cf04c51437fedafd5eb680fee56901e38f183" alt=""><figcaption><p>Editor JSON de Roles personalizados</p></figcaption></figure>

## Uso del editor

### Comprobación de sintaxis / Errores

El editor comprobará la sintaxis mientras escribe. Si se detecta un error de sintaxis, aparecerá un mensaje de error **Ver x errores** y un icono de error junto a **Guardar.**

<figure><img src="/files/8d89cba31041ed0dc56ce72fbc283a2183b3870f" alt=""><figcaption><p>Mensaje/botón de error JSON</p></figcaption></figure>

Haga clic en este mensaje para obtener más detalles sobre el error.

### Formato

Puede dar formato automático al JSON haciendo clic en **Formato** en la esquina superior derecha de la página.

<figure><img src="/files/cf7c7dd995c2686822201f29fe5d3d574d5da720" alt=""><figcaption><p>Botón Formato</p></figcaption></figure>

### Autocompletar

El editor puede ofrecer autocompletado de palabras clave conocidas (como permisos) a partir del esquema.

<figure><img src="/files/c2b5365ae4ce13554ad9008d384ceb8c9d8ab20d" alt=""><figcaption><p>Autocompletado de palabras clave</p></figcaption></figure>

Puede pulsar "Ctrl" + "Espacio" en cualquier momento para invocar Autocompletar.

## Reglas

Un rol se describe como un par de permisos y usuarios y/o grupos a los que se conceden estos permisos.

Los roles se enumeran como parte de un arreglo (lista) bajo la palabra clave **Reglas**.

Ejemplo de conjunto de reglas:

```json
{
  "Rules": [
    {
      "Name": "Default: Supporters can change primary user [27e589a7]",
      "Description": "Default rule to allow members of a Supporter group to change the primary user of RealmJoin joined devices. Please keep the ID that is included its name.",
      "Groups": [
        "f31f5765-f56f-47fa-9248-ac2d77221634",
        "422e6b7c-bd99-4082-be1c-88cbc2bb2734"
      ],
      "Permissions": [
        "CanChangeRealmJoinPrimaryUser"
      ]
    },{
      "Name": "Allow John to add new Self Service Forms",
      "Users": [
        "b31f5765-f56f-47fa-9248-ac2d77221622"
      ],
      "Permissions": [
        "CanAddSelfServiceForms"
      ]
    }
  ]
}
```

### Nombre y descripción

**Nombre** es obligatorio, **Descripción** es opcional.

Ambos son campos de texto sin formato (cadena).

### Permisos

Un permiso es una cadena única que identifica una acción determinada en RealmJoin Portal. **Permisos** es una lista (arreglo) de permisos.

Vea [Permisos disponibles](/es/configuracion-de-realmjoin/permission/custom-roles/available-permissions.md) para obtener una lista y descripción de los permisos comunes.

### Grupos

Una lista (arreglo) de IDs de objeto de grupo de Entra. Dado [permisos](#permissions) se asignará a todos los usuarios que sean miembros de estos grupos.

### Usuarios

Una lista (arreglo) de IDs de objeto de usuario de Entra. Dado [permisos](#permissions) se asignará a estos usuarios.


---

# 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/es/configuracion-de-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.