AcquireTokenInteractiveParameterBuilder Classe

Definição

Construtor para um pedido interativo de token. Veja https://aka.ms/msal-net-acquire-token-interactively

public sealed class AcquireTokenInteractiveParameterBuilder : Microsoft.Identity.Client.AbstractPublicClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenInteractiveParameterBuilder>
type AcquireTokenInteractiveParameterBuilder = class
    inherit AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenInteractiveParameterBuilder>
Public NotInheritable Class AcquireTokenInteractiveParameterBuilder
Inherits AbstractPublicClientAcquireTokenParameterBuilder(Of AcquireTokenInteractiveParameterBuilder)
Herança

Métodos

Name Descrição
ExecuteAsync()

Executa o pedido de Token de forma assíncrona.

(Herdado de BaseAbstractAcquireTokenParameterBuilder<T>)
ExecuteAsync(CancellationToken)

Executa o pedido de Token de forma assíncrona, com possibilidade de cancelar o método assíncrono.

(Herdado de AbstractPublicClientAcquireTokenParameterBuilder<T>)
Validate()

Valida os parâmetros da operação AcquireToken.

(Herdado de BaseAbstractAcquireTokenParameterBuilder<T>)
WithAccount(IAccount)

Define a conta para a qual o token será recuperado. Este método é mutuamente exclusivo com WithLoginHint(String). Se ambos forem usados, será lançada uma exceção

WithAdfsAuthority(String, Boolean)

Adiciona uma Autoridade conhecida correspondente a um servidor ADFS. Consulte https://aka.ms/msal-net-adfs.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(AadAuthorityAudience, Boolean)
Obsoleto.

Importante: Use WithTenantId ou WithTenantIdFromAuthority em vez disso, ou WithB2CAuthority para autoridades B2C.

Adiciona uma autoridade conhecida do Azure AD à aplicação para os utilizadores que iniciam sessão, especificando o público de início de sessão (a cloud sendo a cloud pública do Azure). Consulte https://aka.ms/msal-net-application-configuration.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)
Obsoleto.

Adiciona uma autoridade conhecida do Azure AD à aplicação para os utilizadores de iniciar sessão, especificando a instância cloud e o público de iniciação de sessão. Consulte https://aka.ms/msal-net-application-configuration.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(AzureCloudInstance, Guid, Boolean)
Obsoleto.

Importante: Use WithTenantId ou WithTenantIdFromAuthority em vez disso, ou WithB2CAuthority para autoridades B2C.

Adiciona uma autoridade conhecida do Azure AD à aplicação para iniciar sessão com utilizadores de uma única organização (aplicação de inquilino único) descrita pela sua instância cloud e pelo seu ID de inquilino. Consulte https://aka.ms/msal-net-application-configuration.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(AzureCloudInstance, String, Boolean)
Obsoleto.

Importante: Use WithTenantId ou WithTenantIdFromAuthority em vez disso, ou WithB2CAuthority para autoridades B2C.

Adiciona uma autoridade conhecida do Azure AD à aplicação para iniciar sessão com utilizadores de uma única organização (aplicação de inquilino único) descrita pela sua instância cloud e pelo seu nome de domínio ou ID de inquilino. Consulte https://aka.ms/msal-net-application-configuration.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(String, Boolean)
Obsoleto.

Importante: Use WithTenantId ou WithTenantIdFromAuthority em vez disso, ou WithB2CAuthority para autoridades B2C.

Autoridade específica para a qual o token é solicitado. Passar um valor diferente do configurado no construtor da aplicação reduz a seleção a um tenant específico. Isto não altera o valor configurado na aplicação. Isto é específico para aplicações que gerem várias contas (como um cliente de email com várias caixas de correio). Consulte https://aka.ms/msal-net-application-configuration.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(String, Guid, Boolean)
Obsoleto.

Importante: Use WithTenantId ou WithTenantIdFromAuthority em vez disso, ou WithB2CAuthority para autoridades B2C.

Adiciona uma autoridade conhecida do Azure AD à aplicação para iniciar sessão com utilizadores de uma única organização (aplicação de inquilino único) especificada pelo seu ID de inquilino. Consulte https://aka.ms/msal-net-application-configuration.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(String, String, Boolean)
Obsoleto.

Importante: Use WithTenantId ou WithTenantIdFromAuthority em vez disso, ou WithB2CAuthority para autoridades B2C.

Adiciona uma autoridade Azure AD conhecida à aplicação para iniciar sessão com utilizadores de uma única organização (aplicação de inquilino único) descrita pelo seu nome de domínio. Consulte https://aka.ms/msal-net-application-configuration.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithB2CAuthority(String)

Adiciona uma autoridade conhecida correspondente a uma política B2C do Azure AD. Veja https://aka.ms/msal-net-b2c-specificities

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithClaims(String)

Define reivindicações na consulta. Use quando o administrador do AAD tiver ativado o acesso condicional. Adquirir o token normalmente resultará em um MsalUiRequiredException com a Claims propriedade definida. Tente novamente a aquisição do token e use esse valor no WithClaims(String) método. Consulte https://aka.ms/msal-exceptions para mais detalhes, bem como https://aka.ms/msal-net-claim-challenge.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithCorrelationId(Guid)

Define o id de correlação a ser usado no pedido de autenticação. Usado para rastrear um pedido nos registos tanto do SDK como do serviço Identity Provider. Se não for definido, será gerado um aleatório.

(Herdado de BaseAbstractAcquireTokenParameterBuilder<T>)
WithEmbeddedWebViewOptions(EmbeddedWebViewOptions)

Especifica opções para usar a web view embutida para autenticação interativa.

WithExtraQueryParameters(Dictionary<String,String>)
Obsoleto.

Define parâmetros extra de consulta para a cadeia de consulta no pedido de autenticação HTTP.

(Herdado de BaseAbstractAcquireTokenParameterBuilder<T>)
WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>)

Define Parâmetros Extra de Consulta para a cadeia de consulta no pedido de autenticação HTTP com controlo sobre quais os parâmetros incluídos na chave de cache

(Herdado de BaseAbstractAcquireTokenParameterBuilder<T>)
WithExtraQueryParameters(String)
Obsoleto.

Define parâmetros extra de consulta para a cadeia de consulta no pedido de autenticação HTTP.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithExtraScopesToConsent(IEnumerable<String>)

Construtor para um pedido interativo de token. Veja https://aka.ms/msal-net-acquire-token-interactively

WithLoginHint(String)

Define o loginHint, para evitar diálogos de contas selecionadas caso o utilizador esteja iniciado com várias identidades. Este método é mutuamente exclusivo com WithAccount(IAccount). Se ambos forem usados, será lançada uma exceção

WithParentActivityOrWindow(IntPtr)

Define uma referência ao IntPtr para uma janela que aciona o navegador para ser mostrado. Costumava centrar o navegador que apareceu nesta janela. O centro do ecrã ou a aplicação em primeiro plano, se um valor estiver configurado.

WithParentActivityOrWindow(Object)

Define uma referência para o ViewController (se usar iOS), Activity (se estiver a usar Android), IWin32Window ou IntPtr (se usar .Net Framework). Usado para invocar o navegador.

WithPrompt(Prompt)

Especifica qual é a experiência interativa para o utilizador.

WithProofOfPossession(String, HttpMethod, Uri)

Modifica o pedido de aquisição do token para que o token adquirido seja um token de Prova de Posse (PoP), em vez de um token Portador. Os tokens PoP são semelhantes aos tokens Bearer, mas estão ligados ao pedido HTTP e a uma chave criptográfica, que o MSAL pode gerir no Windows. Note que apenas as partes do host e do caminho do URI do pedido serão atribuídas. Veja https://aka.ms/msal-net-pop

WithScopes(IEnumerable<String>)

Especifica quais os âmbios a solicitar. Este método é usado quando a sua aplicação precisa de especificar os escopos necessários para chamar uma API protegida. Consulte <ver/ver> para saber mais sobre escopos, permissões e consentimento, e <veja>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes</veja> para saber como criar escopos para aplicações legadas que antes expunham permissões OAuth2>https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent<.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithSystemWebViewOptions(SystemWebViewOptions)

Especifica opções para usar o navegador do sistema operativo para tratar da autenticação interativa.

WithTenantId(String)

Sobrepõe-se ao ID do inquilino especificado na autoridade ao nível da aplicação. Esta operação preserva o anfitrião autoridade (ambiente).

Se uma autoridade não foi especificada ao nível da aplicação, o padrão utilizado é https://login.microsoftonline.com/common.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithTenantIdFromAuthority(Uri)

Extrai o ID do inquilino do URI de autoridade fornecido e sobrepõe o ID de inquilino especificado na autoridade ao nível da aplicação. Esta operação preserva o host de autoridade (ambiente) fornecido ao construtor da aplicação. Se não foi fornecida uma autoridade ao construtor da aplicação, este método substituirá o ID do inquilino na autoridade padrão - https://login.microsoftonline.com/common.

(Herdado de AbstractAcquireTokenParameterBuilder<T>)
WithUseEmbeddedWebView(Boolean)

Especifica se a aplicação cliente pública deve usar um navegador web embutido ou o navegador predefinido do sistema. Se o corretor (WAM, Autenticador, Portal da Empresa) estiver configurado, esta configuração só é usada quando o corretor não está instalado.

No .NET, incluindo o net8-windows, os programadores de aplicações devem consultar a Microsoft. Identity.Client.Desktop e chamar PublicClientApplicationBuilder.WithDesktopFeatures() para ativar o navegador web embutido.

Métodos da Extensão

Name Descrição
OnBeforeTokenRequest<T>(AbstractAcquireTokenParameterBuilder<T>, Func<OnBeforeTokenRequestData,Task>)

Intervém no pipeline de pedidos, executando um delegado fornecido pelo utilizador antes de o MSAL fazer o pedido de token. O delegado pode modificar a carga útil do pedido adicionando ou removendo parâmetros e cabeçalhos do corpo. OnBeforeTokenRequestData

WithAdditionalCacheParameters<T>(AbstractAcquireTokenParameterBuilder<T>, IEnumerable<String>)

Especifica parâmetros adicionais adquiridos a partir de respostas de autenticação para serem armazenados em cache com o token de acesso que normalmente não estão incluídos no objeto de cache. estes valores podem ser lidos a partir do AdditionalResponseParameters parâmetro.

WithAuthenticationExtension<T>(AbstractAcquireTokenParameterBuilder<T>, MsalAuthenticationExtension)

Permite que as aplicações cliente forneçam uma operação de autenticação personalizada para ser usada no pedido de aquisição de tokens.

WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String)

Adiciona um par chave-valor à chave cache do token sem a enviar como parâmetro de consulta. Use isto para particionar tokens em cache (por exemplo, isolando sessões de curta duração de sessões normais para o mesmo utilizador). Tanto AcquireTokenByAuthorizationCode como AcquireTokenSilent devem usar a mesma chave de partição para corresponder às entradas em cache.

WithCustomWebUi(AcquireTokenInteractiveParameterBuilder, ICustomWebUi)

Método de extensão que permite aos extensores MSAL.NET para aplicações clientes públicas definir uma interface web personalizada que permitirá ao utilizador iniciar sessão com o Azure AD, apresentar consentimento se necessário e recuperar o código de autorização

WithExtraClientAssertionClaims<T>(AbstractAcquireTokenParameterBuilder<T>, String)

Especifica reivindicações adicionais a serem incluídas na declaração do cliente. Estas reclamações serão fundidas com as reclamações em incumprimento quando a declaração do cliente for gerada. Isto permite APIs de nível mais alto como a Microsoft. A Identity.Web fornece reivindicações adicionais para a declaração do cliente. Importante: os tokens estão associados às reivindicações adicionais de asserção do cliente, o que afeta as consultas de cache. Esta é uma API de extensibilidade e não deve ser usada diretamente por aplicações.

WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>)
Obsoleto.

Adiciona cabeçalhos Http adicionais ao pedido de token.

WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>)

Adiciona cabeçalhos HTTP adicionais ao pedido de token.

WithFmiPathForClientAssertion<T>(AbstractAcquireTokenParameterBuilder<T>, String)

Especifica um caminho FMI a ser usado para a asserção do cliente. Isto permite que APIs de nível superior como a Id.Web forneçam credenciais sensíveis à FMI. Importante: os tokens estão associados ao caminho FMI das credenciais, que afeta as consultas de cache. Esta é uma API de extensibilidade e não deve ser usada por aplicações.

WithProofOfPosessionKeyId<T>(AbstractAcquireTokenParameterBuilder<T>, String, String)

Vincula o token a uma chave na cache. Não são realizadas operações criptográficas sobre o token.

WithSSHCertificateAuthenticationScheme(AcquireTokenInteractiveParameterBuilder, String, String)

Instrui a AAD a devolver um certificado SSH em vez de um token portador. O certificado SSH (diferente do par de chaves pública/privada usado pelo SSH) pode ser usado para implantar de forma segura uma chave SSH pública numa máquina. Consulte https://aka.ms/msal-net-ssh para obter detalhes.

Aplica-se a