t_ChannelConnections_HTTPConnection

HTTPConnection

An HTTP environment specific connection.

Properties

authComponent : string

Authentication interceptor component. If not specified, defaults to the channel authentication component, then to the environment authentication component.

authentication

Authentication mode: none - anonymous, basic - basic user/password, proactive - authenticate without waiting to be prompted, credential - SPNEGO user/password, server - silent SPNEGO w/server process account, certificate - X.509 certificate, perimeter - token based SSO, container - container provided security, custom - authentication interceptor component.

Valid values based on“string”.
none	No authentication. Log in anonymously. If selected, inbound connections are accessed through the anonymous context root. If selected and if authorization is required by the remote system, then outbound connections generate an error. See Environment.httpAnonymousURL as well.
basic	Authenticate using a basic username and password. (default)
proactive	Authenticate using a basic username and password that can be submitted as part of the initial request to the server. This option allows you to authenticate without waiting to be prompted for authentication information. When using this mode, you must ensure that the server host is trusted so that authentication information is not revealed inadvertently.
credential	Authenticate using an SPNEGO username and password.
server	Authenticate using SPNEGO silent sign-on and the server process account.
certificate	Authenticate using an X.509 certificate.
perimeter	Authenticate using token-based SSO.
container	Authenticate using a container-specific protocol.
custom	Authenticate using an interceptor component.

canonical : boolean

True to use the canonical host name in the HTTP/<host> Kerberos service principal name.

certificate : string

The HTTP sender's certificate and private key, for logging in to the remote system. Certificate must be base64-encoded PKCS #12 representation.

channel : string

Connection channel.

condition : string

The property to which the directive is applied.

The property specified here is typically set in the .environment file. It must be prefixed with "-Dnexj" if specified on the JVM command line.

Example: condition="reporting.enabled" ... reporting.enabled="true" or "-Dnexj.reporting.enabled=true"

connectionTimeout : nonNegativeInt

Timeout in milliseconds for establishing HTTP connections, 0 for infinite timeout. Defaults to the channel connectionTimeout.

Valid values based on“int”.
0 (minInclusive)

contentType : string

Default content type. Overrides the channel setting.

description : string

Channel connection description.

directive : directive

A conditional directive determining the operation to apply to the property specified in "condition".

If the operation is set to "if" or "ifnot", the property can be null. "ifdef" means "if defined". "ifndef" means "if not defined". If the operation is set to either, the property must not be null.

Example: "if", "ifnot", "ifdef", "ifndef"

Valid values based on“string”.
if
ifnot
ifdef
ifndef

enabled : boolean

The default state of enablement. (default="true")

maxSenders : integer

Maximum sender connections per server. Overrides the channel setting.

maxSize : nonNegativeInt

Maximum HTTP request size in bytes (0 is unlimited).

Valid values based on“int”.
0 (minInclusive)

merged : boolean

password : password

Password for the HTTP sender. If using a certificate, this is the certificate password.

Valid values based on“string”.

proxyAuthentication

Proxy authentication mode: basic - basic user/password, credential - SPNEGO user/password, server - silent SPNEGO w/server process account.

Valid values based on“string”.
basic	Authenticate using a basic username and password. (default)
proactive	Authenticate using a basic username and password that can be submitted as part of the initial request to the proxy. This option allows you to authenticate without waiting to be prompted for authentication information. When using this mode, you must ensure that the proxy host is trusted so that authentication information is not revealed inadvertently.
credential	Authenticate using an SPNEGO username and password.
server	Authenticate using SPNEGO silent sign-on and the server process account.

proxyHost : string

The proxy server to use for the HTTP sender.

proxyPassword : password

Password for the HTTP sender when connecting to a proxy server.

Valid values based on“string”.

proxyPort : unsignedShort

The proxy server port to use for the HTTP sender. Must be specified if using proxy other than JRE default proxy.

proxyUser : string

User name for the HTTP sender when connecting to a proxy server.

readTimeout : nonNegativeInt

Timeout in milliseconds for outbound HTTP requests, 0 for infinite timeout. Defaults to the channel readTimeout.

Valid values based on“int”.
0 (minInclusive)

secure : boolean

True to require HTTPS communication in the receiver. Defaults to secureTransport in the server configuration.

trust : string

The X.509 certificate, or signer's certificate thereof, for the remote system.

Unspecified to trust the global trust certificate, if any. The CN from the certificate presented by the remote system is used as the user principal for which the invocation context will be created. This allows support of multiple external systems authenticating to an HTTP channel, mapped to different users based on the certificates they present. http://en.wikipedia.org/wiki/X.509

url : string

Default HTTP request URL. Overrides the channel setting.

user : string

User name for the HTTP sender.

warningTimeout : nonNegativeLong

Timeout in milliseconds before a warning is generated, 0 for infinite timeout.

Valid values based on“long”.
0 (minInclusive)

Parents

Parent topic: t_Connections_ChannelConnections

Parent topic: t_Environment_ChannelConnections