Class JAASMemoryLoginModule

  • All Implemented Interfaces:,, Contained, GSSRealm, JmxEnabled, Lifecycle, Realm

    public class JAASMemoryLoginModule
    extends MemoryRealm

    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 implements Realm only to satisfy the calling requirements of the GenericPrincipal constructor. It does not actually perform the functionality required of a Realm implementation.

    Craig R. McClanahan
    • Field Detail

      • callbackHandler

        protected callbackHandler
        The callback handler responsible for answering our requests.
      • committed

        protected boolean committed
        Has our own commit() returned successfully?
      • options

        protected java.util.Map<java.lang.String,​?> options
        The configuration information for this LoginModule.
      • pathname

        protected java.lang.String pathname
        The absolute or relative pathname to the XML configuration file.
      • principal

        protected principal
        The Principal identified by our validation, or null if validation failed.
      • sharedState

        protected java.util.Map<java.lang.String,​?> sharedState
        The state information that is shared with other configured LoginModule instances.
      • subject

        protected subject
        The subject for which we are performing authentication.
    • Constructor Detail

      • JAASMemoryLoginModule

        public JAASMemoryLoginModule()
    • Method Detail

      • abort

        public boolean abort()
        Specified by:
        abort in interface
      • commit

        public boolean commit()
        Specified by:
        commit in interface
      • initialize

        public void initialize​( subject,
                               java.util.Map<java.lang.String,​?> sharedState,
                               java.util.Map<java.lang.String,​?> options)
        Specified by:
        initialize in interface
      • login

        public boolean login()
        Specified by:
        login in interface
      • logout

        public boolean logout()
        Specified by:
        logout in interface
      • load

        protected void load()
        Load the contents of our configuration file.