Atributos de perfil de utilizador

Aplica-se a: Inquilinos externos (saiba mais)

Os atributos de usuário coletados durante a inscrição são armazenados com o perfil do usuário em seu diretório. Você pode escolher entre atributos de usuário internos ou criar atributos de usuário personalizados.

• Atributos de usuário internos, como cidade, país/região, endereço de email e assim por diante, estão disponíveis na ID Externa do Microsoft Entra. Você pode escolher os atributos de usuário internos que deseja coletar durante a inscrição.

• Para qualquer informação adicional que você queira coletar, você pode criar atributos de usuário personalizados. Vários controles de entrada personalizados podem ser adicionados à página de inscrição para coletar os atributos, incluindo caixas de texto, botões de opção e caixas de seleção. O exemplo a seguir mostra como os controles de entrada personalizados podem ser usados para coletar atributos para número de fidelidade, consentimento de termos de uso para termos de uso e consentimento de política de privacidade.

  

Atributos de usuário internos

O Microsoft Entra External ID tem atributos de usuário internos que você pode coletar durante a inscrição. Você configura esses atributos quando cria fluxos de usuário no centro de administração do Microsoft Entra.

Esta tabela resume os atributos de usuário internos que você pode coletar durante o fluxo de inscrição:

• Rótulo no centro de administração do Microsoft Entra é o nome do atributo de usuário como ele aparece no centro de administração do Microsoft Entra.
• Nome programável é o nome do atributo de usuário usado no recurso de usuário da API do Microsoft Graph. Você usa esse nome quando deseja usar esse atributo de usuário programaticamente, como na autenticação nativa.
• Tipo de dados é o tipo de dados do atributo de usuário.

Atributos de usuário personalizados

Se seu aplicativo exigir mais informações do que os atributos de usuário internos fornecem, você poderá adicionar seus próprios atributos. Referimo-nos a esses atributos como atributos de usuário personalizados.

Para definir um atributo de usuário personalizado, primeiro crie o atributo no nível do locatário para que possa ser usado em qualquer fluxo de usuário no locatário. Em seguida, você atribui o atributo ao fluxo de usuário de inscrição e configura como deseja que ele apareça na página de inscrição.

Saiba como criar atributos de usuário personalizados Criar artigo de atributos de usuário personalizados .

Tipos de entrada de atributos de usuário personalizados

Antes de usar atributos de usuário personalizados, determine a melhor maneira de coletar a entrada do usuário para cada atributo personalizado que você deseja coletar. Você pode coletar informações de seus usuários durante a inscrição usando os seguintes controles de tipo de entrada:

• Caixa de texto String
• Botões de opção
• Caixas de seleção múltipla
• Caixa de texto numérica
• Caixa de seleção única

Consulte esta tabela para encontrar os tipos de dados apropriados e os tipos de entrada do usuário:

As caixas de seleção e os botões de opção podem incluir hiperlinks para outros conteúdos, como termos de utilização e política de privacidade. O exemplo no início deste artigo mostra uma página de inscrição que combina atributos internos e atributos personalizados. No exemplo:

• O campo Nome para Exibição é um atributo interno.
• O Número de Fidelidade é um atributo personalizado com um campo de entrada de forma livre que aceita um inteiro numérico. Você pode configurar esse formato usando o tipo de dados Int e o tipo de entrada de usuário NumericTextBox .
• Os atributos personalizados dos termos de uso e da política de privacidade são caixas de seleção separadas e de seleção única com rótulos contendo hiperlinks. Você pode configurar uma única caixa de seleção usando o tipo de dados booleano , que assume como padrão o tipo de entrada de usuário CheckboxSingleSelect . Use o idioma de marcação para adicionar hiperlinks ao rótulo da caixa de seleção.

Saiba como configurar seus tipos de entrada de atributos de usuário no artigo Configurar os tipos de entrada do usuário .

Onde os atributos de usuário personalizados são armazenados

Os atributos de usuário personalizados também são conhecidos como atributos de extensão de diretório porque estendem as informações de perfil de usuário armazenadas em seu diretório. Todos os atributos de extensão para seu locatário externo são armazenados em um aplicativo chamado b2c-extensions-app. Depois que um usuário insere um valor para o atributo personalizado durante a inscrição, ele é adicionado ao objeto de usuário e pode ser chamado por meio da API do Microsoft Graph usando a convenção extension_{appId-without-hyphens}_{custom-attribute-name} de nomenclatura onde:

• {appId-without-hyphens} é a versão simplificada do ID do cliente para a b2c-extensions-app.
• {custom-attribute-name} é o nome que você atribuiu ao atributo personalizado.

Por exemplo, se o ID do cliente do b2c-extensions-app for 2588a-bcdwh-tfeehj-jeeqw-ertc e o nome do atributo for:

• loyaltyNumber, em seguida, o atributo personalizado é nomeado comoextension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber.
• Número de fidelidade , em seguida, o atributo personalizado é nomeado comoextension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. Você remove o espaço e usa CamelCase para separar as palavras.

Use o artigo Localizar a ID da aplicação de extensões para saber como encontrar a ID da aplicação b2c-extensions-app registada no seu tenant externo.

Microsoft Graph APIs

Os atributos de usuário são chamados de atributos de fluxo de usuário no Microsoft Graph. Use o tipo de recurso identityUserFlowAttribute e seus métodos associados para gerenciar atributos de fluxo de usuário internos e personalizados.

Conteúdos relacionados

• Adicione atributos ao token de ID retornado ao seu aplicativo.

• Saiba mais sobre como criar um fluxo de usuários de inscrição e entrada para clientes.

• Construtor de atributos de autenticação nativa do SDK MSAL Android.