SecureWebServer extends WebServer with SSL security features. You must provide a certificate suitable for server authentication, and any passwords or key files needed to access the certificate. SSL3 and TLS3 are the only supported protocols. This agent supports the following Props entries:
socket_linger_time
The number of millisecs to wait after an http request is completed before closing the socket used for that request. Default value is 2000
bind_port
The port that the webserver will bind to. Default value is 80
max_connections
The maximum number of concurrent connections to allow. Default value is 20
index_agent
The agent that gets called when the default page is requested. Default value is HTTPFileServerAgent
bind_ip
The IP address to service HTTP requests on (on mulithoming machines. To service requests on any IP interfaces, use 0.0.0.0 as the value. Default value is 0.0.0.0
log_requests
If this is set to true, the server will create HTTP access logs. Default value is true
log_file_dir
Specifies the directory where the server will create the HTTP access logs. Default value is ./logs
mime_types_file
The path to a file specifying mime types to use with various file extensions. If this file is missing, the server uses common default mappings. Default value is ./mime_types
server_certificate
The path to the certificate this server will use for SSL connections. To retrieve a certificate from the local host's certificate store, use the syntax store:/MY/localhost. Note that the example above doesn’t include a certificate name. If no certificate name is provided the server will use the 1st certificate it finds in the specified certificate store that is suitable for SSL server authentication. Use the following values to access various certificate stores on windows platforms:
CA
Certification authority certificates.
MY
A certificate store holding "My" certificates.
ROOT
Root certificates.
SPC
Software publisher certificates.
Default value is ./test-cert.pfx
certificate_password
The password to use when accessing the certificate. (The password for the certificate stored in the file test-cert.pfx is abcd, so the default value is abcd
.
The following Props settings are optional:
server_key_file
The path to a server key file. By default this prop is not set.
key_file_password
The password used to access the server key file. By default this prop is not set.
Public static (Shared in Visual Basic) members of this type are
safe for multithreaded operations. Instance members are not guaranteed to be
thread-safe.