Compartir a través de


InteractiveBrowserCredential class

Permite la autenticación Microsoft Entra ID dentro del explorador web mediante el flujo de inicio de sesión interactivo.

Constructores

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Crea una instancia de InteractiveBrowserCredential con los detalles necesarios.

Esta credencial usa el flujo de código de autorización. En Node.js, abrirá una ventana del explorador mientras escucha una respuesta de redirección desde el servicio de autenticación. En los exploradores, se autentica a través de elementos emergentes. El loginStyle parámetro opcional se puede establecer en redirect para autenticarse mediante la redirección del usuario a una página de inicio de sesión seguro de Azure, que luego redirigirá al usuario a la aplicación web donde se inició la autenticación.

Por Node.js, si se proporciona un clientId , la aplicación Microsoft Entra deberá configurarse para que tenga un punto de conexión de redireccionamiento de "Aplicaciones móviles y de escritorio". Siga nuestra guía sobre cómo configurar URI de redirección para aplicaciones de escritorio que llaman a las API web.

Métodos

authenticate(string | string[], GetTokenOptions)

Se autentica con Microsoft Entra ID y devuelve un token de acceso si se ejecuta correctamente. Si se produce un error en la autenticación, se producirá un credentialUnavailableError con los detalles del error.

Si el token no se puede recuperar de forma silenciosa, este método requerirá la interacción del usuario para recuperar el token.

En Node.js, esta credencial tiene habilitada la clave de prueba para El intercambio de código (PKCE) de forma predeterminada. PKCE es una característica de seguridad que mitiga los ataques de interceptación de código de autenticación.

getToken(string | string[], GetTokenOptions)

Se autentica con Microsoft Entra ID y devuelve un token de acceso si se ejecuta correctamente. Si se produce un error en la autenticación, se producirá un credentialUnavailableError con los detalles del error.

Si el usuario proporcionó la opción disableAutomaticAuthentication, una vez que el token no se puede recuperar de forma silenciosa, este método no intentará solicitar la interacción del usuario para recuperar el token.

Detalles del constructor

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Crea una instancia de InteractiveBrowserCredential con los detalles necesarios.

Esta credencial usa el flujo de código de autorización. En Node.js, abrirá una ventana del explorador mientras escucha una respuesta de redirección desde el servicio de autenticación. En los exploradores, se autentica a través de elementos emergentes. El loginStyle parámetro opcional se puede establecer en redirect para autenticarse mediante la redirección del usuario a una página de inicio de sesión seguro de Azure, que luego redirigirá al usuario a la aplicación web donde se inició la autenticación.

Por Node.js, si se proporciona un clientId , la aplicación Microsoft Entra deberá configurarse para que tenga un punto de conexión de redireccionamiento de "Aplicaciones móviles y de escritorio". Siga nuestra guía sobre cómo configurar URI de redirección para aplicaciones de escritorio que llaman a las API web.

new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

Parámetros

options

InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions

Opciones para configurar el cliente que realiza las solicitudes de autenticación.

Detalles del método

authenticate(string | string[], GetTokenOptions)

Se autentica con Microsoft Entra ID y devuelve un token de acceso si se ejecuta correctamente. Si se produce un error en la autenticación, se producirá un credentialUnavailableError con los detalles del error.

Si el token no se puede recuperar de forma silenciosa, este método requerirá la interacción del usuario para recuperar el token.

En Node.js, esta credencial tiene habilitada la clave de prueba para El intercambio de código (PKCE) de forma predeterminada. PKCE es una característica de seguridad que mitiga los ataques de interceptación de código de autenticación.

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

Parámetros

scopes

string | string[]

Lista de ámbitos a los que tendrá acceso el token.

options
GetTokenOptions

Las opciones usadas para configurar las solicitudes que pueda realizar esta implementación de TokenCredential.

Devoluciones

Promise<undefined | AuthenticationRecord>

getToken(string | string[], GetTokenOptions)

Se autentica con Microsoft Entra ID y devuelve un token de acceso si se ejecuta correctamente. Si se produce un error en la autenticación, se producirá un credentialUnavailableError con los detalles del error.

Si el usuario proporcionó la opción disableAutomaticAuthentication, una vez que el token no se puede recuperar de forma silenciosa, este método no intentará solicitar la interacción del usuario para recuperar el token.

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

Parámetros

scopes

string | string[]

Lista de ámbitos a los que tendrá acceso el token.

options
GetTokenOptions

Las opciones usadas para configurar las solicitudes que pueda realizar esta implementación de TokenCredential.

Devoluciones

Promise<AccessToken>