Atributos de perfil do usuário

O perfil de usuário do diretório Azure AD B2C (Azure Active Directory B2C) vem com um conjunto de atributos internos, como nome, sobrenome, cidade, CEP e número de telefone. Você pode estender o perfil do usuário com seus próprios dados de aplicativo sem exigir um armazenamento de dados externo.

A API do Microsoft Graph dá suporte à maioria dos atributos que você pode usar com o Azure Este artigo descreve atributos de perfil de usuário compatíveis com o Azure AD B2C. Ele também observa os atributos aos quais o Microsoft Graph não dá suporte e os atributos da API do Microsoft Graph que o Azure AD B2C não deve usar.

Você também pode integrar com sistemas externos. Por exemplo, você pode usar o Azure AD B2C para autenticação, mas delegar a um CRM (gerenciamento de relacionamento com o cliente) externo ou banco de dados de fidelidade do cliente como a fonte autoritativa dos dados do cliente. Para obter mais informações, consulte a solução de perfil remoto .

Tipo de recurso de usuário do Microsoft Entra

O perfil de usuário do diretório B2C do Azure AD dá suporte aos atributos de tipo de recurso de usuário listados na tabela abaixo. Ele fornece as seguintes informações sobre cada atributo:

• Nome do atributo usado pelo Azure AD B2C (seguido pelo nome do Microsoft Graph entre parênteses, se diferente)
• Tipo de dados do atributo
• Descrição do atributo
• Se o atributo está disponível no portal do Azure
• Se o atributo pode ser usado em um fluxo de usuário
• Se o atributo pode ser usado em um perfil técnico do Microsoft Entra ID de política personalizada, e em qual seção (<InputClaims>, <OutputClaims>ou <PersistedClaims>)

¹ Não há suporte para o Microsoft Graph
² Para obter mais informações, consulte o atributo de número de telefone MFA
³ Não deve ser usado com o Azure AD B2C

Atributos necessários

Para criar uma conta de usuário no diretório do Azure AD B2C, forneça os seguintes atributos necessários:

• Nome de exibição

• Identidades: com, pelo menos, uma entidade (uma conta local ou federada).

• Perfil de senha– Se você criar uma conta local, forneça o perfil de senha.

Atributo de nome de exibição

O displayName é o nome a ser exibido no gerenciamento de usuários no portal do Azure para o usuário, e no token de acesso que o Azure AD B2C retorna ao aplicativo. Essa propriedade é obrigatória.

Atributo de identidades

Uma conta de cliente, que pode ser consumidor, parceiro ou cidadão, pode ser associada a esses tipos de identidade:

• Identidade local – O nome de usuário e a senha são armazenados localmente no diretório do Azure AD B2C. Muitas vezes nos referimos a essas identidades como "contas locais".
• Identidade federada - Também conhecida como contas sociais ou empresariais , a identidade do usuário é gerenciada por um provedor de identidade federado como Facebook, Microsoft, ADFS ou Salesforce.

Um usuário com uma conta de cliente pode entrar com várias identidades. Por exemplo, nome de usuário, email, ID do funcionário, ID do governo e outros. Uma única conta pode ter várias identidades, locais e sociais, com a mesma senha.

Na API do Microsoft Graph, as identidades locais e federadas são armazenadas no atributo de usuário identities , que é do tipo objectIdentity. A identities coleção representa um conjunto de identidades usadas para entrar em uma conta de usuário. Essa coleção permite que o usuário entre na conta de usuário com qualquer uma de suas identidades associadas. O atributo de identidades pode conter até 10 objetos objectIdentity . Cada objeto contém as seguintes propriedades:

O snippet JSON a seguir mostra o atributo Identidades com uma identidade de conta local com um nome de login, um endereço de email como login, além de uma identidade social.

"identities": [
  {
    "signInType": "userName",
    "issuer": "contoso.onmicrosoft.com",
    "issuerAssignedId": "johnsmith"
  },
  {
    "signInType": "emailAddress",
    "issuer": "contoso.onmicrosoft.com",
    "issuerAssignedId": "jsmith@yahoo.com"
  },
  {
    "signInType": "federated",
    "issuer": "facebook.com",
    "issuerAssignedId": "5eecb0cd"
  }
]

Para identidades federadas, dependendo do provedor de identidade, o issuerAssignedId é um valor exclusivo para um determinado usuário por aplicativo ou conta de desenvolvimento. Configure a política do Azure AD B2C com a mesma ID de aplicativo que o provedor social ou outro aplicativo na mesma conta de desenvolvimento atribui.

Propriedade de perfil de senha

Para uma identidade local, o atributo passwordProfile é necessário e contém a senha do usuário. O forceChangePasswordNextSignIn atributo indica se um usuário deve redefinir a senha na próxima entrada. Para lidar com uma redefinição de senha forçada, use as instruções na configuração do fluxo de redefinição de senha forçada.

Para uma identidade federada (social), o atributo passwordProfile não é necessário.

"passwordProfile" : {
    "password": "password-value",
    "forceChangePasswordNextSignIn": false
  }

Atributo de política de senha

A política de senha do Azure AD B2C (para contas locais) baseia-se na política de força de senha forte da ID do Microsoft Entra. As políticas de inscrição ou entrada e redefinição de senha do Azure AD B2C exigem essa forte força de senha e não expiram senhas.

Em cenários de migração de usuário, se as contas que você deseja migrar tiverem uma força de senha mais fraca do que a forte força de senha imposta pelo Azure AD B2C, você poderá desabilitar o forte requisito de senha. Para alterar a política de senha padrão, defina o passwordPolicies atributo como DisableStrongPassword. Por exemplo, você pode modificar a solicitação de usuário criada da seguinte maneira:

"passwordPolicies": "DisablePasswordExpiration, DisableStrongPassword"

Atributo de número de telefone de MFA

Ao usar um telefone para MFA (autenticação multifator), o telefone celular é usado para verificar a identidade do usuário. Para adicionar um novo número de telefone programaticamente, atualizar, obter ou excluir o número de telefone, use o método de autenticação de telefone da API do MS Graph.

Nas políticas personalizadas do Azure AD B2C, o número de telefone está disponível por meio do strongAuthenticationPhoneNumber tipo de reivindicação.

Atributos de extensão

Cada aplicativo voltado para o cliente tem requisitos exclusivos para que as informações sejam coletadas. Seu locatário do Azure AD B2C é fornecido com um conjunto interno de informações armazenadas em propriedades, como Nome, Sobrenome e CEP. Com o Azure AD B2C, você pode estender o conjunto de propriedades armazenadas em cada conta de cliente. Para obter mais informações, consulte Adicionar atributos de usuário e personalizar a entrada do usuário no Azure Active Directory B2C

Os atributos de extensão estendem o esquema dos objetos de usuário no diretório. Os atributos de extensão só podem ser registrados em um objeto de aplicativo, mesmo que possam conter dados para um usuário. O atributo de extensão é anexado ao aplicativo chamado b2c-extensions-app. Não modifique esse aplicativo, pois ele é usado pelo Azure AD B2C para armazenar dados do usuário. Você pode encontrar esse aplicativo nos registros do Microsoft Entra App. Saiba mais sobre o Azure AD B2Cb2c-extensions-app.

Os atributos de extensão na API do Microsoft Graph são nomeados usando a convenção extension_ApplicationClientID_AttributeName, em que:

• ApplicationClientID é o ID do aplicativo (cliente) do b2c-extensions-app aplicativo. Saiba como localizar o aplicativo de extensões.
• O AttributeName é o nome do atributo de extensão.

A ID do aplicativo (cliente) quando usada para criar o nome do atributo de extensão não inclui hifens. Por exemplo:

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

Há suporte para os seguintes tipos de dados ao definir um atributo em uma extensão de esquema:

Conteúdo relacionado

Saiba mais sobre atributos de extensão:

• Extensões de esquema
• Definir atributos personalizados