Definir atributos personalizados para fluxos de inscrição de autoatendimento na ID Externa do Microsoft Entra

  • Artigo

Aplica-se a: Círculo verde com um símbolo de marca de seleção branco. Locatários da força de trabalho Círculo branco com um símbolo X cinza. Locatários externos (saiba mais)

Dica

Este artigo se aplica aos fluxos de usuário 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. A ID Externa do Microsoft Entra é fornecida com um conjunto interno de informações armazenadas nos atributos, como Nome, Sobrenome, Cidade e CEP. Com a ID Externa do Microsoft Entra, você pode estender o conjunto de atributos armazenados em uma conta de convidado quando o usuário externo se inscreve por um fluxo do 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 a API do Microsoft Graph. A API do Microsoft Graph dá suporte à criação e à atualização de um usuário com atributos de extensão. 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"

A <extensions-app-id> é específica para o seu locatário. Para encontrar esse identificador, navegue até Identidade>Aplicativos>Registros de aplicativo>Todos os 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

Dica

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

  1. Entre no centro de administração do Microsoft Entra como, no mínimo, Administrador de Usuários.

  2. Navegue até Identidade>Identidades Externas>Visão geral.

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

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

  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 de como incluir um atributo 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 que você cria um usuário por meio de um fluxo do 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 a API do Graph por meio do seu aplicativo para obter os dados desse atributo depois que ele for adicionado ao objeto do usuário.

Próximas etapas