InteractiveBrowserCredential class
Consente l'autenticazione all'ID Microsoft Entra all'interno del Web browser usando il flusso di accesso interattivo.
Costruttori
Interactive |
Crea un'istanza di InteractiveBrowserCredential con i dettagli necessari. Questa credenziale usa il flusso del codice di autorizzazione .
In Node.jsverrà aperta una finestra del browser mentre è in ascolto di una risposta di reindirizzamento dal servizio di autenticazione.
Nei browser, esegue l'autenticazione tramite popup. Il parametro facoltativo Per Node.js, se viene fornito un |
Metodi
authenticate(string | string[], Get |
Esegue l'autenticazione con Microsoft Entra ID e restituisce un token di accesso in caso di esito positivo. Se l'autenticazione non riesce, verrà generata una CredentialUnavailableError con i dettagli dell'errore. Se il token non può essere recuperato automaticamente, questo metodo genererà sempre una richiesta per l'utente. In Node.jsquesta credenziale ha chiave di prova per l'exchange di codice (PKCE) abilitata per impostazione predefinita. PKCE è una funzionalità di sicurezza che attenua gli attacchi di intercettazione del codice di autenticazione. |
get |
Esegue l'autenticazione con Microsoft Entra ID e restituisce un token di accesso in caso di esito positivo. Se l'autenticazione non riesce, verrà generata una CredentialUnavailableError con i dettagli dell'errore. Se l'utente ha fornito l'opzione |
Dettagli costruttore
InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)
Crea un'istanza di InteractiveBrowserCredential con i dettagli necessari.
Questa credenziale usa il flusso del codice di autorizzazione .
In Node.jsverrà aperta una finestra del browser mentre è in ascolto di una risposta di reindirizzamento dal servizio di autenticazione.
Nei browser, esegue l'autenticazione tramite popup. Il parametro facoltativo loginStyle
può essere impostato su redirect
per l'autenticazione reindirizzando l'utente a una pagina di accesso sicuro di Azure, che reindirizzerà quindi l'utente all'applicazione Web in cui è stata avviata l'autenticazione.
Per Node.js, se viene fornito un clientId
, l'applicazione Microsoft Entra dovrà essere configurata per avere un endpoint di reindirizzamento "Applicazioni per dispositivi mobili e desktop".
Seguire la guida su configurazione degli URI di reindirizzamento per le app desktop che chiamano alle API Web.
new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)
Parametri
Opzioni per la configurazione del client che effettua le richieste di autenticazione.
Dettagli metodo
authenticate(string | string[], GetTokenOptions)
Esegue l'autenticazione con Microsoft Entra ID e restituisce un token di accesso in caso di esito positivo. Se l'autenticazione non riesce, verrà generata una CredentialUnavailableError con i dettagli dell'errore.
Se il token non può essere recuperato automaticamente, questo metodo genererà sempre una richiesta per l'utente.
In Node.jsquesta credenziale ha chiave di prova per l'exchange di codice (PKCE) abilitata per impostazione predefinita. PKCE è una funzionalità di sicurezza che attenua gli attacchi di intercettazione del codice di autenticazione.
function authenticate(scopes: string | string[], options?: GetTokenOptions): Promise<undefined | AuthenticationRecord>
Parametri
- scopes
-
string | string[]
Elenco di ambiti per i quali il token avrà accesso.
- options
- GetTokenOptions
Le opzioni usate per configurare le richieste che potrebbero essere eseguite da questa implementazione di TokenCredential.
Restituisce
Promise<undefined | AuthenticationRecord>
getToken(string | string[], GetTokenOptions)
Esegue l'autenticazione con Microsoft Entra ID e restituisce un token di accesso in caso di esito positivo. Se l'autenticazione non riesce, verrà generata una CredentialUnavailableError con i dettagli dell'errore.
Se l'utente ha fornito l'opzione disableAutomaticAuthentication
, una volta che il token non può essere recuperato automaticamente, questo metodo non tenterà di richiedere l'interazione dell'utente per recuperare il token.
function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>
Parametri
- scopes
-
string | string[]
Elenco di ambiti per i quali il token avrà accesso.
- options
- GetTokenOptions
Le opzioni usate per configurare le richieste che potrebbero essere eseguite da questa implementazione di TokenCredential.
Restituisce
Promise<AccessToken>