Definir atributos personalizados para fluxos de utilizador

  • Artigo

Gorjeta

Este artigo se aplica a fluxos de usuário de colaboração B2B. Se o seu locatário estiver configurado para gerenciamento de identidade e acesso do cliente, consulte Coletar atributos de usuário durante a inscrição para clientes.

Para cada aplicativo, você pode ter requisitos diferentes para as informações que deseja coletar durante a inscrição. O Microsoft Entra External ID vem com um conjunto interno de informações armazenadas em atributos, como Nome Próprio, Sobrenome, Cidade e Código Postal. Com o Microsoft Entra External ID, você pode estender o conjunto de atributos armazenados em uma conta de convidado quando o usuário externo se inscrever por meio de um fluxo de usuário.

Você pode criar atributos personalizados no centro de administração do Microsoft Entra e usá-los em seus fluxos de usuário de inscrição de autoatendimento. Você também pode ler e gravar esses atributos usando a API do Microsoft Graph. A API do Microsoft Graph oferece suporte à criação e atualização de um usuário com atributos de extensão. Os atributos de extensão na API do Graph são nomeados usando a convenção extension_<extensions-app-id>_attributename. Por exemplo:

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

O <extensions-app-id> é específico para o seu inquilino. Para encontrar esse identificador, navegue até Registros de aplicativos de identidade>>Todos os>aplicativos. Procure o aplicativo que começa com "aad-extensions-app" e selecione-o. Na página Visão geral do aplicativo, anote a ID do aplicativo (cliente).

Criar um atributo personalizado

Gorjeta

As etapas neste artigo podem variar ligeiramente com base no portal a partir do qual você começou.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de Usuário.

  2. Navegue até Visão>geral de identidades>externas.

  3. Selecione Atributos personalizados do utilizador. São apresentados os atributos de utilizador disponíveis.

    Captura de tela mostrando a seleção de atributos de usuário personalizados para inscrição.

  4. Para adicionar um atributo, selecione Adicionar.

  5. No painel Adicionar um atributo, introduza os seguintes valores:

    • Nome - Forneça um nome para o atributo personalizado (por exemplo, "Tamanho do sapato").
    • Tipo de dados - Escolha um tipo de dados (String, Booleano ou Int).
    • Descrição – opcionalmente, introduza uma descrição do atributo personalizado, para utilização interna. Esta descrição não está visível para o utilizador.

    Captura de tela mostrando a adição de um atributo personalizado.

  6. Selecione Criar.

Quando você adiciona um atributo personalizado à lista de atributos de usuário, ele fica disponível para uso em seus fluxos de usuário. No entanto, o atributo só é criado na primeira vez que é usado em qualquer fluxo de usuário. Depois de criar um novo usuário por meio de um fluxo de usuário que inclui o atributo personalizado recém-adicionado, o objeto pode ser consultado no Microsoft Graph Explorer. Agora você deve ver ShoeSize na lista de atributos coletados durante a jornada de inscrição no objeto de usuário. Você pode chamar a API do Graph do seu aplicativo para obter os dados desse atributo depois que ele for adicionado ao objeto do usuário.

Próximos passos