com.sun.enterprise.security.jmac.config

Class GFServerConfigProvider

java.lang.Object

com.sun.enterprise.security.jmac.config.GFServerConfigProvider

All Implemented Interfaces:

javax.security.auth.message.config.AuthConfigProvider

public class GFServerConfigProvider
extends Object
implements javax.security.auth.message.config.AuthConfigProvider

This class implements the interface AuthConfigProvider.

Author:

Shing Wai Chan, Ronald Monzillo

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	GFServerConfigProvider.GFClientAuthContext
protected static class	GFServerConfigProvider.GFServerAuthContext
static class	GFServerConfigProvider.IDEntry parsed ID entry
static class	GFServerConfigProvider.InterceptEntry
protected static class	GFServerConfigProvider.ModuleInfo A data object contains module object and the corresponding map.

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	CLIENT
protected javax.security.auth.message.config.AuthConfigFactory	factory
static String	HTTPSERVLET
protected static Map<String,String>	layerDefaultRegisIDMap
protected static String	MANAGES_SESSIONS_OPTION
protected static ReadWriteLock	rwLock
protected static String	SERVER
static String	SOAP

Constructor Summary

Constructors

Constructor and Description
GFServerConfigProvider(Map properties, javax.security.auth.message.config.AuthConfigFactory factory)

Method Summary

Modifier and Type	Method and Description
protected static ClassLoader	getClassLoader()
javax.security.auth.message.config.ClientAuthConfig	getClientAuthConfig(String layer, String appContext, CallbackHandler handler) Get an instance of ClientAuthConfig from this provider.
javax.security.auth.message.config.ServerAuthConfig	getServerAuthConfig(String layer, String appContext, CallbackHandler handler) Get an instance of ServerAuthConfig from this provider.
static void	loadConfigContext(Object config) this method is intended to be called by the admin configuration system when the corresponding config object has changed.
protected static void	loadParser(javax.security.auth.message.config.AuthConfigProvider aProvider, javax.security.auth.message.config.AuthConfigFactory aFactory, Object config)
void	refresh() Causes a dynamic configuration provider to update its internal state such that any resulting change to its state is reflected in the corresponding authentication context configuration objects previously created by the provider within the current process context.
static void	setValidateRequestSubject(Subject subject)

Methods inherited from class java.lang.Object

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

Field Detail

SOAP

public static final String SOAP

See Also:

Constant Field Values

HTTPSERVLET

public static final String HTTPSERVLET

See Also:

Constant Field Values

CLIENT

protected static final String CLIENT

See Also:

Constant Field Values

SERVER

protected static final String SERVER

See Also:

Constant Field Values

MANAGES_SESSIONS_OPTION

protected static final String MANAGES_SESSIONS_OPTION

See Also:

Constant Field Values

rwLock

protected static final ReadWriteLock rwLock

layerDefaultRegisIDMap

protected static final Map<String,String> layerDefaultRegisIDMap

factory

protected javax.security.auth.message.config.AuthConfigFactory factory

Constructor Detail

GFServerConfigProvider

public GFServerConfigProvider(Map properties,
                              javax.security.auth.message.config.AuthConfigFactory factory)

Method Detail

getClientAuthConfig

public javax.security.auth.message.config.ClientAuthConfig getClientAuthConfig(String layer,
                                                                               String appContext,
                                                                               CallbackHandler handler)
                                                                        throws javax.security.auth.message.AuthException

Get an instance of ClientAuthConfig from this provider.

The implementation of this method returns a ClientAuthConfig instance that describes the configuration of ClientAuthModules at a given message layer, and for use in an identified application context.

Specified by:

getClientAuthConfig in interface javax.security.auth.message.config.AuthConfigProvider

Parameters:

layer - a String identifying the message layer for the returned ClientAuthConfig object. This argument must not be null.

appContext - a String that identifies the messaging context for the returned ClientAuthConfig object. This argument must not be null.

handler - a CallbackHandler to be passed to the ClientAuthModules encapsulated by ClientAuthContext objects derived from the returned ClientAuthConfig. This argument may be null, in which case the implementation may assign a default handler to the configuration.

Returns:

a ClientAuthConfig Object that describes the configuration of ClientAuthModules at the message layer and messaging context identified by the layer and appContext arguments. This method does not return null.

Throws:

javax.security.auth.message.AuthException - if this provider does not support the assignment of a default CallbackHandler to the returned ClientAuthConfig.

SecurityException - if the caller does not have permission to retrieve the configuration. The CallbackHandler assigned to the configuration must support the Callback objects required to be supported by the profile of this specification being followed by the messaging runtime. The CallbackHandler instance must be initialized with any application context needed to process the required callbacks on behalf of the corresponding application.

getServerAuthConfig

public javax.security.auth.message.config.ServerAuthConfig getServerAuthConfig(String layer,
                                                                               String appContext,
                                                                               CallbackHandler handler)
                                                                        throws javax.security.auth.message.AuthException

Get an instance of ServerAuthConfig from this provider.

The implementation of this method returns a ServerAuthConfig instance that describes the configuration of ServerAuthModules at a given message layer, and for a particular application context.

Specified by:

getServerAuthConfig in interface javax.security.auth.message.config.AuthConfigProvider

Parameters:

layer - a String identifying the message layer for the returned ServerAuthConfig object. This argument must not be null.

appContext - a String that identifies the messaging context for the returned ServerAuthConfig object. This argument must not be null.

handler - a CallbackHandler to be passed to the ServerAuthModules encapsulated by ServerAuthContext objects derived from thr returned ServerAuthConfig. This argument may be null, in which case the implementation may assign a default handler to the configuration.

Returns:

a ServerAuthConfig Object that describes the configuration of ServerAuthModules at a given message layer, and for a particular application context. This method does not return null.

Throws:

javax.security.auth.message.AuthException - if this provider does not support the assignment of a default CallbackHandler to the returned ServerAuthConfig.

SecurityException - if the caller does not have permission to retrieve the configuration.

The CallbackHandler assigned to the configuration must support the Callback objects required to be supported by the profile of this specification being followed by the messaging runtime. The CallbackHandler instance must be initialized with any application context needed to process the required callbacks on behalf of the corresponding application.

refresh

public void refresh()

Causes a dynamic configuration provider to update its internal state such that any resulting change to its state is reflected in the corresponding authentication context configuration objects previously created by the provider within the current process context.

Specified by:

refresh in interface javax.security.auth.message.config.AuthConfigProvider

Throws:

javax.security.auth.message.AuthException - if an error occured during the refresh.

SecurityException - if the caller does not have permission to refresh the provider.

loadConfigContext

public static void loadConfigContext(Object config)

this method is intended to be called by the admin configuration system when the corresponding config object has changed. It relies on the slaves, since it is a static method.

Parameters:

config - a config object of type understood by the parser. NOTE: there appears to be a thread saftey problem, and this method will fail if a slaveProvider has not been established prior to its call.

loadParser

protected static void loadParser(javax.security.auth.message.config.AuthConfigProvider aProvider,
                                 javax.security.auth.message.config.AuthConfigFactory aFactory,
                                 Object config)

getClassLoader

protected static ClassLoader getClassLoader()

setValidateRequestSubject

public static void setValidateRequestSubject(Subject subject)