Delen via


InteractiveBrowserCredential class

Hiermee schakelt u verificatie in voor Microsoft Entra ID in de webbrowser met behulp van de interactieve aanmeldingsstroom.

Constructors

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Hiermee maakt u een exemplaar van InteractiveBrowserCredential met de benodigde details.

Deze referentie maakt gebruik van de autorisatiecodestroom. Op Node.jswordt er een browservenster geopend terwijl er wordt geluisterd naar een omleidingsreactie van de verificatieservice. In browsers wordt het geverifieerd via pop-ups. De loginStyle optionele parameter kan worden ingesteld op redirect om te verifiëren door de gebruiker om te leiden naar een beveiligde aanmeldingspagina van Azure, waarmee de gebruiker vervolgens wordt omgeleid naar de webtoepassing waar de verificatie is gestart.

Als er voor Node.jseen clientId is opgegeven, moet de Microsoft Entra-toepassing worden geconfigureerd om een omleidingseindpunt voor mobiele en bureaubladtoepassingen te hebben. Volg onze handleiding over het instellen van omleidings-URI's voor desktop-apps die web-API'saanroepen.

Methoden

authenticate(string | string[], GetTokenOptions)

Verifieert met Microsoft Entra-id en retourneert een toegangstoken als dit lukt. Als de verificatie mislukt, wordt een CredentialUnavailableError- gegenereerd met de details van de fout.

Als het token niet op de achtergrond kan worden opgehaald, genereert deze methode altijd een uitdaging voor de gebruiker.

Op Node.jsis voor deze referentie standaard Proof Key for Code Exchange (PKCE) ingeschakeld. PKCE is een beveiligingsfunctie waarmee onderscheppingsaanvallen van verificatiecode worden beperkt.

getToken(string | string[], GetTokenOptions)

Verifieert met Microsoft Entra-id en retourneert een toegangstoken als dit lukt. Als de verificatie mislukt, wordt een CredentialUnavailableError- gegenereerd met de details van de fout.

Als de gebruiker de optie disableAutomaticAuthenticationheeft opgegeven, zal deze methode, zodra het token niet op de achtergrond kan worden opgehaald, niet proberen om gebruikersinteractie aan te vragen om het token op te halen.

Constructordetails

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Hiermee maakt u een exemplaar van InteractiveBrowserCredential met de benodigde details.

Deze referentie maakt gebruik van de autorisatiecodestroom. Op Node.jswordt er een browservenster geopend terwijl er wordt geluisterd naar een omleidingsreactie van de verificatieservice. In browsers wordt het geverifieerd via pop-ups. De loginStyle optionele parameter kan worden ingesteld op redirect om te verifiëren door de gebruiker om te leiden naar een beveiligde aanmeldingspagina van Azure, waarmee de gebruiker vervolgens wordt omgeleid naar de webtoepassing waar de verificatie is gestart.

Als er voor Node.jseen clientId is opgegeven, moet de Microsoft Entra-toepassing worden geconfigureerd om een omleidingseindpunt voor mobiele en bureaubladtoepassingen te hebben. Volg onze handleiding over het instellen van omleidings-URI's voor desktop-apps die web-API'saanroepen.

new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Parameters

options

InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions

Opties voor het configureren van de client waarmee de verificatieaanvragen worden ingediend.

Methodedetails

authenticate(string | string[], GetTokenOptions)

Verifieert met Microsoft Entra-id en retourneert een toegangstoken als dit lukt. Als de verificatie mislukt, wordt een CredentialUnavailableError- gegenereerd met de details van de fout.

Als het token niet op de achtergrond kan worden opgehaald, genereert deze methode altijd een uitdaging voor de gebruiker.

Op Node.jsis voor deze referentie standaard Proof Key for Code Exchange (PKCE) ingeschakeld. PKCE is een beveiligingsfunctie waarmee onderscheppingsaanvallen van verificatiecode worden beperkt.

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

Parameters

scopes

string | string[]

De lijst met bereiken waartoe het token toegang heeft.

options
GetTokenOptions

De opties die worden gebruikt voor het configureren van aanvragen die deze TokenCredential-implementatie mogelijk maakt.

Retouren

Promise<undefined | AuthenticationRecord>

getToken(string | string[], GetTokenOptions)

Verifieert met Microsoft Entra-id en retourneert een toegangstoken als dit lukt. Als de verificatie mislukt, wordt een CredentialUnavailableError- gegenereerd met de details van de fout.

Als de gebruiker de optie disableAutomaticAuthenticationheeft opgegeven, zal deze methode, zodra het token niet op de achtergrond kan worden opgehaald, niet proberen om gebruikersinteractie aan te vragen om het token op te halen.

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

Parameters

scopes

string | string[]

De lijst met bereiken waartoe het token toegang heeft.

options
GetTokenOptions

De opties die worden gebruikt voor het configureren van aanvragen die deze TokenCredential-implementatie mogelijk maakt.

Retouren

Promise<AccessToken>