com.microsoft.aad.msal4j

Class AbstractClientApplicationBase

java.lang.Object

com.microsoft.aad.msal4j.AbstractApplicationBase

com.microsoft.aad.msal4j.AbstractClientApplicationBase

Direct Known Subclasses:

ConfidentialClientApplication, PublicClientApplication

public abstract class AbstractClientApplicationBase
extends AbstractApplicationBase

Abstract class containing common methods and properties to both PublicClientApplication and ConfidentialClientApplication.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractClientApplicationBase.Builder<T extends AbstractClientApplicationBase.Builder<T>>

Field Summary

Fields

Modifier and Type	Field and Description
protected String	azureRegion
static String	DEFAULT_AUTHORITY

Fields inherited from class com.microsoft.aad.msal4j.AbstractApplicationBase

authenticationAuthority, log, tokenCache

Method Summary

Modifier and Type	Method and Description
com.microsoft.aad.msal4j.AadInstanceDiscoveryResponse	aadAadInstanceDiscoveryResponse()
CompletableFuture<IAuthenticationResult>	acquireToken(AuthorizationCodeParameters parameters) Acquires security token from the authority using an authorization code previously received.
CompletableFuture<IAuthenticationResult>	acquireToken(RefreshTokenParameters parameters) Acquires a security token from the authority using a refresh token previously received.
CompletableFuture<IAuthenticationResult>	acquireTokenSilently(SilentParameters parameters) Returns tokens from cache if present and not expired or acquires new tokens from the authority by using the refresh token present in cache.
String	applicationName()
String	applicationVersion()
String	authority()
boolean	autoDetectRegion()
String	azureRegion()
protected abstract com.nimbusds.oauth2.sdk.auth.ClientAuthentication	clientAuthentication()
String	clientCapabilities()
String	clientId()
String	correlationId()
CompletableFuture<Set<IAccount>>	getAccounts() Returns accounts in the cache
URL	getAuthorizationRequestUrl(AuthorizationRequestUrlParameters parameters) Computes the URL of the authorization request letting the user sign-in and consent to the application.
IHttpClient	httpClient() Sets HTTP client to be used by the client application for all HTTP requests.
boolean	instanceDiscovery()
boolean	logPii()
Proxy	proxy()
CompletableFuture<Void>	removeAccount(IAccount account) Removes IAccount from the cache
SSLSocketFactory	sslSocketFactory()
TokenCache	tokenCache()
boolean	validateAuthority()

Methods inherited from class com.microsoft.aad.msal4j.AbstractApplicationBase

connectTimeoutForDefaultHttpClient, correlationId, httpClient, logPii, proxy, readTimeoutForDefaultHttpClient, sslSocketFactory

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

azureRegion

protected String azureRegion

DEFAULT_AUTHORITY

public static final String DEFAULT_AUTHORITY

See Also:

Constant Field Values

Method Detail

clientAuthentication

protected abstract com.nimbusds.oauth2.sdk.auth.ClientAuthentication clientAuthentication()

tokenCache

public TokenCache tokenCache()

acquireToken

public CompletableFuture<IAuthenticationResult> acquireToken(AuthorizationCodeParameters parameters)

Acquires security token from the authority using an authorization code previously received.

Parameters:

parameters - AuthorizationCodeParameters

Returns:

A CompletableFuture object representing the IAuthenticationResult of the call.

acquireToken

public CompletableFuture<IAuthenticationResult> acquireToken(RefreshTokenParameters parameters)

Acquires a security token from the authority using a refresh token previously received. Can be used in migration to MSAL from ADAL, and in various integration scenarios where you have a refresh token available.

Parameters:

parameters - RefreshTokenParameters

Returns:

A CompletableFuture object representing the IAuthenticationResult of the call.

acquireTokenSilently

public CompletableFuture<IAuthenticationResult> acquireTokenSilently(SilentParameters parameters)
                                                              throws MalformedURLException

Returns tokens from cache if present and not expired or acquires new tokens from the authority by using the refresh token present in cache.

Parameters:

parameters - instance of SilentParameters

Returns:

A CompletableFuture object representing the IAuthenticationResult of the call.

Throws:

MalformedURLException - if authorityUrl from parameters is malformed URL

getAccounts

public CompletableFuture<Set<IAccount>> getAccounts()

Returns accounts in the cache

Returns:

set of unique accounts from cache which can be used for silent acquire token call

removeAccount

public CompletableFuture<Void> removeAccount(IAccount account)

Removes IAccount from the cache

Parameters:

account - instance of Account to be removed from cache

Returns:

CompletableFuture object representing account removal task.

getAuthorizationRequestUrl

public URL getAuthorizationRequestUrl(AuthorizationRequestUrlParameters parameters)

Computes the URL of the authorization request letting the user sign-in and consent to the application. The URL target the /authorize endpoint of the authority configured in the application object.

Once the user successfully authenticates, the response should contain an authorization code, which can then be passed in toacquireToken(AuthorizationCodeParameters) to be exchanged for a token

Parameters:

parameters - AuthorizationRequestUrlParameters

Returns:

url of the authorization endpoint where the user can sign-in and consent to the application.

clientId

public String clientId()

Returns:

Client ID (Application ID) of the application as registered in the application registration portal (portal.azure.com) and as passed in the constructor of the application

authority

public String authority()

Returns:

URL of the authority, or security token service (STS) from which MSAL will acquire security tokens. Default value is IApplicationBase.DEFAULT_AUTHORITY

validateAuthority

public boolean validateAuthority()

Returns:

a boolean value which determines whether the authority needs to be verified against a list of known authorities.

applicationName

public String applicationName()

applicationVersion

public String applicationVersion()

aadAadInstanceDiscoveryResponse

public com.microsoft.aad.msal4j.AadInstanceDiscoveryResponse aadAadInstanceDiscoveryResponse()

clientCapabilities

public String clientCapabilities()

autoDetectRegion

public boolean autoDetectRegion()

azureRegion

public String azureRegion()

instanceDiscovery

public boolean instanceDiscovery()

logPii

public boolean logPii()

Returns:

a boolean value which determines whether Pii (personally identifiable information) will be logged in

correlationId

public String correlationId()

Returns:

Correlation ID which is used for diagnostics purposes, is attached to token service requests Default value is random UUID

httpClient

public IHttpClient httpClient()

Sets HTTP client to be used by the client application for all HTTP requests. Allows for fine-grained configuration of HTTP client.

Returns:

instance of IHttpClient used by the application

proxy

public Proxy proxy()

Returns:

proxy used by the application for all network communication.

sslSocketFactory

public SSLSocketFactory sslSocketFactory()

Returns:

SSLSocketFactory used by the application for all network communication.