Język

TokenCache Klasa

Definicja

Przestrzeń nazw:
Microsoft.Identity.Client
Zestaw:
Microsoft.Identity.Client.dll
Pakiet:
Microsoft.Identity.Client v4.84.2

Pamięć podręczna tokenów przechowująca tokeny dostępu i odświeżania dla kont Ta klasa jest używana w konstruktorach PublicClientApplication elementów i ConfidentialClientApplication. W przypadku klasy ConfidentialClientApplication używane są dwa wystąpienia, jedno dla pamięci podręcznej tokenu użytkownika i jedno dla pamięci podręcznej tokenu aplikacji (w przypadku aplikacji korzystających z przepływów poświadczeń klienta).

public sealed class TokenCache
type TokenCache = class
    interface ITokenCache
    interface ITokenCacheSerializer
Public NotInheritable Class TokenCache
Dziedziczenie
Object
TokenCache
Implementuje
ITokenCache ITokenCacheSerializer

Konstruktory

Nazwa Opis
TokenCache()
Przestarzałe.

Konstruktor pamięci podręcznej tokenu. Ten konstruktor pozostaje w celu zachowania zgodności z biblioteką MSAL 2.x. Zalecanym sposobem uzyskania pamięci podręcznej jest użycie metody UserTokenCache i IConfidentialClientApplication.AppTokenCache po utworzeniu aplikacji.

Metody

Nazwa Opis
SetAfterAccess(TokenCacheCallback)

Ustawia pełnomocnika, który ma być powiadamiany po jakichkolwiek metodach biblioteki uzyskuje dostęp do pamięci podręcznej. To przekazuje delegatowi możliwość zserializowania wpisu pamięci podręcznej dla aplikacji i kont określonych w TokenCacheNotificationArgs. Zobacz https://aka.ms/msal-net-token-cache-serialization
SetAfterAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Pamięć podręczna tokenów przechowująca tokeny dostępu i odświeżania dla kont Ta klasa jest używana w konstruktorach PublicClientApplication elementów i ConfidentialClientApplication. W przypadku klasy ConfidentialClientApplication używane są dwa wystąpienia, jedno dla pamięci podręcznej tokenu użytkownika i jedno dla pamięci podręcznej tokenu aplikacji (w przypadku aplikacji korzystających z przepływów poświadczeń klienta).
SetBeforeAccess(TokenCacheCallback)

Ustawia pełnomocnika, który ma być powiadamiany przed uzyskaniem dostępu do pamięci podręcznej przez dowolną metodę biblioteki. To daje opcję dla delegata do deserializacji wpisu pamięci podręcznej dla aplikacji i kont wskazanych w pliku TokenCacheNotificationArgs. Zobacz https://aka.ms/msal-net-token-cache-serialization
SetBeforeAccessAsync(Func<TokenCacheNotificationArgs,Task>)

Pamięć podręczna tokenów przechowująca tokeny dostępu i odświeżania dla kont Ta klasa jest używana w konstruktorach PublicClientApplication elementów i ConfidentialClientApplication. W przypadku klasy ConfidentialClientApplication używane są dwa wystąpienia, jedno dla pamięci podręcznej tokenu użytkownika i jedno dla pamięci podręcznej tokenu aplikacji (w przypadku aplikacji korzystających z przepływów poświadczeń klienta).
SetBeforeWrite(TokenCacheCallback)

Ustawia delegata wywoływanego przed zapisaniem dowolnej metody biblioteki w pamięci podręcznej. Dzięki temu pełnomocnik może ponownie załadować stan pamięci podręcznej z wiersza w bazie danych i zablokować ten wiersz. Ten wiersz bazy danych można następnie odblokować w pełnomocniku zarejestrowanym za pomocą polecenia SetAfterAccess(TokenCacheCallback)
SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>)

Pamięć podręczna tokenów przechowująca tokeny dostępu i odświeżania dla kont Ta klasa jest używana w konstruktorach PublicClientApplication elementów i ConfidentialClientApplication. W przypadku klasy ConfidentialClientApplication używane są dwa wystąpienia, jedno dla pamięci podręcznej tokenu użytkownika i jedno dla pamięci podręcznej tokenu aplikacji (w przypadku aplikacji korzystających z przepływów poświadczeń klienta).
SetIosKeychainSecurityGroup(String)

Ustawia grupę zabezpieczeń do użycia z pękiem kluczy systemu iOS. Ta funkcja nie powinna być używana przez klientów zewnętrznych. Zostanie on usunięty w przyszłej wersji biblioteki MSAL.

Jawne implementacje interfejsu

Nazwa Opis
ITokenCacheSerializer.DeserializeAdalV3(Byte[])

Pamięć podręczna tokenów przechowująca tokeny dostępu i odświeżania dla kont Ta klasa jest używana w konstruktorach PublicClientApplication elementów i ConfidentialClientApplication. W przypadku klasy ConfidentialClientApplication używane są dwa wystąpienia, jedno dla pamięci podręcznej tokenu użytkownika i jedno dla pamięci podręcznej tokenu aplikacji (w przypadku aplikacji korzystających z przepływów poświadczeń klienta).
ITokenCacheSerializer.DeserializeMsalV2(Byte[])

Pamięć podręczna tokenów przechowująca tokeny dostępu i odświeżania dla kont Ta klasa jest używana w konstruktorach PublicClientApplication elementów i ConfidentialClientApplication. W przypadku klasy ConfidentialClientApplication używane są dwa wystąpienia, jedno dla pamięci podręcznej tokenu użytkownika i jedno dla pamięci podręcznej tokenu aplikacji (w przypadku aplikacji korzystających z przepływów poświadczeń klienta).
ITokenCacheSerializer.DeserializeMsalV3(Byte[], Boolean)

Pamięć podręczna tokenów przechowująca tokeny dostępu i odświeżania dla kont Ta klasa jest używana w konstruktorach PublicClientApplication elementów i ConfidentialClientApplication. W przypadku klasy ConfidentialClientApplication używane są dwa wystąpienia, jedno dla pamięci podręcznej tokenu użytkownika i jedno dla pamięci podręcznej tokenu aplikacji (w przypadku aplikacji korzystających z przepływów poświadczeń klienta).
ITokenCacheSerializer.SerializeAdalV3()

Pamięć podręczna tokenów przechowująca tokeny dostępu i odświeżania dla kont Ta klasa jest używana w konstruktorach PublicClientApplication elementów i ConfidentialClientApplication. W przypadku klasy ConfidentialClientApplication używane są dwa wystąpienia, jedno dla pamięci podręcznej tokenu użytkownika i jedno dla pamięci podręcznej tokenu aplikacji (w przypadku aplikacji korzystających z przepływów poświadczeń klienta).
ITokenCacheSerializer.SerializeMsalV2()

Pamięć podręczna tokenów przechowująca tokeny dostępu i odświeżania dla kont Ta klasa jest używana w konstruktorach PublicClientApplication elementów i ConfidentialClientApplication. W przypadku klasy ConfidentialClientApplication używane są dwa wystąpienia, jedno dla pamięci podręcznej tokenu użytkownika i jedno dla pamięci podręcznej tokenu aplikacji (w przypadku aplikacji korzystających z przepływów poświadczeń klienta).
ITokenCacheSerializer.SerializeMsalV3()

Pamięć podręczna tokenów przechowująca tokeny dostępu i odświeżania dla kont Ta klasa jest używana w konstruktorach PublicClientApplication elementów i ConfidentialClientApplication. W przypadku klasy ConfidentialClientApplication używane są dwa wystąpienia, jedno dla pamięci podręcznej tokenu użytkownika i jedno dla pamięci podręcznej tokenu aplikacji (w przypadku aplikacji korzystających z przepływów poświadczeń klienta).

Metody rozszerzania

Nazwa Opis
SetCacheOptions(ITokenCache, CacheOptions)

Opcje pamięci podręcznych tokenów biblioteki MSAL.

Biblioteka MSAL przechowuje pamięć podręczną tokenu wewnętrznie w pamięci. Domyślnie ten obiekt pamięci podręcznej jest częścią każdego wystąpienia klasy PublicClientApplication lub ConfidentialClientApplication. Ta metoda umożliwia dostosowanie pamięci podręcznej tokenu w pamięci biblioteki MSAL.

Pamięć podręczna biblioteki MSAL różni się od serializacji pamięci podręcznej tokenu. Serializacja pamięci podręcznej ściąga tokeny z pamięci podręcznej (np. Redis, Cosmos lub pliku na dysku), gdzie są przechowywane w formacie JSON, do wewnętrznej pamięci podręcznej biblioteki MSAL. Operacje pamięci podręcznej nie obejmują operacji JSON.

Serializacja zewnętrznej pamięci podręcznej pozostaje zalecanym sposobem obsługi aplikacji klasycznych, witryn internetowych i internetowych interfejsów API, ponieważ zapewnia trwałość. Te opcje nie kontrolują obecnie serializacji zewnętrznej pamięci podręcznej.

Szczegółowe wskazówki dotyczące poszczególnych typów i platform aplikacji: https://aka.ms/msal-net-token-cache-serialization

Dotyczy