InteractiveBrowserCredential class

웹 브라우저 내에서 인터랙티브 로그인 플로우를 사용하여 Microsoft Entra ID 인증을 가능하게 합니다.

생성자

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

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

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

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

메서드

authenticate(string | string[], GetTokenOptions)

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

토큰을 자동으로 검색할 수 없는 경우 이 메서드는 항상 사용자에게 챌린지를 생성합니다.

Node.js에서는 이 자격 증명이 기본적으로 Proof Key for Code Exchange (PKCE) 활성화되어 있습니다. PKCE는 인증 코드 가로채기 공격을 완화하는 보안 기능입니다.

getToken(string | string[], GetTokenOptions)

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

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

생성자 세부 정보

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

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

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

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에서는 이 자격 증명이 기본적으로 Proof Key for Code Exchange (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>