InteractiveRequestParameters.InteractiveRequestParametersBuilder Classe

Pacchetto:
com.microsoft.aad.msal4j
Artefatto Maven:
com.microsoft.azure:msal4j:1.26.0
  • java.lang.Object
    • com.microsoft.aad.msal4j.InteractiveRequestParameters.InteractiveRequestParametersBuilder

public static class InteractiveRequestParameters.InteractiveRequestParametersBuilder

Riepilogo dei metodi

Modificatore e tipo Metodo e descrizione
InteractiveRequestParameters build()
InteractiveRequestParametersBuilder claims(ClaimsRequest claims)

Attestazioni da richiedere tramite il parametro di richiesta di attestazioni OIDC, consentendo richieste di attestazioni standard e personalizzate
InteractiveRequestParametersBuilder claimsChallenge(String claimsChallenge)

Usato quando una richiesta di token ha esito negativo e la risposta ha una stringa di verifica
InteractiveRequestParametersBuilder domainHint(String domainHint)

Fornisce un suggerimento sul tenant o sul dominio che l'utente deve usare per accedere.
InteractiveRequestParametersBuilder extraHttpHeaders(Map<String,String> extraHttpHeaders)

Aggiunge intestazioni aggiuntive alla richiesta di token
InteractiveRequestParametersBuilder extraQueryParameters(Map<String,String> extraQueryParameters)

Deprecato

Non consigliato per gli scenari di produzione. Verrà rimosso in una versione futura e il comportamento potrebbe essere sostituito da una nuova API.

Aggiunge parametri di query aggiuntivi alla richiesta di token
InteractiveRequestParametersBuilder httpPollingTimeoutInSeconds(int httpPollingTimeoutInSeconds)

Intervallo di tempo in secondi in cui la libreria attenderà un risultato di autenticazione.
InteractiveRequestParametersBuilder instanceAware(boolean instanceAware)

Se impostato su true, il risultato dell'autorizzazione conterrà l'autorità per il cloud principale dell'utente e questa autorità verrà usata per la richiesta di token anziché per l'autorità impostata nell'applicazione.
InteractiveRequestParametersBuilder loginHint(String loginHint)

Può essere usato per pre-compilare il campo nome utente/indirizzo di posta elettronica della pagina di accesso per l'utente, se si conosce il nome utente/indirizzo di posta elettronica in anticipo.
InteractiveRequestParametersBuilder prompt(Prompt prompt)

Indicare il tipo di interazione dell'utente richiesto.
InteractiveRequestParametersBuilder proofOfPossession(HttpMethod httpMethod, URI uri, String nonce)

Imposta i parametri Popper questa richiesta, consentendo alla richiesta di recuperare i token di verifica del possesso anziché i token di connessione
InteractiveRequestParametersBuilder redirectUri(URI redirectUri)

URI di reindirizzamento in cui MSAL sarà in ascolto del codice di autorizzazione restituito da Azure AD.
InteractiveRequestParametersBuilder scopes(Set<String> scopes)

Ambiti a cui l'applicazione richiede l'accesso e l'utente acconsenterà.
InteractiveRequestParametersBuilder systemBrowserOptions(SystemBrowserOptions systemBrowserOptions)

Imposta SystemBrowserOptions da utilizzare dall'applicazione clientpubblica
InteractiveRequestParametersBuilder tenant(String tenant)

Esegue l'override del valore del tenant nell'URL dell'autorità per questa richiesta
java.lang.String toString()
InteractiveRequestParametersBuilder windowHandle(long windowHandle)

Handle della finestra padre usato per aprire gli elementi dell'interfaccia utente con l'elemento padre corretto

Metodi ereditati da 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

Dettagli metodo

build

public InteractiveRequestParameters build()

claims

public InteractiveRequestParameters.InteractiveRequestParametersBuilder claims(ClaimsRequest claims)

Attestazioni da richiedere tramite il parametro di richiesta di attestazioni OIDC, consentendo richieste di attestazioni standard e personalizzate

Parametri:

claims

claimsChallenge

public InteractiveRequestParameters.InteractiveRequestParametersBuilder claimsChallenge(String claimsChallenge)

Usato quando una richiesta di token ha esito negativo e la risposta ha una stringa di verifica

Parametri:

claimsChallenge

domainHint

public InteractiveRequestParameters.InteractiveRequestParametersBuilder domainHint(String domainHint)

Fornisce un suggerimento sul tenant o sul dominio che l'utente deve usare per accedere. Il valore dell'hint di dominio è un dominio registrato per il tenant.

Parametri:

domainHint

extraHttpHeaders

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

Aggiunge intestazioni aggiuntive alla richiesta di token

Parametri:

extraHttpHeaders

extraQueryParameters


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

Deprecato

Non consigliato per gli scenari di produzione. Verrà rimosso in una versione futura e il comportamento potrebbe essere sostituito da una nuova API.

Aggiunge parametri di query aggiuntivi alla richiesta di token

Parametri:

extraQueryParameters

httpPollingTimeoutInSeconds

public InteractiveRequestParameters.InteractiveRequestParametersBuilder httpPollingTimeoutInSeconds(int httpPollingTimeoutInSeconds)

Intervallo di tempo in secondi in cui la libreria attenderà un risultato di autenticazione. 120 secondi è il timeout predefinito.

Se questo timeout è impostato su 0 o meno, verrà ignorato e la libreria userà invece un timeout di 1 secondo

Parametri:

httpPollingTimeoutInSeconds

instanceAware

public InteractiveRequestParameters.InteractiveRequestParametersBuilder instanceAware(boolean instanceAware)

Se impostato su true, il risultato dell'autorizzazione conterrà l'autorità per il cloud principale dell'utente e questa autorità verrà usata per la richiesta di token anziché per l'autorità impostata nell'applicazione.

Parametri:

instanceAware

loginHint

public InteractiveRequestParameters.InteractiveRequestParametersBuilder loginHint(String loginHint)

Può essere usato per pre-compilare il campo nome utente/indirizzo di posta elettronica della pagina di accesso per l'utente, se si conosce il nome utente/indirizzo di posta elettronica in anticipo. Spesso le app usano questo parametro durante la ripetizione dell'autenticazione, avendo già estratto il nome utente da un accesso precedente usando l'attestazione preferred_username.

Parametri:

loginHint

prompt

public InteractiveRequestParameters.InteractiveRequestParametersBuilder prompt(Prompt prompt)

Indicare il tipo di interazione dell'utente richiesto.

Parametri:

prompt

proofOfPossession

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

Imposta i PopParameters per questa richiesta, consentendo alla richiesta di recuperare i token di verifica del possesso anziché i token di connessione

Per altre informazioni, vedere PopParameters e https://aka.ms/msal4j-pop

Parametri:

httpMethod - un metodo HTTP valido, ad esempio "GET" o "POST"
uri - URI nell'API protetta downstream a cui l'applicazione sta tentando di accedere, ad esempio https://graph.microsoft.com/beta/me/profile
nonce - stringa ottenuta chiamando la risorsa (ad esempio, Microsoft Graph) non autenticata e analizzando l'intestazione WWW-Authenticate associata allo schema di autenticazione pop ed estraendo il parametro nonce o, nelle chiamate successive, analizzando l'intestazione Autheticate-Info ed estraendo il parametro nextnonce.

redirectUri

public InteractiveRequestParameters.InteractiveRequestParametersBuilder redirectUri(URI redirectUri)

URI di reindirizzamento in cui MSAL sarà in ascolto del codice di autorizzazione restituito da Azure AD. Deve essere un indirizzo di loopback con una porta specificata, ad esempio http://localhost:3671). Se non viene specificata alcuna porta, MSAL troverà una porta aperta. Per altre informazioni, vedere https://aka.ms/msal4j-interactive-request.

Non può essere Null.

Parametri:

redirectUri

scopes

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

Ambiti a cui l'applicazione richiede l'accesso e l'utente acconsenterà.

Parametri:

scopes

systemBrowserOptions

public InteractiveRequestParameters.InteractiveRequestParametersBuilder systemBrowserOptions(SystemBrowserOptions systemBrowserOptions)

Imposta SystemBrowserOptions da utilizzare da PublicClientApplication

Parametri:

systemBrowserOptions

tenant

public InteractiveRequestParameters.InteractiveRequestParametersBuilder tenant(String tenant)

Esegue l'override del valore del tenant nell'URL dell'autorità per questa richiesta

Parametri:

tenant

toString

public String toString()

Override:

InteractiveRequestParameters.InteractiveRequestParametersBuilder.toString()

windowHandle

public InteractiveRequestParameters.InteractiveRequestParametersBuilder windowHandle(long windowHandle)

Handle della finestra padre usato per aprire gli elementi dell'interfaccia utente con l'elemento padre corretto

Per gli scenari del browser e le applicazioni console Windows, questo valore non deve essere impostato

Per le applicazioni console di Windows, MSAL Java tenterà di individuare l'handle della finestra della console se questo parametro non è impostato

Per gli scenari in cui MSAL Java è responsabile dell'apertura di elementi dell'interfaccia utente (ad esempio quando si usa MSALRuntime), questo parametro è obbligatorio e verrà generata un'eccezione se non impostata

Parametri:

windowHandle

Si applica a