Definir atributos personalizados para fluxos de utilizador
Gorjeta
Este artigo se aplica aos fluxos de usuários de colaboração B2B em locatários da força de trabalho. Para obter informações sobre locatários externos, consulte Coletar atributos de usuário durante a inscrição.
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.
Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de Usuário.
Navegue até Visão>geral de identidades>externas.
Selecione Atributos personalizados do utilizador. São apresentados os atributos de utilizador disponíveis.
Para adicionar um atributo, selecione Adicionar.
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.
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.