InteractiveBrowserCredential class

Umožňuje ověřování Microsoft Entra ID ve webovém prohlížeči pomocí interaktivního toku přihlášení.

Konstruktory

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

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

Tyto přihlašovací údaje používají tok autorizačního kódu. V Node.js se otevř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ý loginStyle parametr je možné nastavit na redirect ověření přesměrováním uživatele na zabezpečenou přihlašovací stránku Azure, která pak přesměruje uživatele zpět do webové aplikace, kde ověřování začalo.

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

Metody

authenticate(string | string[], GetTokenOptions)

Provede ověření pomocí Microsoft Entra ID a v případě úspěchu vrátí přístupový token. Pokud ověřování selže, vyvolá se chyba CredentialUnavailableError s podrobnostmi o selhání.

Pokud token nelze načíst bezobslužně, bude tato metoda vyžadovat interakci uživatele k načtení tokenu.

Na Node.js mají tyto přihlašovací údaje ve výchozím nastavení povolený proof key for Code Exchange (PKCE). PKCE je funkce zabezpečení, která omezuje útoky na zachycování ověřovacího kódu.

getToken(string | string[], GetTokenOptions)

Provede ověření pomocí Microsoft Entra ID a v případě úspěchu vrátí přístupový token. Pokud ověřování selže, vyvolá se chyba CredentialUnavailableError s podrobnostmi o selhání.

Pokud uživatel zadal možnost disableAutomaticAuthentication, jakmile token nebude možné bezobslužně načíst, tato metoda se nebude pokoušet požádat o interakci uživatele za účelem načtení tokenu.

Podrobnosti konstruktoru

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

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

Tyto přihlašovací údaje používají tok autorizačního kódu. V Node.js se otevř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ý loginStyle parametr je možné nastavit na redirect ověření přesměrováním uživatele na zabezpečenou přihlašovací stránku Azure, která pak přesměruje uživatele zpět do webové aplikace, kde ověřování začalo.

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

new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Parametry

options

InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions

Možnosti konfigurace klienta, který provádí požadavky na ověření

Podrobnosti metody

authenticate(string | string[], GetTokenOptions)

Provede ověření pomocí Microsoft Entra ID a v případě úspěchu vrátí přístupový token. Pokud ověřování selže, vyvolá se chyba CredentialUnavailableError s podrobnostmi o selhání.

Pokud token nelze načíst bezobslužně, bude tato metoda vyžadovat interakci uživatele k načtení tokenu.

Na Node.js mají tyto přihlašovací údaje ve výchozím nastavení povolený proof key for Code Exchange (PKCE). PKCE je funkce zabezpečení, která omezuje ú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ů, ke kterým bude mít token přístup.

options
GetTokenOptions

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

Návraty

Promise<undefined | AuthenticationRecord>

getToken(string | string[], GetTokenOptions)

Provede ověření pomocí Microsoft Entra ID a v případě úspěchu vrátí přístupový token. Pokud ověřování selže, vyvolá se chyba CredentialUnavailableError s podrobnostmi o selhání.

Pokud uživatel zadal možnost disableAutomaticAuthentication, jakmile token nebude možné bezobslužně načíst, tato metoda se nebude pokoušet požádat o interakci uživatele za účelem načtení tokenu.

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

Parametry

scopes

string | string[]

Seznam oborů, ke kterým bude mít token přístup.

options
GetTokenOptions

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

Návraty

Promise<AccessToken>