> 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/es/administracion-y-configuracion/permission/custom-roles.md).

# Roles personalizados

## Descripción general

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

{% 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 el Portal de RealmJoin ofrece comprobación y resaltado de sintaxis y verificará su definición frente al 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 autocompletar de palabras clave conocidas (como permisos) del esquema.

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

Puede presionar "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 otorgan estos permisos.

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

Ejemplo de conjunto de reglas:

```json
{
  "Reglas": [
    {
      "Nombre": "Predeterminado: Los colaboradores pueden cambiar el usuario principal [27e589a7]",
      "Descripción": "Regla predeterminada para permitir que los miembros de un grupo de colaboradores cambien el usuario principal de dispositivos unidos a RealmJoin. Conserve el ID que se incluye en su nombre.",
      "Grupos": [
        "f31f5765-f56f-47fa-9248-ac2d77221634",
        "422e6b7c-bd99-4082-be1c-88cbc2bb2734"
      ],
      "Permisos": [
        "CanChangeRealmJoinPrimaryUser"
      ]
    },{
      "Nombre": "Permitir a John agregar nuevos formularios de autoservicio",
      "Usuarios": [
        "b31f5765-f56f-47fa-9248-ac2d77221622"
      ],
      "Permisos": [
        "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 determinada acción en el Portal de RealmJoin. **Permisos** es una lista (matriz) de permisos.

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

### Grupos

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

### Usuarios

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


---

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