javax.security.auth.message.module

Interface ServerAuthModule

All Superinterfaces:

ServerAuth

All Known Implementing Classes:

AbstractServerAuthModule, AllFailureServerAuthModule, AllSuccessServerAuthModule, DelegatingServerAuthModule, HttpServletServerAuthModule, SimpleServerAuthModule

public interface ServerAuthModule
extends ServerAuth

A ServerAuthModule validates client requests and secures responses back to the client.

A module implementation should assume it may be used to secure different requests as different clients. A module should also assume it may be used concurrently by multiple callers. It is the module implementation's responsibility to properly save and restore any state as necessary. A module that does not need to do so may remain completely stateless. Every implementation of the interface must provide a public zero argument contructor.

Since:

May 12, 2006

Version:

$Revision$

Author:

Anil Saldhana, Charlie Lai, Ron Monzillo (Javadoc for JSR-196)

Method Summary

Methods

Modifier and Type	Method and Description
Class[]	getSupportedMessageTypes() Get the one or more Class objects representing the message types supported by the module.
void	initialize(MessagePolicy requestPolicy, MessagePolicy responsePolicy, CallbackHandler handler, Map options) Initialize this module with request and response message policies to enforce, a CallbackHandler, and any module-specific configuration properties.

Methods inherited from interface javax.security.auth.message.ServerAuth

cleanSubject, secureResponse, validateRequest

Method Detail

getSupportedMessageTypes

Class[] getSupportedMessageTypes()

Get the one or more Class objects representing the message types supported by the module.

Returns:

an array of Class objects where each element defines a message type supported by the module. A module should return an array containing at least one element. An empty array indicates that the module will attempt to support any message type. This method never returns null.

initialize

void initialize(MessagePolicy requestPolicy,
              MessagePolicy responsePolicy,
              CallbackHandler handler,
              Map options)
                throws AuthException

Initialize this module with request and response message policies to enforce, a CallbackHandler, and any module-specific configuration properties.

The request policy and the response policy must not both be null.

Parameters:

requestPolicy - the request policy this module must enforce, or null.

responsePolicy - the response policy this module must enforce, or null.

handler - CallbackHandler used to request information.

options - a Map of module-specific configuration properties.

Throws:

AuthException - - if module initialization fails, including for the case where the options argument contains elements that are not supported by the module.