ClientApplicationBase.AcquireTokenSilent Método
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.
Sobrecargas
| Name | Descrição |
|---|---|
| AcquireTokenSilent(IEnumerable<String>, IAccount) |
[V3 API] Tenta adquirir um token de acesso a |
| AcquireTokenSilent(IEnumerable<String>, String) |
[V3 API] Tentativas de adquirir um token de acesso para o IAccount ter a Username correspondência ao dado |
AcquireTokenSilent(IEnumerable<String>, IAccount)
[V3 API] Tenta adquirir um token de acesso a account partir do cache de tokens do utilizador.
Consulte 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 aceder a uma API protegida
- account
- IAccount
Conta para a qual o token é solicitado.
Devoluções
An AcquireTokenSilentParameterBuilder foi usado para construir o pedido de token, adicionando parâmetros opcionais
Implementações
Exceções
será lançado no caso de ser necessária uma interação com o utilizador final da aplicação, por exemplo, se não houver token de atualização na cache, ou se o utilizador precisar de consentir, ou de voltar a iniciar sessão (por exemplo, se a palavra-passe expirar), ou se o utilizador tiver de realizar autenticação em dois fatores
Observações
O token de acesso é considerado uma correspondência se contiver pelo menos todos os escopos solicitados. Isto significa que um token de acesso com mais escopos do que o solicitado poderia ser devolvido. Se o token de acesso estiver expirado ou próximo de expirar – dentro de uma janela de 5 minutos – então o token de atualização em cache (se disponível) é usado para adquirir um novo token de acesso através de uma chamada silenciosa de rede.
Pode definir parâmetros adicionais ao encadear o construtor com: WithTenantId(String) solicitar um token para uma autoridade diferente daquela definida na construção WithForceRefresh(Boolean) da aplicação para contornar a cache do token de utilizador e forçar a atualização do token, bem Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) como para especificar parâmetros de consulta adicionais
Aplica-se a
AcquireTokenSilent(IEnumerable<String>, String)
[V3 API] Tentativas de adquirir um token de acesso para o IAccount ter a Username correspondência ao dado loginHint, a partir da cache do token do utilizador.
Consulte 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 aceder a uma API protegida
- loginHint
- String
Normalmente, o nome de utilizador, em formato UPN, por exemplo, johnd@contoso.com
Devoluções
An AcquireTokenSilentParameterBuilder foi usado para construir o pedido de token, adicionando parâmetros opcionais
Implementações
Exceções
será lançado no caso de ser necessária uma interação com o utilizador final da aplicação, por exemplo, se não houver token de atualização na cache, ou se o utilizador precisar de consentir, ou de voltar a iniciar sessão (por exemplo, se a palavra-passe expirar), ou se o utilizador tiver de realizar autenticação em dois fatores
Observações
Se vários IAccount coincidirem com o loginHint, ou se não houver correspondências, é lançada uma exceção.
O token de acesso é considerado uma correspondência se contiver pelo menos todos os escopos solicitados. Isto significa que um token de acesso com mais escopos do que o solicitado poderia ser devolvido. Se o token de acesso estiver expirado ou próximo de expirar – dentro de uma janela de 5 minutos – então o token de atualização em cache (se disponível) é usado para adquirir um novo token de acesso através de uma chamada silenciosa de rede.
Pode definir parâmetros adicionais ao encadear o construtor com: WithTenantId(String) solicitar um token para uma autoridade diferente daquela definida na construção WithForceRefresh(Boolean) da aplicação para contornar a cache do token de utilizador e forçar a atualização do token, bem Microsoft.Identity.Client.AbstractAcquireTokenParameterBuilder`1.WithExtraQueryParameters(System.Collections.Generic.Dictionary{System.String,System.String}) como para especificar parâmetros de consulta adicionais