Compartilhar via

Coletar atributos personalizados de usuário durante o registro de colaboração B2B

Aplica-se a: Círculo verde com um símbolo de marca de seleção branca que indica que o conteúdo a seguir se aplica aos locatários da força de trabalho. Locatários da força de trabalho (saiba mais)

Dica

Este artigo se aplica aos fluxos de usuários de colaboração B2B em inquilinos da força de trabalho. Para obter informações sobre locatários externos, consulte Coletar atributos de usuário personalizados durante a inscrição de locatário externo.

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

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

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

A <extensions-app-id> é específica para o seu locatário. Para encontrar esse identificador, navegue até Entra ID>App registrations>Todos aplicativos. Pesquise pelo 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).

Como criar um atributo personalizado

  1. Entre no Microsoft Entra admin center como pelo menos um Administrador de Usuário.

  2. Navegue até Entra ID>Identidades externas>Visão geral.

  3. Selecione Atributos de usuário personalizados. Os atributos de usuário disponíveis serão listados.

    Screenshot da página visão geral de identidades externas no Microsoft Entra admin center, com atributos de usuário personalizados selecionados.

  4. Para adicionar um atributo, selecione Adicionar.

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

    • Nome: forneça um nome para o atributo personalizado (por exemplo, "Tamanho do calçado").
    • Tipo de Dados: escolha um tipo de dados (cadeia de caracteres, booliano ou Int).
    • Descrição: opcionalmente, insira uma descrição do atributo personalizado para uso interno. Essa descrição não fica visível para o usuário.

    Captura de tela do painel Adicionar um atributo mostrando os campos Nome, Tipo de Dados e Descrição antes de criar um atributo de usuário personalizado.

  6. Selecione Criar.

Quando você adiciona um atributo personalizado à lista de atributos do usuário, ele fica disponível para uso nos fluxos de usuário. No entanto, o atributo só é criado na primeira vez em 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 o percurso de inscrição do objeto do usuário. Você pode chamar o Graph API de seu aplicativo para obter os dados desse atributo depois que ele for adicionado ao objeto de usuário.

Próximas etapas

  • Last updated on