InteractiveBrowserCredential class

Umožňuje autentizaci Microsoft Entra ID přímo v webovém prohlížeči pomocí interaktivního přihlašovacího procesu.

Konstruktory

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Vytvoří instanci InteractiveBrowserCredential s potřebnými podrobnostmi.

Tyto přihlašovací údaje používajítoku autorizačního kódu . Na Node.jsotevře okno prohlížeče, zatímco naslouchá odpovědi přesměrování z ověřovací služby. V prohlížečích se ověřuje prostřednictvím automaticky otevíraných oken. Volitelné parametr loginStyle lze nastavit na redirect autentizaci přesměrováním uživatele na Azure zabezpečenou přihlašovací stránku, která uživatele následně přesměruje zpět do webové aplikace, kde autentizace začala.

Pro Node.js, pokud je poskytnut clientId, bude potřeba Microsoft Entra aplikace nakonfigurovat tak, aby měla koncový bod pro přesměrování "Mobilní a desktopové aplikace". Postupujte podle našeho průvodce nastavení identifikátorů URI přesměrování pro desktopové aplikace, které volá webová rozhraní API.

Metody

authenticate(string | string[], GetTokenOptions)

Autentizuje se pomocí Microsoft Entra ID a pokud je úspěšný, vrací přístupový token. Pokud se ověření nezdaří, zobrazí se CredentialUnavailableError s podrobnostmi o selhání.

Pokud token nelze načíst bezobslužně, tato metoda vždy vygeneruje výzvu pro uživatele.

Na Node.jsmá toto přihlašovací číslo ve výchozím nastavení zapnuté Proof Key for Code Exchange (PKCE) ve výchozím nastavení. PKCE je funkce zabezpečení, která snižuje útoky na zachycování ověřovacího kódu.

getToken(string | string[], GetTokenOptions)

Autentizuje se pomocí Microsoft Entra ID a pokud je úspěšný, vrací přístupový token. Pokud se ověření nezdaří, zobrazí se CredentialUnavailableError s podrobnostmi o selhání.

Pokud uživatel zadal možnost disableAutomaticAuthentication, jakmile token nelze načíst bezobslužně, tato metoda se nepokusí požádat o interakci uživatele k načtení tokenu.

Podrobnosti konstruktoru

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Vytvoří instanci InteractiveBrowserCredential s potřebnými podrobnostmi.

Tyto přihlašovací údaje používajítoku autorizačního kódu . Na Node.jsotevře okno prohlížeče, zatímco naslouchá odpovědi přesměrování z ověřovací služby. V prohlížečích se ověřuje prostřednictvím automaticky otevíraných oken. Volitelné parametr loginStyle lze nastavit na redirect autentizaci přesměrováním uživatele na Azure zabezpečenou přihlašovací stránku, která uživatele následně přesměruje zpět do webové aplikace, kde autentizace začala.

Pro Node.js, pokud je poskytnut clientId, bude potřeba Microsoft Entra aplikace nakonfigurovat tak, aby měla koncový bod pro přesměrování "Mobilní a desktopové aplikace". Postupujte podle našeho průvodce nastavení identifikátorů URI přesměrování pro desktopové aplikace, které volá webová rozhraní API.

new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Parametry

options

InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions

Možnosti konfigurace klienta, který provádí žádosti o ověření

Podrobnosti metody

authenticate(string | string[], GetTokenOptions)

Autentizuje se pomocí Microsoft Entra ID a pokud je úspěšný, vrací přístupový token. Pokud se ověření nezdaří, zobrazí se CredentialUnavailableError s podrobnostmi o selhání.

Pokud token nelze načíst bezobslužně, tato metoda vždy vygeneruje výzvu pro uživatele.

Na Node.jsmá toto přihlašovací číslo ve výchozím nastavení zapnuté Proof Key for Code Exchange (PKCE) ve výchozím nastavení. PKCE je funkce zabezpečení, která snižuje útoky na zachycování ověřovacího kódu.

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

Parametry

scopes

string | string[]

Seznam oborů, pro které bude mít token přístup.

options
GetTokenOptions

Možnosti použité ke konfiguraci všech požadavků, které tato implementace TokenCredential může provést.

Návraty

Promise<undefined | AuthenticationRecord>

getToken(string | string[], GetTokenOptions)

Autentizuje se pomocí Microsoft Entra ID a pokud je úspěšný, vrací přístupový token. Pokud se ověření nezdaří, zobrazí se CredentialUnavailableError s podrobnostmi o selhání.

Pokud uživatel zadal možnost disableAutomaticAuthentication, jakmile token nelze načíst bezobslužně, tato metoda se nepokusí požádat o interakci uživatele k načtení tokenu.

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

Parametry

scopes

string | string[]

Seznam oborů, pro které bude mít token přístup.

options
GetTokenOptions

Možnosti použité ke konfiguraci všech požadavků, které tato implementace TokenCredential může provést.

Návraty

Promise<AccessToken>