AcquireTokenInteractiveParameterBuilder Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Construtor para uma solicitação de token interativo. Consulte 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
-
AcquireTokenInteractiveParameterBuilder
Métodos
| Nome | Description |
|---|---|
| ExecuteAsync() |
Executa a solicitação de token de forma assíncrona. (Herdado de BaseAbstractAcquireTokenParameterBuilder<T>) |
| ExecuteAsync(CancellationToken) |
Executa a solicitação de token de forma assíncrona, com a 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. Esse método é mutuamente exclusivo com WithLoginHint(String). Se ambos forem usados, uma exceção será gerada |
| WithAdfsAuthority(String, Boolean) |
Adiciona uma autoridade conhecida correspondente a um servidor do ADFS. Consulte https://aka.ms/msal-net-adfs. (Herdado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AadAuthorityAudience, Boolean) |
Obsoleto.
Importante: use WithTenantId ou WithTenantIdFromAuthority ou WithB2CAuthority para autoridades B2C. Adiciona uma autoridade Azure AD conhecida ao aplicativo para conectar usuários que especificam o público-alvo de entrada (a nuvem é o Azure nuvem pública). Consulte https://aka.ms/msal-net-application-configuration. (Herdado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) |
Obsoleto.
Adiciona uma autoridade Azure AD conhecida ao aplicativo para conectar usuários que especificam a instância de nuvem e o público-alvo de entrada. Consulte https://aka.ms/msal-net-application-configuration. (Herdado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, Guid, Boolean) |
Obsoleto.
Importante: use WithTenantId ou WithTenantIdFromAuthority ou WithB2CAuthority para autoridades B2C. Adiciona uma autoridade de Azure AD conhecida ao aplicativo para conectar usuários de uma única organização (aplicativo de locatário único) descrito por sua instância de nuvem e sua ID de locatário. Consulte https://aka.ms/msal-net-application-configuration. (Herdado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, String, Boolean) |
Obsoleto.
Importante: use WithTenantId ou WithTenantIdFromAuthority ou WithB2CAuthority para autoridades B2C. Adiciona uma autoridade de Azure AD conhecida ao aplicativo para conectar usuários de uma única organização (aplicativo de locatário único) descrito por sua instância de nuvem e seu nome de domínio ou ID de locatário. Consulte https://aka.ms/msal-net-application-configuration. (Herdado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Boolean) |
Obsoleto.
Importante: use WithTenantId ou WithTenantIdFromAuthority ou WithB2CAuthority para autoridades B2C. Autoridade específica para a qual o token é solicitado. Passar um valor diferente do configurado no construtor do aplicativo restringe a seleção a um locatário específico. Isso não altera o valor configurado no aplicativo. Isso é específico para aplicativos que gerenciam 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 ou WithB2CAuthority para autoridades B2C. Adiciona uma autoridade Azure AD conhecida ao aplicativo para conectar usuários de uma única organização (aplicativo de locatário único) especificada por sua ID de locatário. Consulte https://aka.ms/msal-net-application-configuration. (Herdado de AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, String, Boolean) |
Obsoleto.
Importante: use WithTenantId ou WithTenantIdFromAuthority ou WithB2CAuthority para autoridades B2C. Adiciona uma autoridade Azure AD conhecida ao aplicativo para conectar usuários de uma única organização (aplicativo de locatário único) descrito pelo 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 do AD B2C Azure. Consulte https://aka.ms/msal-net-b2c-specificities (Herdado de AbstractAcquireTokenParameterBuilder<T>) |
| WithClaims(String) |
Define declarações na consulta. Use quando o administrador do AAD tiver habilitado o acesso condicional. A aquisição do token normalmente resultará em um MsalUiRequiredException com o Claims conjunto de propriedades. Tente novamente a aquisição do token e use esse valor no WithClaims(String) método. Consulte https://aka.ms/msal-exceptions os detalhes, bem como https://aka.ms/msal-net-claim-challenge. (Herdado de AbstractAcquireTokenParameterBuilder<T>) |
| WithCorrelationId(Guid) |
Define a ID de correlação a ser usada na solicitação de autenticação. Usado para acompanhar uma solicitação nos logs do SDK e do serviço provedor de identidade. Se não for definido, um aleatório será gerado. (Herdado de BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithEmbeddedWebViewOptions(EmbeddedWebViewOptions) |
Especifica as opções para usar a exibição da Web inserida para autenticação interativa. |
| WithExtraQueryParameters(Dictionary<String,String>) |
Obsoleto.
Define parâmetros de consulta extras para a cadeia de caracteres de consulta na solicitação de autenticação HTTP. (Herdado de BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>) |
Define parâmetros de consulta extra para a cadeia de caracteres de consulta na solicitação de autenticação HTTP com controle sobre quais parâmetros estão incluídos na chave de cache (Herdado de BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(String) |
Obsoleto.
Define parâmetros de consulta extras para a cadeia de caracteres de consulta na solicitação de autenticação HTTP. (Herdado de AbstractAcquireTokenParameterBuilder<T>) |
| WithExtraScopesToConsent(IEnumerable<String>) |
Construtor para uma solicitação de token interativo. Consulte https://aka.ms/msal-net-acquire-token-interactively |
| WithLoginHint(String) |
Define o |
| WithParentActivityOrWindow(IntPtr) |
Define uma referência ao IntPtr para uma janela que dispara o navegador a ser mostrado. Usado para centralizar o navegador que aparece nesta janela. O centro da tela ou do aplicativo em primeiro plano se um valor estiver configurado. |
| WithParentActivityOrWindow(Object) |
Define uma referência ao ViewController (se estiver usando iOS), Atividade (se estiver usando Android) IWin32Window ou IntPtr (se estiver usando o .Net Framework). Usado para invocar o navegador. |
| WithPrompt(Prompt) |
Especifica o que é a experiência interativa para o usuário. |
| WithProofOfPossession(String, HttpMethod, Uri) |
Modifica a solicitação de aquisição de token para que o token adquirido seja um PoP (Token de Prova de Posse), em vez de um token de portador. Os tokens PoP são semelhantes aos tokens de portador, mas estão associados à solicitação HTTP e a uma chave criptográfica, que a MSAL pode gerenciar em Windows. Observe que somente as partes de host e caminho do URI da solicitação serão associadas. Consulte https://aka.ms/msal-net-pop |
| WithScopes(IEnumerable<String>) |
Especifica quais escopos solicitar. Esse método é usado quando seu aplicativo precisa especificar os escopos necessários para chamar uma API protegida. >https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent<Consulte</veja> para saber mais sobre escopos, permissões e consentimento e <veja>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes</veja> como criar escopos para aplicativos herdados que costumavam expor permissões OAuth2. (Herdado de AbstractAcquireTokenParameterBuilder<T>) |
| WithSystemWebViewOptions(SystemWebViewOptions) |
Especifica opções para usar a autenticação interativa do identificador do navegador do sistema operacional. |
| WithTenantId(String) |
Substitui a ID do locatário especificada na autoridade no nível do aplicativo. Essa operação preserva o host de autoridade (ambiente). Se uma autoridade não tiver sido especificada no nível do aplicativo, o padrão usado será |
| WithTenantIdFromAuthority(Uri) |
Extrai a ID do locatário do URI de autoridade fornecido e substitui a ID de locatário especificada na autoridade no nível do aplicativo. Essa operação preserva o host de autoridade (ambiente) fornecido ao construtor de aplicativos.
Se uma autoridade não tiver sido fornecida ao construtor de aplicativos, esse método substituirá a ID do locatário na autoridade padrão – |
| WithUseEmbeddedWebView(Boolean) |
Especifica se o aplicativo cliente público deve usar um navegador da Web inserido ou o navegador padrão do sistema. Se o agente (WAM, Authenticator, Portal da Empresa) estiver configurado, essa configuração só será usada quando o agente não estiver instalado. Em .NET, incluindo o net8-windows, os desenvolvedores de aplicativos devem referenciar Microsoft. Identity.Client.Desktop e chame PublicClientApplicationBuilder.WithDesktopFeatures() para habilitar o navegador da Web inserido. |
Métodos de Extensão
| Nome | Description |
|---|---|
| OnBeforeTokenRequest<T>(AbstractAcquireTokenParameterBuilder<T>, Func<OnBeforeTokenRequestData,Task>) |
Intervém no pipeline de solicitação executando um delegado fornecido pelo usuário antes que a MSAL faça a solicitação de token. O delegado pode modificar o conteúdo da solicitação adicionando ou removendo os cabeçalhos e parâmetros do corpo. OnBeforeTokenRequestData |
| WithAdditionalCacheParameters<T>(AbstractAcquireTokenParameterBuilder<T>, IEnumerable<String>) |
Especifica parâmetros adicionais adquiridos de respostas de autenticação a serem armazenados em cache com o token de acesso que normalmente não está incluído no objeto de cache. esses valores podem ser lidos do AdditionalResponseParameters parâmetro. |
| WithAuthenticationExtension<T>(AbstractAcquireTokenParameterBuilder<T>, MsalAuthenticationExtension) |
Permite que os aplicativos cliente forneçam uma operação de autenticação personalizada a ser usada na solicitação de aquisição de token. |
| WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String) |
Adiciona um par chave-valor à chave de cache de token sem enviá-la como um parâmetro de consulta.
Use isso para particionar tokens armazenados em cache (por exemplo, isolando sessões de curta duração de sessões regulares para o mesmo usuário). Ambos |
| WithCustomWebUi(AcquireTokenInteractiveParameterBuilder, ICustomWebUi) |
Método de extensão que habilita MSAL.NET extensores para aplicativos cliente públicos para definir uma interface do usuário da Web personalizada que permitirá que o usuário entre com Azure AD, apresente o consentimento, se necessário, e retorne o código de autorização |
| WithExtraClientAssertionClaims<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Especifica declarações extras a serem incluídas na declaração do cliente. Essas declarações serão mescladas com declarações padrão quando a declaração do cliente for gerada. Isso permite APIs de nível mais alto, como Microsoft. Identity.Web fornece declarações adicionais para a declaração do cliente. Importante: os tokens são associados às declarações de declaração de cliente extras, o que afeta as pesquisas de cache. Essa é uma API de extensibilidade e não deve ser usada diretamente por aplicativos. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Obsoleto.
Adiciona cabeçalhos Http adicionais à solicitação de token. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Adiciona cabeçalhos HTTP adicionais à solicitação de token. |
| WithFmiPathForClientAssertion<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Especifica um caminho FMI a ser usado para a declaração do cliente. Isso permite que APIs de nível mais alto, como a Id.Web, forneçam credenciais sensíveis ao FMI. Importante: os tokens são associados ao caminho FMI de credencial, que afeta pesquisas de cache Essa é uma API de extensibilidade e não deve ser usada por aplicativos. |
| WithProofOfPosessionKeyId<T>(AbstractAcquireTokenParameterBuilder<T>, String, String) |
Associa o token a uma chave no cache. Nenhuma operação criptográfica é executada no token. |
| WithSSHCertificateAuthenticationScheme(AcquireTokenInteractiveParameterBuilder, String, String) |
Instrui o AAD a retornar um certificado SSH em vez de um token de portador. O certificado SSH (não o mesmo que o par de chaves pública/privada usada pelo SSH), pode ser usado para implantar com segurança uma chave SSH pública em um computador. Consulte https://aka.ms/msal-net-ssh para obter detalhes. |