TokenCache Clase

Definición

Espacio de nombres:
Microsoft.Identity.Client
Ensamblado:
Microsoft.Identity.Client.dll
Paquete:
Microsoft.Identity.Client v4.84.2

Caché de tokens que almacena tokens de acceso y actualización para cuentas Esta clase se usa en los constructores de PublicClientApplication y ConfidentialClientApplication. En el caso de ConfidentialClientApplication, se usan dos instancias, una para la caché de tokens de usuario y otra para la caché de tokens de aplicación (en el caso de las aplicaciones que usan los flujos de credenciales de cliente).

public sealed class TokenCache
type TokenCache = class
    interface ITokenCache
    interface ITokenCacheSerializer
Public NotInheritable Class TokenCache
Herencia
Object
TokenCache
Implementaciones
ITokenCache ITokenCacheSerializer

Constructores

Nombre Description
TokenCache()
Obsoletos.

Constructor de una caché de tokens. Este constructor se deja para la compatibilidad con MSAL 2.x. La manera recomendada de obtener una memoria caché es mediante UserTokenCache y IConfidentialClientApplication.AppTokenCache una vez creada la aplicación.

Métodos

Nombre Description
SetAfterAccess(TokenCacheCallback)

Establece un delegado que se notificará después de que cualquier método de biblioteca acceda a la memoria caché. Esto proporciona una opción al delegado para serializar una entrada de caché para la aplicación y las cuentas especificadas en TokenCacheNotificationArgs. Vea https://aka.ms/msal-net-token-cache-serialization.
SetAfterAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Caché de tokens que almacena tokens de acceso y actualización para cuentas Esta clase se usa en los constructores de PublicClientApplication y ConfidentialClientApplication. En el caso de ConfidentialClientApplication, se usan dos instancias, una para la caché de tokens de usuario y otra para la caché de tokens de aplicación (en el caso de las aplicaciones que usan los flujos de credenciales de cliente).
SetBeforeAccess(TokenCacheCallback)

Establece un delegado que se notificará antes de que cualquier método de biblioteca acceda a la memoria caché. Esto proporciona una opción al delegado para deserializar una entrada de caché para la aplicación y las cuentas especificadas en TokenCacheNotificationArgs. Vea https://aka.ms/msal-net-token-cache-serialization.
SetBeforeAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Caché de tokens que almacena tokens de acceso y actualización para cuentas Esta clase se usa en los constructores de PublicClientApplication y ConfidentialClientApplication. En el caso de ConfidentialClientApplication, se usan dos instancias, una para la caché de tokens de usuario y otra para la caché de tokens de aplicación (en el caso de las aplicaciones que usan los flujos de credenciales de cliente).
SetBeforeWrite(TokenCacheCallback)

Establece un delegado llamado antes de que cualquier método de biblioteca escriba en la memoria caché. Esto ofrece una opción para que el delegado vuelva a cargar el estado de la caché desde una fila de la base de datos y bloquee esa fila. Después, esa fila de base de datos se puede desbloquear en el delegado registrado con SetAfterAccess(TokenCacheCallback)
SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>)

Caché de tokens que almacena tokens de acceso y actualización para cuentas Esta clase se usa en los constructores de PublicClientApplication y ConfidentialClientApplication. En el caso de ConfidentialClientApplication, se usan dos instancias, una para la caché de tokens de usuario y otra para la caché de tokens de aplicación (en el caso de las aplicaciones que usan los flujos de credenciales de cliente).
SetIosKeychainSecurityGroup(String)

Establece el grupo de seguridad que se va a usar con la cadena de claves de iOS. Los clientes externos no deben usar esta función. Se quitará en una versión futura de MSAL.

Implementaciones de interfaz explícitas

Nombre Description
ITokenCacheSerializer.DeserializeAdalV3(Byte[])

Caché de tokens que almacena tokens de acceso y actualización para cuentas Esta clase se usa en los constructores de PublicClientApplication y ConfidentialClientApplication. En el caso de ConfidentialClientApplication, se usan dos instancias, una para la caché de tokens de usuario y otra para la caché de tokens de aplicación (en el caso de las aplicaciones que usan los flujos de credenciales de cliente).
ITokenCacheSerializer.DeserializeMsalV2(Byte[])

Caché de tokens que almacena tokens de acceso y actualización para cuentas Esta clase se usa en los constructores de PublicClientApplication y ConfidentialClientApplication. En el caso de ConfidentialClientApplication, se usan dos instancias, una para la caché de tokens de usuario y otra para la caché de tokens de aplicación (en el caso de las aplicaciones que usan los flujos de credenciales de cliente).
ITokenCacheSerializer.DeserializeMsalV3(Byte[], Boolean)

Caché de tokens que almacena tokens de acceso y actualización para cuentas Esta clase se usa en los constructores de PublicClientApplication y ConfidentialClientApplication. En el caso de ConfidentialClientApplication, se usan dos instancias, una para la caché de tokens de usuario y otra para la caché de tokens de aplicación (en el caso de las aplicaciones que usan los flujos de credenciales de cliente).
ITokenCacheSerializer.SerializeAdalV3()

Caché de tokens que almacena tokens de acceso y actualización para cuentas Esta clase se usa en los constructores de PublicClientApplication y ConfidentialClientApplication. En el caso de ConfidentialClientApplication, se usan dos instancias, una para la caché de tokens de usuario y otra para la caché de tokens de aplicación (en el caso de las aplicaciones que usan los flujos de credenciales de cliente).
ITokenCacheSerializer.SerializeMsalV2()

Caché de tokens que almacena tokens de acceso y actualización para cuentas Esta clase se usa en los constructores de PublicClientApplication y ConfidentialClientApplication. En el caso de ConfidentialClientApplication, se usan dos instancias, una para la caché de tokens de usuario y otra para la caché de tokens de aplicación (en el caso de las aplicaciones que usan los flujos de credenciales de cliente).
ITokenCacheSerializer.SerializeMsalV3()

Caché de tokens que almacena tokens de acceso y actualización para cuentas Esta clase se usa en los constructores de PublicClientApplication y ConfidentialClientApplication. En el caso de ConfidentialClientApplication, se usan dos instancias, una para la caché de tokens de usuario y otra para la caché de tokens de aplicación (en el caso de las aplicaciones que usan los flujos de credenciales de cliente).

Métodos de extensión

Nombre Description
SetCacheOptions(ITokenCache, CacheOptions)

Opciones para las cachés de tokens de MSAL.

MSAL mantiene una caché de tokens internamente en la memoria. De forma predeterminada, este objeto de caché forma parte de cada instancia de PublicClientApplication o ConfidentialClientApplication. Este método permite personalizar la caché de tokens en memoria de MSAL.

La caché de memoria de MSAL es diferente de la serialización de caché de tokens. La serialización de caché extrae los tokens de una memoria caché (por ejemplo, Redis, Cosmos o un archivo en disco), donde se almacenan en formato JSON, en la caché de memoria interna de MSAL. Las operaciones de caché de memoria no implican operaciones JSON.

La serialización de caché externa sigue siendo la manera recomendada de controlar las aplicaciones de escritorio, el sitio web y las API web, ya que proporciona persistencia. Estas opciones no controlan actualmente la serialización de caché externa.

Instrucciones detalladas para cada tipo de aplicación y plataforma: https://aka.ms/msal-net-token-cache-serialization

Se aplica a