org.jboss.security.auth.container.modules

Class SimpleServerAuthModule

java.lang.Object

org.jboss.security.auth.container.modules.AbstractServerAuthModule

org.jboss.security.auth.container.modules.SimpleServerAuthModule

All Implemented Interfaces:

ServerAuthModule, ServerAuth

public class SimpleServerAuthModule
extends AbstractServerAuthModule

A simple implementation of an username/password based server auth module. The principal name and password are passed as options to the module.

Since:

Dec 6, 2005

Author:

Anil Saldhana

Field Summary

Fields inherited from class org.jboss.security.auth.container.modules.AbstractServerAuthModule

callbackHandler, options, requestPolicy, responsePolicy, supportedTypes

Constructor Summary

Constructors

Constructor and Description
SimpleServerAuthModule()
SimpleServerAuthModule(Class<?>[] supTypes)

Method Summary

Modifier and Type	Method and Description
AuthStatus	secureResponse(MessageInfo param, Subject source) Secure a service response before sending it to the client.
protected boolean	validate(Subject clientSubject, MessageInfo messageInfo) Subclasses have to implement this method to actually validate the subject

Methods inherited from class org.jboss.security.auth.container.modules.AbstractServerAuthModule

cleanSubject, getCallbackHandler, getSupportedMessageTypes, initialize, setCallbackHandler, validateRequest

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleServerAuthModule

public SimpleServerAuthModule()

SimpleServerAuthModule

public SimpleServerAuthModule(Class<?>[] supTypes)

Method Detail

secureResponse

public AuthStatus secureResponse(MessageInfo param,
                                 Subject source)
                          throws AuthException

Description copied from interface: ServerAuth

Secure a service response before sending it to the client. This method is called to transform the response message acquired by calling getResponseMessage (on messageInfo) into the mechanism-specific form to be sent by the runtime.

This method conveys the outcome of its message processing either by returning an AuthStatus value or by throwing an AuthException.

Parameters:

param - - A contextual object that encapsulates the client request and server response objects, and that may be used to save state across a sequence of calls made to the methods of this interface for the purpose of completing a secure message exchange.

source - - A Subject that represents the source of the service request, or null. It may be used by the method implementation as the source of Principals or credentials to be used to secure the request. If the Subject is not null, the method implementation may add additional Principals or credentials (pertaining to the source of the service request) to the Subject.

Returns:

An AuthStatus object representing the completion status of the processing performed by the method. The AuthStatus values that may be returned by this method are defined as follows:

• AuthStatus.SEND_SUCCESS when the application response message was successfully secured. The secured response message may be obtained by calling getResponseMessage on messageInfo.
• AuthStatus.SEND_CONTINUE to indicate that the application response message (within messageInfo) was replaced with a security message that should elicit a security-specific response (in the form of a request) from the peer. This status value serves to inform the calling runtime that (to successfully complete the message exchange) it will need to be capable of continuing the message dialog by processing at least one additional request/response exchange (after having sent the response message returned in messageInfo). When this status value is returned, the application response must be saved by the authentication module such that it can be recovered when the module’s validateRequest message is called to process the elicited response.
• AuthStatus.SEND_FAILURE to indicate that a failure occurred while securing the response message and that an appropriate failure response message is available by calling getResponseMessage on messageInfo.

Throws:

AuthException - When the message processing failed without establishing a failure response message (in messageInfo).

See Also:

ServerAuth.secureResponse(javax.security.auth.message.MessageInfo, javax.security.auth.Subject)

validate

protected boolean validate(Subject clientSubject,
                           MessageInfo messageInfo)
                    throws AuthException

Description copied from class: AbstractServerAuthModule

Subclasses have to implement this method to actually validate the subject

Specified by:

validate in class AbstractServerAuthModule

Returns:

Throws:

AuthException