org.mule.runtime.oauth.api

Interface AuthorizationCodeOAuthDancer

public interface AuthorizationCodeOAuthDancer

Implementations provide OAuth dance support for authorization-code grant-type.

Since:

4.0

Method Summary

Modifier and Type	Method and Description
CompletableFuture<String>	accessToken(String resourceOwner) Will query the internal state (the tokensStore parameter passed to the service to build the AuthorizationCodeOAuthDancer) to get the appropriate accessToken.
ResourceOwnerOAuthContext	getContextForResourceOwner(String resourceOwnerId) Retrieves the oauth context for a particular user.
void	handleLocalAuthorizationRequest(HttpRequest request, HttpResponseReadyCallback responseCallback) Handles an http request that will redirect to the access page in authorizationUrl with the configured credentials.
void	invalidateContext(String resourceOwnerId) Clears the oauth context for a given user.
CompletableFuture<Void>	refreshToken(String resourceOwner) Performs the refresh of the access token.

Method Detail

accessToken

CompletableFuture<String> accessToken(String resourceOwner)
                               throws RequestAuthenticationException

Will query the internal state (the tokensStore parameter passed to the service to build the AuthorizationCodeOAuthDancer) to get the appropriate accessToken. This requires that the authorization has been performed beforehand, otherwise, a RequestAuthenticationException will be thrown.

Parameters:

resourceOwner - The resource owner to get the token for.

Returns:

a future with the token to send on the authorized request. This will be immediately available unless a refresh has to be made.

Throws:

RequestAuthenticationException - if called for a resourceOwner that has not yet been authorized.

refreshToken

CompletableFuture<Void> refreshToken(String resourceOwner)

Performs the refresh of the access token.

Parameters:

resourceOwner - The resource owner to get the token for.

Returns:

a completable future that is complete when the token has been refreshed.

invalidateContext

void invalidateContext(String resourceOwnerId)

Clears the oauth context for a given user.

Parameters:

resourceOwnerId - id of the user.

getContextForResourceOwner

ResourceOwnerOAuthContext getContextForResourceOwner(String resourceOwnerId)

Retrieves the oauth context for a particular user. If there's no state for that user a new state is retrieved so never returns null.

Parameters:

resourceOwnerId - id of the user.

Returns:

oauth state

handleLocalAuthorizationRequest

void handleLocalAuthorizationRequest(HttpRequest request,
                                     HttpResponseReadyCallback responseCallback)

Handles an http request that will redirect to the access page in authorizationUrl with the configured credentials.

Parameters:

request - the request from the user to login and/or authorize the application

responseCallback - the callback where the response with the redirection to the login/authorization page will be sent