net.krotscheck.kangaroo.authz.oauth2.resource.authorize

Interface IAuthorizeHandler

All Known Implementing Classes:

AuthCodeHandler, ImplicitHandler

public interface IAuthorizeHandler

This interface describes a processing entity which handles a specific kind of request against the /authorize endpoint.

Author:

Michael Krotscheck

Method Summary

Modifier and Type	Method and Description
default URI	buildCallback(javax.ws.rs.core.UriInfo info, AuthenticatorState state) Build the callback.
javax.ws.rs.core.Response	callback(AuthenticatorState s, javax.servlet.http.HttpSession browserSession) Handle a callback response from the IdP (Authenticator).
IAuthenticator	getAuthenticator(AuthenticatorState state) Provided a stored intermediate authenticator state, attempt to resolve an instance of the associated authenticator implementation.
javax.ws.rs.core.Response	handle(javax.servlet.http.HttpSession browserSession, Authenticator auth, URI redirect, SortedMap<String,ApplicationScope> scopes, String state) Handle a specific authorization grant request.

Method Detail

handle

javax.ws.rs.core.Response handle(javax.servlet.http.HttpSession browserSession,
                                 Authenticator auth,
                                 URI redirect,
                                 SortedMap<String,ApplicationScope> scopes,
                                 String state)

Handle a specific authorization grant request.

Parameters:

browserSession - The browser session, maintained via cookies.

auth - The authenticator to use to process this request.

redirect - The redirect (already validated) to which the response should be returned.

scopes - The (validated) list of scopes requested by the user.

state - The client's requested state ID.

Returns:

A response entity with the appropriate response.

callback

javax.ws.rs.core.Response callback(AuthenticatorState s,
                                   javax.servlet.http.HttpSession browserSession)

Handle a callback response from the IdP (Authenticator). Provided with the previously stored state, this method should return to the client either a valid token, or an appropriate error response.

Parameters:

s - The request state previously saved by the client.

browserSession - The browser session, maintained via cookies.

Returns:

A response entity indicating success or failure.

getAuthenticator

IAuthenticator getAuthenticator(AuthenticatorState state)

Provided a stored intermediate authenticator state, attempt to resolve an instance of the associated authenticator implementation.

Parameters:

state - The state to resolve.

Returns:

An authenticator Impl, available from the injection context.

buildCallback

default URI buildCallback(javax.ws.rs.core.UriInfo info,
                          AuthenticatorState state)

Build the callback.

Parameters:

info - URI/Request info, used to get the host context.

state - The authenticator state.

Returns:

The callback.