IConfidentialClientApplication Interface
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa aplicações cliente confidenciais - aplicações web, APIs web, aplicações daemon.
public interface IConfidentialClientApplication : Microsoft.Identity.Client.IByUserFederatedIdentityCredential, Microsoft.Identity.Client.IClientApplicationBase
type IConfidentialClientApplication = interface
interface IClientApplicationBase
interface IApplicationBase
interface IByUserFederatedIdentityCredential
Public Interface IConfidentialClientApplication
Implements IByUserFederatedIdentityCredential, IClientApplicationBase
- Derivado
- Implementações
Observações
Aplicações cliente confidenciais são tipicamente aplicações que correm em servidores (aplicações web, API web ou até aplicações de serviço/daemon). São considerados difíceis de aceder e, por isso, capazes de manter uma aplicação em segredo (manter segredos de tempo de configuração, pois estes valores seriam difíceis de extrair para os utilizadores finais). Uma aplicação web é o cliente confidencial mais comum. O ID do cliente é exposto através do navegador web, mas o segredo é passado apenas pelo canal secundário e nunca é exposto diretamente. Para mais detalhes, consulte Aplicações para Clientes.
Propriedades
| Name | Descrição |
|---|---|
| AppConfig |
Detalhes sobre a configuração da ClienteApplication para fins de depuração. (Herdado de IClientApplicationBase) |
| AppTokenCache |
Cache de tokens de aplicação que contém tokens de acesso para esta aplicação. É mantido e atualizado silenciosamente quando se chama AcquireTokenForClient(IEnumerable<String>) |
| Authority |
Obtém o URL da autoridade, ou do serviço de token de segurança (STS), do qual o MSAL.NET irá adquirir os tokens de segurança.
O valor de retorno desta propriedade é ou o valor fornecido pelo desenvolvedor no construtor da aplicação, ou de outra forma o valor do Microsoft.Identity.Client.ApplicationBase.DefaultAuthority elemento estático (isto é |
| UserTokenCache |
Cache de tokens de utilizador que contém tokens de ID, tokens de acesso e tokens de atualização para contas. É usado e atualizado silenciosamente, se necessário, ao chamar AcquireTokenSilent(IEnumerable<String>, IAccount) . É atualizado por cada método de token de aquisição, com exceção do AcquireTokenForClient(IEnumerable<String>) qual apenas utiliza a cache da aplicação (ver AppTokenCache). (Herdado de IClientApplicationBase) |
Métodos
| Name | Descrição |
|---|---|
| AcquireTokenByAuthorizationCode(IEnumerable<String>, String) |
Adquire um token da autoridade configurada na aplicação usando o código de autorização previamente recebido do fornecedor de identidade, utilizando o fluxo de código de autorização OAuth 2.0. Ver Fluxo de Código de Autorização. Este fluxo é normalmente utilizado em aplicações web (por exemplo, aplicações web ASP.NET e ASP.NET Core) que fazem login com os utilizadores e podem solicitar um código de autorização. Este método não procura na cache de tokens, mas armazena o resultado nele. Antes de chamar este método, use outros métodos, como AcquireTokenSilent(IEnumerable<String>, IAccount) verificar a cache do token. |
| AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, Guid, String) |
Adquire um token em nome de um utilizador usando uma asserção federada de credenciais de identidade.
Isto utiliza o tipo de |
| AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, String, String) |
Adquire um token em nome de um utilizador usando uma asserção federada de credenciais de identidade.
Isto utiliza o tipo de |
| AcquireTokenForClient(IEnumerable<String>) |
Adquire um token da autoridade configurada na aplicação para o próprio cliente confidencial (não para um utilizador) usando o fluxo de credenciais do cliente. Veja Fluxo de Credenciais do Cliente. Durante esta operação, a MSAL procura primeiro na cache um token não expirado antes de adquirir um novo do Microsoft Entra ID. |
| AcquireTokenOnBehalfOf(IEnumerable<String>, UserAssertion) |
Adquire um token de acesso para esta aplicação (normalmente uma API web) da autoridade configurada na aplicação, para aceder a outra API web protegida a jusante em nome de um utilizador que utiliza o fluxo OAuth 2.0 On-Behalf-Of. Durante esta operação, a MSAL procura primeiro na cache um token não expirado antes de adquirir um novo do Microsoft Entra ID. Ver em On-Behalf-Of Flow. |
| AcquireTokenSilent(IEnumerable<String>, IAccount) |
Tentativas de adquirir um token de acesso a |
| AcquireTokenSilent(IEnumerable<String>, String) |
Obsoleto.
Em clientes confidenciais usam AcquireTokenSilent(IEnumerable<String>, IAccount) aplicações em vez disso. |
| GetAccountAsync(String) |
Obtenha o IAccount identificador entre as contas disponíveis na cache do token e do mesmo ambiente (host de autoridade) que Authority. (Herdado de IClientApplicationBase) |
| GetAccountsAsync() |
Obsoleto.
Use GetAccountAsync(String) em aplicações web e APIs web, e use um serializador de cache de token para melhor segurança e desempenho. Consulte https://aka.ms/msal-net-cca-token-cache-serialization. |
| GetAccountsAsync(String) |
Apenas para cenários B2C do Azure AD, obtenha a IAccount coleção pelo seu identificador entre as contas disponíveis na cache de tokens com base no fluxo do utilizador. (Herdado de IClientApplicationBase) |
| GetAuthorizationRequestUrl(IEnumerable<String>) |
Calcula a URL do pedido de autorização, permitindo ao utilizador iniciar sessão e consentir que a aplicação aceda a escopos específicos no nome do utilizador. A URL direciona-se para o endpoint /authorize da autoridade configurada na aplicação. |
| RemoveAsync(IAccount) |
Remove todos os tokens da cache da conta especificada. (Herdado de IClientApplicationBase) |
Métodos da Extensão
| Name | Descrição |
|---|---|
| GetCertificate(IConfidentialClientApplication) |
Devolve o certificado usado para criar isto ConfidentialClientApplication, se existir. |