Creare un flusso utente di iscrizione e accesso
Esercizio - Creare un flusso utente di iscrizione e accesso
Un flusso utente definisce la serie di passaggi di iscrizione seguiti dai clienti seguono e i metodi di accesso che possono usare, ad esempio indirizzo di posta elettronica e password, passcode monouso o account social di Google o Facebook. È anche possibile raccogliere informazioni dai clienti durante l'iscrizione selezionando tra una serie di attributi utente predefiniti o aggiungendo attributi personalizzati. Se si hanno più applicazioni da offrire ai propri clienti, è possibile creare più flussi utente.
Nota
Sarà necessario almeno il ruolo della directory Amministratore del flusso utente ID esterno per creare flussi di utenti.
Si desidera fornire un feedback? Saremmo felici di sapere come procede il progetto del modello di verifica. Ci piacerebbe sapere cosa ne pensi!
Per creare un flusso utente di iscrizione e accesso, accedere all'interfaccia di amministrazione di Microsoft Entra e passare a Identità>Identità esterne.
Nel menu selezionare Flussi utente. Selezionare quindi Nuovo flusso utente.
Nella pagina Crea immettere un Nome per il flusso utente (ad esempio "SignUpSignIn"). Quindi, in Provider di identità selezionare la casella di controllo Account di posta elettronica e quindi selezionare una di queste opzioni. Se sono stati configurati altri provider di identità, è possibile selezionarli.
In Attributi utente scegliere gli attributi da raccogliere dall'utente durante l’iscrizione. Selezionare Mostra più per scegliere dall'elenco completo degli attributi, tra cui Posizione, Nome visualizzato, Codice postale e altri ancora. Selezionare quindi Crea per creare il flusso utente.
Nell'elenco selezionare il flusso utente creato.
La procedura seguente attiva l'esperienza di iscrizione e accesso (il flusso utente) per gli utenti che visitano l'applicazione. Nel menu a sinistra selezionare Applicazioni in Usa.
Selezionare Aggiungi applicazione
Selezionare l'applicazione nell'elenco. In alternativa, usare la casella di ricerca per trovare l'applicazione, quindi selezionarla. Scegli Seleziona.
Ora l'applicazione è collegata al flusso utente. Selezionare Esegui flusso utente per visualizzare in anteprima l'esperienza.
Nel pannello Esegui flusso utente che si apre a destra, assicurarsi che siano selezionati l'Applicazione e l'URL di risposta corretti. Selezionare quindi Esegui flusso utente.
le due dipendenze nell'app. È stato creato correttamente un flusso utente ed è stata collegata un'applicazione.
1. Creare un flusso utente
Per creare un flusso utente, creare un oggetto flusso eventi di autenticazione del tipo specificato nel corpo della richiesta.
POST https://graph.microsoft.com/beta/identity/authenticationEventsFlows
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/authenticationEventsFlows/$entity",
"@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow",
"displayName": "Default sign-up and sign-in",
"description": "Woodgrove default sign-up and sign-in flow",
"priority": 500,
"conditions": {
"applications": {
"includeAllApplications": false
}
},
"onInteractiveAuthFlowStart": {
"@odata.type": "#microsoft.graph.onInteractiveAuthFlowStartExternalUsersSelfServiceSignUp",
"isSignUpAllowed": true
},
"onAuthenticationMethodLoadStart": {
"@odata.type": "#microsoft.graph.onAuthenticationMethodLoadStartExternalUsersSelfServiceSignUp",
"identityProviders": [
{
"@odata.type": "#microsoft.graph.builtInIdentityProvider",
"id": "EmailPassword-OAUTH"
}
]
},
"onAttributeCollection": {
"@odata.type": "#microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp",
"accessPackages": [],
"attributeCollectionPage": {
"customStringsFileId": null,
"views": [
{
"title": null,
"description": null,
"inputs": [
{
"attribute": "email",
"label": "Email Address",
"inputType": "text",
"defaultValue": null,
"hidden": true,
"editable": false,
"writeToDirectory": true,
"required": true,
"validationRegEx": "^[a-zA-Z0-9.!#$%&’'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*$",
"options": []
},
{
"attribute": "displayName",
"label": "Display Name",
"inputType": "text",
"defaultValue": null,
"hidden": false,
"editable": true,
"writeToDirectory": true,
"required": true,
"validationRegEx": "^.*",
"options": []
},
{
"attribute": "country",
"label": "Country/Region",
"inputType": "radioSingleSelect",
"defaultValue": null,
"hidden": false,
"editable": true,
"writeToDirectory": true,
"required": false,
"validationRegEx": "^.*",
"options": [
{
"label": "Australia",
"value": "au"
},
{
"label": "Spain",
"value": "es"
},
{
"label": "United States",
"value": "us"
}
]
},
{
"attribute": "city",
"label": "City",
"inputType": "text",
"defaultValue": null,
"hidden": false,
"editable": true,
"writeToDirectory": true,
"required": false,
"validationRegEx": "^.*",
"options": []
}
]
}
]
},
"attributes": [
{
"id": "email"
},
{
"id": "city"
},
{
"id": "country"
},
{
"id": "displayName"
}
]
},
"onUserCreateStart": {
"@odata.type": "#microsoft.graph.onUserCreateStartExternalUsersSelfServiceSignUp",
"userTypeToCreate": "member",
"accessPackages": []
}
}
1.1 Copiare l'ID del flusso utente
Dalla risposta copiare il valore di id del flusso utente. Ad esempio:
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/authenticationEventsFlows/$entity",
"@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow",
"id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"displayName": "Default sign-up and sign-in1",
"description": "Woodgrove default sign-up and sign-in flow",
...
}
2. Aggiungere l'applicazione al flusso utente
Per aggiungere o collegare un'applicazione a un flusso utente, usare la richiesta di Microsoft Graph seguente. Sostituire il valore di {user-flow-ID} con l'ID flusso utente. Sostituire il valore di {app-ID} con l'ID applicazione.
POST https://graph.microsoft.com/beta/identity/authenticationEventsFlows/{user-flow-ID}/conditions/applications/includeApplications
{
"@odata.type": "#microsoft.graph.authenticationConditionApplication",
"appId": "{app-ID}"
}