org.jboss.identity.federation.bindings.jboss.trust
Class JBossRequestHandler

java.lang.Object
  org.jboss.identity.federation.bindings.jboss.trust.JBossRequestHandler

All Implemented Interfaces:

WSTrustRequestHandler

public class JBossRequestHandler
extends java.lang.Object
implements WSTrustRequestHandler

Default implementation of the WSTrustRequestHandler interface. It creates the request context containing the original WS-Trust request as well as any information that may be relevant to the token processing, and delegates the actual token handling processing to the appropriate SecurityTokenProvider.

Author:

Stefan Guilhen

Constructor Summary

JBossRequestHandler()

Method Summary

RequestSecurityTokenResponse	cancel(RequestSecurityToken request, javax.xml.ws.handler.MessageContext context) Cancels the security token as specified in the request message.
void	initialize(STSConfiguration configuration) Initializes the concrete WSTrustRequestHandler instance.
RequestSecurityTokenResponse	issue(RequestSecurityToken request, javax.xml.ws.handler.MessageContext context) Generates a security token according to the information specified in the request message and returns the created token in the response.
RequestSecurityTokenResponse	renew(RequestSecurityToken request, javax.xml.ws.handler.MessageContext context) Renews the security token as specified in the request message, returning the renewed token in the response.
RequestSecurityTokenResponse	validate(RequestSecurityToken request, javax.xml.ws.handler.MessageContext context) Validates the security token as specified in the request message.

Methods inherited from class java.lang.Object

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

Constructor Detail

JBossRequestHandler

public JBossRequestHandler()

Method Detail

initialize

public void initialize(STSConfiguration configuration)

Description copied from interface: WSTrustRequestHandler

Initializes the concrete WSTrustRequestHandler instance.

Specified by:

initialize in interface WSTrustRequestHandler

Parameters:

configuration - a reference to object that contains the STS configuration.

issue

public RequestSecurityTokenResponse issue(RequestSecurityToken request,
                                          javax.xml.ws.handler.MessageContext context)
                                   throws WSTrustException

Description copied from interface: WSTrustRequestHandler

Generates a security token according to the information specified in the request message and returns the created token in the response.

Specified by:

issue in interface WSTrustRequestHandler

Parameters:

request - the security token request message.

context - the context of the token request message. The context provides information that may be relevant to the request processing, such as the subject of the caller.

Returns:

a RequestSecurityTokenResponse containing the generated token.

Throws:

WSTrustException - if an error occurs while handling the request message.

renew

public RequestSecurityTokenResponse renew(RequestSecurityToken request,
                                          javax.xml.ws.handler.MessageContext context)
                                   throws WSTrustException

Description copied from interface: WSTrustRequestHandler

Renews the security token as specified in the request message, returning the renewed token in the response.

Specified by:

renew in interface WSTrustRequestHandler

Parameters:

request - the request message that contains the token to be renewed.

context - the context of the token request message. The context provides information that may be relevant to the request processing, such as the subject of the caller.

Returns:

a RequestSecurityTokenResponse containing the renewed token.

Throws:

WSTrustException - if an error occurs while handling the renewal process.

validate

public RequestSecurityTokenResponse validate(RequestSecurityToken request,
                                             javax.xml.ws.handler.MessageContext context)
                                      throws WSTrustException

Description copied from interface: WSTrustRequestHandler

Validates the security token as specified in the request message.

Specified by:

validate in interface WSTrustRequestHandler

Parameters:

request - the request message that contains the token to be validated.

context - the context of the token request message. The context provides information that may be relevant to the request processing, such as the subject of the caller.

Returns:

a RequestSecurityTokenResponse containing the validation status or a new token.

Throws:

WSTrustException - if an error occurs while handling the validation process.

cancel

public RequestSecurityTokenResponse cancel(RequestSecurityToken request,
                                           javax.xml.ws.handler.MessageContext context)
                                    throws WSTrustException

Description copied from interface: WSTrustRequestHandler

Cancels the security token as specified in the request message.

Specified by:

cancel in interface WSTrustRequestHandler

Parameters:

request - the request message that contains the token to be canceled.

context - the context of the token request message. The context provides information that may be relevant to the request processing, such as the subject of the caller.

Returns:

a RequestSecurityTokenResponse indicating whether the token has been canceled or not.

Throws:

WSTrustException - if an error occurs while handling the cancellation process.