InteractiveBrowserCredential class

Paquete:

@azure/identity

Habilita la autenticación a 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 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 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. Para Node.js, si se proporciona un clientId, la aplicación Microsoft Entra debe configurarse para tener un punto de conexión de redireccionamiento 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 el identificador de Entra de Microsoft y devuelve un token de acceso si se ejecuta correctamente. 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 clave de prueba para intercambio de código (PKCE) habilitada 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 el identificador de Entra de Microsoft y devuelve un token de acceso si se ejecuta correctamente. 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 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.

Para Node.js, si se proporciona un clientId, la aplicación Microsoft Entra debe configurarse para tener un punto de conexión de redireccionamiento 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 el identificador de Entra de Microsoft y devuelve un token de acceso si se ejecuta correctamente. 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 clave de prueba para intercambio de código (PKCE) habilitada 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 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 el identificador de Entra de Microsoft y devuelve un token de acceso si se ejecuta correctamente. 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>