InteractiveBrowserCredentialBuilder Classe

Paquet:

com.azure.identity

Artefact 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>

Générateur d’informations d’identification Fluent pour instancier un InteractiveBrowserCredential.

L’authentification interactive par navigateur est un type de flux d’authentification proposé par Azure Active Directory (Azure AD) qui permet aux utilisateurs de se connecter à des applications et des services à l’aide d’un navigateur web. Cette méthode d’authentification est couramment utilisée pour les applications web, où les utilisateurs entrent leurs informations d’identification directement dans une page web. Avec l’authentification interactive du navigateur, l’utilisateur accède à une application web et est invité à entrer ses informations d’identification de nom d’utilisateur et de mot de passe. L’application redirige ensuite l’utilisateur vers la page de connexion Azure AD, où il est invité à entrer à nouveau ses informations d’identification. Une fois que l’utilisateur s’est authentifié, Azure AD émet un jeton de sécurité que l’application peut utiliser pour autoriser l’accès de l’utilisateur à ses ressources. Le InteractiveBrowserCredential authentifie de manière interactive un utilisateur et acquiert un jeton avec le navigateur système par défaut et offre une expérience d’authentification fluide en permettant à un utilisateur d’utiliser ses propres informations d’identification pour authentifier l’application. Une fois authentifié, le flux oauth2 notifie les informations d’identification du code d’authentification via l’URL de réponse. Pour plus d’informations, reportez-vous aux connaissances conceptuelles et aux détails de configuration.

Exemple : Construire InteractiveBrowserCredential

L’exemple de code suivant illustre la création d’un InteractiveBrowserCredential, à l’aide de pour le InteractiveBrowserCredentialBuilder configurer. Par défaut, les informations d’identification ciblent une URL de redirection localhost, pour remplacer ce comportement, un redirectUrl(String redirectUrl) peut éventuellement être spécifié. Une fois ces informations d’identification créées, elles peuvent être passées au générateur de la plupart des générateurs de clients du SDK Azure pour Java en tant que paramètre « credential ».

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

Récapitulatif du constructeur

Constructeur	Description
InteractiveBrowserCredentialBuilder()

Résumé de la méthode

Modificateur et type	Méthode et description
InteractiveBrowserCredentialBuilder	additionallyAllowedTenants(String[] additionallyAllowedTenants) Pour les applications multilocataires, spécifie des locataires supplémentaires pour lesquels les informations d’identification peuvent acquérir des jetons.
InteractiveBrowserCredentialBuilder	additionallyAllowedTenants(List<String> additionallyAllowedTenants) Pour les applications multilocataires, spécifie des locataires supplémentaires pour lesquels les informations d’identification peuvent acquérir des jetons.
InteractiveBrowserCredentialBuilder	authenticationRecord(AuthenticationRecord authenticationRecord) Définit le AuthenticationRecord capturé à partir d’une authentification précédente.
InteractiveBrowserCredentialBuilder	browserCustomizationOptions(BrowserCustomizationOptions browserCustomizationOptions) Configure les options de personnalisation du navigateur pour l’authentification interactive.
InteractiveBrowserCredential	build() Crée un nouveau InteractiveBrowserCredential avec les configurations actuelles.
InteractiveBrowserCredentialBuilder	disableAutomaticAuthentication() Désactive l’authentification automatique et empêche le InteractiveBrowserCredential d’inviter automatiquement l’utilisateur.
InteractiveBrowserCredentialBuilder	loginHint(String loginHint) Définit la suggestion de nom d’utilisateur pour pré-remplir le champ nom d’utilisateur/adresse e-mail de la page de connexion.
InteractiveBrowserCredentialBuilder	port(int port) Déprécié Configurez l’URL de redirection comme http://localhost:{port} via redirectUrl(String redirectUrl) à la place. Définit le port du serveur HTTP local, pour lequel http://localhost:{port} doit être inscrit en tant qu’URL de réponse valide sur l’application.
InteractiveBrowserCredentialBuilder	redirectUrl(String redirectUrl) Définit l’URL de redirection où STS rappelle l’application avec le code de sécurité.
InteractiveBrowserCredentialBuilder	tokenCachePersistenceOptions(TokenCachePersistenceOptions tokenCachePersistenceOptions) Configure les options de cache de jetons partagés persistants et active le cache de jetons persistants, qui est désactivé par défaut.

Méthodes héritées de AadCredentialBuilderBase

additionallyAllowedTenants additionallyAllowedTenants authorityHost clientId disableInstanceDiscovery enableUnsafeSupportLogging executorService tenantId

Méthodes héritées de CredentialBuilderBase

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

Méthodes héritées de java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Détails du constructeur

InteractiveBrowserCredentialBuilder

public InteractiveBrowserCredentialBuilder()

Détails de la méthode

additionallyAllowedTenants

public InteractiveBrowserCredentialBuilder additionallyAllowedTenants(String[] additionallyAllowedTenants)

Pour les applications multilocataires, spécifie des locataires supplémentaires pour lesquels les informations d’identification peuvent acquérir des jetons. Ajoutez la valeur générique « * » pour permettre aux informations d’identification d’acquérir des jetons pour n’importe quel locataire sur lequel l’application est installée. Si aucune valeur n’est spécifiée pour TenantId, cette option n’aura aucun effet et les informations d’identification acquièrent des jetons pour tout locataire demandé.

Overrides:

InteractiveBrowserCredentialBuilder.additionallyAllowedTenants(String[] additionallyAllowedTenants)

Parameters:

additionallyAllowedTenants - les locataires autorisés en outre.

Returns:

Une instance mise à jour de ce générateur avec les locataires supplémentaires configurés.

additionallyAllowedTenants

public InteractiveBrowserCredentialBuilder additionallyAllowedTenants(List additionallyAllowedTenants)

Pour les applications multilocataires, spécifie des locataires supplémentaires pour lesquels les informations d’identification peuvent acquérir des jetons. Ajoutez la valeur générique « * » pour permettre aux informations d’identification d’acquérir des jetons pour n’importe quel locataire sur lequel l’application est installée. Si aucune valeur n’est spécifiée pour TenantId, cette option n’aura aucun effet et les informations d’identification acquièrent des jetons pour tout locataire demandé.

Overrides:

InteractiveBrowserCredentialBuilder.additionallyAllowedTenants(List<String> additionallyAllowedTenants)

Parameters:

additionallyAllowedTenants - les locataires autorisés en outre.

Returns:

Une instance mise à jour de ce générateur avec les locataires supplémentaires configurés.

authenticationRecord

public InteractiveBrowserCredentialBuilder authenticationRecord(AuthenticationRecord authenticationRecord)

Définit le AuthenticationRecord capturé à partir d’une authentification précédente.

Parameters:

authenticationRecord - Enregistrement d’authentification à configurer.

Returns:

Une instance mise à jour de ce générateur avec l’enregistrement d’authentification configuré.

browserCustomizationOptions

public InteractiveBrowserCredentialBuilder browserCustomizationOptions(BrowserCustomizationOptions browserCustomizationOptions)

Configure les options de personnalisation du navigateur pour l’authentification interactive.

Parameters:

browserCustomizationOptions - options de personnalisation du navigateur

Returns:

Mise à jour instance de ce générateur avec les options de personnalisation du navigateur configurées.

build

public InteractiveBrowserCredential build()

Crée un nouveau InteractiveBrowserCredential avec les configurations actuelles.

Returns:

avec InteractiveBrowserCredential les configurations actuelles.

disableAutomaticAuthentication

public InteractiveBrowserCredentialBuilder disableAutomaticAuthentication()

Désactive l’authentification automatique et empêche le InteractiveBrowserCredential d’inviter automatiquement l’utilisateur. Si l’authentification automatique est désactivée, une AuthenticationRequiredException exception est levée dans getToken(TokenRequestContext request) le cas où l’interaction de l’utilisateur est nécessaire. L’application est chargée de gérer cette exception et d’appeler authenticate() ou authenticate(TokenRequestContext request) d’authentifier l’utilisateur de manière interactive.

Returns:

Une instance mise à jour de ce générateur avec l’authentification automatique désactivée.

loginHint

public InteractiveBrowserCredentialBuilder loginHint(String loginHint)

Définit la suggestion de nom d’utilisateur pour pré-remplir le champ nom d’utilisateur/adresse e-mail de la page de connexion. Un utilisateur peut toujours se connecter avec un nom d’utilisateur différent.

Parameters:

loginHint - la suggestion de nom d’utilisateur pour prére remplir le champ nom d’utilisateur/adresse e-mail de la page de connexion.

Returns:

Une instance mise à jour de ce générateur avec l’indicateur de connexion configuré.

port

@Deprecated
public InteractiveBrowserCredentialBuilder port(int port)

Déprécié

Configurez l’URL de redirection comme http://localhost:{port} via redirectUrl(String redirectUrl) à la place.

Définit le port du serveur HTTP local, pour lequel http://localhost:{port} doit être inscrit en tant qu’URL de réponse valide sur l’application.

Parameters:

port - port sur lequel les informations d’identification écouteront le résultat de l’authentification du navigateur

Returns:

InteractiveBrowserCredentialBuilder lui-même

redirectUrl

public InteractiveBrowserCredentialBuilder redirectUrl(String redirectUrl)

Définit l’URL de redirection où STS rappelle l’application avec le code de sécurité. Elle est obligatoire si un ID client personnalisé est spécifié via InteractiveBrowserCredentialBuilder#clientId(String) et doit correspondre à l’URL de redirection spécifiée lors de l’inscription de l’application.

Parameters:

redirectUrl - URL de redirection pour écouter et recevoir le code de sécurité.

Returns:

Une instance mise à jour de ce générateur avec l’URL de redirection configurée.

tokenCachePersistenceOptions

public InteractiveBrowserCredentialBuilder tokenCachePersistenceOptions(TokenCachePersistenceOptions tokenCachePersistenceOptions)

Configure les options de cache de jetons partagés persistants et active le cache de jetons persistants, qui est désactivé par défaut. Si elles sont configurées, les informations d’identification stockent les jetons dans un cache conservé sur l’ordinateur, protégé pour l’utilisateur actuel, qui peut être partagé par d’autres informations d’identification et processus.

Parameters:

tokenCachePersistenceOptions - options de configuration du cache de jetons

Returns:

Une instance mise à jour de ce générateur avec les options de cache de jeton configurées.