TokenCache Classe

Definição

Namespace:
Microsoft.Identity.Client
Assembly:
Microsoft.Identity.Client.dll
Pacote:
Microsoft.Identity.Client v4.84.2

Cache de tokens armazenando tokens de acesso e atualização para contas Essa classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, duas instâncias são usadas, uma para o cache de token de usuário e outra para o cache de token de aplicativo (no caso de aplicativos usando os fluxos de credencial 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

Nome Description
TokenCache()
Obsoleto.

Construtor de um cache de token. Esse construtor é deixado para compatibilidade com MSAL 2.x. A maneira recomendada de obter um cache é usando UserTokenCache e IConfidentialClientApplication.AppTokenCache depois que o aplicativo é criado.

Métodos

Nome Description
SetAfterAccess(TokenCacheCallback)

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

Cache de tokens armazenando tokens de acesso e atualização para contas Essa classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, duas instâncias são usadas, uma para o cache de token de usuário e outra para o cache de token de aplicativo (no caso de aplicativos usando os fluxos de credencial do cliente).
SetBeforeAccess(TokenCacheCallback)

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

Cache de tokens armazenando tokens de acesso e atualização para contas Essa classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, duas instâncias são usadas, uma para o cache de token de usuário e outra para o cache de token de aplicativo (no caso de aplicativos usando os fluxos de credencial do cliente).
SetBeforeWrite(TokenCacheCallback)

Define um delegado chamado antes de qualquer método de biblioteca gravar no cache. Isso fornece uma opção ao delegado para recarregar o estado do cache de uma linha no banco de dados e bloquear essa linha. Essa linha de banco de dados pode ser desbloqueada no delegado registrado com SetAfterAccess(TokenCacheCallback)
SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>)

Cache de tokens armazenando tokens de acesso e atualização para contas Essa classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, duas instâncias são usadas, uma para o cache de token de usuário e outra para o cache de token de aplicativo (no caso de aplicativos usando os fluxos de credencial do cliente).
SetIosKeychainSecurityGroup(String)

Define o grupo de segurança a ser usado com o conjunto de chaves do iOS. Essa função não deve ser usada por clientes externos. Ele será removido em uma versão futura da MSAL.

Implantações explícitas de interface

Nome Description
ITokenCacheSerializer.DeserializeAdalV3(Byte[])

Cache de tokens armazenando tokens de acesso e atualização para contas Essa classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, duas instâncias são usadas, uma para o cache de token de usuário e outra para o cache de token de aplicativo (no caso de aplicativos usando os fluxos de credencial do cliente).
ITokenCacheSerializer.DeserializeMsalV2(Byte[])

Cache de tokens armazenando tokens de acesso e atualização para contas Essa classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, duas instâncias são usadas, uma para o cache de token de usuário e outra para o cache de token de aplicativo (no caso de aplicativos usando os fluxos de credencial do cliente).
ITokenCacheSerializer.DeserializeMsalV3(Byte[], Boolean)

Cache de tokens armazenando tokens de acesso e atualização para contas Essa classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, duas instâncias são usadas, uma para o cache de token de usuário e outra para o cache de token de aplicativo (no caso de aplicativos usando os fluxos de credencial do cliente).
ITokenCacheSerializer.SerializeAdalV3()

Cache de tokens armazenando tokens de acesso e atualização para contas Essa classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, duas instâncias são usadas, uma para o cache de token de usuário e outra para o cache de token de aplicativo (no caso de aplicativos usando os fluxos de credencial do cliente).
ITokenCacheSerializer.SerializeMsalV2()

Cache de tokens armazenando tokens de acesso e atualização para contas Essa classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, duas instâncias são usadas, uma para o cache de token de usuário e outra para o cache de token de aplicativo (no caso de aplicativos usando os fluxos de credencial do cliente).
ITokenCacheSerializer.SerializeMsalV3()

Cache de tokens armazenando tokens de acesso e atualização para contas Essa classe é usada nos construtores de PublicClientApplication e ConfidentialClientApplication. No caso do ConfidentialClientApplication, duas instâncias são usadas, uma para o cache de token de usuário e outra para o cache de token de aplicativo (no caso de aplicativos usando os fluxos de credencial do cliente).

Métodos de Extensão

Nome Description
SetCacheOptions(ITokenCache, CacheOptions)

Opções para caches de token MSAL.

A MSAL mantém um cache de token internamente na memória. Por padrão, esse objeto de cache faz parte de cada instância de PublicClientApplication ou ConfidentialClientApplication. Esse método permite a personalização do cache de token na memória da MSAL.

O cache de memória da MSAL é diferente da serialização do cache de token. A serialização de cache extrai os tokens de um cache (por exemplo, Redis, Cosmos ou um arquivo em disco), em que eles são armazenados no formato JSON, no cache de memória interna da MSAL. As operações de cache de memória não envolvem operações JSON.

A serialização de cache externo continua sendo a maneira recomendada de lidar com aplicativos da área de trabalho, site e APIs da Web, pois fornece persistência. No momento, essas opções não controlam a serialização de cache externo.

Diretrizes detalhadas para cada tipo de aplicativo e plataforma: https://aka.ms/msal-net-token-cache-serialization

Aplica-se a