P
param-name
Contains a context parameter name.
Superelements
context-param
Subelements
none - contains data
param-value
Contains a context parameter value.
Superelements
context-param
Subelements
none - contains data
port-unification
Configures port unification.
Superelements
protocol
Subelements
The following table describes subelements for the port-unification element.
port-unification Subelements
|
|
|
|
zero or one |
Configures the
protocol finder. |
|
Attributes
The following table describes attributes for the port-unification element.
port-unification Attributes
|
|
|
name |
none |
Specifies a unique name
for the port-unification. |
|
none |
Specifies the class name of the port-unification implementation. |
|
principal
Contains the principal of the servlet or EJB client.
Superelements
security-map
Subelements
none - contains data
principal-map
Maps an EIS principal to a principal defined in the Enterprise Server
domain.
Superelements
work-security-map
Subelements
none
Attributes
The following table describes attributes for the principal-map element.
principal-map Attributes
|
|
|
|
none |
Specifies an EIS principal. |
|
none |
Specifies
a principal defined in the Enterprise Server domain. |
|
profiler
Configures a profiler for use with the Enterprise Server. For more information about
profilers, see the Sun GlassFish Enterprise Server v3 Application Development Guide.
Superelements
java-config
Subelements
The following table describes subelements for the profiler element.
profiler Subelements
|
|
|
|
zero or more |
Contains profiler-specific
JVM command line options. |
|
zero or more |
Specifies a property or a variable. |
|
Note - Subelements of a profiler element can occur in any order.
Attributes
The following table describes attributes for the profiler element.
profiler Attributes
|
|
|
|
none |
Specifies the name of
the profiler. |
|
none |
(optional) Specifies the classpath for the profiler. |
|
none |
(optional) Specifies the native
library path for the profiler. |
enabled |
true |
(optional) Determines whether the profiler is enabled. |
|
property
Specifies a property. A property adds configuration information to its parent element that
is one or both of the following:
-
Optional with respect to the Enterprise Server
-
Needed by a system or object that the Enterprise Server doesn’t have knowledge of, such as an LDAP server or a Java class
For example, an auth-realm element can include property subelements:
<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.
Superelements
admin-object-resource, admin-service, appclient-module, application, audit-module, auth-realm, config, connector-connection-pool, connector-module, connector-resource, custom-resource, das-config,
domain, ejb-container, ejb-module, ejb-timer-service, engine, extension-module, external-jndi-resource, http-service, iiop-listener, j2ee-application, jacc-provider, java-config,
jdbc-connection-pool, jdbc-resource, jms-host, jms-service, jmx-connector, lifecycle-module, log-service, mail-resource, manager-properties, mdb-container, module-log-levels,
module-monitoring-levels, monitoring-service, orb, profiler, provider-config, resource-adapter-config, security-service, server, session-properties, store-properties, thread-pool, transaction-service,
virtual-server, web-container, , web-module
Subelements
none
Attributes
The following table describes attributes for the property element.
property Attributes
|
|
|
|
none |
Specifies the name of
the property or variable. |
|
none |
Specifies the value of the property or variable. |
|
none |
(optional) Specifies
a text description of this element. |
|
protocol
Configures a network protocol. A protocol can be defined in one of the
following ways according to its subelements:
Superelements
protocols
Subelements
The following table describes subelements for the protocol element.
protocol Subelements
|
|
|
|
zero or one |
Configures HTTP
parameters. |
|
zero or one |
Configures port unification. |
|
zero or one |
Configures a protocol chain instance handler. |
|
zero
or one |
Configures a protocol filter. |
|
zero or one |
Defines SSL parameters. |
|
Attributes
The following table describes attributes for the protocol element.
protocol Attributes
|
|
|
name |
none |
Specifies a unique name
for the protocol. |
|
false |
(optional) Determines whether the network-listener that references this protocol
runs SSL. To turn SSL2 or SSL3 on or off and set ciphers,
use an ssl subelement. |
|
protocol-chain
Configures a protocol chain.
Superelements
protocol-chain-instance-handler
Subelements
none
Attributes
The following table describes attributes for the protocol-chain element.
protocol-chain Attributes
|
|
|
name |
none |
Specifies a unique name
for the protocol chain. |
|
none |
Specifies the class name of the protocol chain implementation. |
|
STATELESS |
Specifies
the type of protocol chain. |
|
protocol-chain-instance-handler
Configures a protocol chain instance handler.
Superelements
protocol
Subelements
The following table describes subelements for the protocol-chain-instance-handler element.
protocol-chain-instance-handler Subelements
|
|
|
|
one or more |
Configures a
protocol chain. |
|
Attributes
The following table describes attributes for the protocol-chain-instance-handler element.
protocol-chain-instance-handler Attributes
|
|
|
name |
none |
Specifies a unique name
for the protocol chain instance handler. |
|
none |
Specifies the class name of the protocol
chain instance handler implementation. |
|
protocol-filter
Configures a protocol filter.
Superelements
protocol
Subelements
none
Attributes
The following table describes attributes for the protocol-filter element.
protocol-filter Attributes
|
|
|
name |
none |
Specifies a unique name
for the protocol filter. |
|
none |
Specifies the class name of the protocol filter implementation. |
|
protocol-finder
Configures a protocol finder.
Superelements
port-unification
Subelements
none
Attributes
The following table describes attributes for the protocol-finder element.
protocol-finder Attributes
|
|
|
name |
none |
Specifies a unique name
for the protocol finder. |
|
none |
Specifies the class name of the protocol finder implementation. |
protocol |
none |
Specifies
the name of the protocol associated with this protocol finder. |
|
protocols
Contains protocols.
Superelements
network-config
Subelements
The following table describes subelements for the protocols element.
protocols Subelements
|
|
|
|
one or more |
Configures a
protocol. |
|
provider-config
Specifies a configuration for one message security provider.
Although the request-policy and response-policy subelements are optional, the provider-config element does
nothing if they are not specified.
Use property subelements to configure provider-specific properties. Property values are passed to the
provider when its initialize method is called.
Superelements
message-security-config
Subelements
The following table describes subelements for the provider-config element.
provider-config Subelements
|
|
|
|
zero or one |
Defines the
authentication policy requirements of the authentication provider’s request processing. |
|
zero or one |
Defines the authentication
policy requirements of the authentication provider’s response processing. |
|
zero or more |
Specifies a property or
a variable. |
|
Attributes
The following table describes attributes for the provider-config element.
provider-config Attributes
|
|
|
|
none |
Specifies a unique identifier
for this provider-config element. |
|
none |
Specifies whether the provider is a client, server, or
client-server authentication provider. |
|
none |
Specifies the Java implementation class of the provider. Client authentication providers must
implement the com.sun.enterprise.security.jauth.ClientAuthModule interface. Server authentication providers must implement the com.sun.enterprise.security.jauth.ServerAuthModule
interface. Client-server providers must implement both interfaces. |
|
Properties
The following table describes properties for the provider-config element.
provider-config Properties
|
|
|
|
domain-dir/config/wss-server-config-1.0.xml |
Specifies the location of
the message security configuration file. To point to a configuration file in the
domain-dir/config directory, use the system property ${com.sun.aas.instanceRoot}/config/, for example: ${com.sun.aas.instanceRoot}/config/wss-server-config-1.0.xml See system-property. |
|
false |
If true, enables
dumping of server provider debug messages to the server log. |
dynamic.username.password |
false |
If true, signals the
provider runtime to collect the user name and password from the CallbackHandler for each
request. If false, the user name and password for wsse:UsernameToken(s) is collected once,
during module initialization. This property is only applicable for a ClientAuthModule. |
|
s1as |
Specifies the encryption
key used by the provider. The key is identified by its keystore alias. |
|
s1as |
Specifies
the signature key used by the provider. The key is identified by its
keystore alias. |
|