Attributi del profilo utente

Il profilo utente della directory di Azure Active Directory B2C (Azure AD B2C) include un set di attributi predefiniti, ad esempio nome, cognome, città, codice postale e numero di telefono. È possibile estendere il profilo utente con i dati dell'applicazione senza che sia necessario un archivio dati esterno.

L'API Microsoft Graph supporta la maggior parte degli attributi che è possibile usare con Azure Questo articolo descrive gli attributi del profilo utente supportati da Azure AD B2C. Annota anche gli attributi che Microsoft Graph non supporta e gli attributi dell'API Microsoft Graph che Azure AD B2C non deve usare.

È anche possibile integrare sistemi esterni. Ad esempio, è possibile usare Azure AD B2C per l'autenticazione, ma delegare a un database CRM (Customer Relationship Management) o di gestione della fedeltà clienti esterno come fonte autorevole di dati dei clienti. Per altre informazioni, vedere la soluzione Profilo remoto.

Tipo di risorsa utente Microsoft Entra

Il profilo utente della directory di Azure AD B2C supporta gli attributi del tipo di risorsa utente elencati nella tabella seguente. Essa fornisce le informazioni seguenti su ogni attributo:

• Nome dell'attributo usato da Azure AD B2C (seguito dal nome Microsoft Graph tra parentesi, se diverso)
• Tipo di dati dell'attributo
• Descrizione dell'attributo
• Indica se l'attributo è disponibile nel portale di Azure
• Indica se l'attributo può essere usato in un flusso utente
• Indica se l'attributo può essere usato in un profilo tecnico microsoft Entra ID personalizzato e in quale sezione (<InputClaims>, <OutputClaims> o <PersistedClaims>)

¹ Non supportato da Microsoft Graph
² Per altre informazioni, vedere Attributo numero di telefono MFA
³ Non deve essere usato con Azure AD B2C

Attributi obbligatori

Per creare un account utente nella directory di Azure AD B2C, specificare gli attributi necessari seguenti:

• Nome visualizzato

• Identità: con almeno un'entità (un account locale o federato).

• Profilo password: se si crea un account locale, specificare il profilo password.

Attributo del nome visualizzato

displayName è il nome da visualizzare in portale di Azure gestione utenti per l'utente e nel token di accesso restituito da Azure AD B2C all'applicazione. Questa proprietà è obbligatoria.

Attributo Identities

Un account cliente, che può essere un consumer, un partner o un cittadino, può essere associato a questi tipi di identità:

• Identità locale : il nome utente e la password vengono archiviati localmente nella directory di Azure AD B2C. Queste identità sono spesso dette "account locali".
• Identità federata : nota anche come account di social networking o aziendale , l'identità dell'utente viene gestita da un provider di identità federato come Facebook, Microsoft, ADFS o Salesforce.

Un utente con un account cliente può accedere con più identità. Ad esempio, nome utente, posta elettronica, ID dipendente, ID governo e altri. Un singolo account può avere più identità, sia locali che social, con la stessa password.

Nell'API Microsoft Graph le identità locali e federate vengono archiviate nell'attributo utente identities , che è di tipo objectIdentity. La identities raccolta rappresenta un set di identità usate per accedere a un account utente. Questa raccolta consente all'utente di accedere all'account utente con una delle identità associate. L'attributo identities può contenere fino a 10 oggetti objectIdentity . Ogni oggetto contiene le proprietà seguenti:

Il frammento JSON seguente mostra l'attributo Identityes , con un'identità dell'account locale con un nome di accesso, un indirizzo di posta elettronica come accesso e un'identità di social networking.

"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"
  }
]

Per le identità federate, a seconda del provider di identità, issuerAssignedId è un valore univoco per un determinato utente per ogni applicazione o account di sviluppo. Configurare i criteri di Azure AD B2C con lo stesso ID applicazione assegnato dal provider di social networking o da un'altra applicazione all'interno dello stesso account di sviluppo.

Proprietà del profilo password

Per un'identità locale, l'attributo passwordProfile è obbligatorio e contiene la password dell'utente. L'attributo forceChangePasswordNextSignIn indica se un utente deve reimpostare la password al successivo accesso. Per gestire una reimpostazione della password forzata, usare le istruzioni riportate in Configurare il flusso di reimpostazione della password forzata.

Per un'identità federata (social), l'attributo passwordProfile non è obbligatorio.

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

Attributo dei criteri password

I criteri password di Azure AD B2C (per gli account locali) si basano sui criteri di complessità della password complessa di Microsoft Entra ID. I criteri di iscrizione o di accesso e reimpostazione della password di Azure AD B2C richiedono questo livello di complessità della password complessa e non scadono le password.

Negli scenari di migrazione degli utenti, se gli account di cui si vuole eseguire la migrazione hanno un livello di complessità della password più debole rispetto al livello di complessità della password complessa applicato da Azure AD B2C, è possibile disabilitare il requisito di password complessa. Per modificare i criteri password predefiniti, impostare l'attributo passwordPolicies su DisableStrongPassword. È ad esempio possibile modificare la richiesta di creazione utente come segue:

"passwordPolicies": "DisablePasswordExpiration, DisableStrongPassword"

Attributo numero di telefono MFA

Quando si usa un telefono per l'autenticazione a più fattori (MFA), il telefono cellulare viene usato per verificare l'identità dell'utente. Per aggiungere un nuovo numero di telefono a livello di codice, aggiornare, ottenere o eliminare il numero di telefono, usare il metodo di autenticazione telefono dell'API Graph ms.

Nei criteri personalizzati di Azure AD B2C il numero di telefono è disponibile tramite strongAuthenticationPhoneNumber il tipo di attestazione.

Attributi di estensione

Ogni applicazione rivolta al cliente ha requisiti univoci per le informazioni da raccogliere. Il tenant di Azure AD B2C include un set predefinito di informazioni archiviate in proprietà, ad esempio nome, cognome e codice postale. Con Azure AD B2C è possibile estendere il set di proprietà archiviate in ogni account cliente. Per altre informazioni, vedere Aggiungere attributi utente e personalizzare l'input dell'utente in Azure Active Directory B2C

Gli attributi di estensione estendono lo schema degli oggetti utente nella directory. Gli attributi di estensione possono essere registrati solo su un oggetto applicazione anche se possono contenere dati per un utente. L'attributo di estensione è associato all'applicazione denominata b2c-extensions-app. Non modificare questa applicazione, perché viene usata da Azure AD B2C per l'archiviazione dei dati utente. È possibile trovare questa applicazione in Microsoft Entra Registrazioni app. Altre informazioni su Azure AD B2Cb2c-extensions-app.

Gli attributi di estensione nell'API Graph vengono denominati usando la convenzione extension_ApplicationClientID_AttributeName, dove:

• ApplicationClientID è l'ID applicazione (client) dell'applicazioneb2c-extensions-app. Informazioni su come trovare l'app delle estensioni.
• AttributeName è il nome dell'attributo di estensione.

L'ID applicazione (client) quando usato per creare il nome dell'attributo di estensione non include trattini. Ad esempio:

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

Quando si definisce un attributo in un'estensione dello schema, sono supportati i tipi di dati seguenti:

Passaggi successivi

Altre informazioni sugli attributi di estensione:

• Estensioni dello schema
• Definire attributi personalizzati