Field Detail

• realms

  protected java.util.List<Realm> realms

  The list of Realms contained by this Realm.

• name

  protected static final java.lang.String name

  Descriptive information about this Realm implementation.

  See Also:

  Constant Field Values

Constructor Detail

• CombinedRealm

  public CombinedRealm()

Method Detail

• addRealm

  public void addRealm(Realm theRealm)

  Add a realm to the list of realms that will be used to authenticate users.

• getRealms

  public javax.management.ObjectName[] getRealms()

  Return the set of Realms that this Realm is wrapping

• authenticate

  public java.security.Principal authenticate(java.lang.String username,
                                     java.lang.String clientDigest,
                                     java.lang.String nonce,
                                     java.lang.String nc,
                                     java.lang.String cnonce,
                                     java.lang.String qop,
                                     java.lang.String realmName,
                                     java.lang.String md5a2)

  Return the Principal associated with the specified username, which matches the digest calculated using the given parameters using the method described in RFC 2069; otherwise return null.

  Specified by:

  authenticate in interface Realm

  Overrides:

  authenticate in class RealmBase

  Parameters:

  username - Username of the Principal to look up

  clientDigest - Digest which has been submitted by the client

  nonce - Unique (or supposedly unique) token which has been used for this request

  realmName - Realm name

  md5a2 - Second MD5 digest used to calculate the digest : MD5(Method + ":" + uri)

• authenticate

  public java.security.Principal authenticate(java.lang.String username)

  Return the Principal associated with the specified user name otherwise return null.

  Specified by:

  authenticate in interface Realm

  Overrides:

  authenticate in class RealmBase

  Parameters:

  username - User name of the Principal to look up

• authenticate

  public java.security.Principal authenticate(java.lang.String username,
                                     java.lang.String credentials)

  Return the Principal associated with the specified username and credentials, if there is one; otherwise return null.

  Specified by:

  authenticate in interface Realm

  Overrides:

  authenticate in class RealmBase

  Parameters:

  username - Username of the Principal to look up

  credentials - Password or other credentials to use in authenticating this username

• setContainer

  public void setContainer(Container container)

  Set the Container with which this Realm has been associated.

  Specified by:

  setContainer in interface Realm

  Overrides:

  setContainer in class RealmBase

  Parameters:

  container - The associated Container

• startInternal

  protected void startInternal()
                        throws LifecycleException

  Prepare for the beginning of active use of the public methods of this component and implement the requirements of LifecycleBase.startInternal().

  Overrides:

  startInternal in class RealmBase

  Throws:

  LifecycleException - if this component detects a fatal error that prevents this component from being used

• stopInternal

  protected void stopInternal()
                       throws LifecycleException

  Gracefully terminate the active use of the public methods of this component and implement the requirements of LifecycleBase.stopInternal().

  Overrides:

  stopInternal in class RealmBase

  Throws:

  LifecycleException - if this component detects a fatal error that needs to be reported

• destroyInternal

  protected void destroyInternal()
                          throws LifecycleException

  Ensure child Realms are destroyed when this Realm is destroyed.

  Overrides:

  destroyInternal in class LifecycleMBeanBase

  Throws:

  LifecycleException

• backgroundProcess

  public void backgroundProcess()

  Delegate the backgroundProcess call to all sub-realms.

  Specified by:

  backgroundProcess in interface Realm

  Overrides:

  backgroundProcess in class RealmBase

• authenticate

  public java.security.Principal authenticate(java.security.cert.X509Certificate[] certs)

  Return the Principal associated with the specified chain of X509 client certificates. If there is none, return null.

  Specified by:

  authenticate in interface Realm

  Overrides:

  authenticate in class RealmBase

  Parameters:

  certs - Array of client certificates, with the first one in the array being the certificate of the client itself.

• authenticate

  public java.security.Principal authenticate(org.ietf.jgss.GSSContext gssContext,
                                     boolean storeCreds)

  Return the Principal associated with the specified GSSContext. If there is none, return null.

  Specified by:

  authenticate in interface Realm

  Overrides:

  authenticate in class RealmBase

  Parameters:

  gssContext - The gssContext processed by the Authenticator.

  storeCreds - Should the realm attempt to store the delegated credentials in the returned Principal?

• getName

  protected java.lang.String getName()

  Description copied from class: RealmBase
  Return a short name for this Realm implementation, for use in log messages.

  Specified by:

  getName in class RealmBase

• getPassword

  protected java.lang.String getPassword(java.lang.String username)

  Description copied from class: RealmBase
  Return the password associated with the given principal's user name.

  Specified by:

  getPassword in class RealmBase

• getPrincipal

  protected java.security.Principal getPrincipal(java.lang.String username)

  Description copied from class: RealmBase
  Return the Principal associated with the given user name.

  Specified by:

  getPrincipal in class RealmBase