InteractiveRequestParameters.InteractiveRequestParametersBuilder Classe

  • java.lang.Object
    • com.microsoft.aad.msal4j.InteractiveRequestParameters.InteractiveRequestParametersBuilder

public static class InteractiveRequestParameters.InteractiveRequestParametersBuilder

Résumé de la méthode

Modificateur et type Méthode et description
InteractiveRequestParameters build()
InteractiveRequestParametersBuilder claims(ClaimsRequest claims)

Revendications à demander via le paramètre de demande de revendications OIDC, ce qui permet de demander des revendications standard et personnalisées

InteractiveRequestParametersBuilder claimsChallenge(String claimsChallenge)

Utilisé lorsqu’une demande de jeton échoue et que la réponse a une chaîne de défi

InteractiveRequestParametersBuilder domainHint(String domainHint)

Fournit un indicateur sur le locataire ou le domaine que l’utilisateur doit utiliser pour se connecter.

InteractiveRequestParametersBuilder extraHttpHeaders(Map<String,String> extraHttpHeaders)

Ajoute des en-têtes supplémentaires à la demande de jeton

InteractiveRequestParametersBuilder extraQueryParameters(Map<String,String> extraQueryParameters)

Déprécié

Non recommandé pour les scénarios de production. Elle sera supprimée dans une prochaine version et le comportement peut être remplacé par une nouvelle API.

Ajoute des paramètres de requête supplémentaires à la demande de jeton

InteractiveRequestParametersBuilder httpPollingTimeoutInSeconds(int httpPollingTimeoutInSeconds)

Durée en secondes pendant laquelle la bibliothèque attend un résultat d’authentification.

InteractiveRequestParametersBuilder instanceAware(boolean instanceAware)

Si la valeur est true, le résultat d’autorisation contient l’autorité du cloud de base de l’utilisateur, et cette autorité sera utilisée pour la demande de jeton au lieu de l’autorité définie dans l’application.

InteractiveRequestParametersBuilder loginHint(String loginHint)

Peut être utilisé pour pré-remplir le champ nom d’utilisateur/adresse e-mail de la page de connexion de l’utilisateur, si vous connaissez l’adresse nom d’utilisateur/e-mail à l’avance.

InteractiveRequestParametersBuilder prompt(Prompt prompt)

Indiquez le type d’interaction utilisateur requis.

InteractiveRequestParametersBuilder proofOfPossession(HttpMethod httpMethod, URI uri, String nonce)

Définit les paramètres popde cette requête, ce qui permet à la demande de récupérer des jetons de preuve de possession plutôt que des jetons du porteur

InteractiveRequestParametersBuilder redirectUri(URI redirectUri)

URI de redirection où MSAL écoute le code d’autorisation retourné par Azure AD.

InteractiveRequestParametersBuilder scopes(Set<String> scopes)

Étendues auxquelles l’application demande l’accès et l’utilisateur consent.

InteractiveRequestParametersBuilder systemBrowserOptions(SystemBrowserOptions systemBrowserOptions)

Définit SystemBrowserOptions à utiliser par l’application clientepublique

InteractiveRequestParametersBuilder tenant(String tenant)

Remplace la valeur du locataire dans l’URL d’autorité de cette requête

java.lang.String toString()
InteractiveRequestParametersBuilder windowHandle(long windowHandle)

Handle de fenêtre parent utilisé pour ouvrir des éléments d’interface utilisateur avec le parent approprié

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

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

Détails de la méthode

build

public InteractiveRequestParameters build()

claims

public InteractiveRequestParameters.InteractiveRequestParametersBuilder claims(ClaimsRequest claims)

Revendications à demander via le paramètre de demande de revendications OIDC, ce qui permet de demander des revendications standard et personnalisées

Paramètres:

claims

claimsChallenge

public InteractiveRequestParameters.InteractiveRequestParametersBuilder claimsChallenge(String claimsChallenge)

Utilisé lorsqu’une demande de jeton échoue et que la réponse a une chaîne de défi

Paramètres:

claimsChallenge

domainHint

public InteractiveRequestParameters.InteractiveRequestParametersBuilder domainHint(String domainHint)

Fournit un indicateur sur le locataire ou le domaine que l’utilisateur doit utiliser pour se connecter. La valeur de l’indicateur de domaine est un domaine inscrit pour le locataire.

Paramètres:

domainHint

extraHttpHeaders

public InteractiveRequestParameters.InteractiveRequestParametersBuilder extraHttpHeaders(Map<String,String> extraHttpHeaders)

Ajoute des en-têtes supplémentaires à la demande de jeton

Paramètres:

extraHttpHeaders

extraQueryParameters


public InteractiveRequestParameters.InteractiveRequestParametersBuilder extraQueryParameters(Map<String,String> extraQueryParameters)

Déprécié

Non recommandé pour les scénarios de production. Elle sera supprimée dans une prochaine version et le comportement peut être remplacé par une nouvelle API.

Ajoute des paramètres de requête supplémentaires à la demande de jeton

Paramètres:

extraQueryParameters

httpPollingTimeoutInSeconds

public InteractiveRequestParameters.InteractiveRequestParametersBuilder httpPollingTimeoutInSeconds(int httpPollingTimeoutInSeconds)

Durée en secondes pendant laquelle la bibliothèque attend un résultat d’authentification. 120 secondes est le délai d’expiration par défaut.

Si ce délai d’expiration est défini sur 0 ou moins, il sera ignoré et la bibliothèque utilisera un délai d’expiration de 1 seconde à la place

Paramètres:

httpPollingTimeoutInSeconds

instanceAware

public InteractiveRequestParameters.InteractiveRequestParametersBuilder instanceAware(boolean instanceAware)

Si la valeur est true, le résultat d’autorisation contient l’autorité du cloud de base de l’utilisateur, et cette autorité sera utilisée pour la demande de jeton au lieu de l’autorité définie dans l’application.

Paramètres:

instanceAware

loginHint

public InteractiveRequestParameters.InteractiveRequestParametersBuilder loginHint(String loginHint)

Peut être utilisé pour pré-remplir le champ nom d’utilisateur/adresse e-mail de la page de connexion de l’utilisateur, si vous connaissez l’adresse nom d’utilisateur/e-mail à l’avance. Souvent, les applications utilisent ce paramètre pendant la réauthentification, ayant déjà extrait le nom d’utilisateur d’une connexion précédente à l’aide de la revendication preferred_username.

Paramètres:

loginHint

prompt

public InteractiveRequestParameters.InteractiveRequestParametersBuilder prompt(Prompt prompt)

Indiquez le type d’interaction utilisateur requis.

Paramètres:

prompt

proofOfPossession

public InteractiveRequestParameters.InteractiveRequestParametersBuilder proofOfPossession(HttpMethod httpMethod, URI uri, String nonce)

Définit les PopParameters pour cette requête, ce qui permet à la demande de récupérer des jetons de preuve de possession plutôt que des jetons du porteur

Pour plus d’informations, consultez PopParameters et https://aka.ms/msal4j-pop

Paramètres:

httpMethod - une méthode HTTP valide, telle que « GET » ou « POST »
uri - l’URI sur l’API protégée en aval que l’application tente d’accéder, par exemple. https://graph.microsoft.com/beta/me/profile
nonce - chaîne obtenue en appelant la ressource (par exemple, Microsoft Graph) non authentifiée et analysant l’en-tête WWW-Authenticate associé au schéma d’authentification pop et en extrayant le paramètre nonce ou, lors des appels suivants, en analysant l’en-tête Autheticate-Info et en extrayant le paramètre nextnonce.

redirectUri

public InteractiveRequestParameters.InteractiveRequestParametersBuilder redirectUri(URI redirectUri)

URI de redirection où MSAL écoute le code d’autorisation retourné par Azure AD. Doit être une adresse de bouclage avec un port spécifié (par exemple, http://localhost:3671). Si aucun port n’est spécifié, MSAL trouve un port ouvert. Pour plus d’informations, consultez https://aka.ms/msal4j-interactive-request.

Ne peut pas être null.

Paramètres:

redirectUri

scopes

public InteractiveRequestParameters.InteractiveRequestParametersBuilder scopes(Set<String> scopes)

Étendues auxquelles l’application demande l’accès et l’utilisateur consent.

Paramètres:

scopes

systemBrowserOptions

public InteractiveRequestParameters.InteractiveRequestParametersBuilder systemBrowserOptions(SystemBrowserOptions systemBrowserOptions)

Définit SystemBrowserOptions à utiliser par PublicClientApplication

Paramètres:

systemBrowserOptions

tenant

public InteractiveRequestParameters.InteractiveRequestParametersBuilder tenant(String tenant)

Remplace la valeur du locataire dans l’URL d’autorité de cette requête

Paramètres:

tenant

toString

public String toString()

Remplacements:

InteractiveRequestParameters.InteractiveRequestParametersBuilder.toString()

windowHandle

public InteractiveRequestParameters.InteractiveRequestParametersBuilder windowHandle(long windowHandle)

Handle de fenêtre parent utilisé pour ouvrir des éléments d’interface utilisateur avec le parent approprié

Pour les scénarios de navigateur et les applications console Windows, cette valeur ne doit pas nécessairement être définie

Pour Windows applications console, MSAL Java tentera de découvrir le handle de fenêtre de la console si ce paramètre n'est pas défini

Dans les scénarios où MSAL Java est responsable de l’ouverture d’éléments d’interface utilisateur (par exemple, lors de l’utilisation de MSALRuntime), ce paramètre est requis et une exception est levée si elle n’est pas définie

Paramètres:

windowHandle

S’applique à