Sun Java System Application Server Platform Edition 8.2 Developer's Guide

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.