Criar um fluxo de usuário de inscrição e de entrada
Exercício - Criar um fluxo de usuário de inscrição e entrada
Um fluxo de usuário define a série de etapas de inscrição que os clientes seguem e os métodos de entrada que eles podem usar (como email e senha, senhas de uso único ou contas sociais do Google ou do Facebook). Você também pode coletar informações de clientes durante a inscrição selecionando de uma série de atributos de usuário internos ou adicionando seus atributos personalizados. Você poderá criar vários fluxos de usuário se tiver vários aplicativos que deseja oferecer aos clientes.
Observação
Você precisará ter pelo menos a função de diretório Administrador de fluxo de usuários de ID externa para criar fluxos de usuários.
Algum comentário? Conte-nos como está indo seu projeto de prova de conceito. Gostaríamos muito de ouvir de você!
Para criar um fluxo de usuário de inscrição e entrada, entre no centro de administração do Microsoft Entra e navegue até Identidade>Identidades Externas.
No menu, selecione Fluxos dos usuários. Em seguida, selecione Novo fluxo de usuário.
Na página Criar, insira um Nome para o fluxo de usuário (por exemplo, "SignUpSignIn"). Em seguida, em Provedores de identidade, marque a caixa de seleção Contas de Email e selecione uma destas opções. Se você tiver configurado outros provedores de identidade, poderá selecioná-los.
Em Atributos de usuário, escolha os atributos que você deseja coletar do usuário no momento da inscrição. Selecione Mostrar mais para escolher entre a lista completa de atributos, inclusive Cargo, Nome de Exibição, Código Postal e outros. Em seguida, selecione Criar para criar o fluxo de usuário.
Na lista, selecione o fluxo de usuário que você criou.
As etapas a seguir ativam a experiência de inscrição e de entrada (o fluxo do usuário) para os usuários que visitam o seu aplicativo. No menu à esquerda, em Usar, selecione Aplicativos.
Selecione Adicionar aplicativo
Selecione o aplicativo na lista. Ou use a caixa de pesquisa para localizar o aplicativo e, em seguida, selecione-o. Escolha Selecionar.
O aplicativo agora está vinculado ao fluxo do usuário. Selecione Executar fluxo de usuário para visualizar a experiência.
No painel Executar fluxo do usuário que é aberto à direita, certifique-se de que o aplicativo e o URL de resposta corretos estejam selecionados. Em seguida, selecione Executar fluxo do usuário.
Muito bem! Você criou com êxito um fluxo de usuário e vinculou um aplicativo!
Dica
Você sempre pode usar o botão Executar fluxo do usuário para visualizar a experiência de entrada. Quando os usuários fizerem a entrada no site de compras, eles encontrarão a experiência de entrada e inscrição configurada no fluxo do usuário.
1. Criar um fluxo de usuário
Para criar um fluxo de usuário, crie um objeto fluxo de eventos de autenticação que seja do tipo especificado no corpo da solicitação.
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 Copie a ID do fluxo de usuários
Na resposta, copie o valor do fluxo de usuário id. Por exemplo:
{
"@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. Adicione seu aplicativo ao fluxo de usuários
Para adicionar ou vincular um aplicativo a um fluxo de usuário, use a seguinte solicitação do Microsoft Graph. Substitua o {user-flow-ID} pela sua ID do fluxo de usuário. Substitua o {app-ID} pela sua ID de aplicativo.
POST https://graph.microsoft.com/beta/identity/authenticationEventsFlows/{user-flow-ID}/conditions/applications/includeApplications
{
"@odata.type": "#microsoft.graph.authenticationConditionApplication",
"appId": "{app-ID}"
}