AcquireTokenForClientParameterBuilder Classe

Executa o pedido de Token de forma assíncrona.

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

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

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

Especifica um atributo de identidade a incluir no pedido de token. Os valores dos atributos serão devolvidos como uma reivindicação no token chamada "xms_attr" nas reivindicações do token de acesso. Isto é tipicamente usado em cenários FMI (Federated Managed Identity). Exemplo de atributo json: "{"sg1":"0000-00000-0001","sg2":["0000-00000-0002","0000-00000-0003","0000-00000-0004"]}"

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.

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.

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.

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.

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.

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.

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.

Por favor, use o WithAzureRegion no objeto ConfidentialClientApplicationBuilder

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

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.

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.

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

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

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

Adiciona um parâmetro de fmi_path ao pedido. Modifica o tema do token.

Especifica se a aplicação cliente deve ignorar tokens de acesso ao ler a cache do token. Novos tokens continuarão a ser escritos na cache de tokens de aplicação. Por defeito, o token é retirado da cache do token de aplicação (forceRefresh=false)

Especifica que o certificado fornecido será usado para tokens PoP com autenticação mTLS (TLS mútuo). Para mais informações, consulte a documentação de Prova de Posse.

Por favor, use o WithAzureRegion no objeto ConfidentialClientApplicationBuilder

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. Veja https://aka.ms/msal-net-pop

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>https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent< para saber mais sobre escopos, permissões e consentimento, e >veja</veja>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes< para saber como criar escopos para aplicações legadas que antes expunham permissões OAuth2>.

Aplicável apenas a aplicações de primeira parte, este método também permite especificar se a reivindicação x5c deve ser enviada para o Azure AD. Enviar o x5c permite aos programadores de aplicações conseguir uma simples transferência de certificados no Azure AD: este método envia a cadeia de certificados para o Azure AD juntamente com o pedido de token, para que o Azure AD possa usá-lo para validar o nome do assunto com base numa política de emissor de confiança. Isto poupa ao administrador da aplicação a necessidade de gerir explicitamente o rollover de certificados (seja via portal ou operação PowerShell/CLI). Para mais informações, consultar: https://aka.ms/msal-net-sni

Modifica o pedido para adquirir um token de Prova de Posse (PoP) de Pedido HTTP Assinado (SHR), em vez de um Portador. Os tokens SHR PoP estão ligados ao pedido HTTP e a uma chave criptográfica, que o MSAL gere no Windows. Os tokens SHR PoP são diferentes dos tokens MTLS PoP, que são usados para autenticação Mutual TLS (mTLS). Consulte https://aka.ms/mtls-pop para obter detalhes.

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.

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.

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

Configura o SDK para não recuperar um token da cache se este corresponder ao hash SHA256 do token configurado. Semelhante à API WithForceRefresh(bool), mas em vez de contornar a cache para todos os tokens, o bypass da cache ocorre apenas para 1 token

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.

Envia attributeTokens como attribute_tokens parâmetro do corpo e inclui-os na chave de cache. Entradas nulas/vazias/espaços em branco são ignoradas; uma coleção nula ou vazia é uma no-op.

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.

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.

Especifica reivindicações originadas pelo cliente a incluir no pedido de token. Ao contrário WithClaims(String) (para desafios de reclamações emitidas pelo servidor), os tokens adquiridos com claims do cliente são armazenados em cache e a entrada de cache é indexada pelo valor das reclamações. Valores diferentes de reivindicações produzem entradas de cache separadas. Use valores estáveis e não dinâmicos para evitar o crescimento ilimitado da cache.

Adicione parâmetros adicionais ao pedido do token. Estes parâmetros são adicionados à chave de cache para associar estes parâmetros ao token adquirido.

Adicione parâmetros adicionais ao pedido do token. Estes parâmetros são adicionados à chave de cache para associar estes parâmetros ao token adquirido. Funciona para fluxos confidenciais de clientes (AcquireTokenForClient, AcquireTokenOnBehalfOf, AcquireTokenByAuthorizationCode).

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.

Adiciona cabeçalhos Http adicionais ao pedido de token.

Adiciona cabeçalhos HTTP adicionais ao pedido de token.

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.

Vincula o token a uma chave na cache. As chaves de cache L2 contêm o id da chave. Não são realizadas operações criptográficas sobre o token.

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