javax.security.auth.message.config
Interface AuthConfig

All Known Subinterfaces:

ClientAuthConfig, ServerAuthConfig

public interface AuthConfig

This interface defines the common functionality implemented by Authentication context configuration objects.

Version:

%I%, %G%

See Also:

ClientAuthContext, ServerAuthContext

Method Summary

java.lang.String	getAppContext() Get the application context identifier of this authentication context configuration object.
java.lang.String	getAuthContextID(MessageInfo messageInfo) Get the authentication context identifier corresponding to the request and response objects encapsulated in messageInfo.
java.lang.String	getMessageLayer() Get the message layer name of this authentication context configuration object.
boolean	isProtected() Used to determine whether the authentication context configuration object encapsulates any protected authentication contexts.
void	refresh() Causes a dynamic anthentication context configuration object to update the internal state that it uses to process calls to its getAuthContext method.

Method Detail

getMessageLayer

java.lang.String getMessageLayer()

Get the message layer name of this authentication context configuration object.

Returns:

The message layer name of this configuration object, or null if the configuration object pertains to an unspecified message layer.

getAppContext

java.lang.String getAppContext()

Get the application context identifier of this authentication context configuration object.

Returns:

The String identifying the application context of this configuration object, or null if the configuration object pertains to an unspecified application context.

getAuthContextID

java.lang.String getAuthContextID(MessageInfo messageInfo)

Get the authentication context identifier corresponding to the request and response objects encapsulated in messageInfo.

Parameters:

messageInfo - A contextual Object that encapsulates the client request and server response objects.

Returns:

The authentication context identifier corresponding to the encapsulated request and response objects, or null.

Throws:

java.lang.IllegalArgumentException - If the type of the message objects incorporated in messageInfo are not compatible with the message types supported by this authentication context configuration object.

refresh

void refresh()

Causes a dynamic anthentication context configuration object to update the internal state that it uses to process calls to its getAuthContext method.

Throws:

AuthException - If an error occured during the update.

SecurityException - If the caller does not have permission to refresh the configuration object.

isProtected

boolean isProtected()

Used to determine whether the authentication context configuration object encapsulates any protected authentication contexts.

Returns:

True if the configuration object encapsulates at least one protected authentication context. Otherwise, this method returns false.