TokenCache 클래스

정의

네임스페이스:: Microsoft.Identity.Client

어셈블리:: Microsoft.Identity.Client.dll

패키지:: Microsoft.Identity.Client v4.84.2

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

계정에 대한 액세스 및 새로 고침 토큰을 저장하는 토큰 캐시 이 클래스는 생성자 PublicClientApplication 에서 ConfidentialClientApplication사용됩니다. ConfidentialClientApplication의 경우 두 개의 인스턴스가 사용됩니다. 하나는 사용자 토큰 캐시에 사용되고, 다른 하나는 애플리케이션 토큰 캐시에 사용됩니다(클라이언트 자격 증명 흐름을 사용하는 애플리케이션의 경우).

public sealed class TokenCache

type TokenCache = class
    interface ITokenCache
    interface ITokenCacheSerializer

Public NotInheritable Class TokenCache

상속: Object
TokenCache

구현: ITokenCache ITokenCacheSerializer

생성자

Name	Description
TokenCache()	사용되지 않음. 토큰 캐시의 생성자입니다. 이 생성자는 MSAL 2.x와의 호환성을 위해 남아 있습니다. 캐시를 가져오는 권장 방법은 앱을 만들고 나면 사용하는 UserTokenCache`IConfidentialClientApplication.AppTokenCache` 것입니다.

메서드

Name	Description
SetAfterAccess(TokenCacheCallback)	라이브러리 메서드가 캐시에 액세스한 후 알림을 받을 대리자를 설정합니다. 이는 TokenCacheNotificationArgs에 지정된 애플리케이션 및 계정에 대한 캐시 항목을 직렬화하는 옵션을 대리자에게 제공합니다. https://aka.ms/msal-net-token-cache-serialization을 참조하십시오.
SetAfterAccessAsync(Func<TokenCacheNotificationArgs,Task>)	계정에 대한 액세스 및 새로 고침 토큰을 저장하는 토큰 캐시 이 클래스는 생성자 PublicClientApplication 에서 ConfidentialClientApplication사용됩니다. ConfidentialClientApplication의 경우 두 개의 인스턴스가 사용됩니다. 하나는 사용자 토큰 캐시에 사용되고, 다른 하나는 애플리케이션 토큰 캐시에 사용됩니다(클라이언트 자격 증명 흐름을 사용하는 애플리케이션의 경우).
SetBeforeAccess(TokenCacheCallback)	라이브러리 메서드가 캐시에 액세스하기 전에 알림을 받을 대리자를 설정합니다. 이는 TokenCacheNotificationArgs에 지정된 애플리케이션 및 계정에 대한 캐시 항목을 역직렬화하는 옵션을 대리자에게 제공합니다. https://aka.ms/msal-net-token-cache-serialization을 참조하십시오.
SetBeforeAccessAsync(Func<TokenCacheNotificationArgs,Task>)	계정에 대한 액세스 및 새로 고침 토큰을 저장하는 토큰 캐시 이 클래스는 생성자 PublicClientApplication 에서 ConfidentialClientApplication사용됩니다. ConfidentialClientApplication의 경우 두 개의 인스턴스가 사용됩니다. 하나는 사용자 토큰 캐시에 사용되고, 다른 하나는 애플리케이션 토큰 캐시에 사용됩니다(클라이언트 자격 증명 흐름을 사용하는 애플리케이션의 경우).
SetBeforeWrite(TokenCacheCallback)	라이브러리 메서드가 캐시에 쓰기 전에 호출된 대리자를 설정합니다. 이렇게 하면 대리자가 데이터베이스의 행에서 캐시 상태를 다시 로드하고 해당 행을 잠글 수 있는 옵션이 제공됩니다. 그러면 등록된 대리자에서 해당 데이터베이스 행의 잠금을 해제할 수 있습니다. SetAfterAccess(TokenCacheCallback)
SetBeforeWriteAsync(Func<TokenCacheNotificationArgs,Task>)	계정에 대한 액세스 및 새로 고침 토큰을 저장하는 토큰 캐시 이 클래스는 생성자 PublicClientApplication 에서 ConfidentialClientApplication사용됩니다. ConfidentialClientApplication의 경우 두 개의 인스턴스가 사용됩니다. 하나는 사용자 토큰 캐시에 사용되고, 다른 하나는 애플리케이션 토큰 캐시에 사용됩니다(클라이언트 자격 증명 흐름을 사용하는 애플리케이션의 경우).
SetIosKeychainSecurityGroup(String)	iOS 키 집합과 함께 사용할 보안 그룹을 설정합니다. 이 함수는 외부 고객이 사용하면 안 됩니다. 이후 버전의 MSAL에서 제거됩니다 .

명시적 인터페이스 구현

Name	Description
ITokenCacheSerializer.DeserializeAdalV3(Byte[])	계정에 대한 액세스 및 새로 고침 토큰을 저장하는 토큰 캐시 이 클래스는 생성자 PublicClientApplication 에서 ConfidentialClientApplication사용됩니다. ConfidentialClientApplication의 경우 두 개의 인스턴스가 사용됩니다. 하나는 사용자 토큰 캐시에 사용되고, 다른 하나는 애플리케이션 토큰 캐시에 사용됩니다(클라이언트 자격 증명 흐름을 사용하는 애플리케이션의 경우).
ITokenCacheSerializer.DeserializeMsalV2(Byte[])	계정에 대한 액세스 및 새로 고침 토큰을 저장하는 토큰 캐시 이 클래스는 생성자 PublicClientApplication 에서 ConfidentialClientApplication사용됩니다. ConfidentialClientApplication의 경우 두 개의 인스턴스가 사용됩니다. 하나는 사용자 토큰 캐시에 사용되고, 다른 하나는 애플리케이션 토큰 캐시에 사용됩니다(클라이언트 자격 증명 흐름을 사용하는 애플리케이션의 경우).
ITokenCacheSerializer.DeserializeMsalV3(Byte[], Boolean)	계정에 대한 액세스 및 새로 고침 토큰을 저장하는 토큰 캐시 이 클래스는 생성자 PublicClientApplication 에서 ConfidentialClientApplication사용됩니다. ConfidentialClientApplication의 경우 두 개의 인스턴스가 사용됩니다. 하나는 사용자 토큰 캐시에 사용되고, 다른 하나는 애플리케이션 토큰 캐시에 사용됩니다(클라이언트 자격 증명 흐름을 사용하는 애플리케이션의 경우).
ITokenCacheSerializer.SerializeAdalV3()	계정에 대한 액세스 및 새로 고침 토큰을 저장하는 토큰 캐시 이 클래스는 생성자 PublicClientApplication 에서 ConfidentialClientApplication사용됩니다. ConfidentialClientApplication의 경우 두 개의 인스턴스가 사용됩니다. 하나는 사용자 토큰 캐시에 사용되고, 다른 하나는 애플리케이션 토큰 캐시에 사용됩니다(클라이언트 자격 증명 흐름을 사용하는 애플리케이션의 경우).
ITokenCacheSerializer.SerializeMsalV2()	계정에 대한 액세스 및 새로 고침 토큰을 저장하는 토큰 캐시 이 클래스는 생성자 PublicClientApplication 에서 ConfidentialClientApplication사용됩니다. ConfidentialClientApplication의 경우 두 개의 인스턴스가 사용됩니다. 하나는 사용자 토큰 캐시에 사용되고, 다른 하나는 애플리케이션 토큰 캐시에 사용됩니다(클라이언트 자격 증명 흐름을 사용하는 애플리케이션의 경우).
ITokenCacheSerializer.SerializeMsalV3()	계정에 대한 액세스 및 새로 고침 토큰을 저장하는 토큰 캐시 이 클래스는 생성자 PublicClientApplication 에서 ConfidentialClientApplication사용됩니다. ConfidentialClientApplication의 경우 두 개의 인스턴스가 사용됩니다. 하나는 사용자 토큰 캐시에 사용되고, 다른 하나는 애플리케이션 토큰 캐시에 사용됩니다(클라이언트 자격 증명 흐름을 사용하는 애플리케이션의 경우).

확장명 메서드

Name	Description
SetCacheOptions(ITokenCache, CacheOptions)	MSAL 토큰 캐시에 대한 옵션입니다. MSAL은 메모리에 내부적으로 토큰 캐시를 유지 관리합니다. 기본적으로 이 캐시 개체는 각 인스턴스의 PublicClientApplication 일부 또는 ConfidentialClientApplication. 이 메서드를 사용하면 MSAL의 메모리 내 토큰 캐시를 사용자 지정할 수 있습니다. MSAL의 메모리 캐시는 토큰 캐시 serialization과 다릅니다. 캐시 serialization은 JSON 형식으로 저장된 캐시(예: Redis, Cosmos 또는 디스크의 파일)에서 MSAL의 내부 메모리 캐시로 토큰을 가져옵니다. 메모리 캐시 작업에는 JSON 작업이 포함되지 않습니다. 외부 캐시 직렬화는 지속성을 제공하므로 데스크톱 앱, 웹 사이트 및 웹 API를 처리하는 데 권장되는 방법입니다. 이러한 옵션은 현재 외부 캐시 serialization을 제어하지 않습니다. 각 애플리케이션 유형 및 플랫폼에 대한 자세한 지침: https://aka.ms/msal-net-token-cache-serialization

Name

Description

SetCacheOptions(ITokenCache, CacheOptions)

MSAL 토큰 캐시에 대한 옵션입니다.

MSAL은 메모리에 내부적으로 토큰 캐시를 유지 관리합니다. 기본적으로 이 캐시 개체는 각 인스턴스의 PublicClientApplication 일부 또는 ConfidentialClientApplication. 이 메서드를 사용하면 MSAL의 메모리 내 토큰 캐시를 사용자 지정할 수 있습니다.

MSAL의 메모리 캐시는 토큰 캐시 serialization과 다릅니다. 캐시 serialization은 JSON 형식으로 저장된 캐시(예: Redis, Cosmos 또는 디스크의 파일)에서 MSAL의 내부 메모리 캐시로 토큰을 가져옵니다. 메모리 캐시 작업에는 JSON 작업이 포함되지 않습니다.

외부 캐시 직렬화는 지속성을 제공하므로 데스크톱 앱, 웹 사이트 및 웹 API를 처리하는 데 권장되는 방법입니다. 이러한 옵션은 현재 외부 캐시 serialization을 제어하지 않습니다.

각 애플리케이션 유형 및 플랫폼에 대한 자세한 지침: https://aka.ms/msal-net-token-cache-serialization

적용 대상

피드백

이 페이지가 도움이 되었나요?