org.mule.runtime.oauth.api.builder

Interface OAuthAuthorizationCodeDancerBuilder

All Superinterfaces:

OAuthDancerBuilder<AuthorizationCodeOAuthDancer>

public interface OAuthAuthorizationCodeDancerBuilder
extends OAuthDancerBuilder<AuthorizationCodeOAuthDancer>

Builder that allows to configure the attributes for the authorization code grant type.

Since:

4.0

Method Summary

Modifier and Type	Method and Description
OAuthAuthorizationCodeDancerBuilder	afterDanceCallback(BiConsumer<AuthorizationCodeDanceCallbackContext,ResourceOwnerOAuthContext> callback) Allows custom code to be run after doing the request to the provided tokenUrl and processing its results.
OAuthAuthorizationCodeDancerBuilder	authorizationUrl(String authorizationUrl)
OAuthAuthorizationCodeDancerBuilder	beforeDanceCallback(Function<AuthorizationCodeRequest,AuthorizationCodeDanceCallbackContext> callback) Allows custom code to be run just before doing the request to the provided tokenUrl.
OAuthAuthorizationCodeDancerBuilder	customParameters(Map<String,String> customParameters) There are OAuth implementations that require or allow extra query parameters to be sent when calling the Authentication URL of the OAS.
OAuthAuthorizationCodeDancerBuilder	customParameters(Supplier<Map<String,String>> customParameters) There are OAuth implementations that require or allow extra query parameters to be sent when calling the Authentication URL of the OAS.
OAuthAuthorizationCodeDancerBuilder	externalCallbackUrl(String externalCallbackUrl) The oauth authentication server will use this url to provide the authentication code to the Mule server so the mule server can retrieve the access token.
OAuthAuthorizationCodeDancerBuilder	localAuthorizationUrlPath(String path) If this attribute is provided mule will automatically create and endpoint in the host server (the same configured for localCallback(java.net.URL)) that the user can hit to authenticate and grant access to the application for his account.
OAuthAuthorizationCodeDancerBuilder	localAuthorizationUrlResourceOwnerId(String localAuthorizationUrlResourceOwnerIdExpr) This attribute is only required when the applications needs to access resources from more than one user in the OAuth authentication server.
OAuthAuthorizationCodeDancerBuilder	localCallback(HttpServer server, String localCallbackConfigPath) The produced AuthorizationCodeOAuthDancer will use an existing HttpServer to listen on the provided localCallbackConfigPath.
OAuthAuthorizationCodeDancerBuilder	localCallback(URL localCallbackUrl) The produced AuthorizationCodeOAuthDancer will create an HttpServer to listen on the provided localCallbackUrl.
OAuthAuthorizationCodeDancerBuilder	localCallback(URL localCallbackUrl, TlsContextFactory tlsContextFactory) The produced AuthorizationCodeOAuthDancer will create an HttpServer with the provided tlsContextFactory to listen on the provided localCallbackUrl.
OAuthAuthorizationCodeDancerBuilder	state(String stateExpr) Mule will add some internal stuff to the state that is sent to the Authorization server.

Methods inherited from interface org.mule.runtime.oauth.api.builder.OAuthDancerBuilder

build, clientCredentials, customParametersExtractorsExprs, encoding, resourceOwnerIdTransformer, responseAccessTokenExpr, responseExpiresInExpr, responseRefreshTokenExpr, scopes, tokenUrl, tokenUrl, tokenUrl, tokenUrl, tokenUrl

Method Detail

localCallback

OAuthAuthorizationCodeDancerBuilder localCallback(URL localCallbackUrl)

The produced AuthorizationCodeOAuthDancer will create an HttpServer to listen on the provided localCallbackUrl.

Parameters:

localCallbackUrl - the url to listen on

Returns:

this builder

localCallback

OAuthAuthorizationCodeDancerBuilder localCallback(URL localCallbackUrl,
                                                  TlsContextFactory tlsContextFactory)

The produced AuthorizationCodeOAuthDancer will create an HttpServer with the provided tlsContextFactory to listen on the provided localCallbackUrl.

Parameters:

localCallbackUrl - the url to listen on

tlsContextFactory - the TLS context to use for the listener

Returns:

this builder

localCallback

OAuthAuthorizationCodeDancerBuilder localCallback(HttpServer server,
                                                  String localCallbackConfigPath)

The produced AuthorizationCodeOAuthDancer will use an existing HttpServer to listen on the provided localCallbackConfigPath.

Parameters:

server - a server listening on a specific host and port

localCallbackConfigPath - the path on the server to listen on

Returns:

this builder

localAuthorizationUrlPath

OAuthAuthorizationCodeDancerBuilder localAuthorizationUrlPath(String path)

If this attribute is provided mule will automatically create and endpoint in the host server (the same configured for localCallback(java.net.URL)) that the user can hit to authenticate and grant access to the application for his account.

Parameters:

path - the path to listen for the callback

Returns:

this builder

localAuthorizationUrlResourceOwnerId

OAuthAuthorizationCodeDancerBuilder localAuthorizationUrlResourceOwnerId(String localAuthorizationUrlResourceOwnerIdExpr)

This attribute is only required when the applications needs to access resources from more than one user in the OAuth authentication server.

Parameters:

localAuthorizationUrlResourceOwnerIdExpr - expression to get the identifier under which the oauth authentication attributes are stored (accessToken, refreshToken, etc).

Returns:

this builder

customParameters

OAuthAuthorizationCodeDancerBuilder customParameters(Map<String,String> customParameters)

There are OAuth implementations that require or allow extra query parameters to be sent when calling the Authentication URL of the OAS.

Invoking this method overrides any prior invokations to customParameters(Supplier)

Parameters:

customParameters - the extra parameters to be sent with the authorization request to authorizationUrl(String).

Returns:

this builder

customParameters

OAuthAuthorizationCodeDancerBuilder customParameters(Supplier<Map<String,String>> customParameters)

There are OAuth implementations that require or allow extra query parameters to be sent when calling the Authentication URL of the OAS.

Invoking this method overrides any prior invokations to customParameters(Map)

Parameters:

customParameters - A Supplier the extra parameters to be sent with the authorization request to authorizationUrl(String).

Returns:

this builder

state

OAuthAuthorizationCodeDancerBuilder state(String stateExpr)

Mule will add some internal stuff to the state that is sent to the Authorization server. When the callback is received, those will be removed to be processed, and the state as specified in this method will be honored.

Parameters:

stateExpr - parameter for holding state between the authentication request and the callback done by the OAuth authorization server to the externalCallbackUrl(String).

Returns:

this builder

authorizationUrl

OAuthAuthorizationCodeDancerBuilder authorizationUrl(String authorizationUrl)

Parameters:

authorizationUrl - The OAuth authentication server url to authorize the app for a certain user.

Returns:

this builder

externalCallbackUrl

OAuthAuthorizationCodeDancerBuilder externalCallbackUrl(String externalCallbackUrl)

The oauth authentication server will use this url to provide the authentication code to the Mule server so the mule server can retrieve the access token.

Note: this must be the externally visible address of the localCallback(java.net.URL).

TODO MULE-11861: Allow to infer the localCallback url based on the externalCallbackUrl for Auth-code grant-type

Parameters:

externalCallbackUrl - the callback url where the authorization code will be received.

Returns:

this builder

beforeDanceCallback

OAuthAuthorizationCodeDancerBuilder beforeDanceCallback(Function<AuthorizationCodeRequest,AuthorizationCodeDanceCallbackContext> callback)

Allows custom code to be run just before doing the request to the provided tokenUrl.

The map returned by the provided function will be passed to the afterDanceCallback(BiConsumer), if set.

Parameters:

callback - a Function that receives the parameters that will be used in the executing dance and returns an AuthorizationCodeDanceCallbackContext to be then passed to the afterDanceCallback(BiConsumer). Not null.

Returns:

this builder

afterDanceCallback

OAuthAuthorizationCodeDancerBuilder afterDanceCallback(BiConsumer<AuthorizationCodeDanceCallbackContext,ResourceOwnerOAuthContext> callback)

Allows custom code to be run after doing the request to the provided tokenUrl and processing its results.

Parameters:

callback - a BiConsumer that receives the AuthorizationCodeDanceCallbackContext returned by the callback passed to beforeDanceCallback(Function) and the OAuth context from the response of the call to tokenUrl. Not null.

Returns:

this builder