Dela via


InteractiveBrowserCredential class

Aktiverar autentisering till Microsoft Entra-ID i webbläsaren med hjälp av det interaktiva inloggningsflödet.

Konstruktorer

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Skapar en instans av InteractiveBrowserCredential med den information som behövs.

Den här autentiseringsuppgiften använder Authorization Code Flow. På Node.jsöppnas ett webbläsarfönster medan det lyssnar efter ett omdirigeringssvar från autentiseringstjänsten. I webbläsare autentiseras den via popup-fönster. Den loginStyle valfria parametern kan ställas in på redirect att autentisera genom att omdirigera användaren till en säker Inloggningssida i Azure, som sedan omdirigerar användaren tillbaka till webbprogrammet där autentiseringen startade.

Om en clientId tillhandahålls för Node.jsmåste Microsoft Entra-programmet konfigureras för att ha en omdirigeringsslutpunkt för mobil- och skrivbordsprogram. Följ vår guide om konfigurera omdirigerings-URI:er för skrivbordsappar som anropar webb-API:er.

Metoder

authenticate(string | string[], GetTokenOptions)

Autentiserar med Microsoft Entra-ID och returnerar en åtkomsttoken om det lyckas. Om autentiseringen misslyckas utlöses en CredentialUnavailableError med information om felet.

Om token inte kan hämtas tyst genererar den här metoden alltid en utmaning för användaren.

På Node.jshar den här autentiseringsuppgiften proof key for Code Exchange (PKCE) aktiverat som standard. PKCE är en säkerhetsfunktion som minimerar autentiseringskodavlyssningsattacker.

getToken(string | string[], GetTokenOptions)

Autentiserar med Microsoft Entra-ID och returnerar en åtkomsttoken om det lyckas. Om autentiseringen misslyckas utlöses en CredentialUnavailableError med information om felet.

Om användaren angav alternativet disableAutomaticAuthentication, när token inte kan hämtas tyst, kommer den här metoden inte att försöka begära användarinteraktion för att hämta token.

Konstruktorinformation

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Skapar en instans av InteractiveBrowserCredential med den information som behövs.

Den här autentiseringsuppgiften använder Authorization Code Flow. På Node.jsöppnas ett webbläsarfönster medan det lyssnar efter ett omdirigeringssvar från autentiseringstjänsten. I webbläsare autentiseras den via popup-fönster. Den loginStyle valfria parametern kan ställas in på redirect att autentisera genom att omdirigera användaren till en säker Inloggningssida i Azure, som sedan omdirigerar användaren tillbaka till webbprogrammet där autentiseringen startade.

Om en clientId tillhandahålls för Node.jsmåste Microsoft Entra-programmet konfigureras för att ha en omdirigeringsslutpunkt för mobil- och skrivbordsprogram. Följ vår guide om konfigurera omdirigerings-URI:er för skrivbordsappar som anropar webb-API:er.

new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Parametrar

options

InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions

Alternativ för att konfigurera klienten som gör autentiseringsbegäranden.

Metodinformation

authenticate(string | string[], GetTokenOptions)

Autentiserar med Microsoft Entra-ID och returnerar en åtkomsttoken om det lyckas. Om autentiseringen misslyckas utlöses en CredentialUnavailableError med information om felet.

Om token inte kan hämtas tyst genererar den här metoden alltid en utmaning för användaren.

På Node.jshar den här autentiseringsuppgiften proof key for Code Exchange (PKCE) aktiverat som standard. PKCE är en säkerhetsfunktion som minimerar autentiseringskodavlyssningsattacker.

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

Parametrar

scopes

string | string[]

Listan över omfång som token ska ha åtkomst till.

options
GetTokenOptions

De alternativ som används för att konfigurera alla begäranden som denna TokenCredential-implementering kan göra.

Returer

Promise<undefined | AuthenticationRecord>

getToken(string | string[], GetTokenOptions)

Autentiserar med Microsoft Entra-ID och returnerar en åtkomsttoken om det lyckas. Om autentiseringen misslyckas utlöses en CredentialUnavailableError med information om felet.

Om användaren angav alternativet disableAutomaticAuthentication, när token inte kan hämtas tyst, kommer den här metoden inte att försöka begära användarinteraktion för att hämta token.

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

Parametrar

scopes

string | string[]

Listan över omfång som token ska ha åtkomst till.

options
GetTokenOptions

De alternativ som används för att konfigurera alla begäranden som denna TokenCredential-implementering kan göra.

Returer

Promise<AccessToken>