Editing the HTTP Server Adapter Reference

Name Page

Field Description
Name Name of this adapter. No action necessary.
Description Meaningful description for this adapter, for reference purposes. Required.
Select a Group
Specifies a group to associate with this configuration. Valid values are:
  • None – no group association. This is the default.
  • Create New Group – Creates a new group to associate with this configuration.
  • Select Group – Select from the list an existing group to associate with this configuration.

HTTP Connection Properties Page

Field Description
HTTP Listen Port The port number on which the Perimeter server process listens for connections from external trading partner HTTP clients. If a local-mode Perimeter server is chosen, this listen port is bound on the local computer. Valid values are 1 through 65536. On many operating systems, only the root user can bind on ports 1 through 1024. Required.
Perimeter Server Name List of available Perimeter servers, including local-mode Perimeter servers. Required. Default is local-mode Perimeter server.
Total Business Process queue depth threshold Indicates the maximum number of queued business processes allowed for this adapter. If a value other than 0 is specified, the adapter will limit the number of business process requests put on the queue. If the SUM of business processes on all the queues is less than the queue threshold value, processing occurs normally. For example, a queue threshold of 500 will stop a request if queue 4 has 300 business processes, queue 6 has 200, and queue 7 has 3. If the threshold is exceeded, the adapter will return a Service Unavailable message, which will trigger senders to retry later. Valid value is any integer. 0 indicates no threshold.
Document Storage
Where to store the body of the request document. Valid values are:
  • System Default
  • Database
  • File System

Default is System Default. Required.

Note: For more information about document storage types, see Managing Services and Adapters.
User Authentication Required
Whether to enable HTTP basic authentication. Valid values are:
  • Yes - A connection must pass HTTP basic authentication to be serviced.
  • No - HTTP basic authentication is not to be used.

Default is Yes. Required.

Use SSL
Whether SSL Server authentication must be enabled or not. Valid values are:
  • Must - SSL is enabled
  • None - SSL is disabled

Default is Must. Required.

Note: User Authentication without SSL will result in a weak security configuration.
TLS Version Select the TLS protocol version from the drop-down menu. Required if SSL option is Must. The default value is System Default. Valid values are:
  • TLSv1.3
  • TLSv1.0-TLSv1.3
  • TLSv1.2-TLSv1.3
  • SystemDefault
Important:
  • The TLSVersionUIOptions property in the security.properties file specifies which TLS versions are available for selection from the drop-down menu.
  • You can customize the property by adding any of the permissible values to the list or removing any existing values. Permissible values are:
    • TLS1.3
    • TLS1.2
    • TLS1.0-TLS1.3
    • TLS1.2-TLS1.3
    • SystemDefault
  • It is important to note that any other value will be ignored. In such cases, the handshake will proceed using the SSLHelloProtocol property value as a fallback option to ensure secure communication.
Note:
  • System Default uses the value from security.properties file.
  • In case of NIST Strict, the SSLHelloProtocolForNISTStrict property is used. Otherwise, SSLHelloProtocol property is used.
  • When TLSv1.3 is selected, ensure TLS 1.3 ciphers are configured in the security.properties file under the TLSv13Ciphers property. For the list of supported ciphers, see Cipher suites.

SSL Information

Field Description
System Certificate Select a system certificate from the list. This is the private key that the SSL server will use. Required if Use SSL is Must.
Cipher Strength
Specifies the strength of the algorithms (cipher suites) used to encrypt data. Valid values are:
  • STRONG - Required if Use SSL is Must
  • ALL - All cipher strengths are supported
  • WEAK - Often required for international trade, because government regulations prohibit STRONG encryption from being exported

Default is STRONG. Required if SSL is checked.

CA Certificate Move one or more CA Certificates to the use column. These are the digital security certificates that the SSL server will use to authenticate the client. Optional.

Specifications Page

Field Description
URI Uniform resource identifier representing incoming requests. Required.
Launch Business Process or WAR Corresponding business process or a WAR file associated with the URI. Required.
Enter WAR File Path Specifies WAR file to be launched by URI. Valid value is any accessible path. Required if WAR File is selected for Launch BP or WAR File field.
Business Process Specifies business process to be launched by URI. Select from the list of available business processes. Required if BP is selected for Launch BP or WAR File field.
Send Raw Messages
Whether the raw message is presented to the business process. The term raw denotes that the primary document associated with the business process contains HTTP headers. Valid values are:
  • Yes - Both the HTTP headers and the entity body are copied to the body of the business process document before the business process is started. This setting is required for EDIINT AS2, RosettaNet, and ebXML.
  • No - Just the HTTP entity body is copied to the body buffer of the business process document. The headers are not available to the business process.

Default is No. Required if BP is selected for Launch BP or WAR File field.

Note: Any business process that uses the EDIINT Message service requires raw messages.
Run BP in sync mode
Whether to invoke Web services in synchronous mode. Valid values are:
  • Yes - HTTP Server Adapter bootstraps the BP in synchronous mode. HTTP Server Adapter executes the BP in the same thread.
  • No - HTTP Server Adapter bootstraps the BP asynchronous mode.

Default is No. Required if BP is to be run in synchronous mode.