Class JAASMemoryLoginModule

java.lang.Object

org.apache.catalina.util.LifecycleBase

org.apache.catalina.util.LifecycleMBeanBase

org.apache.catalina.realm.RealmBase

org.apache.catalina.realm.MemoryRealm

org.apache.catalina.realm.JAASMemoryLoginModule

All Implemented Interfaces:

MBeanRegistration, LoginModule, Contained, JmxEnabled, Lifecycle, Realm

@Deprecated
public class JAASMemoryLoginModule
extends MemoryRealm
implements LoginModule

Deprecated.

This class will be removed in Tomcat 12.

Implementation of the JAAS LoginModule interface, primarily for use in testing JAASRealm. It utilizes an XML-format data file of username/password/role information identical to that supported by org.apache.catalina.realm.MemoryRealm.

This class recognizes the following string-valued options, which are specified in the configuration file and passed to initialize(Subject, CallbackHandler, Map, Map) in the options argument:

• pathname - Relative (to the pathname specified by the "catalina.base" system property) or absolute pathname to the XML file containing our user information, in the format supported by MemoryRealm. The default value matches the MemoryRealm default.
• credentialHandlerClassName - The fully qualified class name of the CredentialHandler to use. If not specified, MessageDigestCredentialHandler will be used.
• Any additional options will be used to identify and call setters on the CredentialHandler. For example, algorithm=SHA256 would result in a call to MessageDigestCredentialHandler.setAlgorithm(String) with a parameter of "SHA256"

IMPLEMENTATION NOTE - This class extends MemoryRealm rather than implementing Realm directly, so that user lookup and credential validation are performed against the XML file configured for the memory realm.

Nested Class Summary

Nested classes/interfaces inherited from class RealmBase

RealmBase.AllRolesMode

Nested classes/interfaces inherited from interface Lifecycle

Lifecycle.SingleUse

Field Summary

Fields

Modifier and Type	Field	Description
protected CallbackHandler	callbackHandler	Deprecated. The callback handler responsible for answering our requests.
protected boolean	committed	Deprecated. Has our own commit() returned successfully?
protected Map<String,?>	options	Deprecated. The configuration information for this LoginModule.
protected String	pathname	Deprecated. The absolute or relative pathname to the XML configuration file.
protected Principal	principal	Deprecated. The Principal identified by our validation, or null if validation failed.
protected HashSet<Principal>	roles	Deprecated. The Principal for the roles.
protected Map<String,?>	sharedState	Deprecated. The state information that is shared with other configured LoginModule instances.
protected Subject	subject	Deprecated. The subject for which we are performing authentication.

Fields inherited from class RealmBase

allRolesMode, container, containerLog, realmPath, sm, stripRealmForGss, support, USER_ATTRIBUTES_DELIMITER, USER_ATTRIBUTES_WILDCARD, userAttributes, userAttributesList, validate, x509UsernameRetriever, x509UsernameRetrieverClassName

Fields inherited from interface Lifecycle

AFTER_DESTROY_EVENT, AFTER_INIT_EVENT, AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_DESTROY_EVENT, BEFORE_INIT_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, CONFIGURE_START_EVENT, CONFIGURE_STOP_EVENT, PERIODIC_EVENT, START_EVENT, STOP_EVENT

Constructor Summary

Constructors

Constructor	Description
JAASMemoryLoginModule()	Deprecated. Constructs a new JAASMemoryLoginModule.

Method Summary

Modifier and Type	Method	Description
boolean	abort()	Deprecated.
boolean	commit()	Deprecated.
void	initialize(Subject subject, CallbackHandler callbackHandler, Map<String,?> sharedState, Map<String,?> options)	Deprecated.
protected void	load()	Deprecated. Load the contents of our configuration file.
boolean	login()	Deprecated.
boolean	logout()	Deprecated.

Methods inherited from class MemoryRealm

authenticate, getDigester, getPassword, getPathname, getPrincipal, setPathname, startInternal

Methods inherited from class RealmBase

addPropertyChangeListener, authenticate, authenticate, authenticate, authenticate, authenticate, authenticate, backgroundProcess, findSecurityConstraints, getAllRolesMode, getContainer, getCredentialHandler, getDigest, getDigest, getDomainInternal, getObjectNameKeyProperties, getPrincipal, getPrincipal, getPrincipal, getRealmPath, getRealmSuffix, getServer, getTransportGuaranteeRedirectStatus, getUserAttributes, getValidate, getX509UsernameRetrieverClassName, hasMessageDigest, hasResourcePermission, hasRole, hasRoleInternal, hasUserDataPermission, initInternal, isStripRealmForGss, main, parseUserAttributes, removePropertyChangeListener, setAllRolesMode, setContainer, setCredentialHandler, setRealmPath, setStripRealmForGss, setTransportGuaranteeRedirectStatus, setUserAttributes, setValidate, setX509UsernameRetrieverClassName, stopInternal, toString

Methods inherited from class LifecycleMBeanBase

destroyInternal, getDomain, getObjectName, postDeregister, postRegister, preDeregister, preRegister, register, setDomain, unregister, unregister

Methods inherited from class LifecycleBase

addLifecycleListener, destroy, findLifecycleListeners, fireLifecycleEvent, getState, getStateName, getThrowOnFailure, init, removeLifecycleListener, setState, setState, setThrowOnFailure, start, stop

Methods inherited from class Object

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

Methods inherited from interface Realm

isAvailable

Field Details

callbackHandler

protected CallbackHandler callbackHandler

Deprecated.

The callback handler responsible for answering our requests.

committed

protected boolean committed

Deprecated.

Has our own commit() returned successfully?

options

protected Map<String,?> options

Deprecated.

The configuration information for this LoginModule.

pathname

protected String pathname

Deprecated.

The absolute or relative pathname to the XML configuration file.

principal

protected Principal principal

Deprecated.

The Principal identified by our validation, or null if validation failed.

roles

protected HashSet<Principal> roles

Deprecated.

The Principal for the roles.

sharedState

protected Map<String,?> sharedState

Deprecated.

The state information that is shared with other configured LoginModule instances.

subject

protected Subject subject

Deprecated.

The subject for which we are performing authentication.

Constructor Details

JAASMemoryLoginModule

public JAASMemoryLoginModule()

Deprecated.

Constructs a new JAASMemoryLoginModule.

Method Details

abort

public boolean abort()
              throws LoginException

Deprecated.

Specified by:

abort in interface LoginModule

Throws:

LoginException

commit

public boolean commit()
               throws LoginException

Deprecated.

Specified by:

commit in interface LoginModule

Throws:

LoginException

initialize

public void initialize(Subject subject,
 CallbackHandler callbackHandler,
 Map<String,?> sharedState,
 Map<String,?> options)

Deprecated.

Specified by:

initialize in interface LoginModule

login

public boolean login()
              throws LoginException

Deprecated.

Specified by:

login in interface LoginModule

Throws:

LoginException

logout

public boolean logout()
               throws LoginException

Deprecated.

Specified by:

logout in interface LoginModule

Throws:

LoginException

load

protected void load()

Deprecated.

Load the contents of our configuration file.