# Perfiles de usuario y atributos

Campos de perfil estándar, atributos de perfil personalizados y visibilidad.

El **perfil** de un usuario es el conjunto de campos que describen la cuenta. La plataforma incorpora un conjunto fijo de campos estándar y permite ampliar el perfil con **atributos personalizados** propios, definidos una sola vez de forma centralizada y asignados a los directorios que deban utilizarlos.

## Campos de perfil estándar

Cada directorio expone un conjunto común de campos estándar. Los más importantes son:

| Campo | Notas |
|---|---|
| **Correo electrónico** | Contacto principal y, en la mayoría de los directorios, el identificador de inicio de sesión. Puede verificarse. |
| **Nombre de usuario** | Identificador secundario opcional. |
| **Nombre completo** | Nombre, apellidos y, opcionalmente, un segundo nombre. |
| **Mobile** | Número de teléfono, utilizado para los factores por SMS; puede verificarse. Se admite un segundo número opcional. |
| **Título**, **Departamento**, **Nombre de la empresa** | Atributos laborales. El nombre de la empresa está desactivado de forma predeterminada y comparte su almacenamiento con el valor que entrega una sincronización de directorio. |
| Ubicación de la oficina, número de empleado, fecha de contratación | Atributos laborales adicionales, disponibles allí donde el directorio permite editar el perfil. |

Cada directorio controla, **por campo**, si está activado, si sirve como **identificador de inicio de sesión**, si es **obligatorio** y si aparece durante el **registro** (off / optional / required). Al menos un identificador debe estar siempre activo. Esto se configura en el propio directorio; consulte [Directorios de usuarios → Esquema de perfil](https://dts-identity.com/es/docs/directories/user-directories.md).

### Qué sistema es propietario de un campo

Que un campo de perfil pueda editarse en la consola depende del directorio:

- **Directorios locales**: aquí los campos siempre son editables. La plataforma es la fuente de verdad.
- **Directorios enterprise sincronizados**: la fuente Active Directory / LDAP anterior es la responsable de sus campos. En la consola son de **solo lectura**, salvo que la **sincronización ascendente (write-back)** esté activada para ese directorio; en ese caso, las modificaciones que realice aquí se escriben de vuelta en la fuente. Con el write-back desactivado, los campos del formulario se muestran pero están deshabilitados.

Esto está directamente ligado a los conmutadores de activado / obligatorio por campo y al ajuste de sincronización ascendente del directorio; consulte [Directorios de usuarios → Sincronización](https://dts-identity.com/es/docs/directories/user-directories.md).

En los directorios **AD/LDAP**, el perfil expone los identificadores propios del directorio, **common name**, **organizational unit** (elegida en un selector de OU) y **user principal name**, en lugar de la edición libre del correo electrónico y del nombre de usuario.

### Datos de perfil frente a datos que otorgan acceso

Un perfil contiene dos clases de datos, y la diferencia decide quién puede editar un campo:

- Los **datos de perfil** describen a la persona y cambian con su vida, no con su acceso: nombre para mostrar, número de teléfono, idioma preferido, ubicación de la oficina, talla de camiseta para el kit de bienvenida. Allí donde un directorio permite el autoservicio, **los usuarios mantienen ellos mismos estos campos**.
- Los **datos que otorgan acceso** son todo aquello que un sistema lee para decidir qué puede hacer la persona: la pertenencia a grupos, los roles, el estado de la cuenta, el centro de coste o el departamento cuando una app deriva permisos de ellos, un número de cliente en el que una aplicación confía. Un campo así **nunca** se abre al autoservicio: un valor que el usuario puede cambiar es un valor que el usuario puede concederse a sí mismo. Manténgalo controlado por el administrador o sincronizado desde el sistema propietario.

Que un atributo salga de la plataforma se decide **por aplicación**, en la pestaña **Atributos** de la aplicación: una aplicación OIDC selecciona los atributos personalizados que recibe como claims, y una aplicación SAML o WS-Federation los asigna a sus declaraciones de atributos. Definir un atributo, por tanto, nunca lo expone por sí solo. Trate todo lo que acaba en un token o en una Assertion como datos operativos: emita solo lo que la aplicación receptora necesita y no exponga nunca valores internos o sensibles por esta vía.

## Atributos de perfil personalizados

> **Nota:** Los atributos de perfil personalizados forman parte de la función **profile metadata**, disponible a partir del nivel Advanced (y durante el Trial).

Cuando los campos estándar no bastan, defina un **atributo personalizado**. Los atributos personalizados se crean una sola vez en un catálogo central y después se **asignan a cada directorio** que deba recogerlos. Este modelo de dos pasos mantiene una única definición coherente entre directorios y, al mismo tiempo, deja que cada directorio decida si el campo es obligatorio y si aparece en el registro.

### Definir un atributo personalizado

Los atributos personalizados se gestionan en el área de directorios, en la página **Atributos**.

1. Abra **Atributos** y elija añadir un atributo nuevo.
2. Asígnele un **nombre** (el identificador estable) y una **etiqueta** (lo que ven usuarios y administradores). Los nombres de los campos de perfil estándar y los nombres de los claims utilizados en los tokens emitidos (por ejemplo `email`, `title`, `mobile`, `groups` o `sub`) están **reservados**, con independencia de las mayúsculas y minúsculas: un atributo personalizado con uno de esos nombres parecería el campo estándar pero contendría datos distintos, por lo que se rechaza su creación. Elija en su lugar un nombre propio, como `jobRole` en lugar de `title`.
3. Elija un **tipo**:

   | Tipo | Se usa para |
   |---|---|
   | **Text** | Texto libre y breve. |
   | **Number** | Valores numéricos. |
   | **Date** | Fechas de calendario. |
   | **Select** / **Choice** | Una lista fija de opciones que usted define (valor y etiqueta). |
   | **Password** | Un valor secreto. |

4. De forma opcional, configure:
   - **Descripción**: texto libre que se muestra como indicación debajo del campo, en el registro y en el perfil, exactamente como se introdujo (no se traduce).
   - **Multiple values**: permite que el campo contenga una lista.
   - **Valor predeterminado**.
   - **Uniqueness**: de forma predeterminada, el valor de un atributo debe ser único entre todas las cuentas (dos usuarios no pueden compartirlo, por ejemplo un número de empleado). Active **Permitir duplicados** para levantar esa restricción y permitir que varias cuentas tengan el mismo valor.
   - **Maintained via API only**: el valor se muestra, pero no puede editarse manualmente ni en el perfil del usuario ni en la Admin Console; solo lo escribe la API de gestión (una integración o una sincronización). Un atributo así tampoco se recoge nunca en el registro.
5. Establezca la **visibilidad** (véase más abajo) y guarde.

Todos los atributos personalizados pueden filtrarse a través de la API de gestión; el índice que sustenta esas consultas se mantiene de forma automática.

### Partir de una plantilla

Las plantillas cubren atributos que casi todos los tenants necesitan de todos modos, como el tamaño de la empresa, el centro de coste, el tipo de contratación o la fecha de incorporación. Elija una en **Attribute template** y el nombre, el tipo y las opciones se rellenan previamente, junto con una etiqueta. Nada queda vinculado a la plantilla: todos los valores son editables y el resultado se comporta exactamente igual que un atributo definido desde cero.

Las plantillas también vienen traducidas. Una etiqueta tomada de una plantilla se muestra a cada usuario en su propio idioma, de modo que un usuario alemán lee "Unternehmensgröße" donde un usuario inglés lee "Company size". Después de elegir una plantilla, el campo **Etiqueta** muestra el texto de referencia en inglés, porque es a partir de ese texto como se busca la traducción. Déjelo tal cual para conservar las traducciones.

Una etiqueta que escriba usted mismo se muestra a todo el mundo exactamente como la introdujo, en todos los idiomas. Lo mismo se aplica a una etiqueta de plantilla que modifique después, así que cámbiela solo si prefiere su propia formulación a las traducciones. Las etiquetas de opción de un atributo de tipo select siguen la misma regla.

### Visibilidad

La visibilidad controla dónde se muestra el atributo y quién puede editarlo:

| Visibilidad | Comportamiento |
|---|---|
| **Solo API** | No se muestra ni en el perfil ni en la Admin Console. Se establece a través de la API, o se recoge una sola vez en el registro cuando un directorio lo solicita. |
| **Consola de administración** | Visible y editable en la Admin Console, no para el usuario final. |
| **Consola de administración + perfil de usuario** | Además se muestra al usuario en su perfil, donde puede editarlo por sí mismo. |

> **Nota:** En cuanto un atributo está **asignado a cualquier directorio**, su visibilidad queda **bloqueada** y el atributo no puede eliminarse hasta que se retire su asignación en todas partes. Esto protege los registros de usuario existentes y la representación del registro y del perfil frente a desviaciones respecto de la definición.

### Asignar a un directorio

Cualquier atributo personalizado puede asignarse a un directorio, con lo que queda disponible en los usuarios de ese directorio. Dónde se establece el valor depende de la visibilidad:

- un atributo con **Consola de administración + perfil de usuario** aparece en el perfil del usuario y, donde esté activado, en el registro; el usuario puede rellenarlo;
- un atributo **Consola de administración** aparece en esos usuarios en la Admin Console, para que lo establezca usted; no se muestra al usuario;
- un atributo **Solo API** se establece a través de la API y no se muestra ni en el perfil ni en la Admin Console. Utilícelo para un valor que consuma una aplicación (por ejemplo, un atributo SAML) y que mantenga una integración en lugar de una persona.

En la configuración de atributos del directorio elige, por atributo, si aparece en el **registro** (allí opcional u obligatorio) y si es **obligatorio** en el perfil. La recogida en el registro es independiente de la visibilidad: un atributo **Consola de administración** u **Solo API** que se solicita en el registro lo rellena una sola vez la persona que se registra y después solo es legible allí donde su visibilidad lo permite. Utilice esto para datos que necesita en el registro pero que el usuario no debe volver a consultar, como un código de recomendación o un centro de coste. Un atributo con **Maintained via API only** no puede recogerse en el registro, ya que la persona que se registra nunca podría rellenar su campo. El ajuste **obligatorio** se aplica allí donde el atributo se muestra para su edición.

La propia definición también puede editarse desde esta pestaña: **Añadir atributo → Create new attribute** crea un atributo nuevo y lo asigna al directorio de inmediato, y **Edit attribute**, en el menú de acciones de una fila, abre el diálogo de definición (etiqueta, tipo, opciones, ajustes). **Configurar** sigue siendo el lugar para los ajustes de recogida por directorio descritos más arriba.

El orden de la lista es el orden de presentación: el registro, el perfil del usuario y la página de detalle del usuario muestran los atributos exactamente como se hayan ordenado aquí. Arrastre el asa situada a la derecha de una fila para reordenarlos.

## Véase también

- [Personas](https://dts-identity.com/es/docs/directories/people.md): dónde se editan los campos de perfil de un usuario.
- [Directorios de usuarios](https://dts-identity.com/es/docs/directories/user-directories.md): configuración de campos y ajustes de registro por directorio.
- [Planes y add-ons](https://dts-identity.com/es/docs/getting-started/plans-and-addons.md): disponibilidad de funciones por nivel.
