Skip to Content

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:

CampoNotas
Correo electrónicoContacto principal y, en la mayoría de los directorios, el identificador de inicio de sesión. Puede verificarse.
Nombre de usuarioIdentificador secundario opcional.
Nombre completoNombre, apellidos y, opcionalmente, un segundo nombre.
MobileNú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 empresaAtributos 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ónAtributos 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.

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.

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:

    TipoSe usa para
    TextTexto libre y breve.
    NumberValores numéricos.
    DateFechas de calendario.
    Select / ChoiceUna lista fija de opciones que usted define (valor y etiqueta).
    PasswordUn 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:

VisibilidadComportamiento
Solo APINo 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ónVisible y editable en la Admin Console, no para el usuario final.
Consola de administración + perfil de usuarioAdemá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

En esta página