HTTP Secure Server Configuration

This Secure Server factory configuration provides the set of properties of the Plain Server configuration and additional properties related to setting providers of SSL server sockets and credentials.

In addition, the default value for the port is 443.

The Secondary Port optional property is not loaded by default. You may set it by using a runtime console command like the following one:

config.setvalue CM_GENERATED_PID_1 secondaryPort 4434

where CM_GENERATED_PID_1 is the ID assigned internally by the OSGi Configuration Admin upon creating the default secure configuration from the HTTP Secure Server Configuration factory.

You may also set it by using Web Admin Console. The default value for this option is 4433.

Configuration Property	Name	Type	Default Value	Description
address	IP Address	String[]	127.0.0.1	Optional. Local IP addresses the HTTP server will bind to. Useful for systems with several IP addresses. Default is 127.0.0.1.
maxusers	Max Users	int	50	The greatest number of users that simultaneously contact the HTTP Service on one of its ports. This property must be a value between 1 and 65535. Default is 50 users.
on	On	boolean	true	Optional. Indicates if the HTTP server should be started or stopped. Default is true.
persistentconnection	PersistentConnection	boolean	true	The Persistent connection radio buttons impose persistent connections with HTTP clients. Default value - true. When set to false the HTTP Bundle closes the connection after each response.
port	Port	int	443	The port allocated for HTTP requests. It must be a number between 1 and 65535. The default value is 443.
requesttimeout	Request Timeout	int	30	The timeout in seconds for keeping alive the connection. Default value - 30. This property must be a value between 0 and 300.
responsetimeout	Response Timeout	int	0	Time period in seconds necessary to write out 1KB of data to the HTTP client. If the timeout expires before writing the data, connection is closed. This property value must be a number between 0 and 300. Default value is 0, which means that there will be no blocking when writing output data.
secondaryport	Secondary Port	int	4433	Optional. If the primary port is overloaded or is already reserved for another type of communication, the secondary port is used to carry the incoming and outgoing traffic. This property is available only for plain connection type. It must be a number between 1 and 65535. The default value is 4433.
ssprovider	Secure Socket Provider	String	-	Optional. The name of the JSSE SSLContext provider that the HTTP Bundle will use for establishing SSL-enabled connection. Has precedence over the mbs.http.tlsprovider system property.
kmfalgorithm	Key Manager Factory Algorithm	String	-	Optional. The algorithm that will be used for key management of the private credentials presented to the SSL client. If not set, the value of the mbs.http.keyManagerFactoryAlgorithm system property will be used.
kmfprovider	Key Manager Factory Provider	String	-	Optional. The name of the provider that supports the key management algorithm, specified with the kmfalgorithm property, for the private credentials presented to the SSL client. If not set, the value of the mbs.http.keyManagerFactoryProvider system property will be used.
tmfalgorithm	Trust Manager Factory Algorithm	String	-	Optional. The algorithm that will be used for trust management of the credentials presented by SSL clients. If not set, the value of the mbs.http.trustManagerFactoryAlgorithm system property will be used.
tmfprovider	Trust Manager Factory Provider	String	-	Optional. The name of the provider that supports the trust management algorithm, specified with the tmfalgorithm property, for the authentication credentials presented by the SSL clients. If not set, the value of the mbs.http.trustManagerFactoryProvider system property will be used.
filter	Filter	String	-	Optional. Filter in LDAP format for locating the SSL Server Socket Factory service that will be used by the HTTP Bundle for opening secure sockets.
name	Name	String	-	Optional. In case you want to create another HTTP server, specify its name with the name property.
secureAdditionalPorts	Secure Additional Ports	int[]	<secondary port>	Optional. If you want to add some additional ports for the secure connection of the HTTP server, use this property. By default it is equal to the secondary port.