com.microsoft.aad.msal4j

Class RefreshTokenParameters

java.lang.Object

com.microsoft.aad.msal4j.RefreshTokenParameters

public class RefreshTokenParameters
extends Object

Object containing parameters for refresh token request. Can be used as parameter to AbstractClientApplicationBase.acquireToken(RefreshTokenParameters) or to AbstractClientApplicationBase.acquireToken(RefreshTokenParameters)

RefreshTokenParameters should only be used for migration scenarios (when moving from ADAL to MSAL). To acquire tokens silently, use AbstractClientApplicationBase.acquireTokenSilently(SilentParameters)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RefreshTokenParameters.RefreshTokenParametersBuilder

Method Summary

Modifier and Type	Method and Description
static RefreshTokenParameters.RefreshTokenParametersBuilder	builder(Set<String> scopes, String refreshToken) Builder for RefreshTokenParameters
ClaimsRequest	claims() Gets the claims request parameter that will be sent with the authentication request.
Map<String,String>	extraHttpHeaders() Gets additional HTTP headers to be included in the token request.
Map<String,String>	extraQueryParameters() Gets additional query parameters to be included in the token request.
String	refreshToken()
Set<String>	scopes() Gets the set of scopes (permissions) requested for the access token.
String	tenant() Gets the tenant identifier for the token request.

Methods inherited from class java.lang.Object

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

Method Detail

builder

public static RefreshTokenParameters.RefreshTokenParametersBuilder builder(Set<String> scopes,
                                                                           String refreshToken)

Builder for RefreshTokenParameters

Parameters:

scopes - scopes application is requesting access to

refreshToken - refresh token received form the STS

Returns:

builder object that can be used to construct RefreshTokenParameters

scopes

public Set<String> scopes()

Gets the set of scopes (permissions) requested for the access token.

Scopes represent the permissions that the application is requesting access to.

Returns:

A set of scope strings being requested for the access token.

refreshToken

public String refreshToken()

claims

public ClaimsRequest claims()

Gets the claims request parameter that will be sent with the authentication request.

The claims request parameter can be used to request specific claims to be returned in the token, to request MFA authentication, or to control other aspects of token issuance.

Returns:

A ClaimsRequest object containing the requested claims, or null if no claims are specified.

extraHttpHeaders

public Map<String,String> extraHttpHeaders()

Gets additional HTTP headers to be included in the token request.

These headers will be added to the HTTP requests sent to the token endpoint. This can be useful for scenarios requiring custom headers for proxies or for diagnostic purposes.

Returns:

A map of additional HTTP headers to include with the token request, or null if no extra headers are needed.

extraQueryParameters

public Map<String,String> extraQueryParameters()

Gets additional query parameters to be included in the token request.

These parameters will be added to the query string in requests to the authorization and token endpoints. This can be useful for scenarios requiring custom parameters that aren't explicitly supported in the library.

Returns:

A map of additional query parameters to include with the token request, or null if no extra parameters are needed.

tenant

public String tenant()

Gets the tenant identifier for the token request.

When specified, this value overrides the tenant specified in the application's authority URL. It can be a tenant ID (GUID), domain name, or one of the special values like "common" or "organizations".

Returns:

The tenant identifier to use for the token request, or null to use the tenant from the authority URL.