MsalException 클래스

정의

중요

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

토큰을 획득하는 동안 오류가 발생할 때 throw되는 기본 예외 유형입니다. 자세한 내용은 https://aka.ms/msal-net-exceptions을 참조하세요.

public class MsalException : Exception

type MsalException = class
    inherit Exception

Public Class MsalException
Inherits Exception

파생: Microsoft.Identity.Client.MsalClientException

Microsoft.Identity.Client.MsalServiceException

이 예외를 throw하지 마세요. 대신 더 특수하거나 MsalClientException MsalServiceException

속성	Description
MsalException()	예외 클래스의 새 인스턴스를 초기화합니다.
MsalException(String, String, Exception)	지정된 오류 코드와 이 예외의 원인인 내부 예외에 대한 참조를 사용하여 예외 클래스의 새 인스턴스를 초기화합니다.
MsalException(String, String)	지정된 오류 코드 및 오류 메시지를 사용하여 예외 클래스의 새 인스턴스를 초기화합니다.
MsalException(String)	지정된 오류 코드를 사용하여 예외 클래스의 새 인스턴스를 초기화합니다.

속성	Description
AuthenticationResultMetadataKey	토큰 획득이 Data 실패MsalException할 때 MSAL이 캡처된 것을 저장하는 AuthenticationResultMetadata 키입니다. 원래 예외가 변경되지 않고 다시 throw되더라도 다운스트림 소비자가 토큰 획득 진단을 노출할 수 있습니다.
BrokerErrorCode	AdditionalExceptionData 데스크톱 브로커를 사용할 때 사용할 수 있는 속성 키입니다.
BrokerErrorContext	AdditionalExceptionData 데스크톱 브로커를 사용할 때 사용할 수 있는 속성 키입니다.
BrokerErrorStatus	AdditionalExceptionData 데스크톱 브로커를 사용할 때 사용할 수 있는 속성 키입니다.
BrokerErrorTag	AdditionalExceptionData 데스크톱 브로커를 사용할 때 사용할 수 있는 속성 키입니다.
BrokerTelemetry	AdditionalExceptionData 데스크톱 브로커를 사용할 때 사용할 수 있는 속성 키입니다.
ManagedIdentitySource	AdditionalExceptionData 관리 ID를 사용할 때 사용할 수 있는 속성 키입니다.

속성	Description
AdditionalExceptionData	이 예외에 대한 추가 세부 정보가 있는 속성 모음입니다.
AuthenticationResultMetadata	실패한 토큰 획득 시도에 대한 진단 메타데이터 - 총 기간 및 관련 단계가 실행된 경우 HTTP/캐시 기간, 토큰 엔드포인트 및 사용된 지역입니다. 요청 `null` 파이프라인이 메타데이터 수집을 시작하기 전에 예외가 throw된 경우입니다(예: 매개 변수 또는 작성기 유효성 검사). null이 아닌 경우(일반적인 요청 내 오류) DurationTotalInMs 는 항상 채워지지만(대기 시간 측정에 유용함), 해당 단계가 실행되지 않은 경우 다른 필드는 0/null일 수 있습니다. 오류 TokenSource 의 경우 의미 있는 값이 없으며 의존해서는 안 됩니다. 성공 경로에서 반환된 AuthenticationResultMetadata 형식을 다시 사용합니다.
CorrelationId	단일 인증 흐름을 구성하는 데 사용할 수 있는 ID입니다.
ErrorCode	서비스에서 반환되거나 클라이언트에서 생성한 프로토콜 오류 코드를 가져옵니다. 예외 처리에 사용할 수 있는 코드입니다. 이 코드의 값은 일반적으로 완화에 대한 설명과 함께 파생된 예외 형식의 상수 문자열로 제공됩니다.
IsRetryable	이 예외를 발생시킨 이전 작업을 다시 시도해야 하는지를 나타냅니다.

속성	Description
FromJsonString(String)	ToJsonString()에서 생성된 JSON에서 MsalException(또는 파생 형식 중 하나)의 다시 하이드레이션을 허용합니다.
ToJsonString()	예외의 대부분의 값을 JSON으로 serialization할 수 있습니다.
ToString()	현재 예외의 문자열 표현을 만들고 반환합니다.

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