> 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

Los roles personalizados de RealmJoin definen permisos granulares como JSON y se vinculan a grupos o usuarios de Entra mediante el editor JSON integrado.

## Resumen

**Roles personalizados** es una característica 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 respecto al esquema JSON de Roles Personalizados.

<figure><img src="https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FNifuPdTWlMiAniHWFyov%2Fimage.png?alt=media&amp;token=189d5359-6632-4d41-a9ca-14a886fce7c1" 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 aparecerán junto a **Guardar.**

<figure><img src="https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F9KdtoXuHIptOvZot6fHy%2Fimage.png?alt=media&amp;token=6337d312-d237-48bf-a7fa-2e0ae3ffe67f" 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 autoformatear el JSON haciendo clic en **Formato** en la esquina superior derecha de la página.

<figure><img src="https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBcvly75klfY71hEA0oMj%2Fimage.png?alt=media&amp;token=009be309-82ff-4dac-828b-146c29def86e" 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="https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FwyhuLYTSuCJyhdK3K0lX%2Fimage.png?alt=media&amp;token=20ab28f4-6b98-4349-96fc-1586d609449a" 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 un arreglo (lista) bajo la palabra clave **Reglas**.

Ejemplo de conjunto de reglas:

```json
{
  "Rules": [
    {
      "Name": "Predeterminado: los colaboradores pueden cambiar el usuario principal [27e589a7]",
      "Description": "Regla predeterminada para permitir que los miembros de un grupo de colaboradores cambien el usuario principal de los dispositivos unidos a RealmJoin. Por favor, conserve el ID que está incluido en su nombre.",
      "Groups": [
        "f31f5765-f56f-47fa-9248-ac2d77221634",
        "422e6b7c-bd99-4082-be1c-88cbc2bb2734"
      ],
      "Permissions": [
        "CanChangeRealmJoinPrimaryUser"
      ]
    },{
      "Name": "Permitir a John agregar nuevos formularios de autoservicio",
      "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 determinada acción en RealmJoin Portal. **Permisos** es una lista (arreglo) de permisos.

Consulta [Permisos disponibles](https://docs.realmjoin.com/es/administracion-y-configuracion/permission/custom-roles/available-permissions.md) para una lista y descripción de los permisos comunes.

### Grupos

Una lista (arreglo) de ID 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 ID 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/es/administracion-y-configuracion/permission/custom-roles.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
