Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Administration Guide

- Previous: Admin Console Tasks for Security
- Next: To edit a realm

## To create a realm

The Application Server comes preconfigured with three realms: `file`, `certificate`, and `admin-realm`. It is also possible to create `ldap`, `solaris`, and custom realms. Generally, you will have one realm of each type on a server, but on the Application Server there are two file realms: `file` and `admin-realm`. These are two realms of the same type used for two different purposes. It is also possible to have a different certificate database for each virtual server on your system.

1. In the Admin Console tree component, expand the Configurations node.

2. Select the instance to configure:

   - To configure a particular instance, expand the instance’s config node. For example, the default instance, `server`, expand the `server-config` node.

   - To configure the default settings for all instances, expand the `default-config` node.

3. Expand the Security node.

4. Select the Realms node.

5. On the Realms page, click New.

   The Create Realm page is displayed.

6. Enter a name for the realm in the Name field.

7. Specify the class name for the realm being created.

   Valid choices are shown in the following table.

   Realm Name | Class Name
   --- | ---
   `file` | `com.sun.enterprise.security.auth.realm.file.FileRealm`
   `certificate` | `com.sun.enterprise.security.auth.realm.certificate.CertificateRealm`
   `ldap` | `com.sun.enterprise.security.auth.realm.ldap.LDAPRealm`
   `solaris` | `com.sun.enterprise.security.auth.realm.solaris.SolarisRealm`
   custom | Name of login realm class

8. Add the required properties and any desired optional properties for the realm.

   1. Click Add Property.

   2. In the Name field, enter the name of the property.

      - For a description of `file` realm properties, see Editing the file and admin-realm Realms.

      - For a description of `certificate` realm properties, see Editing the certificate Realm.

      - For a description of `ldap` realm properties, see Creating an ldap Realm.

      - For a description of `solaris` realm properties, see Creating the solaris Realm.

      - For a description of custom realm properties, see Creating a Custom Realm.

   3. In the Value field, enter the value of the property.

9. Click OK.

##### Equivalent asadmin command

`create-auth-realm`

- Previous: Admin Console Tasks for Security
- Next: To edit a realm

- © 2010, Oracle Corporation and/or its affiliates