auth-realm (Sun GlassFish Enterprise Server v2.1.1 Application Deployment Guide)

Sun GlassFish Enterprise Server v2.1.1 Application Deployment Guide

auth-realm

JAAS is available on the ACC. Defines the optional configuration for a JAAS authentication realm. Authentication realms require provider-specific properties, which vary depending on what a particular implementation needs. For more information about how to define realms, see Realm Configuration in Sun GlassFish Enterprise Server v2.1.1 Developer’s Guide.

Superelements

client-container (sun-acc.xml)

Subelements

The following table describes subelements for the auth-realm element.

Table A–5 auth-realm subelement


Element	Required	Description
property (with attributes)	zero or more	Specifies a property, which has a name and a value.

Attributes

The following table describes attributes for the auth-realm element.

Table A–6 auth-realm attributes


Attribute	Default	Description
`name`	none	Defines the name of this realm.
`classname`	none	Defines the Java class which implements this realm.

Example

Here is an example of the default file realm:

<auth-realm name="file"
   classname="com.sun.enterprise.security.auth.realm.file.FileRealm">
   <property name="file" value="domain-dir/config/keyfile"/>
   <property name="jaas-context" value="fileRealm"/>
</auth-realm>

Which properties an auth-realm element uses depends on the value of the auth-realm element’s name attribute. The file realm uses file and jaas-context properties. Other realms use different properties. See Realm Configuration in Sun GlassFish Enterprise Server v2.1.1 Developer’s Guide.