public class UserDatabaseRealm extends RealmBase
Implementation of Realm
that is based on an implementation of
UserDatabase
made available through the global JNDI resources
configured for this instance of Catalina. Set the resourceName
parameter to the global JNDI resources name for the configured instance
of UserDatabase
that we should consult.
RealmBase.AllRolesMode
Lifecycle.SingleUse
Modifier and Type | Field and Description |
---|---|
protected UserDatabase |
database
The
UserDatabase we will use to authenticate users
and identify associated roles. |
protected static String |
info
Descriptive information about this Realm implementation.
|
protected static String |
name
Descriptive information about this Realm implementation.
|
protected String |
resourceName
The global JNDI name of the
UserDatabase resource
we will be utilizing. |
allRolesMode, container, containerLog, digest, digestEncoding, md, md5Encoder, md5Helper, realmPath, sm, stripRealmForGss, support, validate, x509UsernameRetriever, x509UsernameRetrieverClassName
mserver
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 and Description |
---|
UserDatabaseRealm() |
Modifier and Type | Method and Description |
---|---|
String |
getInfo()
Return descriptive information about this Realm implementation and
the corresponding version number, in the format
<description>/<version> . |
protected String |
getName()
Return a short name for this Realm implementation.
|
protected String |
getPassword(String username)
Return the password associated with the given principal's user name.
|
protected Principal |
getPrincipal(String username)
Return the Principal associated with the given user name.
|
String |
getResourceName()
Return the global JNDI name of the
UserDatabase resource
we will be using. |
boolean |
hasRole(Wrapper wrapper,
Principal principal,
String role)
Return
true if the specified Principal has the specified
security role, within the context of this Realm; otherwise return
false . |
void |
setResourceName(String resourceName)
Set the global JNDI name of the
UserDatabase resource
we will be using. |
protected void |
startInternal()
Prepare for the beginning of active use of the public methods of this
component and implement the requirements of
LifecycleBase.startInternal() . |
protected void |
stopInternal()
Gracefully terminate the active use of the public methods of this
component and implement the requirements of
LifecycleBase.stopInternal() . |
addPropertyChangeListener, authenticate, authenticate, authenticate, authenticate, authenticate, authenticate, backgroundProcess, compareCredentials, digest, Digest, findSecurityConstraints, getAllRolesMode, getContainer, getDigest, getDigest, getDigestCharset, getDigestEncoding, getDomainInternal, getObjectNameKeyProperties, getPrincipal, getPrincipal, getPrincipal, getRealmPath, getRealmSuffix, getServer, getTransportGuaranteeRedirectStatus, getValidate, getX509UsernameRetrieverClassName, hasMessageDigest, hasResourcePermission, hasUserDataPermission, initInternal, isStripRealmForGss, main, removePropertyChangeListener, setAllRolesMode, setContainer, setDigest, setDigestEncoding, setRealmPath, setStripRealmForGss, setTransportGuaranteeRedirectStatus, setValidate, setX509UsernameRetrieverClassName, toString
destroyInternal, getDomain, getObjectName, postDeregister, postRegister, preDeregister, preRegister, register, setDomain, unregister
addLifecycleListener, destroy, findLifecycleListeners, fireLifecycleEvent, getState, getStateName, getThrowOnFailure, init, removeLifecycleListener, setState, setState, setThrowOnFailure, start, stop
protected UserDatabase database
UserDatabase
we will use to authenticate users
and identify associated roles.protected static final String info
protected static final String name
protected String resourceName
UserDatabase
resource
we will be utilizing.public String getInfo()
<description>/<version>
.public String getResourceName()
UserDatabase
resource
we will be using.public void setResourceName(String resourceName)
UserDatabase
resource
we will be using.resourceName
- The new global JNDI namepublic boolean hasRole(Wrapper wrapper, Principal principal, String role)
true
if the specified Principal has the specified
security role, within the context of this Realm; otherwise return
false
. This implementation returns true
if the User
has the role, or if any Group
that the User
is a member of has the role.hasRole
in interface Realm
hasRole
in class RealmBase
principal
- Principal for whom the role is to be checkedrole
- Security role to be checkedwrapper
- wrapper context for evaluating roletrue
if the specified Principal has the specified
security role, within the context of this Realm; otherwise return
false
.protected String getName()
protected String getPassword(String username)
getPassword
in class RealmBase
protected Principal getPrincipal(String username)
getPrincipal
in class RealmBase
protected void startInternal() throws LifecycleException
LifecycleBase.startInternal()
.startInternal
in class RealmBase
LifecycleException
- if this component detects a fatal error
that prevents this component from being usedprotected void stopInternal() throws LifecycleException
LifecycleBase.stopInternal()
.stopInternal
in class RealmBase
LifecycleException
- if this component detects a fatal error
that needs to be reportedCopyright © 2000-2021 Apache Software Foundation. All Rights Reserved.