AcquireTokenInteractiveParameterBuilder 클래스

정의

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

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

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

중요

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

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

public sealed class AcquireTokenInteractiveParameterBuilder : Microsoft.Identity.Client.AbstractPublicClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenInteractiveParameterBuilder>

type AcquireTokenInteractiveParameterBuilder = class
    inherit AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenInteractiveParameterBuilder>

Public NotInheritable Class AcquireTokenInteractiveParameterBuilder
Inherits AbstractPublicClientAcquireTokenParameterBuilder(Of AcquireTokenInteractiveParameterBuilder)

상속: Object

BaseAbstractAcquireTokenParameterBuilder<T>

AbstractAcquireTokenParameterBuilder<T>

AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenInteractiveParameterBuilder>
AcquireTokenInteractiveParameterBuilder

메서드

Name	Description
ExecuteAsync()	토큰 요청을 비동기적으로 실행합니다. (다음에서 상속됨 BaseAbstractAcquireTokenParameterBuilder<T>)
ExecuteAsync(CancellationToken)	비동기 메서드를 취소할 수 있는 토큰 요청을 비동기적으로 실행합니다. (다음에서 상속됨 AbstractPublicClientAcquireTokenParameterBuilder<T>)
Validate()	AcquireToken 작업의 매개 변수의 유효성을 검사합니다. (다음에서 상속됨 BaseAbstractAcquireTokenParameterBuilder<T>)
WithAccount(IAccount)	토큰을 검색할 계정을 설정합니다. 이 메서드는 .와 WithLoginHint(String)함께 사용할 수 없습니다. 둘 다 사용되는 경우 예외가 throw됩니다.
WithAdfsAuthority(String, Boolean)	ADFS 서버에 해당하는 알려진 기관을 추가합니다. https://aka.ms/msal-net-adfs을(를) 참조하세요. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(AadAuthorityAudience, Boolean)	사용되지 않음. 중요: 대신 WithTenantId 또는 WithTenantIdFromAuthority를 사용하거나 B2C 기관에 WithB2CAuthority를 사용합니다. 로그인 대상 그룹(클라우드가 Azure 퍼블릭 클라우드)을 지정하는 로그인 사용자에게 애플리케이션에 알려진 Azure AD 기관을 추가합니다. https://aka.ms/msal-net-application-configuration을(를) 참조하세요. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean)	사용되지 않음. 클라우드 인스턴스 및 로그인 대상 그룹을 지정하는 로그인 사용자에게 애플리케이션에 알려진 Azure AD 기관을 추가합니다. https://aka.ms/msal-net-application-configuration을(를) 참조하세요. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(AzureCloudInstance, Guid, Boolean)	사용되지 않음. 중요: 대신 WithTenantId 또는 WithTenantIdFromAuthority를 사용하거나 B2C 기관에 WithB2CAuthority를 사용합니다. 알려진 Azure AD 기관을 애플리케이션에 추가하여 클라우드 인스턴스 및 테넌트 ID로 설명된 단일 조직(단일 테넌트 애플리케이션)의 사용자를 로그인합니다. https://aka.ms/msal-net-application-configuration을(를) 참조하세요. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(AzureCloudInstance, String, Boolean)	사용되지 않음. 중요: 대신 WithTenantId 또는 WithTenantIdFromAuthority를 사용하거나 B2C 기관에 WithB2CAuthority를 사용합니다. 알려진 Azure AD 기관을 애플리케이션에 추가하여 클라우드 인스턴스 및 해당 도메인 이름 또는 테넌트 ID로 설명된 단일 조직(단일 테넌트 애플리케이션)의 사용자를 로그인합니다. https://aka.ms/msal-net-application-configuration을(를) 참조하세요. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(String, Boolean)	사용되지 않음. 중요: 대신 WithTenantId 또는 WithTenantIdFromAuthority를 사용하거나 B2C 기관에 WithB2CAuthority를 사용합니다. 토큰이 요청되는 특정 권한입니다. 애플리케이션 생성자에서 구성된 값과 다른 값을 전달하면 선택 영역의 범위를 특정 테넌트로 좁힐 수 있습니다. 이렇게 하면 애플리케이션에서 구성된 값이 변경되지 않습니다. 이는 여러 계정(예: 여러 사서함이 있는 메일 클라이언트)을 관리하는 애플리케이션에만 해당됩니다. https://aka.ms/msal-net-application-configuration을(를) 참조하세요. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(String, Guid, Boolean)	사용되지 않음. 중요: 대신 WithTenantId 또는 WithTenantIdFromAuthority를 사용하거나 B2C 기관에 WithB2CAuthority를 사용합니다. 애플리케이션에 알려진 Azure AD 기관을 추가하여 테넌트 ID로 지정된 단일 조직(단일 테넌트 애플리케이션)의 사용자를 로그인합니다. https://aka.ms/msal-net-application-configuration을(를) 참조하세요. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithAuthority(String, String, Boolean)	사용되지 않음. 중요: 대신 WithTenantId 또는 WithTenantIdFromAuthority를 사용하거나 B2C 기관에 WithB2CAuthority를 사용합니다. 도메인 이름으로 설명된 단일 조직(단일 테넌트 애플리케이션)의 사용자를 로그인하도록 애플리케이션에 알려진 Azure AD 기관을 추가합니다. https://aka.ms/msal-net-application-configuration을(를) 참조하세요. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithB2CAuthority(String)	Azure AD B2C 정책에 해당하는 알려진 기관을 추가합니다. https://aka.ms/msal-net-b2c-specificities을 참조하십시오. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithClaims(String)	쿼리에서 클레임을 설정합니다. AAD 관리자가 조건부 액세스를 사용하도록 설정한 경우에 사용합니다. 토큰을 일반적으로 획득하면 속성 집합이 MsalUiRequiredException Claims 사용됩니다. 토큰 획득을 다시 시도하고 메서드에서 WithClaims(String) 이 값을 사용합니다. 자세한 내용은 .를 참조하세요 https://aka.ms/msal-exceptions https://aka.ms/msal-net-claim-challenge. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithCorrelationId(Guid)	인증 요청에 사용할 상관 관계 ID를 설정합니다. SDK 및 ID 공급자 서비스의 로그에서 요청을 추적하는 데 사용됩니다. 설정하지 않으면 임의 하나가 생성됩니다. (다음에서 상속됨 BaseAbstractAcquireTokenParameterBuilder<T>)
WithEmbeddedWebViewOptions(EmbeddedWebViewOptions)	대화형 인증에 포함된 웹 보기를 사용하는 옵션을 지정합니다.
WithExtraQueryParameters(Dictionary<String,String>)	사용되지 않음. HTTP 인증 요청의 쿼리 문자열에 대한 추가 쿼리 매개 변수를 설정합니다. (다음에서 상속됨 BaseAbstractAcquireTokenParameterBuilder<T>)
WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>)	캐시 키에 포함되는 매개 변수를 제어하여 HTTP 인증 요청의 쿼리 문자열에 대한 추가 쿼리 매개 변수를 설정합니다. (다음에서 상속됨 BaseAbstractAcquireTokenParameterBuilder<T>)
WithExtraQueryParameters(String)	사용되지 않음. HTTP 인증 요청의 쿼리 문자열에 대한 추가 쿼리 매개 변수를 설정합니다. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithExtraScopesToConsent(IEnumerable<String>)	대화형 토큰 요청에 대한 작성기입니다. https://aka.ms/msal-net-acquire-token-interactively을 참조하십시오.
WithLoginHint(String)	`loginHint`사용자가 여러 ID로 로그인하는 경우 계정 선택 대화 상자를 방지하기 위해 를 설정합니다. 이 메서드는 .와 WithAccount(IAccount)함께 사용할 수 없습니다. 둘 다 사용되는 경우 예외가 throw됩니다.
WithParentActivityOrWindow(IntPtr)	IntPtr에 대한 참조를 표시할 브라우저를 트리거하는 창으로 설정합니다. 이 창에 팝업되는 브라우저를 가운데에 배치하는 데 사용됩니다. 값이 구성된 경우 화면의 가운데 또는 포그라운드 앱입니다.
WithParentActivityOrWindow(Object)	ViewController(iOS를 사용하는 경우), 작업(Android를 사용하는 경우) IWin32Window 또는 IntPtr(.Net Framework를 사용하는 경우)에 대한 참조를 설정합니다. 브라우저를 호출하는 데 사용됩니다.
WithPrompt(Prompt)	사용자에 대한 대화형 환경을 지정합니다.
WithProofOfPossession(String, HttpMethod, Uri)	획득한 토큰이 전달자 토큰이 아닌 PoP(소유 증명 토큰)가 되도록 토큰 획득 요청을 수정합니다. PoP 토큰은 전달자 토큰과 유사하지만 HTTP 요청 및 암호화 키에 바인딩되며, MSAL은 Windows 관리할 수 있습니다. 요청 URI의 호스트 및 경로 부분만 바인딩됩니다. https://aka.ms/msal-net-pop을 참조하십시오.
WithScopes(IEnumerable<String>)	요청할 범위를 지정합니다. 이 메서드는 애플리케이션이 보호된 API를 호출하는 데 필요한 범위를 지정해야 하는 경우에 사용됩니다. >https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent<OAuth2 권한을 노출하는 데 사용된 레거시 애플리케이션에 대한 범위를 만드는 방법을 알아보려면 참조/>참조>하여 범위,>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes<< 사용 권한 및 동의에 대해 자세히 알아보세요<. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithSystemWebViewOptions(SystemWebViewOptions)	시스템 OS 브라우저 핸들 대화형 인증을 사용하는 옵션을 지정합니다.
WithTenantId(String)	애플리케이션 수준에서 권한에 지정된 테넌트 ID를 재정의합니다. 이 작업은 기관 호스트(환경)를 유지합니다. 애플리케이션 수준에서 기관을 지정하지 않은 경우 사용되는 기본값은 .입니다 `https://login.microsoftonline.com/common`. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithTenantIdFromAuthority(Uri)	제공된 기관 URI에서 테넌트 ID를 추출하고 애플리케이션 수준에서 권한에 지정된 테넌트 ID를 재정의합니다. 이 작업은 애플리케이션 작성기에서 제공하는 기관 호스트(환경)를 유지합니다. 인증 기관이 애플리케이션 작성기에게 제공되지 않은 경우 이 메서드는 기본 기관의 테넌트 ID를 대체합니다 `https://login.microsoftonline.com/common`. (다음에서 상속됨 AbstractAcquireTokenParameterBuilder<T>)
WithUseEmbeddedWebView(Boolean)	공용 클라이언트 애플리케이션이 포함된 웹 브라우저 또는 시스템 기본 브라우저를 사용해야 하는지 여부를 지정합니다. broker(WAM, Authenticator, 회사 포털)가 구성된 경우 이 설정은 broker가 설치되지 않은 경우에만 사용됩니다. net8-windows를 비롯한 .NET 앱 개발자는 Microsoft 참조해야 합니다. Identity.Client.Desktop을 호출하고 PublicClientApplicationBuilder.WithDesktopFeatures()를 호출하여 포함된 웹 브라우저를 사용하도록 설정합니다.

확장명 메서드

Name	Description
OnBeforeTokenRequest<T>(AbstractAcquireTokenParameterBuilder<T>, Func<OnBeforeTokenRequestData,Task>)	MSAL이 토큰 요청을 하기 전에 사용자가 제공한 대리자를 실행하여 요청 파이프라인에 개입합니다. 대리자는 본문 매개 변수 및 헤더를 추가하거나 제거하여 요청 페이로드를 수정할 수 있습니다. OnBeforeTokenRequestData
WithAdditionalCacheParameters<T>(AbstractAcquireTokenParameterBuilder<T>, IEnumerable<String>)	일반적으로 캐시 개체에 포함되지 않은 액세스 토큰을 사용하여 캐시할 인증 응답에서 얻은 추가 매개 변수를 지정합니다. 이러한 값은 매개 변수에서 AdditionalResponseParameters 읽을 수 있습니다.
WithAuthenticationExtension<T>(AbstractAcquireTokenParameterBuilder<T>, MsalAuthenticationExtension)	클라이언트 애플리케이션이 토큰 획득 요청에 사용할 사용자 지정 인증 작업을 제공할 수 있도록 합니다.
WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String)	키-값 쌍을 쿼리 매개 변수로 보내지 않고 토큰 캐시 키에 추가합니다. 캐시된 토큰을 분할하는 데 사용합니다(예: 동일한 사용자에 대한 일반 세션에서 수명이 짧은 세션 격리). `AcquireTokenSilent` 둘 다 `AcquireTokenByAuthorizationCode` 동일한 파티션 키를 사용하여 캐시된 항목을 일치시켜야 합니다.
WithCustomWebUi(AcquireTokenInteractiveParameterBuilder, ICustomWebUi)	공용 클라이언트 애플리케이션에 MSAL.NET extender를 사용하여 사용자가 Azure AD로 로그인하고, 필요한 경우 동의를 표시하고, 권한 부여 코드를 다시 가져올 수 있는 사용자 지정 웹 UI를 설정할 수 있도록 하는 확장 메서드
WithExtraClientAssertionClaims<T>(AbstractAcquireTokenParameterBuilder<T>, String)	클라이언트 어설션에 포함할 추가 클레임을 지정합니다. 이러한 클레임은 클라이언트 어설션이 생성될 때 기본 클레임과 병합됩니다. 이렇게 하면 Microsoft 같은 더 높은 수준의 API를 사용할 수 있습니다. Identity.Web은 클라이언트 어설션에 대한 추가 클레임을 제공합니다. 중요: 토큰은 캐시 조회에 영향을 미치는 추가 클라이언트 어설션 클레임과 연결됩니다. 확장성 API이며 애플리케이션에서 직접 사용하면 안 됩니다.
WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>)	사용되지 않음. 토큰 요청에 추가 Http 헤더를 추가합니다.
WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>)	토큰 요청에 추가 HTTP 헤더를 추가합니다.
WithFmiPathForClientAssertion<T>(AbstractAcquireTokenParameterBuilder<T>, String)	클라이언트 어설션에 사용할 FMI 경로를 지정합니다. 이렇게 하면 Id.Web과 같은 상위 수준 API가 FMI에 중요한 자격 증명을 제공할 수 있습니다. 중요: 토큰은 캐시 조회에 영향을 주는 자격 증명 FMI 경로와 연결됩니다. 이는 확장성 API이며 애플리케이션에서 사용해서는 안 됩니다.
WithProofOfPosessionKeyId<T>(AbstractAcquireTokenParameterBuilder<T>, String, String)	토큰을 캐시의 키에 바인딩합니다. 토큰에 대해 암호화 작업이 수행되지 않습니다.
WithSSHCertificateAuthenticationScheme(AcquireTokenInteractiveParameterBuilder, String, String)	전달자 토큰 대신 SSH 인증서를 반환하도록 AAD에 지시합니다. SSH 인증서(SSH에서 사용하는 퍼블릭/프라이빗 키 쌍과 동일하지 않음)는 퍼블릭 SSH 키를 컴퓨터에 안전하게 배포하는 데 사용할 수 있습니다. 자세한 내용은 https://aka.ms/msal-net-ssh를 참조하세요.

적용 대상

피드백

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