언어

MsalServiceException 클래스

정의

네임스페이스:
Microsoft.Identity.Client
어셈블리:
Microsoft.Identity.Client.dll
Package(패키지):
Microsoft.Identity.Client v4.91.0

서비스가 오류 응답을 반환하거나 다른 네트워킹 오류가 발생할 때 throw되는 예외 유형입니다. 자세한 내용은 https://aka.ms/msal-net-exceptions을 참조하세요.

public class MsalServiceException : Microsoft.Identity.Client.MsalException
type MsalServiceException = class
    inherit MsalException
Public Class MsalServiceException
Inherits MsalException
상속
Exception
MsalException
MsalServiceException
파생

생성자

속성 Description
MsalServiceException(String, String, Exception)

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

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

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

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

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

필드

속성 Description
AuthenticationResultMetadataKey

토큰 획득이 Data 실패MsalException할 때 MSAL이 캡처된 것을 저장하는 AuthenticationResultMetadata 키입니다. 원래 예외가 변경되지 않고 다시 throw되더라도 다운스트림 소비자가 토큰 획득 진단을 노출할 수 있습니다.

(다음에서 상속됨 MsalException)
BrokerErrorCode

AdditionalExceptionData 데스크톱 브로커를 사용할 때 사용할 수 있는 속성 키입니다.

(다음에서 상속됨 MsalException)
BrokerErrorContext

AdditionalExceptionData 데스크톱 브로커를 사용할 때 사용할 수 있는 속성 키입니다.

(다음에서 상속됨 MsalException)
BrokerErrorStatus

AdditionalExceptionData 데스크톱 브로커를 사용할 때 사용할 수 있는 속성 키입니다.

(다음에서 상속됨 MsalException)
BrokerErrorTag

AdditionalExceptionData 데스크톱 브로커를 사용할 때 사용할 수 있는 속성 키입니다.

(다음에서 상속됨 MsalException)
BrokerTelemetry

AdditionalExceptionData 데스크톱 브로커를 사용할 때 사용할 수 있는 속성 키입니다.

(다음에서 상속됨 MsalException)
ManagedIdentitySource

AdditionalExceptionData 관리 ID를 사용할 때 사용할 수 있는 속성 키입니다.

(다음에서 상속됨 MsalException)

속성

속성 Description
AdditionalExceptionData

이 예외에 대한 추가 세부 정보가 있는 속성 모음입니다.

(다음에서 상속됨 MsalException)
AuthenticationResultMetadata

실패한 토큰 획득 시도에 대한 진단 메타데이터 - 총 기간 및 관련 단계가 실행된 경우 HTTP/캐시 기간, 토큰 엔드포인트 및 사용된 지역입니다. 요청 null 파이프라인이 메타데이터 수집을 시작하기 전에 예외가 throw된 경우입니다(예: 매개 변수 또는 작성기 유효성 검사). null이 아닌 경우(일반적인 요청 내 오류) DurationTotalInMs 는 항상 채워지지만(대기 시간 측정에 유용함), 해당 단계가 실행되지 않은 경우 다른 필드는 0/null일 수 있습니다. 오류 TokenSource 의 경우 의미 있는 값이 없으며 의존해서는 안 됩니다. 성공 경로에서 반환된 AuthenticationResultMetadata 형식을 다시 사용합니다.

(다음에서 상속됨 MsalException)
Claims

서비스에서 요청한 추가 클레임입니다. 이 속성이 null이거나 비어 있지 않으면 서비스에서 2단계 인증과 같은 추가 클레임을 제공해야 합니다. 두 가지 경우는 다음과 같습니다.

자세한 내용은 를 참조하세요. https://aka.ms/msal-net-claim-challenge
CorrelationId

단일 인증 흐름을 구성하는 데 사용할 수 있는 ID입니다.

(다음에서 상속됨 MsalException)
ErrorCode

서비스에서 반환되거나 클라이언트에서 생성한 프로토콜 오류 코드를 가져옵니다. 예외 처리에 사용할 수 있는 코드입니다. 이 코드의 값은 일반적으로 완화에 대한 설명과 함께 파생된 예외 형식의 상수 문자열로 제공됩니다.

(다음에서 상속됨 MsalException)
ErrorCodesForLogging

구체화하는 토큰 서비스에서 반환된 STS 관련 오류 코드 목록입니다(예: 숫자 코드(예: <a0/>). 값은 서비스에서 내보내며 예고 없이 변경될 수 있습니다. 진단 및 로깅을 위한 것입니다. 이 값에 대한 프로덕션 동작을 분기하지 마세요. 서비스에서 오류 코드를 제공하지 않은 경우를 반환 null 합니다.
Headers

오류를 나타내는 서버 응답의 HTTP 헤더를 포함합니다.
IsRetryable

이 예외를 발생시킨 이전 작업을 다시 시도해야 하는지를 나타냅니다.

(다음에서 상속됨 MsalException)
ResponseBody

서버에서 받은 원시 응답 본문입니다.
StatusCode

HTTP 계층에서 반환된 상태 코드를 가져옵니다. 이 상태 코드는 HttpStatusCode 내부 HttpRequestException 응답의 코드이거나 브라우저 기반 흐름의 NavigateError 이벤트 상태 코드입니다( NavigateError 이벤트 상태 코드 참조). 재시도 논리 또는 오류 조사 구현과 같은 목적으로 이 코드를 사용할 수 있습니다.
SubErrorForLogging

토큰 서비스 구체화 ErrorCode 에서 반환된 하위 오류(예consent_required: , bad_tokenprotection_policy_required)입니다. 값은 서비스에서 내보내며 예고 없이 변경될 수 있습니다. 진단 및 로깅을 위한 것입니다. 이 값에 대한 프로덕션 동작을 분기하지 마세요.

메서드

속성 Description
ToJsonString()

예외의 대부분의 값을 JSON으로 serialization할 수 있습니다.

(다음에서 상속됨 MsalException)
ToString()

현재 예외의 문자열 표현을 만들고 반환합니다.
UpdateIsRetryable()

Evo, AAD와의 논의에 따라

적용 대상