Condividi tramite

Definire attributi personalizzati per i flussi di iscrizione self-service in Microsoft Entra per ID esterno

  • Articolo

Si applica a: cerchio verde con un simbolo di segno di spunta bianco. Tenant della forza lavoro Cerchio bianco con un simbolo X grigio. Tenant esterni (altre informazioni)

Suggerimento

Questo articolo si applica ai flussi utente di Collaborazione B2B nei tenant delle risorse. Per informazioni sui tenant esterni, consultare Raccogliere gli attributi utente durante la registrazione.

È possibile definire requisiti diversi per le informazioni da raccogliere durante l'iscrizione alle singole applicazioni. Microsoft Entra per ID esterno include un set predefinito di informazioni archiviate in attributi, ad esempio nome, cognome, città e codice postale. Con Microsoft Entra per ID esterno è possibile estendere il set di attributi archiviati in un account guest quando l'utente esterno si iscrive tramite un flusso utente.

È possibile creare attributi personalizzati nell'interfaccia di amministrazione di Microsoft Entra e usarli nei flussi utente di iscrizione self-service. È anche possibile leggere e scrivere questi attributi usando l'API Microsoft Graph. L'API Microsoft Graph supporta la creazione e l'aggiornamento di un utente con attributi di estensione. Gli attributi di estensione nell'API Graph vengono denominati usando la convenzione extension_<extensions-app-id>_attributename. Ad esempio:

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

<extensions-app-id> è specifico del tenant. Per trovare questo identificatore, passare a Entra ID>Registrazioni delle app>Tutte le applicazioni. Cercare l'app che inizia con "aad-extensions-app" e selezionarla. Nella pagina Panoramica dell'app prendere nota dell'ID applicazione (client).

Creare un attributo personalizzato

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un amministratore utente.

  2. Passare a Entra ID>Identità Esterne>Panoramica.

  3. Selezionare Attributi utente personalizzati. Sono elencati gli attributi utente disponibili.

    Screenshot della selezione degli attributi utente personalizzati per l'iscrizione.

  4. Per aggiungere un attributo, selezionare Aggiungi.

  5. Nel riquadro Aggiungi un attributo immettere i valori seguenti:

    • Nome : specificare un nome per l'attributo personalizzato, ad esempio "Dimensioni scarpe".
    • Tipo di dati : scegliere un tipo di dati (String, Boolean o Int).
    • Descrizione : immettere facoltativamente una descrizione dell'attributo personalizzato per l'uso interno. Questa descrizione non è visibile all'utente.

    Screenshot dell'aggiunta di un attributo personalizzato.

  6. Selezionare Crea.

Quando si aggiunge un attributo personalizzato all'elenco di attributi utente, tale attributo diventa disponibile per l'uso nei flussi utente. Tuttavia, l'attributo viene creato solo la prima volta che viene usato in qualsiasi flusso utente. Dopo aver creato un nuovo utente tramite un flusso utente che include l'attributo personalizzato appena aggiunto, è possibile eseguire query sull'oggetto in Microsoft Graph Explorer. Si dovrebbe ora vedere ShoeSize nell'elenco degli attributi raccolti durante il percorso di iscrizione sull'oggetto utente. È possibile chiamare l'API Graph dall'applicazione per ottenere i dati da questo attributo dopo l'aggiunta all'oggetto utente.

Passaggi successivi