ClientApplicationBase.AcquireTokenSilent Método
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.
Sobrecargas
| Nome | Description |
|---|---|
| AcquireTokenSilent(IEnumerable<String>, IAccount) |
[API V3] Tenta adquirir um token de acesso para o |
| AcquireTokenSilent(IEnumerable<String>, String) |
[API V3] Tenta adquirir um token de acesso para que ele IAccountUsername corresponda ao determinado |
AcquireTokenSilent(IEnumerable<String>, IAccount)
[API V3] Tenta adquirir um token de acesso para o account cache do token de usuário.
Veja https://aka.ms/msal-net-acquiretokensilent para mais detalhes
public Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder AcquireTokenSilent(System.Collections.Generic.IEnumerable<string> scopes, Microsoft.Identity.Client.IAccount account);abstract member AcquireTokenSilent : seq<string> * Microsoft.Identity.Client.IAccount -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder
override this.AcquireTokenSilent : seq<string> * Microsoft.Identity.Client.IAccount -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilderPublic Function AcquireTokenSilent (scopes As IEnumerable(Of String), account As IAccount) As AcquireTokenSilentParameterBuilderParâmetros
- scopes
- IEnumerable<String>
Escopos solicitados para acessar uma API protegida
- account
- IAccount
Conta para a qual o token é solicitado.
Retornos
Um AcquireTokenSilentParameterBuilder usado para criar a solicitação de token, adicionando parâmetros opcionais
Implementações
Exceções
será gerada no caso em que uma interação for necessária com o usuário final do aplicativo, por exemplo, se nenhum token de atualização estiver no cache ou se o usuário precisar consentir ou entrar novamente (por exemplo, se a senha tiver expirado) ou se o usuário precisar executar a autenticação de dois fatores
Comentários
O token de acesso será considerado uma correspondência se ele contiver pelo menos todos os escopos solicitados. Isso significa que um token de acesso com mais escopos do que o solicitado pode ser retornado. Se o token de acesso estiver expirado ou perto da expiração , dentro de uma janela de 5 minutos, o token de atualização armazenado em cache (se disponível) será usado para adquirir um novo token de acesso fazendo uma chamada de rede silenciosa.
Você pode definir parâmetros adicionais encadeando o construtor com: WithTenantId(String) para solicitar um token para uma autoridade diferente daquela definida na construção WithForceRefresh(Boolean) do aplicativo para ignorar o cache de token de usuário e forçar a atualização do token, bem como Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) especificar parâmetros de consulta extras
Aplica-se a
AcquireTokenSilent(IEnumerable<String>, String)
[API V3] Tenta adquirir um token de acesso para que ele IAccountUsername corresponda ao determinado loginHintno cache de token de usuário.
Veja https://aka.ms/msal-net-acquiretokensilent para mais detalhes
public Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder AcquireTokenSilent(System.Collections.Generic.IEnumerable<string> scopes, string loginHint);abstract member AcquireTokenSilent : seq<string> * string -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilder
override this.AcquireTokenSilent : seq<string> * string -> Microsoft.Identity.Client.AcquireTokenSilentParameterBuilderPublic Function AcquireTokenSilent (scopes As IEnumerable(Of String), loginHint As String) As AcquireTokenSilentParameterBuilderParâmetros
- scopes
- IEnumerable<String>
Escopos solicitados para acessar uma API protegida
- loginHint
- String
Normalmente, o nome de usuário, no formato UPN, por exemplo, johnd@contoso.com
Retornos
Um AcquireTokenSilentParameterBuilder usado para criar a solicitação de token, adicionando parâmetros opcionais
Implementações
Exceções
será gerada no caso em que uma interação for necessária com o usuário final do aplicativo, por exemplo, se nenhum token de atualização estiver no cache ou se o usuário precisar consentir ou entrar novamente (por exemplo, se a senha tiver expirado) ou se o usuário precisar executar a autenticação de dois fatores
Comentários
Se vários corresponderem IAccount ao loginHint, ou se não houver correspondências, uma exceção será gerada.
O token de acesso será considerado uma correspondência se ele contiver pelo menos todos os escopos solicitados. Isso significa que um token de acesso com mais escopos do que o solicitado pode ser retornado. Se o token de acesso estiver expirado ou perto da expiração , dentro de uma janela de 5 minutos, o token de atualização armazenado em cache (se disponível) será usado para adquirir um novo token de acesso fazendo uma chamada de rede silenciosa.
Você pode definir parâmetros adicionais encadeando o construtor com: WithTenantId(String) para solicitar um token para uma autoridade diferente daquela definida na construção WithForceRefresh(Boolean) do aplicativo para ignorar o cache de token de usuário e forçar a atualização do token, bem como Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) especificar parâmetros de consulta extras