다음을 통해 공유


InteractiveBrowserCredential class

대화형 로그인 흐름을 사용하여 웹 브라우저 내에서 Microsoft Entra ID 인증을 사용하도록 설정합니다.

생성자

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

필요한 세부 정보를 사용하여 InteractiveBrowserCredential의 instance 만듭니다.

이 자격 증명은 권한 부여 코드 흐름을 사용합니다. Node.js 인증 서비스에서 리디렉션 응답을 수신 대기하는 동안 브라우저 창이 열립니다. 브라우저에서는 팝업을 통해 인증합니다. 선택적 매개 변수는 loginStyle 사용자를 Azure 보안 로그인 페이지로 redirect 리디렉션하여 인증하도록 설정할 수 있습니다. 그러면 인증이 시작된 웹 애플리케이션으로 사용자를 다시 리디렉션합니다.

Node.js 경우 가 clientId 제공되면 "모바일 및 데스크톱 애플리케이션" 리디렉션 엔드포인트를 사용하도록 Microsoft Entra 애플리케이션을 구성해야 합니다. 웹 API를 호출하는 데스크톱 앱에 대한 리디렉션 URI 설정에 대한 가이드를 따릅니다.

메서드

authenticate(string | string[], GetTokenOptions)

Microsoft Entra ID 사용하여 인증하고 성공하면 액세스 토큰을 반환합니다. 인증에 실패하면 실패 세부 정보와 함께 CredentialUnavailableError 가 throw됩니다.

토큰을 자동으로 검색할 수 없는 경우 이 메서드는 토큰을 검색하기 위해 사용자 상호 작용이 필요합니다.

Node.js 이 자격 증명에는 기본적으로 PKCE(코드 교환용 증명 키) 가 사용하도록 설정되어 있습니다. PKCE는 인증 코드 가로채기 공격을 완화하는 보안 기능입니다.

getToken(string | string[], GetTokenOptions)

Microsoft Entra ID 사용하여 인증하고 성공하면 액세스 토큰을 반환합니다. 인증에 실패하면 실패 세부 정보와 함께 CredentialUnavailableError 가 throw됩니다.

사용자가 옵션을 disableAutomaticAuthentication제공한 경우 토큰을 자동으로 검색할 수 없으면 이 메서드는 토큰을 검색하기 위해 사용자 상호 작용을 요청하지 않습니다.

생성자 세부 정보

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

필요한 세부 정보를 사용하여 InteractiveBrowserCredential의 instance 만듭니다.

이 자격 증명은 권한 부여 코드 흐름을 사용합니다. Node.js 인증 서비스에서 리디렉션 응답을 수신 대기하는 동안 브라우저 창이 열립니다. 브라우저에서는 팝업을 통해 인증합니다. 선택적 매개 변수는 loginStyle 사용자를 Azure 보안 로그인 페이지로 redirect 리디렉션하여 인증하도록 설정할 수 있습니다. 그러면 인증이 시작된 웹 애플리케이션으로 사용자를 다시 리디렉션합니다.

Node.js 경우 가 clientId 제공되면 "모바일 및 데스크톱 애플리케이션" 리디렉션 엔드포인트를 사용하도록 Microsoft Entra 애플리케이션을 구성해야 합니다. 웹 API를 호출하는 데스크톱 앱에 대한 리디렉션 URI 설정에 대한 가이드를 따릅니다.

new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

매개 변수

options

InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions

인증 요청을 만드는 클라이언트를 구성하는 옵션입니다.

메서드 세부 정보

authenticate(string | string[], GetTokenOptions)

Microsoft Entra ID 사용하여 인증하고 성공하면 액세스 토큰을 반환합니다. 인증에 실패하면 실패 세부 정보와 함께 CredentialUnavailableError 가 throw됩니다.

토큰을 자동으로 검색할 수 없는 경우 이 메서드는 토큰을 검색하기 위해 사용자 상호 작용이 필요합니다.

Node.js 이 자격 증명에는 기본적으로 PKCE(코드 교환용 증명 키) 가 사용하도록 설정되어 있습니다. PKCE는 인증 코드 가로채기 공격을 완화하는 보안 기능입니다.

function authenticate(scopes: string | string[], options?: GetTokenOptions): Promise<undefined | AuthenticationRecord>

매개 변수

scopes

string | string[]

토큰에 액세스할 범위 목록입니다.

options
GetTokenOptions

이 TokenCredential 구현에서 수행할 수 있는 요청을 구성하는 데 사용되는 옵션입니다.

반환

Promise<undefined | AuthenticationRecord>

getToken(string | string[], GetTokenOptions)

Microsoft Entra ID 사용하여 인증하고 성공하면 액세스 토큰을 반환합니다. 인증에 실패하면 실패 세부 정보와 함께 CredentialUnavailableError 가 throw됩니다.

사용자가 옵션을 disableAutomaticAuthentication제공한 경우 토큰을 자동으로 검색할 수 없으면 이 메서드는 토큰을 검색하기 위해 사용자 상호 작용을 요청하지 않습니다.

function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>

매개 변수

scopes

string | string[]

토큰에 액세스할 범위 목록입니다.

options
GetTokenOptions

이 TokenCredential 구현에서 수행할 수 있는 요청을 구성하는 데 사용되는 옵션입니다.

반환

Promise<AccessToken>