TokenCache Classe

Definição

Espaço de Nomes:
Microsoft.Identity.Client
Assemblagem:
Microsoft.Identity.Client.dll
Pacote:
Microsoft.Identity.Client v4.84.2

Cache de tokens armazena tokens de acesso e atualização para contas Esta classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, são usadas duas instâncias, uma para a cache de tokens de utilizador e outra para a cache de tokens de aplicação (no caso de aplicações que utilizam os fluxos de credenciais do cliente).

public sealed class TokenCache
type TokenCache = class
    interface ITokenCache
    interface ITokenCacheSerializer
Public NotInheritable Class TokenCache
Herança
Object
TokenCache
Implementações
ITokenCache ITokenCacheSerializer

Construtores

Name Descrição
TokenCache()
Obsoleto.

Construtor de uma cache de tokens. Este construtor é deixado para compatibilidade com o MSAL 2.x. A forma recomendada de obter uma cache é usando UserTokenCache e IConfidentialClientApplication.AppTokenCache depois de a aplicação estar criada.

Métodos

Name Descrição
SetAfterAccess(TokenCacheCallback)

Define um delegado para ser notificado após qualquer método de biblioteca aceder à cache. Isso dá uma opção ao delegado para serializar uma entrada de cache para o aplicativo e as contas especificadas no TokenCacheNotificationArgs. Veja https://aka.ms/msal-net-token-cache-serialization
SetAfterAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Cache de tokens armazena tokens de acesso e atualização para contas Esta classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, são usadas duas instâncias, uma para a cache de tokens de utilizador e outra para a cache de tokens de aplicação (no caso de aplicações que utilizam os fluxos de credenciais do cliente).
SetBeforeAccess(TokenCacheCallback)

Define um delegado para ser notificado antes de qualquer método de biblioteca aceder à cache. Isso dá uma opção ao delegado para desserializar uma entrada de cache para o aplicativo e as contas especificadas no TokenCacheNotificationArgs. Veja https://aka.ms/msal-net-token-cache-serialization
SetBeforeAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Cache de tokens armazena tokens de acesso e atualização para contas Esta classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, são usadas duas instâncias, uma para a cache de tokens de utilizador e outra para a cache de tokens de aplicação (no caso de aplicações que utilizam os fluxos de credenciais do cliente).
SetBeforeWrite(TokenCacheCallback)

Define um delegado chamado antes de qualquer método de biblioteca escrever na cache. Isto dá ao delegado a opção de recarregar o estado da cache a partir de uma linha na base de dados e bloquear essa linha. Essa linha de base de dados pode então ser desbloqueada no delegado registado com SetAfterAccess(TokenCacheCallback)
SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>)

Cache de tokens armazena tokens de acesso e atualização para contas Esta classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, são usadas duas instâncias, uma para a cache de tokens de utilizador e outra para a cache de tokens de aplicação (no caso de aplicações que utilizam os fluxos de credenciais do cliente).
SetIosKeychainSecurityGroup(String)

Define o grupo de segurança para ser usado com o Keychain iOS. Esta função não deve ser utilizada por clientes externos. Será removido numa versão futura do MSAL.

Implementações de Interface Explícita

Name Descrição
ITokenCacheSerializer.DeserializeAdalV3(Byte[])

Cache de tokens armazena tokens de acesso e atualização para contas Esta classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, são usadas duas instâncias, uma para a cache de tokens de utilizador e outra para a cache de tokens de aplicação (no caso de aplicações que utilizam os fluxos de credenciais do cliente).
ITokenCacheSerializer.DeserializeMsalV2(Byte[])

Cache de tokens armazena tokens de acesso e atualização para contas Esta classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, são usadas duas instâncias, uma para a cache de tokens de utilizador e outra para a cache de tokens de aplicação (no caso de aplicações que utilizam os fluxos de credenciais do cliente).
ITokenCacheSerializer.DeserializeMsalV3(Byte[], Boolean)

Cache de tokens armazena tokens de acesso e atualização para contas Esta classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, são usadas duas instâncias, uma para a cache de tokens de utilizador e outra para a cache de tokens de aplicação (no caso de aplicações que utilizam os fluxos de credenciais do cliente).
ITokenCacheSerializer.SerializeAdalV3()

Cache de tokens armazena tokens de acesso e atualização para contas Esta classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, são usadas duas instâncias, uma para a cache de tokens de utilizador e outra para a cache de tokens de aplicação (no caso de aplicações que utilizam os fluxos de credenciais do cliente).
ITokenCacheSerializer.SerializeMsalV2()

Cache de tokens armazena tokens de acesso e atualização para contas Esta classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, são usadas duas instâncias, uma para a cache de tokens de utilizador e outra para a cache de tokens de aplicação (no caso de aplicações que utilizam os fluxos de credenciais do cliente).
ITokenCacheSerializer.SerializeMsalV3()

Cache de tokens armazena tokens de acesso e atualização para contas Esta classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, são usadas duas instâncias, uma para a cache de tokens de utilizador e outra para a cache de tokens de aplicação (no caso de aplicações que utilizam os fluxos de credenciais do cliente).

Métodos da Extensão

Name Descrição
SetCacheOptions(ITokenCache, CacheOptions)

Opções para caches de tokens MSAL.

O MSAL mantém uma cache de tokens internamente na memória. Por defeito, este objeto cache faz parte de cada instância de PublicClientApplication ou ConfidentialClientApplication. Este método permite a personalização da cache de tokens em memória do MSAL.

A cache de memória da MSAL é diferente da serialização da cache de tokens. A serialização da cache retira os tokens de uma cache (por exemplo, Redis, Cosmos ou um ficheiro no disco), onde são armazenados em formato JSON, para a cache interna de memória da MSAL. As operações de cache de memória não envolvem operações JSON.

A serialização da cache externa continua a ser a forma recomendada de lidar com aplicações de ambiente de trabalho, sites web e APIs web, pois proporciona persistência. Estas opções não controlam atualmente a serialização da cache externa.

Orientação detalhada para cada tipo de aplicação e plataforma: https://aka.ms/msal-net-token-cache-serialization

Aplica-se a