Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Developer's Guide

- Previous: auth-method
- Next: B

## 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.

### 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.

- Previous: auth-method
- Next: B

- © 2010, Oracle Corporation and/or its affiliates