Atributos de perfil de usuario
Se aplica a: 
inquilinos de Workforce 
inquilinos externos (más información)
Los atributos de usuario que recopila durante el registro se almacenan con el perfil del usuario en el directorio. Puede elegir entre atributos de usuario integrados o crear atributos de usuario personalizados.
Los atributos de usuario integrados, como la ciudad, el país o la región, la dirección de correo electrónico, etc., están disponibles en Id. externa de Microsoft Entra. Puede elegir los atributos de usuario integrados que desea recopilar durante el registro.
Para obtener información adicional que quiera recopilar, puede crear atributos de usuario personalizados. Se pueden agregar varios controles de entrada personalizados a la página de registro para recopilar los atributos, incluidos los cuadros de texto, los botones de radio y las casillas. En el ejemplo siguiente se muestra cómo se pueden usar los controles de entrada personalizados para recopilar atributos para el número de fidelidad, el consentimiento de los términos de uso y el consentimiento de la directiva de privacidad.
Atributos de usuario integrados
La Id. externa de Microsoft Entra tiene atributos de usuario integrados que puede recopilar durante el registro. Estos atributos se configuran al crear flujos de usuario en el Centro de administración Microsoft Entra.
En esta tabla se resumen los atributos de usuario integrados que puede recopilar durante el flujo de registro:
- La etiqueta del Centro de administración Microsoft Entra es el nombre del atributo de usuario tal como aparece en el Centro de administración Microsoft Entra.
- El nombre programable es el nombre del atributo de usuario, tal y como se usa en el recurso de usuario de Microsoft Graph API. Use este nombre cuando quiera usar este atributo de usuario mediante programación, como en la autenticación nativa.
- El tipo de datos es el tipo de datos del atributo de usuario.
| Etiqueta en el Centro de administración Microsoft Entra | Nombre programable | Tipo de datos | Comentarios |
|---|---|---|---|
| City | city | Cadena | La longitud máxima es de 128 caracteres. |
| País/región | country | Cadena | La longitud máxima es de 128 caracteres. |
| Nombre | DisplayName | Cadena | La longitud máxima es de 256 caracteres. |
| Dirección de correo electrónico | Cadena | Esta propiedad no puede contener caracteres de acentuación. En la API de autenticación nativa, se hace referencia a este atributo como nombre de usuario. | |
| Nombre propio | givenName | Cadena | La longitud máxima es de 64 caracteres. |
| Puesto | jobTitle | Cadena | La longitud máxima es de 128 caracteres. |
| Código postal | postalCode | Cadena | La longitud máxima es de 40 caracteres. |
| Estado o provincia | state | Cadena | La longitud máxima es de 128 caracteres. |
| Dirección | streetAddress | Cadena | La longitud máxima es de 1024 caracteres. |
| Apellido | surname | Cadena | La longitud máxima es de 64 caracteres. |
Atributos de usuario personalizados
Si la aplicación requiere más información de la que proporcionan los atributos de usuario integrados, puede agregar sus propios atributos. Hacemos referencia a estos atributos como atributos de usuario personalizados.
Para definir un atributo de usuario personalizado, primero debe crear el atributo en el nivel de inquilino para que se pueda usar en cualquier flujo de usuario del inquilino. A continuación, asigne el atributo al flujo de usuario de registro y configure cómo desea que aparezca en la página de registro.
Obtenga información sobre cómo crear atributos de usuario personalizados en el artículo Crear atributos de usuario personalizados.
Tipos de entrada de atributos de usuario personalizados
Antes de usar atributos de usuario personalizados, determine la mejor manera de recopilar la entrada de usuario para cada atributo personalizado que quiera recopilar. Puede recopilar información de los usuarios durante el registro mediante los siguientes controles de tipo de entrada:
- Cuadro de texto de cadena
- Botones de radio
- Casillas de selección múltiple
- Cuadro de texto numérico
- Casilla de selección única
Consulte esta tabla para buscar los tipos de datos y tipos de entrada de usuario adecuados:
| Tipo de datos | Tipo de entrada de usuario | Descripción |
|---|---|---|
| Cadena | TextBox | Campo de entrada de texto de forma libre. |
| Cadena | RadioSingleSelect | Serie de botones de radio con solo una selección permitida. El texto de los botones de selección individuales puede incluir hipervínculos con formato en el lenguaje Markdown. |
| Cadena | CheckboxMultiSelect | Serie de una o varias casillas con varias selecciones permitidas. El texto de las casillas individuales puede incluir hipervínculos con formato en el lenguaje Markdown. |
| Booleano | CheckboxSingleSelect | Casilla booleana única con una etiqueta. La etiqueta de la casilla puede incluir hipervínculos con formato en el lenguaje Markdown. |
| Int | NumericTextBox | Entrada de número entero de forma libre. |
Las casillas y los botones de selección pueden incluir hipervínculos a otro contenido, como los términos de uso y las directivas de privacidad. El ejemplo al principio de este artículo muestra una página de registro que combina atributos integrados y atributos personalizados. En el ejemplo:
- El campo Nombre para mostrar es un atributo integrado.
- El número de fidelidad es un atributo personalizado con un campo de entrada de forma libre que acepta un entero numérico. Puede configurar este formato con el tipo de datos Int y el tipo de entrada de usuario NumericTextBox.
- Los atributos personalizados de los términos de uso y las directivas de privacidad son casillas independientes y de selección única con etiquetas que contienen hipervínculos. Puedes configurar una sola casilla usando el tipo de datos booleano, que tiene como valor predeterminado el tipo de entrada de usuario CheckboxSingleSelect. Usa el lenguaje Markdown para añadir hipervínculos a la etiqueta de la casilla.
Obtenga información sobre cómo configurar sus tipos de entrada de atributos de usuario en el artículo Configurar tipos de entrada de usuario.
Dónde se almacenan los atributos de usuario personalizados
Los atributos de usuario personalizados también se conocen como atributos de extensión de directorio porque amplían la información del perfil de usuario almacenada en el directorio de cliente. Todos los atributos de extensión del inquilino externo se almacenan en una aplicación denominada b2c-extensions-app. Después de que un usuario escriba un valor para el atributo personalizado durante el registro, se agrega al objeto de usuario y se puede llamar a través de Microsoft Graph API mediante la convención de nomenclatura extension_{appId-without-hyphens}_{custom-attribute-name} donde:
{appId-without-hyphens}es la versión quitada del identificador de cliente del b2c-extensions-app.{custom-attribute-name}es el nombre que asignó al atributo personalizado.
Por ejemplo, si el id. de cliente de b2c-extensions-app es 2588a-bcdwh-tfeehj-jeeqw-ertc y el nombre del atributo es:
- loyaltyNumber, entonces el atributo personalizado se denomina
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. - Número de fidelidad, entonces el atributo personalizado se denomina
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. Quite el espacio y use notación camello para separar las palabras.
Use el artículo Buscar el id. de aplicación para la aplicación de extensiones para saber cómo buscar el id. de aplicación para la b2c-extensions-app registrada en el inquilino externo.
Microsoft Graph API
Los atributos de usuario se conocen como atributos de flujo de usuario en Microsoft Graph. Use el tipo de recurso identityUserFlowAttribute y sus métodos asociados para administrar los atributos de flujo de usuario integrados y personalizados.
Contenido relacionado
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de