> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Esquema

> El esquema detrás de cada perfil de usuario: los campos integrados, los atributos personalizados que defines y cómo los atributos alimentan los Auto Groups y las asignaciones de aplicaciones.

Cada perfil de usuario se configura según tu **esquema**: el conjunto de atributos que puede contener
un perfil. El esquema empieza con campos integrados que existen para todos, y
lo amplías con **atributos personalizados** adaptados a tu organización. El esquema se edita
desde **Directory → Users → Schema** (el control del esquema en la página Users es un botón de icono, no una etiqueta de texto).

Los atributos son más que almacenamiento. Son la materia prima a partir de la cual los
[Auto Groups](/es/identity/directory/auto-groups) calculan la pertenencia
y que las aplicaciones asignan a los datos de identidad que reciben, por lo que el esquema
que diseñes aquí determina el acceso y la automatización en todo Iru Identity.

<Frame caption="El editor User Schema: atributos integrados y personalizados con su slug, tipo e indicadores, agrupados en categorías.">
  <img src="https://mintcdn.com/iru/yv46VZ-WbN1GdStp/assets/media/images/user-schema.webp?fit=max&auto=format&n=yv46VZ-WbN1GdStp&q=85&s=374c27a7f249db7f8fa332ecb1964c26" alt="La página User Schema, que muestra la categoría Default con atributos como Domain, Username, Iru Role, Name y Email, cada uno con un slug, un tipo y las columnas Unique, Required y Auto Group." width="2000" height="1137" data-path="assets/media/images/user-schema.webp" />
</Frame>

## Campos integrados

Cada perfil incluye un conjunto de facetas integradas que no tienes que definir:

* **Nombre**, que se usa para crear el nombre visible del usuario.
* **Correos electrónicos**, **números de teléfono** y **direcciones**, cada entrada con una
  **etiqueta**, como trabajo o personal.
* Un **nombre de usuario** y un **dominio** que juntos forman el identificador de inicio de sesión.
* Un **rol**, un **estado** y un **origen**. El **rol** se aplica en todos los productos de Iru,
  no solo en Identity.

Se describen junto con el resto del perfil en
[Usuarios](/es/identity/directory/users).

<Note>
  **Admitir más de un dominio de correo electrónico.** El **dominio** que puede tener un usuario procede
  de una lista fija de valores permitidos en el campo de dominio integrado. Si tu
  organización usa varios dominios (por ejemplo, `example.com` y `example.io`),
  añade cada uno a esa lista en el esquema; solo se pueden elegir los dominios definidos ahí
  al crear o importar un usuario.
</Note>

## Atributos personalizados

Un atributo personalizado añade un campo a cada perfil de usuario. Cuando creas uno,
le asignas:

| Propiedad | Qué hace |
| - | - |
| **Display name** | La etiqueta legible que se muestra en el perfil. |
| **Slug** | Un identificador estable y apto para máquinas que se usa al asignar el atributo a aplicaciones y reglas. |
| **Type** | El tipo de valor que contiene, elegido entre los **tipos de atributo** que se indican a continuación. |
| **Descripción** | Orientación opcional que se muestra a los administradores que editan el perfil. |
| **Categoría** | La sección del perfil en la que aparece el atributo (consulta más abajo). |
| **Required** | Si está activado, no se puede guardar un perfil sin un valor para este atributo. |
| **Unique** | Si está activado, dos usuarios no pueden compartir el mismo valor para este atributo. |

<Frame caption="Añadir un atributo personalizado.">
  <img src="https://mintcdn.com/iru/yv46VZ-WbN1GdStp/assets/media/images/schema-add-attribute.webp?fit=max&auto=format&n=yv46VZ-WbN1GdStp&q=85&s=d1cd709823941a74f2e097f8f386453f" alt="El cuadro de diálogo Add Attribute con los campos Display Name, Slug y Description, los selectores Category y Type, y los interruptores Unique y Required." width="2000" height="1135" data-path="assets/media/images/schema-add-attribute.webp" />
</Frame>

<Note>
  Elige **required** y **unique** de forma deliberada. Un atributo obligatorio debe
  estar presente en todos los usuarios, incluidos los creados por importación o sincronización con RR. HH., por lo que un
  registro sin él no se podrá guardar. Un atributo único es adecuado para
  identificadores como un número de empleado.
</Note>

### Tipos de atributo

Cuando añades un atributo personalizado, eliges uno de estos tipos para el valor que
contiene:

| Tipo | Qué contiene |
| - | - |
| **String** | Texto libre. |
| **Integer** | Un número entero. |
| **Decimal** | Un número que puede tener parte fraccionaria. |
| **Boolean** | Un valor verdadero o falso. |
| **Enumeration** | Un valor elegido de una lista fija de opciones que defines (consulta más abajo). |
| **Date** | Un valor de fecha. |
| **Binary** | Un valor codificado en base64. |
| **JSON** | Un valor JSON estructurado, para datos anidados o compuestos. |

<Note>
  El tipo se elige al crear el atributo y **no se puede cambiar después**.
  **Unique** no está disponible para los atributos **Boolean** o **Enumeration**, cuyos
  valores están pensados para repetirse entre usuarios. Un valor **Binary** se almacena en base64
  y no tiene límite de tamaño, así que úsalo para valores **pequeños**, como un token o una clave,
  no para archivos grandes.
</Note>

### Atributos con un conjunto fijo de opciones

Algunos atributos solo deben aceptar valores de una lista conocida (un departamento, una
ubicación, un tipo de empleo). Para ellos, asigna al atributo una lista fija de
**valores permitidos** (opciones de enumeración). Cada opción tiene su propio nombre visible
e identificador.

Los atributos de opción fija son especialmente útiles porque combinan de forma natural con
los [Auto Groups](/es/identity/directory/auto-groups): cada valor permitido puede
convertirse en su propio grupo, con la pertenencia calculada automáticamente.

## Categorías

Los atributos se organizan en **categorías**, las secciones con nombre en las que se agrupa
un perfil, como "Employment" o "Contact". Cada categoría tiene un nombre
visible, un icono y una posición que controla su orden en el perfil. Agrupar
atributos relacionados mantiene legibles los perfiles largos y facilita el mantenimiento
del esquema.

<Frame caption="Añadir una categoría.">
  <img src="https://mintcdn.com/iru/yv46VZ-WbN1GdStp/assets/media/images/schema-add-category.webp?fit=max&auto=format&n=yv46VZ-WbN1GdStp&q=85&s=7e0973bc1aa36406e83acf65a1f1c572" alt="El cuadro de diálogo Add Category con los campos Display Name, Slug, Icon y Description." width="2000" height="1126" data-path="assets/media/images/schema-add-category.webp" />
</Frame>

## Cómo se usan los atributos

```mermaid theme={null}
flowchart LR
  attr["Atributo de perfil"]
  attr -->|"calcula la pertenencia de"| dyn["Auto Groups"]
  attr -->|"se asigna a"| apps["Inicio de sesión en aplicaciones<br/>(aserciones y tokens)"]
  attr -->|"puede ser una condición en"| pol["Políticas de autenticación"]
```

<CardGroup cols={2}>
  <Card title="Impulsar Auto Groups" icon="wand-magic-sparkles" href="/es/identity/directory/auto-groups">
    Marca un atributo para impulsar **Auto Groups**, e Iru convierte sus valores en
    grupos cuya pertenencia se actualiza a medida que cambian los perfiles.
  </Card>

  <Card title="Asignar a aplicaciones" icon="grip" href="/es/identity/applications/provisioning">
    Las aplicaciones asignan atributos de perfil a la aserción o al token que
    reciben, para que cada aplicación obtenga los datos de identidad que espera.
  </Card>
</CardGroup>

<Tip>
  Diseña el esquema antes de incorporar usuarios a gran escala. Decidir de antemano qué
  atributos son obligatorios, únicos y de opción fija hace que las importaciones y las sincronizaciones
  con RR. HH. se realicen sin problemas y que tus Auto Groups se comporten como esperas.
</Tip>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Crear Auto Groups" icon="wand-magic-sparkles" href="/es/identity/directory/auto-groups">
    Convierte un atributo en grupos que se mantienen solos.
  </Card>

  <Card title="Gestionar usuarios" icon="user" href="/es/identity/directory/users">
    Ve los atributos en acción en perfiles individuales.
  </Card>
</CardGroup>
