InteractiveBrowserCredentialBuilder Clase

Paquete:

com.azure.identity

Artefacto Maven:

com.azure:azure-identity:1.10.4

• java.lang.Object
• • com.azure.identity.CredentialBuilderBase<T>
  • • com.azure.identity.AadCredentialBuilderBase<T>
    • • com.azure.identity.InteractiveBrowserCredentialBuilder

public class InteractiveBrowserCredentialBuilder
extends AadCredentialBuilderBase<InteractiveBrowserCredentialBuilder>

Generador de credenciales de Fluent para crear instancias de .InteractiveBrowserCredential

La autenticación interactiva del explorador es un tipo de flujo de autenticación que ofrece Azure Active Directory (Azure AD) que permite a los usuarios iniciar sesión en aplicaciones y servicios mediante un explorador web. Este método de autenticación se usa normalmente para las aplicaciones web, donde los usuarios escriben sus credenciales directamente en una página web. Con la autenticación interactiva del explorador, el usuario navega a una aplicación web y se le pide que escriba sus credenciales de nombre de usuario y contraseña. A continuación, la aplicación redirige al usuario a la página de inicio de sesión de Azure AD, donde se les pide que vuelvan a escribir sus credenciales. Una vez que el usuario se autentique correctamente, Azure AD emite un token de seguridad que la aplicación puede usar para autorizar el acceso del usuario a sus recursos. InteractiveBrowserCredential Autentica interactivamente a un usuario y adquiere un token con el explorador del sistema predeterminado y ofrece una experiencia de autenticación fluida al permitir que un usuario use sus propias credenciales para autenticar la aplicación. Cuando se autentica, el flujo de oauth2 notifica la credencial del código de autenticación a través de la dirección URL de respuesta. Para obtener más información, consulte los detalles de configuración y conocimientos conceptuales.

Ejemplo: Construcción de InteractiveBrowserCredential

En el ejemplo de código siguiente se muestra la creación de un InteractiveBrowserCredentialobjeto , utilizando para InteractiveBrowserCredentialBuilder configurarlo. De forma predeterminada, la credencial tiene como destino una dirección URL de redirección de localhost para invalidar ese comportamiento redirectUrl(String redirectUrl) que se puede especificar opcionalmente. Una vez creada esta credencial, se puede pasar al generador de muchos de los generadores de cliente de Azure SDK para Java como parámetro "credential".

TokenCredential interactiveBrowserCredential = new InteractiveBrowserCredentialBuilder()
     .redirectUrl("http://localhost:8765")
     .build();

Resumen del constructor

Constructor	Description
InteractiveBrowserCredentialBuilder()

Resumen del método

Modificador y tipo	Método y descripción
InteractiveBrowserCredentialBuilder	additionallyAllowedTenants(String[] additionallyAllowedTenants) Para las aplicaciones multiinquilino, especifica inquilinos adicionales para los que la credencial puede adquirir tokens.
InteractiveBrowserCredentialBuilder	additionallyAllowedTenants(List<String> additionallyAllowedTenants) Para las aplicaciones multiinquilino, especifica inquilinos adicionales para los que la credencial puede adquirir tokens.
InteractiveBrowserCredentialBuilder	authenticationRecord(AuthenticationRecord authenticationRecord) Establece el AuthenticationRecord objeto capturado a partir de una autenticación anterior.
InteractiveBrowserCredentialBuilder	browserCustomizationOptions(BrowserCustomizationOptions browserCustomizationOptions) Configura las opciones para personalizar el explorador para la autenticación interactiva.
InteractiveBrowserCredential	build() Crea un nuevo InteractiveBrowserCredential con las configuraciones actuales.
InteractiveBrowserCredentialBuilder	disableAutomaticAuthentication() Deshabilita la autenticación automática e impide que se InteractiveBrowserCredential le pida automáticamente al usuario.
InteractiveBrowserCredentialBuilder	loginHint(String loginHint) Establece la sugerencia de nombre de usuario para rellenar previamente el campo nombre de usuario o dirección de correo electrónico de la página de inicio de sesión.
InteractiveBrowserCredentialBuilder	port(int port) Obsoleto Configure la dirección URL de redireccionamiento como http://localhost:{port} vía redirectUrl(String redirectUrl) en su lugar. Establece el puerto del servidor HTTP local, para el que http://localhost:{port} se debe registrar como una dirección URL de respuesta válida en la aplicación.
InteractiveBrowserCredentialBuilder	redirectUrl(String redirectUrl) Establece la dirección URL de redireccionamiento donde STS devolverá la llamada a la aplicación con el código de seguridad.
InteractiveBrowserCredentialBuilder	tokenCachePersistenceOptions(TokenCachePersistenceOptions tokenCachePersistenceOptions) Configura las opciones de caché de tokens compartidos persistentes y habilita la caché de tokens persistente que está deshabilitada de forma predeterminada.

Métodos heredados de AadCredentialBuilderBase

additionallyAllowedTenants additionallyAllowedTenants authorityHost clientId disableInstanceDiscovery enableUnsafeSupportLogging executorService tenantId

Métodos heredados de CredentialBuilderBase

addPolicy clientOptions configuration enableAccountIdentifierLogging httpClient httpLogOptions httpPipeline maxRetry pipeline proxyOptions retryOptions retryPolicy retryTimeout

Métodos heredados de java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Detalles del constructor

InteractiveBrowserCredentialBuilder

public InteractiveBrowserCredentialBuilder()

Detalles del método

additionallyAllowedTenants

public InteractiveBrowserCredentialBuilder additionallyAllowedTenants(String[] additionallyAllowedTenants)

Para las aplicaciones multiinquilino, especifica inquilinos adicionales para los que la credencial puede adquirir tokens. Agregue el valor comodín "*" para permitir que la credencial adquiera tokens para cualquier inquilino en el que esté instalada la aplicación. Si no se especifica ningún valor para TenantId, esta opción no tendrá ningún efecto y la credencial adquirirá tokens para cualquier inquilino solicitado.

Overrides:

InteractiveBrowserCredentialBuilder.additionallyAllowedTenants(String[] additionallyAllowedTenants)

Parameters:

additionallyAllowedTenants - los inquilinos permitidos además.

Returns:

Instancia actualizada de este generador con los inquilinos adicionales configurados.

additionallyAllowedTenants

public InteractiveBrowserCredentialBuilder additionallyAllowedTenants(List additionallyAllowedTenants)

Para las aplicaciones multiinquilino, especifica inquilinos adicionales para los que la credencial puede adquirir tokens. Agregue el valor comodín "*" para permitir que la credencial adquiera tokens para cualquier inquilino en el que esté instalada la aplicación. Si no se especifica ningún valor para TenantId, esta opción no tendrá ningún efecto y la credencial adquirirá tokens para cualquier inquilino solicitado.

Overrides:

InteractiveBrowserCredentialBuilder.additionallyAllowedTenants(List<String> additionallyAllowedTenants)

Parameters:

additionallyAllowedTenants - los inquilinos permitidos además.

Returns:

Instancia actualizada de este generador con los inquilinos adicionales configurados.

authenticationRecord

public InteractiveBrowserCredentialBuilder authenticationRecord(AuthenticationRecord authenticationRecord)

Establece el AuthenticationRecord objeto capturado a partir de una autenticación anterior.

Parameters:

authenticationRecord - Registro de autenticación que se va a configurar.

Returns:

Instancia actualizada de este generador con el registro de autenticación configurado.

browserCustomizationOptions

public InteractiveBrowserCredentialBuilder browserCustomizationOptions(BrowserCustomizationOptions browserCustomizationOptions)

Configura las opciones para personalizar el explorador para la autenticación interactiva.

Parameters:

browserCustomizationOptions - las opciones de personalización del explorador

Returns:

Instancia actualizada de este generador con las opciones de personalización del explorador configuradas.

build

public InteractiveBrowserCredential build()

Crea un nuevo InteractiveBrowserCredential con las configuraciones actuales.

Returns:

con InteractiveBrowserCredential las configuraciones actuales.

disableAutomaticAuthentication

public InteractiveBrowserCredentialBuilder disableAutomaticAuthentication()

Deshabilita la autenticación automática e impide que se InteractiveBrowserCredential le pida automáticamente al usuario. Si la autenticación automática está deshabilitada, se producirá una AuthenticationRequiredException excepción getToken(TokenRequestContext request) en caso de que sea necesaria la interacción del usuario. La aplicación es responsable de controlar esta excepción y llamar authenticate() a o authenticate(TokenRequestContext request) autenticar al usuario de forma interactiva.

Returns:

Instancia actualizada de este generador con autenticación automática deshabilitada.

loginHint

public InteractiveBrowserCredentialBuilder loginHint(String loginHint)

Establece la sugerencia de nombre de usuario para rellenar previamente el campo nombre de usuario o dirección de correo electrónico de la página de inicio de sesión. Un usuario puede seguir iniciando sesión con un nombre de usuario diferente.

Parameters:

loginHint - la sugerencia de nombre de usuario para rellenar previamente el campo nombre de usuario o dirección de correo electrónico de la página de inicio de sesión.

Returns:

Instancia actualizada de este generador con la sugerencia de inicio de sesión configurada.

port

@Deprecated
public InteractiveBrowserCredentialBuilder port(int port)

Obsoleto

Configure la dirección URL de redireccionamiento como http://localhost:{port} vía redirectUrl(String redirectUrl) en su lugar.

Establece el puerto del servidor HTTP local, para el que http://localhost:{port} se debe registrar como una dirección URL de respuesta válida en la aplicación.

Parameters:

port - el puerto en el que la credencial escuchará el resultado de la autenticación del explorador.

Returns:

InteractiveBrowserCredentialBuilder

redirectUrl

public InteractiveBrowserCredentialBuilder redirectUrl(String redirectUrl)

Establece la dirección URL de redireccionamiento donde STS devolverá la llamada a la aplicación con el código de seguridad. Es necesario si se especifica un identificador de cliente personalizado a través InteractiveBrowserCredentialBuilder#clientId(String) de y debe coincidir con la dirección URL de redireccionamiento especificada durante el registro de la aplicación.

Parameters:

redirectUrl - la dirección URL de redireccionamiento para escuchar y recibir código de seguridad.

Returns:

Instancia actualizada de este generador con la dirección URL de redireccionamiento configurada.

tokenCachePersistenceOptions

public InteractiveBrowserCredentialBuilder tokenCachePersistenceOptions(TokenCachePersistenceOptions tokenCachePersistenceOptions)

Configura las opciones de caché de tokens compartidos persistentes y habilita la caché de tokens persistente que está deshabilitada de forma predeterminada. Si se configura, la credencial almacenará tokens en una memoria caché almacenada en la máquina, protegida para el usuario actual, que se puede compartir con otras credenciales y procesos.

Parameters:

tokenCachePersistenceOptions - las opciones de configuración de la caché de tokens

Returns:

Instancia actualizada de este generador con las opciones de caché de tokens configuradas.