File	Doc	Category	Size	Date	Package
Realm.java	API Doc	Apache Tomcat 6.0.14	7565	Fri Jul 20 04:20:32 BST 2007	org.apache.catalina

Realm

Fields Summary

Constructors Summary

Methods Summary
public void	addPropertyChangeListener(java.beans.PropertyChangeListener listener) Add a property change listener to this component. param listener The listener to add
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. param username Username of the Principal to look up param credentials Password or other credentials to use in authenticating this username
public java.security.Principal	authenticate(java.lang.String username, byte[] credentials) Return the Principal associated with the specified username and credentials, if there is one; otherwise return null. param username Username of the Principal to look up param credentials Password or other credentials to use in authenticating this username
public java.security.Principal	authenticate(java.lang.String username, java.lang.String digest, java.lang.String nonce, java.lang.String nc, java.lang.String cnonce, java.lang.String qop, java.lang.String realm, 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. param username Username of the Principal to look up param digest Digest which has been submitted by the client param nonce Unique (or supposedly unique) token which has been used for this request param realm Realm name param md5a2 Second MD5 digest used to calculate the digest : MD5(Method + ":" + uri)
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. param certs Array of client certificates, with the first one in the array being the certificate of the client itself.
public void	backgroundProcess() Execute a periodic task, such as reloading, etc. This method will be invoked inside the classloading context of this container. Unexpected throwables will be caught and logged.
public org.apache.catalina.deploy.SecurityConstraint[]	findSecurityConstraints(org.apache.catalina.connector.Request request, Context context) Return the SecurityConstraints configured to guard the request URI for this request, or null if there is no such constraint. param request Request we are processing
public Container	getContainer() Return the Container with which this Realm has been associated.
public java.lang.String	getInfo() Return descriptive information about this Realm implementation and the corresponding version number, in the format <description>/<version>.
public boolean	hasResourcePermission(org.apache.catalina.connector.Request request, org.apache.catalina.connector.Response response, org.apache.catalina.deploy.SecurityConstraint[] constraint, Context context) Perform access control based on the specified authorization constraint. Return true if this constraint is satisfied and processing should continue, or false otherwise. param request Request we are processing param response Response we are creating param constraint Security constraint we are enforcing param context The Context to which client of this class is attached. exception IOException if an input/output error occurs
public boolean	hasRole(java.security.Principal principal, java.lang.String role) Return true if the specified Principal has the specified security role, within the context of this Realm; otherwise return false. param principal Principal for whom the role is to be checked param role Security role to be checked
public boolean	hasUserDataPermission(org.apache.catalina.connector.Request request, org.apache.catalina.connector.Response response, org.apache.catalina.deploy.SecurityConstraint[] constraint) Enforce any user data constraint required by the security constraint guarding this request URI. Return true if this constraint was not violated and processing should continue, or false if we have created a response already. param request Request we are processing param response Response we are creating param constraint Security constraint being checked exception IOException if an input/output error occurs
public void	removePropertyChangeListener(java.beans.PropertyChangeListener listener) Remove a property change listener from this component. param listener The listener to remove
public void	setContainer(Container container) Set the Container with which this Realm has been associated. param container The associated Container