InteractiveBrowserCredential class

Permite la autenticación de Microsoft Entra ID dentro del navegador 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 de . En Node.js, se 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 parámetro opcional loginStyle puede configurarse en redirect autenticarse redirigiendo al usuario a una página de inicio de sesión Azure segura, que luego redirigirá al usuario de vuelta a la aplicación web donde comenzó la autenticación.

Por Node.js, si se proporciona un clientId, la aplicación Microsoft Entra deberá configurarse para tener un endpoint de redirección de "Aplicaciones móviles y de escritorio". Siga nuestra guía sobre configuración de 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 tiene éxito. Si se produce un error en la autenticación, se producirá una credentialUnavailableError con los detalles del error.

Si el token no se puede recuperar de forma silenciosa, este método siempre generará un desafío para el usuario.

En Node.js, esta credencial tiene activada por defecto la clave Proof Key for Code Exchange (PKCE). 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 tiene éxito. Si se produce un error en la autenticación, se producirá una credentialUnavailableError con los detalles del error.

Si el usuario proporcionó la opción disableAutomaticAuthentication, una vez que el token no se pueda 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 de . En Node.js, se 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 parámetro opcional loginStyle puede configurarse en redirect autenticarse redirigiendo al usuario a una página de inicio de sesión Azure segura, que luego redirigirá al usuario de vuelta a la aplicación web donde comenzó la autenticación.

Por Node.js, si se proporciona un clientId, la aplicación Microsoft Entra deberá configurarse para tener un endpoint de redirección de "Aplicaciones móviles y de escritorio". Siga nuestra guía sobre configuración de 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 tiene éxito. Si se produce un error en la autenticación, se producirá una credentialUnavailableError con los detalles del error.

Si el token no se puede recuperar de forma silenciosa, este método siempre generará un desafío para el usuario.

En Node.js, esta credencial tiene activada por defecto la clave Proof Key for Code Exchange (PKCE). 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 para los que el token tendrá acceso.

options
GetTokenOptions

Las opciones que se usan para configurar las solicitudes que puede 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 tiene éxito. Si se produce un error en la autenticación, se producirá una credentialUnavailableError con los detalles del error.

Si el usuario proporcionó la opción disableAutomaticAuthentication, una vez que el token no se pueda 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 para los que el token tendrá acceso.

options
GetTokenOptions

Las opciones que se usan para configurar las solicitudes que puede realizar esta implementación de TokenCredential.

Devoluciones

Promise<AccessToken>