Dela via


InteractiveBrowserCredential class

Gör att autentisering kan 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 auktoriseringskodflödet. 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å att redirect 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.

För Node.js clientId måste Microsoft Entra-programmet konfigureras för att ha en omdirigeringsslutpunkt för "mobil- och skrivbordsprogram". Följ vår guide om hur du konfigurerar 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 genereras en CredentialUnavailableError med information om felet.

Om token inte kan hämtas tyst kräver den här metoden användarinteraktion för att hämta token.

På Node.js har 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 genereras en CredentialUnavailableError med information om felet.

Om användaren angav alternativet disableAutomaticAuthentication, när token inte kan hämtas tyst, försöker den här metoden inte 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 auktoriseringskodflödet. 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å att redirect 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.

För Node.js clientId måste Microsoft Entra-programmet konfigureras för att ha en omdirigeringsslutpunkt för "mobil- och skrivbordsprogram". Följ vår guide om hur du konfigurerar 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 genereras en CredentialUnavailableError med information om felet.

Om token inte kan hämtas tyst kräver den här metoden användarinteraktion för att hämta token.

På Node.js har 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 tokencredential-implementeringen 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 genereras en CredentialUnavailableError med information om felet.

Om användaren angav alternativet disableAutomaticAuthentication, när token inte kan hämtas tyst, försöker den här metoden inte 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 tokencredential-implementeringen kan göra.

Returer

Promise<AccessToken>