Azure Active Directory B2C: usare attributi personalizzati per raccogliere informazioni sugli utentiAzure Active Directory B2C: Use custom attributes to collect information about your consumers

La directory Azure Active Directory (Azure AD) B2C viene fornita con un set predefinito di informazioni (attributi), ad esempio nome, cognome, città, codice postale e altri attributi.Your Azure Active Directory (Azure AD) B2C directory comes with a built-in set of information (attributes): Given Name, Surname, City, Postal Code, and other attributes. Tuttavia, ogni applicazione consumatori ha requisiti specifici relativi agli attributi da raccogliere.However, every consumer-facing application has unique requirements on what attributes to gather from consumers. Con Azure AD B2C, è possibile estendere il set di attributi archiviati in ogni account utente.With Azure AD B2C, you can extend the set of attributes stored on each consumer account. È possibile creare attributi personalizzati nel portale di Azure e usarli nei criteri di iscrizione, come illustrato di seguito.You can create custom attributes on the Azure portal and use it in your sign-up policies, as shown below. Questi attributi possono anche essere scritti e letti usando l' API Graph di Azure AD.You can also read and write these attributes by using the Azure AD Graph API.

Creare un attributo personalizzatoCreate a custom attribute

  1. Seguire questa procedura per passare al pannello delle funzionalità B2C nel portale di Azure.Follow these steps to navigate to the B2C features blade on the Azure portal.
  2. Fare clic su Attributi utente.Click User attributes.
  3. Fare clic su +Aggiungi nella parte superiore del pannello.Click +Add at the top of the blade.
  4. Fornire un Nome per l'attributo personalizzato (ad esempio, "ShoeSize") e, facoltativamente, una Descrizione.Provide a Name for the custom attribute (for example, "ShoeSize") and optionally, a Description. Fare clic su Crea.Click Create.

    Nota

    Come tipi di dati sono attualmente disponibili solo "String", "Boolean" e "Int".Only the "String", "Boolean" and "Int" Data Types are currently available.

L'attributo personalizzato è ora disponibile nell'elenco degli Attributi utentee per l'uso nei criteri di iscrizione.The custom attribute is now available in the list of User attributes, and for use in your sign-up policies.

Usare un attributo personalizzato nei criteri di iscrizioneUse a custom attribute in your sign-up policy

  1. Seguire questa procedura per passare al pannello delle funzionalità B2C nel portale di Azure.Follow these steps to navigate to the B2C features blade on the Azure portal.
  2. Fare clic su Criteri di iscrizione.Click Sign-up policies.
  3. Fare clic sul criterio di iscrizione (ad esempio, "B2C_1_SiUp") per aprirlo.Click your sign-up policy (for example, "B2C_1_SiUp") to open it. Fare clic su Modifica nella parte superiore del pannello.Click Edit at the top of the blade.
  4. Fare clic su Attributi iscrizione e selezionare l'attributo personalizzato (ad esempio, "ShoeSize").Click Sign-up attributes and select the custom attribute (for example, "ShoeSize"). Fare clic su OK.Click OK.
  5. Fare clic su Attestazioni applicazione e selezionare l'attributo personalizzato.Click Application claims and select the custom attribute. Fare clic su OK.Click OK.
  6. Fare clic su Salva nella parte superiore del pannello.Click Save at the top of the blade.

È possibile utilizzare la funzionalità "Esegui ora" nei criteri per verificare l'esperienza utente.You can use the "Run now" feature on the policy to verify the consumer experience. Ora si dovrebbe vedere "ShoeSize" nell'elenco di attributi che vengono raccolti durante l'iscrizione dell’utente e nel token inviato all'applicazione.You should now see "ShoeSize" in the list of attributes collected during consumer sign-up, and see it in the token sent back to your application.

NoteNotes

  • Insieme ai criteri di iscrizione, gli attributi personalizzati possono essere usati anche nei criteri di iscrizione o accesso e nei criteri di modifica del profilo.Along with sign-up policies, custom attributes can also be used in sign-up or sign-in policies and profile editing policies.
  • Esiste una limitazione nota degli attributi personalizzati.There is a known limitation of custom attributes. Si verifica solo la prima volta che viene usato in un criterio e non quando viene aggiunto all'elenco di Attributi utente.It is only created the first time it is used in any policy, and not when you add it to the list of User attributes.