Attributi del profilo utente
Si applica a: 
Tenant della forza lavoro 
Tenant esterni (altre informazioni)
Gli attributi utente raccolti durante l'iscrizione vengono archiviati con il profilo dell'utente nella directory. È possibile scegliere tra attributi utente predefiniti o creare attributi utente personalizzati.
Gli attributi utente predefiniti, ad esempio città, Paese/area geografica, indirizzo di posta elettronica e così via, sono disponibili in Microsoft Entra External ID. È possibile scegliere gli attributi utente predefiniti da raccogliere durante l'iscrizione.
Per eventuali informazioni aggiuntive da raccogliere, è possibile creare attributi utente personalizzati. È possibile aggiungere diversi controlli di input personalizzati alla pagina di iscrizione per raccogliere gli attributi, incluse caselle di testo, pulsanti di opzione e caselle di controllo. L'esempio seguente illustra come usare i controlli di input personalizzati per raccogliere attributi per il numero di fedeltà, il consenso alle condizioni per l'utilizzo e il consenso all'informativa sulla privacy.
Attributi utente predefiniti
Microsoft Entra External ID include attributi utente predefiniti che è possibile raccogliere durante l'iscrizione. Questi attributi vengono configurati quando si creano flussi utente nell'interfaccia di amministrazione di Microsoft Entra.
Questa tabella riepiloga gli attributi utente predefiniti che è possibile raccogliere durante il flusso di iscrizione:
- L'etichetta nell'interfaccia di amministrazione di Microsoft Entra è il nome dell'attributo utente visualizzato nell'interfaccia di amministrazione di Microsoft Entra.
- Il nome programmabile è il nome dell'attributo utente usato nella risorsa utente dell'API Microsoft Graph. Questo nome viene usato quando si vuole usare questo attributo utente a livello di codice, ad esempio nell'autenticazione nativa.
- Il tipo di dati è il tipo di dati dell'attributo utente.
| Etichetta nell’interfaccia di amministrazione di Microsoft Entra | Nome programmabile | Tipo di dati | Osservazioni: |
|---|---|---|---|
| Città | city | String | La lunghezza massima consentita è di 128 caratteri. |
| Paese/area geografica | country | String | La lunghezza massima consentita è di 128 caratteri. |
| Nome visualizzato | displayName | String | La lunghezza massima consentita è di 256 caratteri. |
| Indirizzo di posta elettronica | posta elettronica | String | Questa proprietà non può contenere caratteri accenti. Nell'API di autenticazione nativa, a questo attributo si fa riferimento come nome utente. |
| Nome | givenName | String | La lunghezza massima consentita è di 64 caratteri. |
| Posizione | jobTitle | String | La lunghezza massima consentita è di 128 caratteri. |
| CAP | postalCode | String | La lunghezza massima consentita è di 40 caratteri. |
| Provincia | state | String | La lunghezza massima consentita è di 128 caratteri. |
| Indirizzo | streetAddress | String | La lunghezza massima è di 1024 caratteri. |
| Cognome | surname | String | La lunghezza massima consentita è di 64 caratteri. |
Attributi utente personalizzati
Se l'app richiede più informazioni rispetto agli attributi utente predefiniti, è possibile aggiungere attributi personalizzati. Questi attributi vengono indicati come attributi utente personalizzati.
Per definire un attributo utente personalizzato, creare prima l'attributo a livello di tenant in modo che possa essere usato in qualsiasi flusso utente nel tenant. Assegnare quindi l'attributo al flusso utente di iscrizione e configurare la modalità di visualizzazione nella pagina di iscrizione.
Informazioni su come creare attributi utente personalizzati Creare attributi utente personalizzati.
Tipi di input degli attributi utente personalizzati
Prima di usare attributi utente personalizzati, determinare il modo migliore per raccogliere l'input utente per ogni attributo personalizzato che si vuole raccogliere. È possibile raccogliere informazioni dagli utenti durante l'iscrizione usando i controlli del tipo di input seguenti:
- Casella di testo stringa
- Pulsanti di opzione
- Caselle di controllo a selezione multipla
- Casella di testo numerica
- Casella di controllo a selezione singola
Fare riferimento a questa tabella per trovare i tipi di dati e i tipi di input utente appropriati:
| Tipo di dati | Tipo di input utente | Descrizione |
|---|---|---|
| Stringa | TextBox | Campo di immissione testo in formato libero. |
| String | RadioSingleSelect | Serie di pulsanti di opzione con una sola selezione consentita. Il testo per i singoli pulsanti di opzione può includere collegamenti ipertestuali formattati nella lingua Markdown. |
| String | CheckboxMultiSelect | Serie di una o più caselle di controllo con più selezioni consentite. Il Testo per singole caselle di controllo può includere collegamenti ipertestuali formattati nel linguaggio Markdown. |
| Booleano | CheckboxSingleSelect | Casella di controllo booleana singola con un'etichetta. L’etichetta della casella di controllo può includere collegamenti ipertestuali formattati nel linguaggio Markdown. |
| Int | NumericTextBox | Voce integer in formato libero. |
Le caselle di controllo e i pulsanti di opzione possono includere collegamenti ipertestuali ad altri contenuti, ad esempio le condizioni per l'utilizzo e le informative sulla privacy. L'esempio all'inizio di questo articolo mostra una pagina di iscrizione che combina attributi predefiniti e attributi personalizzati. Nell'esempio:
- Il campo Nome visualizzato è un attributo predefinito.
- Il numero fedeltà è un attributo personalizzato con un campo di immissione in formato libero che accetta un numero intero numerico. È possibile configurare questo formato usando il tipo di dati Int e il tipo di input utente NumericTextBox.
- Gli attributi personalizzati condizioni per l'utilizzo e informativa sulla privacy sono caselle di controllo separate e a selezione singola con etichette contenenti collegamenti ipertestuali. È possibile configurare una singola casella di controllo usando il tipo di dati booleano che per impostazione predefinita è il tipo di input utente CheckboxSingleSelect. Usare il linguaggio Markdown per aggiungere collegamenti ipertestuali all'etichetta della casella di controllo.
Informazioni su come configurare i tipi di input degli attributi utente nell'articolo Configurare i tipi di input utente.
Posizione in cui vengono archiviati gli attributi utente personalizzati
Gli attributi utente personalizzati sono noti anche come attributi di estensione della directory poiché ampliano le informazioni del profilo utente archiviate nella directory. Tutti gli attributi di estensione per il tenant esterno vengono archiviati in un'app denominata b2c-extensions-app. Dopo che un utente immette un valore per l'attributo personalizzato durante l'iscrizione, viene aggiunto all'oggetto utente e può essere richiamato tramite l’API Microsoft Graph usando la convenzione di denominazione extension_{appId-without-hyphens}_{custom-attribute-name} dove:
{appId-without-hyphens}indica la versione rimossa dell'ID client per b2c-extensions-app.{custom-attribute-name}è il nome assegnato all'attributo personalizzato.
Ad esempio, se l'ID client di b2c-extensions-app è 2588a-bcdwh-tfeehj-jeeqw-ertc e il nome dell'attributo è:
- loyaltyNumber, quindi l'attributo personalizzato viene denominato come
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. - Numero fedeltà, quindi l'attributo personalizzato viene denominato
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. Rimuovere lo spazio e usare la notazione Camel per separare le parole.
Usare l'articolo Trovare l'ID applicazione per l'app Estensioni per informazioni su come trovare l'ID applicazione per b2c-extensions-app registrata nel tenant esterno.
API Microsoft Graph
Gli attributi utente vengono definiti attributi del flusso utente in Microsoft Graph. Usare il tipo di risorsa identityUserFlowAttribute e i relativi metodi associati per gestire gli attributi del flusso utente predefiniti e personalizzati.