Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Developer's Guide

- Previous: Alphabetical Listing of All Elements
- Next: B

# A

## activation-config

Specifies an activation configuration, which includes the runtime configuration properties of the message-driven bean in its operational environment. For example, this can include information about the name of a physical JMS destination. Matches and overrides the `activation-config` element in the `ejb-jar.xml` file.

### Superelements

mdb-resource-adapter (`sun-ejb-jar.xml`)

### Subelements

The following table describes subelements for the `activation-config` element.

Table A–2 `activation-config` subelements

Element | Required | Description
--- | --- | ---
description | zero or one | Specifies a text description of the activation configuration.
activation-config-property | one or more | Specifies an activation configuration property.

## activation-config-property

Specifies the name and value of an activation configuration property.

### Superelements

activation-config (`sun-ejb-jar.xml`)

### Subelements

The following table describes subelements for the `activation-config-property` element.

Table A–3 `activation-config-property` subelements

Element | Required | Description
--- | --- | ---
activation-config-property-name | only one | Specifies the name of an activation configuration property.
activation-config-property-value | only one | Specifies the value of an activation configuration property.

## activation-config-property-name

Specifies the name of an activation configuration property.

### Superelements

activation-config-property (`sun-ejb-jar.xml`)

### Subelements

none - contains data

## activation-config-property-value

Specifies the value of an activation configuration property.

### Superelements

activation-config-property (`sun-ejb-jar.xml`)

### Subelements

none - contains data

## as-context

Specifies the authentication mechanism used to authenticate the client.

### Superelements

ior-security-config (`sun-ejb-jar.xml`)

### Subelements

The following table describes subelements for the `as-context` element.

Table A–4 `as-context` Subelements

Element | Required | Description
--- | --- | ---
auth-method | only one | Specifies the authentication method. The only supported value is `USERNAME_PASSWORD`.
realm | only one | Specifies the realm in which the user is authenticated.
required | only one | Specifies whether the authentication method specified must be used for client authentication.

## auth-method

Specifies the authentication method.

If the parent element is as-context, the only supported value is `USERNAME_PASSWORD`.

If the parent element is login-config, specifies the authentication mechanism for the web service endpoint. As a prerequisite to gaining access to any web resources protected by an authorization constraint, a user must be authenticated using the configured mechanism.

### Superelements

login-config (`sun-web.xml`), as-context (`sun-ejb-jar.xml`)

### Subelements

none - contains data

## 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: Alphabetical Listing of All Elements
- Next: B

- © 2010, Oracle Corporation and/or its affiliates