Recopilación de atributos de usuario personalizados durante el registro

Se aplica a: Inquilinos del personal Inquilinos externos (más información)

Si la aplicación requiere más información de la que proporcionan los atributos de usuario integrados, puede agregar sus propios atributos. Nos referimos 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 más información sobre los atributos de usuario personalizados en el artículo Atributos de perfil de usuario.

Creación de atributos de usuario personalizados

1. Inicie sesión en el Centro de administración de Microsoft Entra.

2. Si tiene acceso a varios inquilinos, use el icono Configuración del menú superior para cambiar al inquilino externo desde el menú Directorios y suscripciones.

3. Vaya a Entra ID>Identidades Externas>Información General.

4. Seleccione Atributos de usuario personalizados. La lista contiene todos los atributos de usuario disponibles en el inquilino, incluidos los atributos de usuario personalizados que se han creado. La columna Tipo de atributo indica si un atributo está integrado o personalizado.

5. Seleccione Agregar. En el panel Agregar un atributo , escriba un nombre para el atributo personalizado (por ejemplo, "Términos de uso").

6. En Tipo de datos, elija String, Boolean o Int en función del tipo de datos y el control de entrada de usuario que quiera crear. Los atributos de cadena tienen un valor de tipo de entrada de usuario predeterminado de TextBox, pero puede cambiarlo en un paso posterior (por ejemplo, si desea configurar botones de radio o casillas de selección múltiple).

7. (Opcional) En Descripción, escriba una descripción del atributo personalizado para uso interno. Esta descripción no es visible para el usuario.

   

8. Seleccione Crear. El atributo personalizado ya está disponible en la lista de atributos de usuario y se puede agregar a los flujos de usuario.

Incluir el atributo de usuario personalizado en un flujo de registro

Siga estos pasos para agregar atributos personalizados de usuario a un flujo de usuario que ya ha creado. (Si necesita crear un nuevo flujo de usuario, consulte Creación de un flujo de usuario de registro e inicio de sesión para los clientes).

1. Inicie sesión en el Centro de administración de Microsoft Entra.

2. Si tiene acceso a varios inquilinos, use el icono Configuración del menú superior para cambiar al inquilino externo desde el menú Directorios y suscripciones.

3. Vaya a Entra ID>Identidades externas>Flujos de usuario.

4. Seleccione el flujo de usuario de la lista.

5. Seleccione Atributos de usuario. La lista incluye los atributos personalizados de usuario que haya definido como se describe en la sección anterior. Por ejemplo, el nuevo atributo Términos de uso aparece ahora en la lista. Elija todos los atributos que quiere recopilar del usuario durante el registro.

   

6. Seleccione Guardar.

Configurar los tipos de entrada de usuario y el diseño de página

En la página Diseño de página, puede indicar qué atributos son necesarios y organizar el orden de presentación. También puede editar etiquetas de atributo, crear botones de radio o casillas y agregar hipervínculos a más contenido (como las condiciones de uso o la directiva de privacidad).

1. Inicie sesión en el Centro de administración de Microsoft Entra.

2. Vaya a Entra ID>Identidades externas>Flujos de usuario.

3. En la lista, seleccione el flujo de usuario.

4. En Personalizar, seleccione Diseños de página. Aparecen los atributos que eligió recopilar.

5. Edite la etiqueta de cualquier atributo seleccionando el valor de la columna Etiqueta y modificando el texto.

6. Configurar casillas o botones de selección:

   • Casilla de selección única: un tipo de atributo booleano se representa como una casilla de selección única en la página de registro. Para configurar el texto que se muestra junto a la casilla, seleccione y edite el valor en la columna Etiqueta . Use el lenguaje Markdown para agregar hipervínculos. Para obtener más información, consulte Para configurar una casilla de selección única (CheckboxSingleSelect)
   • Casillas de selección múltiple: busque el atributo tipo de datos String que desea configurar y seleccione el valor de la columna Tipo de entrada de usuario para abrir el panel del editor. Elija el tipo de entrada de usuario CheckboxMultiSelect y escriba los valores. Para obtener más información, vea Configurar casillas de selección múltiple (CheckboxMultiSelect)..
   • Botones de radio: busque el atributo tipo de datos String que desea configurar y seleccione el valor de la columna Tipo de entrada de usuario para abrir el panel del editor. Elija el tipo de entrada RadioSingleSelect y escriba los valores. Para obtener más información, consulte Para configurar botones de radio (RadioSingleSelect)

7. Cambie el orden de presentación seleccionando un atributo y seleccionando Subir, Bajar, Mover a la parte superior o Mover a la parte inferior.

8. Haga que un atributo sea necesario activando la casilla de la columna Requerido . Todos los atributos pueden marcarse como obligatorios. Para las casillas de selección múltiple, "Obligatorio" significa que el usuario debe seleccionar al menos una casilla.

9. Cuando se completen todos los cambios, seleccione Guardar.

Configurar una casilla de selección única (CheckboxSingleSelect)

Un atributo con un tipo de datos booleano tiene un tipo de entrada de usuario de CheckboxSingleSelect. Puedes modificar el texto que se muestra junto a la casilla e incluir hipervínculos.

Para configurar una casilla de selección única, siga estos pasos:

1. En la página Diseños de página, busque el atributo con el tipo de datos Boolean que desea configurar.

2. Seleccione el valor de la columna Etiqueta y escriba el texto que desea mostrar junto a la casilla. Use el lenguaje Markdown para agregar hipervínculos. Por ejemplo:

   • Para configurar la etiqueta para un atributo Terms of use , puede escribir:

     I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use).

   • O bien, puedes combinar los términos de uso y la directiva de privacidad en una sola casilla necesaria:

     I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use) and the [privacy policy](https://woodgrove.com/privacy).

3. Seleccione Aceptar.

   

4. En la página Diseños de página, seleccione Guardar.

Configurar casillas de selección múltiple (CheckboxMultiSelect)

Un atributo con un tipo de datos String se puede configurar como un tipo de entrada de usuario CheckboxMultiSelect, que es una serie de una o varias casillas que aparecen bajo la etiqueta de atributo. El usuario puede seleccionar una o varias casillas. Puedes definir el texto de casillas individuales e incluir hipervínculos a otros contenidos. Hacer que este atributo sea "Obligatorio" significa que el usuario debe seleccionar al menos una de las casillas.

1. En la página Diseños de página, busque el atributo con el tipo de datos String que desea configurar como una serie de casillas.

2. Seleccione el valor de la columna Etiqueta y escriba el encabezado que desea mostrar encima de la serie de casillas, por ejemplo How did you hear about us?.

3. Seleccione el valor de la columna Tipo de entrada de usuario para abrir el panel del editor.

4. En el panel del editor, en Tipo de entrada de usuario, seleccione CheckboxMultiSelect.

5. Para cada casilla que quieras agregar, crea una nueva línea y escribe la siguiente información:

   • En Texto, escriba el texto que desea mostrar junto a la casilla. Use el lenguaje Markdown para agregar hipervínculos.

   • En Valores, escriba un valor que se escribirá en el objeto de usuario y se devolverá como notificación si el usuario activa la casilla.

6. Seleccione Aceptar.

   

7. En la página Diseños de página, seleccione Guardar.

Configurar botones de radio (RadioSingleSelect)

Un atributo con un tipo de datos String se puede configurar como un tipo de entrada de usuario RadioSingleSelect, que es una serie de botones de radio que aparecen bajo la etiqueta de atributo. El usuario solo puede seleccionar un botón de radio. Puedes definir el texto para botones de selección individuales e incluir hipervínculos a otros contenidos.

1. En la página Diseños de página, busque el atributo con el tipo de datos String que desea configurar como un botón de radio o una serie de botones de radio.

2. Seleccione el valor de la columna Etiqueta y escriba el encabezado que desea mostrar encima de la serie de botones de radio, por ejemplo Sweatshirt size.

3. Seleccione el valor de la columna Tipo de entrada de usuario para abrir el panel del editor.

4. En el panel del editor, en Tipo de entrada de usuario, seleccione RadioSingleSelect.

5. Para cada botón de selección que quieras agregar, crea una nueva línea y escribe la siguiente información:

   • En Texto, escriba el texto que desea mostrar junto al botón de radio. Use el lenguaje Markdown para agregar hipervínculos.

   • En Valores, escriba un valor que se registrará en el objeto de usuario y se devolverá como el reclamo si el usuario selecciona el botón de radio.

6. Seleccione Aceptar.

   

7. En la página Diseños de página, seleccione Guardar.

Configurar la visibilidad y la editabilidad de los atributos con Microsoft Graph

Puede controlar qué atributos se muestran o recopilan de los usuarios durante el registro configurando las marcas ocultas y editables para cada atributo. Estas opciones no están disponibles actualmente en la interfaz de usuario del Centro de administración, pero puede configurarlas con Microsoft Graph.

Cada atributo admite las marcas siguientes:

• hidden: esta marca es false de forma predeterminada, por lo que el atributo se muestra en la página de registro, pero puede establecerlo en true para ocultar el atributo.
• editable: esta marca es true de forma predeterminada para permitir que los usuarios editen el atributo, pero puede establecerla en false para que el atributo sea de solo lectura.

Ejemplos:

• Para mostrar el atributo en la página, pero evitar que los usuarios lo editen, establezca hidden en false y editable en false .
• Para ocultar el atributo de la página mientras se permite establecer mediante programación, establezca en hiddentrue y editable en true. Por ejemplo, puede asignar un valor al atributo creando una extensión de autenticación personalizada para un evento de envío de colección de atributos.

Para establecer las marcas ocultas y editables mediante Microsoft Graph, use el tipo de recurso authenticationAttributeCollectionInputConfiguration . Para obtener referencia, consulte el ejemplo sobre cómo actualizar el diseño de página de un flujo de usuario de registro de autoservicio.

Búsqueda del identificador de aplicación de la aplicación de extensiones

Los atributos de usuario personalizadosse 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 eliminada del identificador de cliente para b2c-extensions-app.
• {custom-attribute-name} es el nombre que asignó al atributo personalizado.

Siga estos pasos para buscar el identificador de aplicación de la aplicación de extensiones:

1. Inicie sesión en el Centro de administración de Microsoft Entra.
2. Vaya a Entra ID>Registros de aplicaciones>Todas las aplicaciones.
3. Seleccione la aplicación b2c-extensions-app. No modifique. Usado por AADB2C para almacenar datos de usuario.
4. En la página Información general, use el valor de ID de aplicación (cliente), por ejemplo: 12345678-abcd-1234-1234-ab123456789, pero quite los guiones.

Por ejemplo, si crea un atributo personalizado denominado loyaltyNumber, haga referencia a él como extension_12345678abcd12341234ab123456789_loyaltyNumber

Adición de atributos de usuario personalizados al token de identificador

Cuando los usuarios inician sesión en la aplicación, la aplicación recibe un token de identificador, que incluye los detalles del usuario. Estos detalles se denominan notificaciones de token. Si es necesario, puede incluir un atributo de usuario personalizado para que esté disponible como una notificación en el token de identificador que se devuelve a la aplicación. Para ello, siga los pasos descritos en El artículo Incorporación de atributos al token de identificador devuelto a la aplicación .

Pasos siguientes

Agregue atributos al token de identificador devuelto a la aplicación.

Cree un flujo de usuario de registro e inicio de sesión para los clientes.