Microsoft.Identity.Client 네임스페이스

NuGet NuGet 다운로드 GitHub 리포지토리 별

Microsoft.Identity.Client는 패키지를 통해 사용할 수 있는 .NET MSAL(Microsoft 인증 라이브러리)의 핵심 네임스페이 Microsoft.Identity.Client 스입니다. 여기에는 지원되는 인증 공급자로부터 토큰을 획득하는 데 필요한 모든 주요 구성 요소가 포함됩니다.

설치

CLI(.NET Command-Line 인터페이스) 사용:

dotnet add package Microsoft.Identity.Client

NuGet CLI(명령줄 인터페이스) 사용:

nuget install Microsoft.Identity.Client

패키지 관리자 콘솔 사용:

Install-Package Microsoft.Identity.Client

Visual Studio 사용:

  1. 솔루션 탐색기 엽니다.
  2. 솔루션 내에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다.
  3. NuGet 패키지 관리를 클릭합니다...
  4. 찾아보기 탭을 클릭하고 을 검색합니다 Microsoft.Identity.Client.
  5. Microsoft.Identity.Client 패키지를 클릭하고 설치를 클릭합니다.

설명서

시작하려면 .NET 가이드에 대한 Microsoft 인증 라이브러리 확인하세요.

샘플

Microsoft ID 플랫폼 코드 샘플샘플 브라우저를 참조하세요.

클래스

Name Description
AbstractAcquireTokenParameterBuilder<T>

제공된 매개 변수를 기반으로 토큰을 획득하려고 시도하는 토큰 요청 작성기의 기본 클래스입니다.

AbstractApplicationBuilder<T>

NuGet NuGet 다운로드 GitHub 리포지토리 별

Microsoft.Identity.Client는 패키지를 통해 사용할 수 있는 .NET MSAL(Microsoft 인증 라이브러리)의 핵심 네임스페이 Microsoft.Identity.Client 스입니다. 여기에는 지원되는 인증 공급자로부터 토큰을 획득하는 데 필요한 모든 주요 구성 요소가 포함됩니다.

설치

CLI(.NET Command-Line 인터페이스) 사용:

dotnet add package Microsoft.Identity.Client

NuGet CLI(명령줄 인터페이스) 사용:

nuget install Microsoft.Identity.Client

패키지 관리자 콘솔 사용:

Install-Package Microsoft.Identity.Client

Visual Studio 사용:

  1. 솔루션 탐색기 엽니다.
  2. 솔루션 내에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다.
  3. NuGet 패키지 관리를 클릭합니다...
  4. 찾아보기 탭을 클릭하고 을 검색합니다 Microsoft.Identity.Client.
  5. Microsoft.Identity.Client 패키지를 클릭하고 설치를 클릭합니다.

설명서

시작하려면 .NET 가이드에 대한 Microsoft 인증 라이브러리 확인하세요.

샘플

Microsoft ID 플랫폼 코드 샘플샘플 브라우저를 참조하세요.

AbstractClientAppBaseAcquireTokenParameterBuilder<T>

공용 클라이언트 애플리케이션 및 기밀 클라이언트 애플리케이션 토큰 획득 작업에 공통적인 매개 변수 작성기를 위한 기본 클래스

AbstractConfidentialClientAcquireTokenParameterBuilder<T>

기밀 클라이언트 애플리케이션 토큰 요청 작성기를 위한 기본 클래스

AbstractManagedIdentityAcquireTokenParameterBuilder<T>

관리 ID 애플리케이션 토큰 요청 작성기를 위한 추상 기본 클래스입니다.

AbstractPublicClientAcquireTokenParameterBuilder<T>

공용 클라이언트 애플리케이션 토큰 요청 작성기를 위한 기본 클래스

AccountExtensions

에 대한 확장 메서드 IAccount

AccountId

특정 테넌트에 있는 계정의 식별자입니다. 반환한 작성자 IAccount.HomeAccountId

AcquireTokenByAuthorizationCodeParameterBuilder

AcquireTokenByAuthorizationCode용 작성기

AcquireTokenByIntegratedWindowsAuthParameterBuilder

AcquireTokenByIntegratedWindowsAuth용 작성기

AcquireTokenByRefreshTokenParameterBuilder

메서드에 대한 매개 변수 작성기 AcquireTokenByRefreshToken(IEnumerable<String>, String) 입니다. https://aka.ms/msal-net-migration-adal2-msal2을 참조하십시오.

AcquireTokenByUserFederatedIdentityCredentialParameterBuilder

작업에 대한 매개 변수 작성기입니다 AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, String, String) .

AcquireTokenByUsernameAndPasswordConfidentialParameterBuilder

작업에 대한 매개 변수 작성기입니다 AcquireTokenByUsernamePassword(IEnumerable<String>, String, String) . https://aka.ms/msal-net-up을 참조하십시오.

AcquireTokenByUsernamePasswordParameterBuilder

작업에 대한 매개 변수 작성기입니다 AcquireTokenByUsernamePassword(IEnumerable<String>, String, String) . https://aka.ms/msal-net-up을 참조하십시오.

AcquireTokenForClientParameterBuilder

AcquireTokenForClient용 작성기(클라이언트 자격 증명 흐름, 디먼 애플리케이션에서 사용됨) https://aka.ms/msal-net-client-credentials을 참조하십시오.

AcquireTokenForManagedIdentityParameterBuilder

AcquireTokenForManagedIdentity용 작성기(관리 ID에 대한 토큰을 가져오는 데 사용됨). https://aka.ms/msal-net-managed-identity을 참조하십시오.

AcquireTokenInteractiveParameterBuilder

대화형 토큰 요청에 대한 작성기입니다. https://aka.ms/msal-net-acquire-token-interactively을 참조하십시오.

AcquireTokenOnBehalfOfParameterBuilder

AcquireTokenOnBehalfOf에 대한 작성기(OBO 흐름) 참조 https://aka.ms/msal-net-on-behalf-of

AcquireTokenSilentParameterBuilder

작업에 대한 매개 변수 작성기입니다 AcquireTokenSilent(IEnumerable<String>, IAccount) . https://aka.ms/msal-net-acquiretokensilent을 참조하십시오.

AcquireTokenWithDeviceCodeParameterBuilder

작업에 대한 매개 변수 작성기입니다 AcquireTokenWithDeviceCode(IEnumerable<String>, Func<DeviceCodeResult,Task>) . https://aka.ms/msal-net-device-code-flow을 참조하십시오.

ApplicationBase

클라이언트 애플리케이션을 만드는 데 사용되는 인터페이스입니다. 자세한 내용은 https://aka.ms/msal-net-client-applications를 참조하세요.

ApplicationOptions

구성 파일에서 로드할 수 있는 문자열 값이 있는 옵션 개체에 대한 기본 클래스(예: asp.net 구성 시나리오에서와 같이 JSON 파일) https://aka.ms/msal-net-application-configuration 파생 클래스 및 PublicClientApplicationOptions 참조 ConfidentialClientApplicationOptions

AssertionRequestOptions

생성해야 하는 클라이언트 어설션에 대한 정보 참조 https://aka.ms/msal-net-client-assertion

AuthenticationHeaderParser

에서 헤더 값을 HttpResponseHeaders검색하기 위해 인증 헤더를 구문 분석했습니다.

AuthenticationInfoParameters

Authentication-Info 헤더에서 반환된 매개 변수입니다. 이를 통해 소유 증명 등과 같은 시나리오를 수행할 수 있습니다. 참조 https://www.rfc-editor.org/rfc/rfc7615

AuthenticationResult

한 토큰 획득 작업(ConfidentialClientApplication) PublicClientApplication 의 결과를 포함합니다. 자세한 내용은 를 참조 https://aka.ms/msal-net-authenticationresult

AuthenticationResultMetadata

인증 결과의 메타데이터를 포함합니다. Metrics 추가 MSAL 전체 메트릭의 경우

BaseAbstractAcquireTokenParameterBuilder<T>

제공된 매개 변수를 기반으로 토큰을 획득하려고 시도하는 토큰 요청 작성기의 기본 클래스입니다.

BaseAbstractApplicationBuilder<T>

NuGet NuGet 다운로드 GitHub 리포지토리 별

Microsoft.Identity.Client는 패키지를 통해 사용할 수 있는 .NET MSAL(Microsoft 인증 라이브러리)의 핵심 네임스페이 Microsoft.Identity.Client 스입니다. 여기에는 지원되는 인증 공급자로부터 토큰을 획득하는 데 필요한 모든 주요 구성 요소가 포함됩니다.

설치

CLI(.NET Command-Line 인터페이스) 사용:

dotnet add package Microsoft.Identity.Client

NuGet CLI(명령줄 인터페이스) 사용:

nuget install Microsoft.Identity.Client

패키지 관리자 콘솔 사용:

Install-Package Microsoft.Identity.Client

Visual Studio 사용:

  1. 솔루션 탐색기 엽니다.
  2. 솔루션 내에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다.
  3. NuGet 패키지 관리를 클릭합니다...
  4. 찾아보기 탭을 클릭하고 을 검색합니다 Microsoft.Identity.Client.
  5. Microsoft.Identity.Client 패키지를 클릭하고 설치를 클릭합니다.

설명서

시작하려면 .NET 가이드에 대한 Microsoft 인증 라이브러리 확인하세요.

샘플

Microsoft ID 플랫폼 코드 샘플샘플 브라우저를 참조하세요.

BaseApplicationOptions

구성 파일에서 로드할 수 있는 문자열 값이 있는 옵션 개체의 기본 클래스(예: asp.net 구성 시나리오에서와 같이 JSON 파일) 파생 클래스 참조 https://aka.ms/msal-net-application-configurationApplicationOptions

BrokerOptions

클래스는 OperatingSystems에서 broker에 대한 옵션을 지정합니다. 공통 속성은 직접 멤버 플랫폼 특정 속성(있는 경우)이 해당 옵션의 일부입니다.

CacheOptions

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

ClientApplicationBase

일반적인 API 메서드 및 속성을 포함하는 추상 클래스입니다. ConfidentialClientApplication과 ConfidentialClientApplication은 모두 PublicClientApplication 이 클래스를 확장합니다. 자세한 내용은 를 참조 https://aka.ms/msal-net-client-applications

ClientSignedAssertion

에서 반환된 WithClientAssertion컨테이너입니다.

ConfidentialClientApplication

기밀 클라이언트 애플리케이션(웹앱, 웹 API 및 디먼 애플리케이션)에 사용할 클래스입니다.

ConfidentialClientApplicationBuilder

NuGet NuGet 다운로드 GitHub 리포지토리 별

Microsoft.Identity.Client는 패키지를 통해 사용할 수 있는 .NET MSAL(Microsoft 인증 라이브러리)의 핵심 네임스페이 Microsoft.Identity.Client 스입니다. 여기에는 지원되는 인증 공급자로부터 토큰을 획득하는 데 필요한 모든 주요 구성 요소가 포함됩니다.

설치

CLI(.NET Command-Line 인터페이스) 사용:

dotnet add package Microsoft.Identity.Client

NuGet CLI(명령줄 인터페이스) 사용:

nuget install Microsoft.Identity.Client

패키지 관리자 콘솔 사용:

Install-Package Microsoft.Identity.Client

Visual Studio 사용:

  1. 솔루션 탐색기 엽니다.
  2. 솔루션 내에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다.
  3. NuGet 패키지 관리를 클릭합니다...
  4. 찾아보기 탭을 클릭하고 을 검색합니다 Microsoft.Identity.Client.
  5. Microsoft.Identity.Client 패키지를 클릭하고 설치를 클릭합니다.

설명서

시작하려면 .NET 가이드에 대한 Microsoft 인증 라이브러리 확인하세요.

샘플

Microsoft ID 플랫폼 코드 샘플샘플 브라우저를 참조하세요.

ConfidentialClientApplicationOptions

기밀 클라이언트 애플리케이션(웹앱/웹 API/디먼 앱)에 대한 구성 옵션입니다. https://aka.ms/msal-net/application-configuration을 참조하십시오.

DeviceCodeResult

이 개체는 디바이스 코드 흐름의 일부로 반환되며 로그인을 탐색할 위치와 해당 디바이스에 입력해야 하는 디바이스 코드에 대한 정보를 사용자에게 표시합니다. https://aka.ms/msal-device-code-flow을(를) 참조하세요.

EmbeddedWebViewOptions

포함된 웹 보기를 사용하기 위한 옵션입니다.

GetAuthorizationRequestUrlParameterBuilder

참고: AbstractAcquireTokenParameterBuilder의 몇 가지 메서드(예: 계정)는 여기에 의미가 없습니다. 모든 공통 메서드를 포함하는 추가 기반을 만든 다음 AcquireToken에만 사용되는 계정을 포함한 다른 기본 메서드를 만들겠습니까?

IntuneAppProtectionPolicyRequiredException

Intune에서 앱 보호 정책이 필요한 경우 이 예외가 throw됩니다. 이 예외의 정보는 앱에서 MAM(모바일 앱 관리) SDK에서 필요한 등록 ID를 가져오는 데 사용할 수 있습니다. https://aka.ms/msal-net-trueMAM을 참조하십시오.

ManagedIdentityApplication

관리 ID 애플리케이션(App Services, Virtual Machines, Azure Arc, 서비스 Fabric 및 Cloud Shell 같은 Azure 리소스)에 사용할 클래스입니다.

ManagedIdentityApplicationBuilder

관리 ID 애플리케이션용 작성기입니다.

ManagedIdentityPopExtensions

관리 ID 흐름에서 mTLS 소유 증명을 사용하도록 설정하는 확장 메서드입니다.

Metrics

MSAL 전체 메트릭.

MsalClaimsChallengeException

이 예외는 해결해야 하는 엔드포인트에서 클레임이 반환되었음을 나타냅니다. 이 작업은 다음 인증 요청에서 사용하여 수행할 수 있습니다. 조건부 액세스 및 클레임 문제를 참조하세요. MFA(다단계 인증), 조건부 액세스 및 증분 동의 처리를 참조하세요.

MsalClientException

이 예외 클래스는 라이브러리 또는 디바이스에 로컬인 오류를 나타냅니다. MsalServiceException Azure AD 서비스 또는 네트워크에서 발생하는 오류를 나타내는 것과 반대입니다. 자세한 내용은 https://aka.ms/msal-net-exceptions을 참조하세요.

MsalError

MsalException에서 속성으로 반환된 오류 코드

MsalException

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

MsalManagedIdentityException

이 예외 클래스는 관리 ID 원본에서 생성된 예외에 대한 것입니다. 이 클래스는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 MsalServiceException을 catch합니다. 자세한 내용은 https://aka.ms/msal-net-managed-identity을 참조하세요.

MsalServiceException

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

MsalThrottledServiceException

MSAL이 다음과 같은 결과로 토큰을 너무 자주 획득하려고 시도하는 것을 MSAL이 감지할 때 throw되는 예외 유형입니다.

  • 이전 요청으로 인해 팔로우되지 않은 Retry-After 헤더가 포함된 HTTP 응답이 발생했습니다.
  • 이전 요청으로 인해 서버 문제를 나타내는 HTTP 429 또는 5xx가 발생했습니다.

이 예외의 속성은 원래 예외와 동일합니다.

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

MsalThrottledUiRequiredException

MSAL이 최근에 throw된 경우에도 애플리케이션이 토큰을 획득하려고 하는 것을 감지할 때 throw되는 MsalUiRequiredException 예외 유형입니다. 이를 MsalUiRequiredException 완화하려면 애플리케이션이 대화형으로 토큰 획득으로 전환해야 합니다. throw된 MsalUiRequiredException 이유를 더 잘 이해하려면 속성을 검사합니다 Classification .

이 예외의 속성은 원래 예외와 동일합니다.

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

MsalUiRequiredException

이 예외 클래스는 인증에 성공하려면 UI 상호 작용이 필요하다는 것을 개발자에게 알리는 것입니다. 호출하거나 재정의 중 하나를 호출 AcquireTokenSilent(IEnumerable<String>, IAccount) 할 때 throw되며, 토큰이 캐시에 없거나 사용자가 더 많은 콘텐츠를 제공하거나 Azure AD 정책 등을 기반으로 다단계 인증을 수행해야 하는 경우 throw됩니다. 자세한 내용은 https://aka.ms/msal-net-exceptions을 참조하세요.

OsCapabilitiesExtensions

확장 메서드

PublicClientApplication

일반적인 API 메서드 및 속성을 포함하는 추상 클래스입니다. 자세한 내용은 를 참조 https://aka.ms/msal-net-client-applications

PublicClientApplicationBuilder

NuGet NuGet 다운로드 GitHub 리포지토리 별

Microsoft.Identity.Client는 패키지를 통해 사용할 수 있는 .NET MSAL(Microsoft 인증 라이브러리)의 핵심 네임스페이 Microsoft.Identity.Client 스입니다. 여기에는 지원되는 인증 공급자로부터 토큰을 획득하는 데 필요한 모든 주요 구성 요소가 포함됩니다.

설치

CLI(.NET Command-Line 인터페이스) 사용:

dotnet add package Microsoft.Identity.Client

NuGet CLI(명령줄 인터페이스) 사용:

nuget install Microsoft.Identity.Client

패키지 관리자 콘솔 사용:

Install-Package Microsoft.Identity.Client

Visual Studio 사용:

  1. 솔루션 탐색기 엽니다.
  2. 솔루션 내에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다.
  3. NuGet 패키지 관리를 클릭합니다...
  4. 찾아보기 탭을 클릭하고 을 검색합니다 Microsoft.Identity.Client.
  5. Microsoft.Identity.Client 패키지를 클릭하고 설치를 클릭합니다.

설명서

시작하려면 .NET 가이드에 대한 Microsoft 인증 라이브러리 확인하세요.

샘플

Microsoft ID 플랫폼 코드 샘플샘플 브라우저를 참조하세요.

PublicClientApplicationExtensions

에 대한 확장성 메서드 IPublicClientApplication

PublicClientApplicationOptions

공용 클라이언트 애플리케이션(데스크톱/모바일 앱)에 대한 구성 옵션입니다. https://aka.ms/msal-net/application-configuration을 참조하십시오.

RegionDetails

AuthenticationResultMetadata의 일부로 게시된 MSAL 지역 검색을 사용하는 경우의 지역 결과를 포함합니다. AuthenticationResultMetadata 인증 결과의 추가 메타데이터 정보를 확인합니다.

SystemWebViewOptions

기본 OS 브라우저를 별도의 프로세스로 사용하여 대화형 인증을 처리하는 옵션입니다. MSAL은 OS 브라우저가 인증을 완료하도록 수신 대기하지만 브라우저를 닫을 수는 없습니다. 그러나 여기에서 구성할 수 있는 200 OK 메시지 또는 302 리디렉션으로 응답할 수 있습니다. 자세한 내용은 를 참조하세요. https://aka.ms/msal-net-os-browser

TenantProfile

특정 테넌트에 있는 계정을 나타냅니다. 동일한 계정이 홈 테넌트에 있을 수 있으며 다른 여러 테넌트에서도 게스트로 존재할 수 있습니다. 액세스 토큰 및 ID 토큰은 테넌트별이며 이 개체는 계정과 연결된 모든 ID 토큰에 대한 높은 수준의 정보를 제공합니다.

TokenCache

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

TokenCacheExtensions

ITokenCache에 대한 확장 메서드

TokenCacheNotificationArgs

캐시에 액세스하는 MSAL 호출에서 사용하는 매개 변수를 포함합니다. 캐시 serialization을 사용자 지정하는 방법도 ITokenCacheSerializer 참조하세요. 토큰 캐시에 대한 자세한 내용은 https://aka.ms/msal-net-web-token-cache

TraceTelemetryConfig

System.Diagnostics.Trace를 사용하여 데이터를 쓰는 간단한 ITelemetryConfig 구현입니다.

UserAssertion

NuGet NuGet 다운로드 GitHub 리포지토리 별

Microsoft.Identity.Client는 패키지를 통해 사용할 수 있는 .NET MSAL(Microsoft 인증 라이브러리)의 핵심 네임스페이 Microsoft.Identity.Client 스입니다. 여기에는 지원되는 인증 공급자로부터 토큰을 획득하는 데 필요한 모든 주요 구성 요소가 포함됩니다.

설치

CLI(.NET Command-Line 인터페이스) 사용:

dotnet add package Microsoft.Identity.Client

NuGet CLI(명령줄 인터페이스) 사용:

nuget install Microsoft.Identity.Client

패키지 관리자 콘솔 사용:

Install-Package Microsoft.Identity.Client

Visual Studio 사용:

  1. 솔루션 탐색기 엽니다.
  2. 솔루션 내에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다.
  3. NuGet 패키지 관리를 클릭합니다...
  4. 찾아보기 탭을 클릭하고 을 검색합니다 Microsoft.Identity.Client.
  5. Microsoft.Identity.Client 패키지를 클릭하고 설치를 클릭합니다.

설명서

시작하려면 .NET 가이드에 대한 Microsoft 인증 라이브러리 확인하세요.

샘플

Microsoft ID 플랫폼 코드 샘플샘플 브라우저를 참조하세요.

WindowsBrokerOptions

Windows 10 broker를 사용하기 위한 고급 옵션입니다. 자세한 내용은 를 참조하세요. https://aka.ms/msal-net-wam

WwwAuthenticateParameters

WWW-Authenticate 헤더에서 반환된 매개 변수입니다. 이렇게 하면 클레임 챌린지, CAE(지속적인 액세스 평가) 및 CA(조건부 액세스)와 같은 동적 시나리오를 사용할 수 있습니다. https://aka.ms/msal-net/wwwAuthenticate을(를) 참조하세요.

구조체

Name Description
Prompt

AcquireTokenAsync의 대화형 재정의를 사용자에게 표시하는 방법을 지정하는 데 사용할 수 있는 IPublicClientApplication 정적 멤버를 포함하는 구조체입니다.

인터페이스

Name Description
IAccount

IAccount 인터페이스는 단일 계정에 대한 정보를 나타냅니다. 동일한 사용자가 다른 테넌트에 있을 수 있습니다. 즉, 사용자가 여러 계정을 가질 수 있습니다. . IAccount 속성에 AuthenticationResultAccount 반환되며, PublicClientApplication 및 ConfidentialClientApplication 메서드의 매개 변수로 사용하여 토큰을 획득할 수 있습니다.AcquireTokenSilent(IEnumerable<String>, IAccount)

IAppConfig

공용 또는 기밀 클라이언트 애플리케이션을 빌드하는 데 사용되는 구성 속성입니다.

IApplicationBase

클라이언트 애플리케이션을 만드는 데 사용되는 인터페이스입니다. 자세한 내용은 https://aka.ms/msal-net-client-applications를 참조하세요.

IByRefreshToken

NuGet NuGet 다운로드 GitHub 리포지토리 별

Microsoft.Identity.Client는 패키지를 통해 사용할 수 있는 .NET MSAL(Microsoft 인증 라이브러리)의 핵심 네임스페이 Microsoft.Identity.Client 스입니다. 여기에는 지원되는 인증 공급자로부터 토큰을 획득하는 데 필요한 모든 주요 구성 요소가 포함됩니다.

설치

CLI(.NET Command-Line 인터페이스) 사용:

dotnet add package Microsoft.Identity.Client

NuGet CLI(명령줄 인터페이스) 사용:

nuget install Microsoft.Identity.Client

패키지 관리자 콘솔 사용:

Install-Package Microsoft.Identity.Client

Visual Studio 사용:

  1. 솔루션 탐색기 엽니다.
  2. 솔루션 내에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다.
  3. NuGet 패키지 관리를 클릭합니다...
  4. 찾아보기 탭을 클릭하고 을 검색합니다 Microsoft.Identity.Client.
  5. Microsoft.Identity.Client 패키지를 클릭하고 설치를 클릭합니다.

설명서

시작하려면 .NET 가이드에 대한 Microsoft 인증 라이브러리 확인하세요.

샘플

Microsoft ID 플랫폼 코드 샘플샘플 브라우저를 참조하세요.

IByUserFederatedIdentityCredential

UserFIC(사용자 페더레이션 ID 자격 증명) 흐름을 사용하여 토큰을 획득하기 위한 인터페이스를 제공합니다.

IByUsernameAndPassword

기밀 클라이언트에서 리소스 소유자 암호 부여를 사용하기 위한 명시적 인터페이스를 제공합니다.

IClientApplicationBase

일반적인 API 메서드 및 속성을 정의하는 인터페이스입니다. 둘 다 PublicClientApplication 이 클래스를 ConfidentialClientApplication 확장합니다. 자세한 내용은 를 참조 https://aka.ms/msal-net-client-applications

IConfidentialClientApplication

웹앱, 웹 API, 디먼 애플리케이션 등 기밀 클라이언트 애플리케이션을 나타냅니다.

ILongRunningWebApi

웹 API에서 장기 실행 또는 백그라운드 프로세스에 대한 메서드입니다.

IManagedIdentityApplication

Azure 리소스에 대한 관리 ID 애플리케이션과 함께 사용할 구성 요소입니다.

IMsalHttpClientFactory

HttpClient를 만드는 팩터리입니다. 자세한 내용은 https://dotnet.territoriali.olinfo.it/dotnet/api/system.net.http.httpclient?view=net-7.0#instancing를 참조하세요.

IMsalMtlsHttpClientFactory

mTLS(상호 TLS)에 대해 구성된 HttpClient 인스턴스를 만드는 팩터리입니다. 이 팩터리는 mTLS를 사용하여 Azure AD와의 통신을 보호하는 데 사용하기 위한 것입니다. HttpClient 인스턴스화에 대한 자세한 내용은 다음을 참조하세요 https://dotnet.territoriali.olinfo.it/en-us/dotnet/api/system.net.http.httpclient?view=net-8.0#instancing.

IMsalSFHttpClientFactory

사용자 지정 서버 인증서 유효성 검사 콜백을 사용하여 HttpClient를 만드는 팩터리. 이는 서버 인증서를 사용하여 서버 인증서 유효성 검사가 필요한 서비스 Fabric 시나리오에 유용합니다. 자세한 내용은 참조하세요https://dotnet.territoriali.olinfo.it/dotnet/api/system.net.http.httpclient?view=net-7.0#instancing.

IPublicClientApplication

공용 클라이언트 애플리케이션(데스크톱 및 모바일 애플리케이션)을 나타냅니다.

ITelemetryConfig

NuGet NuGet 다운로드 GitHub 리포지토리 별

Microsoft.Identity.Client는 패키지를 통해 사용할 수 있는 .NET MSAL(Microsoft 인증 라이브러리)의 핵심 네임스페이 Microsoft.Identity.Client 스입니다. 여기에는 지원되는 인증 공급자로부터 토큰을 획득하는 데 필요한 모든 주요 구성 요소가 포함됩니다.

설치

CLI(.NET Command-Line 인터페이스) 사용:

dotnet add package Microsoft.Identity.Client

NuGet CLI(명령줄 인터페이스) 사용:

nuget install Microsoft.Identity.Client

패키지 관리자 콘솔 사용:

Install-Package Microsoft.Identity.Client

Visual Studio 사용:

  1. 솔루션 탐색기 엽니다.
  2. 솔루션 내에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다.
  3. NuGet 패키지 관리를 클릭합니다...
  4. 찾아보기 탭을 클릭하고 을 검색합니다 Microsoft.Identity.Client.
  5. Microsoft.Identity.Client 패키지를 클릭하고 설치를 클릭합니다.

설명서

시작하려면 .NET 가이드에 대한 Microsoft 인증 라이브러리 확인하세요.

샘플

Microsoft ID 플랫폼 코드 샘플샘플 브라우저를 참조하세요.

ITelemetryEventPayload

수집되는 일련의 이벤트에서 단일 스냅샷을 나타내는 데이터

ITokenCache

캐시 작업에 대한 공용 액세스를 구현하는 인터페이스입니다. CacheV2를 사용하면 해당 시나리오에서 사용되는 serialize/deserialize 및 이전/이후 알림을 제공하므로 호출자가 자체 저장소에 캐시를 유지하는 경우에만 이 작업이 필요합니다. https://aka.ms/aka.ms/msal-net-token-cache-serialization을 참조하십시오.

ITokenCacheSerializer

이 인터페이스는 TokenCacheNotificationArgs 콜백에서 캐시의 serialization/deserialization을 사용하도록 설정할 수 있습니다.

열거형

Name Description
AadAuthorityAudience

지정된 애플리케이션에서 로그인하는 데 사용할 수 있는 Microsoft 계정을 지정합니다. https://aka.ms/msal-net-application-configuration을 참조하십시오.

AzureCloudInstance

NuGet NuGet 다운로드 GitHub 리포지토리 별

Microsoft.Identity.Client는 패키지를 통해 사용할 수 있는 .NET MSAL(Microsoft 인증 라이브러리)의 핵심 네임스페이 Microsoft.Identity.Client 스입니다. 여기에는 지원되는 인증 공급자로부터 토큰을 획득하는 데 필요한 모든 주요 구성 요소가 포함됩니다.

설치

CLI(.NET Command-Line 인터페이스) 사용:

dotnet add package Microsoft.Identity.Client

NuGet CLI(명령줄 인터페이스) 사용:

nuget install Microsoft.Identity.Client

패키지 관리자 콘솔 사용:

Install-Package Microsoft.Identity.Client

Visual Studio 사용:

  1. 솔루션 탐색기 엽니다.
  2. 솔루션 내에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다.
  3. NuGet 패키지 관리를 클릭합니다...
  4. 찾아보기 탭을 클릭하고 을 검색합니다 Microsoft.Identity.Client.
  5. Microsoft.Identity.Client 패키지를 클릭하고 설치를 클릭합니다.

설명서

시작하려면 .NET 가이드에 대한 Microsoft 인증 라이브러리 확인하세요.

샘플

Microsoft ID 플랫폼 코드 샘플샘플 브라우저를 참조하세요.

BrokerOptions.OperatingSystems

지원되는 OperatingSystems

CacheRefreshReason

AcquireTokenSilent, AcquireTokenForClient 또는 AcquireTokenOnBehalfOf를 사용할 때 ID 공급자로부터 액세스 토큰을 가져오는 이유를 지정합니다.

LogLevel

MSAL의 로그 수준을 나타냅니다. 자세한 내용은 MSAL 로깅을 참조하세요.

TelemetryAudienceType

원격 분석에 대한 대상 그룹의 유형을 설명합니다. AudienceType

TokenSource

인증 결과에서 액세스 및 ID 토큰의 원본을 지정합니다.

UiRequiredExceptionClassification

사용자가 대화형 인증을 MsalUiRequiredException통과할 때 예상할 수 있는 사항에 대한 힌트를 제공하는 원인에 대한 세부 정보입니다. 자세한 내용은 MsalUiRequiredException 이해를 참조하세요.

대리자

Name Description
LogCallback

애플리케이션 개발자가 로그를 사용하고 사용자 지정 방식으로 처리할 수 있도록 하는 콜백 대리자입니다. 이 콜백은 .를 사용하여 WithLogging(LogCallback, Nullable<LogLevel>, Nullable<Boolean>, Nullable<Boolean>)설정됩니다. 로 설정된 경우 PiiLoggingEnabled 콜백을 등록할 때 이 메서드는 메시지를 두 번 받습니다. 매개 변수가 truecontainsPii 고 PII가 없는 메시지는 한 번false, 매개 변수가 같 containsPii 고 메시지에 PII가 포함될 수 true있습니다. 경우에 따라(메시지에 PII가 포함되지 않은 경우) 메시지는 동일합니다. 자세한 내용은 를 참조 https://aka.ms/msal-net-logging

TokenCacheCallback

토큰을 획득하는 동안 특정 토큰 캐시 상호 작용에 대한 알림입니다. 이 대리자는 특히 사용자 지정 토큰 캐시 serialization을 제공하는 데 사용됩니다. https://aka.ms/aka.ms/msal-net-token-cache-serialization을 참조하십시오.

설명

기여

.NET 향상을 위해 Microsoft 인증 라이브러리 수 있도록 피드백과 기여에 감사드립니다! 시작하기 전에 다음 문서를 읽어보세요.

이슈

라이브러리 피드백을 제공하거나 버그를 보고하려면 GitHub 문제를 여세요.