Habilitar opções de autenticação em um aplicativo da área de trabalho do WPF usando o Azure AD B2C

Este artigo descreve maneiras de personalizar e aprimorar a experiência de autenticação do Azure AD B2C (Azure Active Directory B2C) para seu aplicativo de área de trabalho do WPF (Windows Presentation Foundation).

Antes de começar, familiarize-se com a autenticação Configurar em um aplicativo de área de trabalho WPF de exemplo usando o artigo do Azure AD B2C .

Preencher previamente o nome de usuário

Durante uma jornada de sign-in do usuário, seu aplicativo pode focar em um usuário específico. Quando um aplicativo tem como destino um usuário, ele pode especificar na solicitação de autorização o login_hint parâmetro de consulta com o nome de entrada do usuário. O Azure AD B2C preenche automaticamente o nome de entrada e o usuário precisa fornecer apenas a senha.

Para preencher o nome de logon, faça o seguinte:

1. Se você estiver usando uma política personalizada, adicione a declaração de entrada necessária, conforme descrito em Configurar conexão direta.
2. Procure o objeto de configuração da MSAL (Biblioteca de Autenticação da Microsoft) e, em seguida, adicione o método withLoginHint() com a dica de logon.

authResult = await app.AcquireTokenInteractive(App.ApiScopes)
    .WithParentActivityOrWindow(new WindowInteropHelper(this).Handle)
    .WithLoginHint("bob@contoso.com")
    .ExecuteAsync();

Pré-selecionar um provedor de identidade

Se você configurou o percurso de entrada do aplicativo para incluir contas sociais, como Facebook, LinkedIn ou Google, poderá especificar o domain_hint parâmetro. Esse parâmetro de consulta fornece uma dica para o Azure AD B2C sobre o provedor de identidade social que deve ser usado para entrar. Por exemplo, se o aplicativo especificar domain_hint=facebook.com, o fluxo de entrada vai diretamente para a página de entrada do Facebook.

Para redirecionar usuários para um provedor de identidade externo, faça o seguinte:

1. Verifique o nome de domínio do provedor de identidade externo. Para obter mais informações, consulte Redirecionar o login para um provedor social.
2. Crie ou use um objeto existente Dictionary para armazenar parâmetros de consulta extras.
3. Adicione o domain_hint parâmetro com o nome de domínio correspondente ao dicionário (por exemplo, facebook.com).
4. Passe o objeto de parâmetros de consulta extra para o método do objeto de configuração MSAL WithExtraQueryParameters .

Dictionary<string, string> extraQueryParameters = new Dictionary<string, string>();
extraQueryParameters.Add("domain_hint", "facebook.com");

authResult = await app.AcquireTokenInteractive(App.ApiScopes)
    .WithParentActivityOrWindow(new WindowInteropHelper(this).Handle)
    .WithExtraQueryParameters(extraQueryParameters)
    .ExecuteAsync();

Especificar o idioma da interface do usuário

A personalização de idiomas no Azure AD B2C permite que seu fluxo de usuário acomode uma variedade de idiomas para atender às necessidades dos clientes. Para obter mais informações, consulte Personalização de idioma.

Para definir o idioma preferencial, faça o seguinte:

1. Configurar a personalização do idioma.
2. Crie ou use um objeto existente Dictionary para armazenar parâmetros de consulta extras.
3. Adicione o ui_locales parâmetro com o código de idioma correspondente ao dicionário (por exemplo, en-us).
4. Passe o objeto de parâmetros de consulta extra para o método do objeto de configuração MSAL WithExtraQueryParameters .

Dictionary<string, string> extraQueryParameters = new Dictionary<string, string>();
extraQueryParameters.Add("ui_locales", "en-us");

authResult = await app.AcquireTokenInteractive(App.ApiScopes)
    .WithParentActivityOrWindow(new WindowInteropHelper(this).Handle)
    .WithExtraQueryParameters(extraQueryParameters)
    .ExecuteAsync();

Passar um parâmetro de cadeia de caracteres de consulta personalizado

Com políticas personalizadas, você pode passar um parâmetro de cadeia de caracteres de consulta personalizado. Um bom exemplo de caso de uso é quando você deseja alterar dinamicamente o conteúdo da página.

Para passar um parâmetro de cadeia de caracteres de consulta personalizada, faça o seguinte:

1. Configure o elemento ContentDefinitionParameters .
2. Crie ou use um objeto existente Dictionary para armazenar parâmetros de consulta extras.
3. Adicione o parâmetro de cadeia de caracteres de consulta personalizada, como campaignId. Defina o valor do parâmetro (por exemplo, germany-promotion).
4. Passe o objeto de parâmetros de consulta extra para o método do objeto de configuração MSAL WithExtraQueryParameters .

Dictionary<string, string> extraQueryParameters = new Dictionary<string, string>();
extraQueryParameters.Add("campaignId", "germany-promotion");

authResult = await app.AcquireTokenInteractive(App.ApiScopes)
    .WithParentActivityOrWindow(new WindowInteropHelper(this).Handle)
    .WithExtraQueryParameters(extraQueryParameters)
    .ExecuteAsync();

Passar uma dica de token de ID

Um aplicativo de terceira parte confiável pode enviar um JWT (Token Web JSON) de entrada como parte da solicitação de autorização OAuth2. O token de entrada é uma dica sobre o usuário ou a solicitação de autorização. O Azure AD B2C valida o token e, em seguida, extrai a declaração.

Para incluir uma dica de token de ID na solicitação de autenticação, faça o seguinte:

1. Em sua política personalizada, defina um perfil técnico de dica de token de ID.
2. Em seu código, gere ou adquira um token de ID e defina o token como uma variável (por exemplo, idToken).
3. Crie ou use um objeto existente Dictionary para armazenar parâmetros de consulta extras.
4. Adicione o id_token_hint parâmetro com a variável correspondente que armazena o token de ID.
5. Passe o objeto de parâmetros de consulta extra para o atributo do objeto de configuração MSAL extraQueryParameters .

Dictionary<string, string> extraQueryParameters = new Dictionary<string, string>();
extraQueryParameters.Add("id_token_hint", idToken);

authResult = await app.AcquireTokenInteractive(App.ApiScopes)
    .WithParentActivityOrWindow(new WindowInteropHelper(this).Handle)
    .WithExtraQueryParameters(extraQueryParameters)
    .ExecuteAsync();

Configurar o registro em log

A biblioteca MSAL gera mensagens de log que podem ajudar a diagnosticar problemas. O aplicativo pode configurar o registro em log. O aplicativo também pode fornecer controle personalizado sobre o nível de detalhes e se os dados pessoais e organizacionais são registrados.

Recomendamos que você crie um retorno de chamada de registro em log da MSAL e forneça uma maneira para os usuários enviarem logs quando estiverem com problemas de autenticação. A MSAL fornece os níveis de detalhes de log a seguir:

• Erro: algo deu errado e um erro foi gerado. Esse nível é usado para depurar e identificar problemas.
• Aviso: não houve necessariamente um erro ou falha, mas as informações se destinam a diagnósticos e problemas de identificação.
• Informações: A MSAL registra eventos destinados a fins informativos e não necessariamente para depuração.
• Detalhado: esse é o nível padrão. A MSAL registra todos os detalhes do comportamento da biblioteca.

Por padrão, o registrador de MSAL não captura dados pessoais ou organizacionais. A biblioteca oferece a opção de habilitar o registro em log de dados pessoais e organizacionais se você decidir fazer isso.

O trecho de código a seguir demonstra como configurar o registro em log na MSAL:

PublicClientApp = PublicClientApplicationBuilder.Create(ClientId)
    .WithB2CAuthority(AuthoritySignUpSignIn)
    .WithRedirectUri(RedirectUri)
    .WithLogging(Log, LogLevel.Info, false) // don't log P(ersonally) I(dentifiable) I(nformation) details on a regular basis
    .Build();

Configurar o URI de redirecionamento

Durante o processo de registro do aplicativo da área de trabalho , ao escolher um URI de redirecionamento, tenha em mente as seguintes considerações importantes:

• Desenvolvimento: para uso de desenvolvimento em aplicativos da área de trabalho, você pode definir o URI de redirecionamento como http://localhost, e o Azure AD B2C respeitará qualquer porta na solicitação. Se o URI registrado contiver uma porta, o Azure AD B2C usará apenas essa porta. Por exemplo, se o URI de redirecionamento registrado for http://localhost, o URI de redirecionamento na solicitação poderá ser http://localhost:<randomport>. Se o URI de redirecionamento registrado for http://localhost:8080, o URI de redirecionamento na solicitação deverá ser http://localhost:8080.
• Exclusivo: o esquema do URI de redirecionamento deve ser exclusivo para cada aplicativo. No exemplo com.onmicrosoft.contosob2c.exampleapp://oauth/redirect, com.onmicrosoft.contosob2c.exampleapp é o esquema. Esse padrão deve ser seguido. Se dois aplicativos compartilharem o mesmo esquema, os usuários receberão uma opção de aplicativos. Se os usuários escolherem incorretamente, a entrada falhará.
• Concluído: o URI de redirecionamento deve ter um esquema e um caminho. O caminho deve conter pelo menos um caractere de barra após o domínio. Por exemplo, //oauth/ funciona e //oauth falha. Não inclua caracteres especiais no URI. Por exemplo, o caractere de sublinhado (_) não é permitido.

Próximas etapas

• Para saber mais, confira as opções de configuração do MSAL para .NET, UWP e NetCore.