public static class PublicClientApplication.Builder extends Object
Modifier and Type | Method and Description |
---|---|
T |
aadInstanceDiscoveryResponse(String val)
Sets instance discovery response data which will be used for determining tenant discovery
endpoint and authority aliases.
|
T |
applicationName(String val)
Sets application name for telemetry purposes
|
T |
applicationVersion(String val)
Sets application version for telemetry purposes
|
T |
authority(String val)
Set URL of the authenticating authority or security token service (STS) from which MSAL
will acquire security tokens.
|
T |
autoDetectRegion(boolean val)
Indicates that the library should attempt to discover the Azure region the application is running in when
fetching the instance discovery metadata.
|
T |
azureRegion(String val)
Indicates that the library should attempt to fetch the instance discovery metadata from the specified Azure region.
|
T |
b2cAuthority(String val) |
PublicClientApplication |
build() |
T |
clientCapabilities(Set<String> capabilities) |
T |
connectTimeoutForDefaultHttpClient(Integer val)
Sets the connect timeout value used in HttpsURLConnection connections made by
DefaultHttpClient ,
and is not needed if using a custom HTTP client |
T |
correlationId(String val)
Set optional correlation id to be used by the API.
|
T |
executorService(ExecutorService val)
Sets ExecutorService to be used to execute the requests.
|
T |
httpClient(IHttpClient val)
Sets HTTP client to be used by the client application for all HTTP requests.
|
T |
logPii(boolean val)
Set logPii - boolean value, which determines
whether Pii (personally identifiable information) will be logged in.
|
T |
proxy(Proxy val)
Sets Proxy configuration to be used by the client application (MSAL4J by default uses
HttpsURLConnection ) for all network communication. |
T |
readTimeoutForDefaultHttpClient(Integer val)
Sets the read timeout value used in HttpsURLConnection connections made by
DefaultHttpClient ,
and is not needed if using a custom HTTP client |
protected PublicClientApplication.Builder |
self() |
T |
setTokenCacheAccessAspect(ITokenCacheAccessAspect val)
Sets ITokenCacheAccessAspect to be used for cache_data persistence.
|
T |
sslSocketFactory(SSLSocketFactory val)
Sets SSLSocketFactory to be used by the client application for all network communication.
|
T |
validateAuthority(boolean val)
Set a boolean value telling the application if the authority needs to be verified
against a list of known authorities.
|
public PublicClientApplication build()
protected PublicClientApplication.Builder self()
public T authority(String val) throws MalformedURLException
IClientApplicationBase.DEFAULT_AUTHORITY
val
- a string value of authorityMalformedURLException
- if val is malformed URLpublic T b2cAuthority(String val) throws MalformedURLException
MalformedURLException
public T validateAuthority(boolean val)
AbstractClientApplicationBase.aadAadInstanceDiscoveryResponse
The default value is true.
val
- a boolean value for validateAuthoritypublic T correlationId(String val)
val
- a string value of correlation idpublic T logPii(boolean val)
val
- a boolean value for logPiipublic T executorService(ExecutorService val)
val
- an instance of ExecutorServicepublic T proxy(Proxy val)
HttpsURLConnection
) for all network communication.
If no proxy value is passed in, system defined properties are used. If HTTP client is set on
the client application (via ClientApplication.builder().httpClient()),
proxy configuration should be done on the HTTP client object being passed in,
and not through this method.val
- an instance of Proxypublic T httpClient(IHttpClient val)
val
- Implementation of IHttpClient
public T sslSocketFactory(SSLSocketFactory val)
val
- an instance of SSLSocketFactorypublic T connectTimeoutForDefaultHttpClient(Integer val)
DefaultHttpClient
,
and is not needed if using a custom HTTP clientval
- timeout value in millisecondspublic T readTimeoutForDefaultHttpClient(Integer val)
DefaultHttpClient
,
and is not needed if using a custom HTTP clientval
- timeout value in millisecondspublic T applicationName(String val)
val
- application namepublic T applicationVersion(String val)
val
- application versionpublic T setTokenCacheAccessAspect(ITokenCacheAccessAspect val)
val
- an instance of ITokenCacheAccessAspectpublic T aadInstanceDiscoveryResponse(String val)
Note that authority validation is not done even if AbstractClientApplicationBase.validateAuthority
is set to true.
For more information, see https://aka.ms/msal4j-instance-discovery
val
- JSON formatted value of response from AAD instance discovery endpointpublic T autoDetectRegion(boolean val)
If the region is found, token requests will be sent to the regional ESTS endpoint rather than the global endpoint. If region information could not be found, the library will fall back to using the global endpoint, which is also the default behavior if this value is not set.
val
- boolean (default is false)public T azureRegion(String val)
If the region is valid, token requests will be sent to the regional ESTS endpoint rather than the global endpoint. If region information could not be verified, the library will fall back to using the global endpoint, which is also the default behavior if this value is not set.
val
- String region nameCopyright © 2013–2022. All rights reserved.