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

Element Required Description protocol-finder zero or one Configures the protocol finder.

Attributes

The following table describes attributes for the port-unification element.

port-unification Attributes

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

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

Element Required Description jvm-options zero or more Contains profiler-specific JVM command line options. property zero or more Specifies a property or a variable.

Attributes

The following table describes attributes for the profiler element.

profiler Attributes

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

protocol

Configures a network protocol. A protocol can be defined in one of the following ways according to its subelements:

• http — Defines HTTP or HTTPS protocol.

• protocol-chain-instance-handler — Defines a custom protocol as a chain of protocol-filter links.

• port-unification — Defines a composite protocol, which can consist of several protocol definitions. Port unification makes it possible for a single network-listener to host several protocols at the same time. For example, HTTP and IIOP can work simultaneously on port 8080.

Superelements

protocols

Subelements

The following table describes subelements for the protocol element.

protocol Subelements

Element Required Description http zero or one Configures HTTP parameters. port-unification zero or one Configures port unification. protocol-chain-instance-handler zero or one Configures a protocol chain instance handler. protocol-filter zero or one Configures a protocol filter. ssl zero or one Defines SSL parameters.

Attributes

The following table describes attributes for the protocol element.

protocol Attributes

Attribute Default Description name none Specifies a unique name for the protocol. security-enabled 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

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

Element Required Description protocol-chain 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

protocol-filter

Configures a protocol filter.

Superelements

protocol

Subelements

none

Attributes

The following table describes attributes for the protocol-filter element.

protocol-filter Attributes

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

Attribute Default Description name none Specifies a unique name for the protocol finder. classname 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

Element Required Description protocol 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

Element Required Description request-policy zero or one Defines the authentication policy requirements of the authentication provider’s request processing. response-policy zero or one Defines the authentication policy requirements of the authentication provider’s response processing. property zero or more Specifies a property or a variable.

Attributes

The following table describes attributes for the provider-config element.

provider-config Attributes

Properties

The following table describes properties for the provider-config element.

provider-config Properties