NonStop Servlets for JavaServer Pages (NSJSP) 6.0 System Administrator's Guide

Configuring NSJSP

NonStop Servlets for JavaServer Pages (NSJSP) 6.0 System Administrator’s Guide—544548-004

3-24

MemoryRealm

MemoryRealm is a simple demonstration of the NSJSP 6.0 realm interface. It is not

designed for production use. During startup, MemoryRealm loads information about all

the users and their corresponding roles from an XML document, which is loaded from

the file NSJSP_HOME/conf/nsjsp-users.xml. Changes to data in this file are not

recognized until the NSJSP server is restarted.

Realm Element Attributes

To configure MemoryRealm, create a <Realm> element and nest it in the file

NSJSP_HOME/conf/server.xml or in the <Context> element in the context

configuration file, as described in Example 3-9 on page 3-23. MemoryRealm supports

the following attributes:

className

The value is org.apache.catalina.realm.MemoryRealm.

digest

The digest algorithm stores passwords in non-plain text format.

Valid values are those accepted by the java.security.MessageDigest class

for the algorithm name. For more information, see Digested Passwords on

page 3-39. If not specified, passwords are stored in clear text format.

pathname

This is the absolute or relative pathname of the file nsjsp-users.xml (XML

document) containing valid user names, passwords, and roles. For more

information on the format of this file, see User File Format on page 3-24. For

example:

<Realm className="org.apache.catalina.realm.MemoryRealm"

pathname="conf/nsjsp-users.xml" />

User File Format

The file nsjsp-users.xml (for example, NSJSP_HOME/conf/nsjsp-users.xml)

must be an XML document with a root element <tomcat-users>. Nested inside the

root element is a <user> element for each valid user, consisting of the following

attributes:

name

The user name you must use to log on.