SSL Support in HyperServer

SSL configuration is not required for DLL mode, as your web server (for example IIS) handles SSL configurations and certificates.

For Standalone and Service modes, SSL configuration is done using a file named <server_name>.ssl.cfg where server_name is the name of your HyperServer executable.

Below is a default ssl.cfg content:

ssl.cfg

object TUniHyperSSL
 SSL.Enabled = False
 SSL.SSLOptions.RootCertFile = 'root.pem'
 SSL.SSLOptions.CertFile = 'cert.pem'
 SSL.SSLOptions.KeyFile = 'key.pem'
 SSL.SSLOptions.Method = sslvTLSv1_2
 SSL.SSLOptions.SSLVersions = [sslvTLSv1_2]
 SSL.SSLOptions.Mode = sslmUnassigned
 SSL.SSLOptions.VerifyMode = []
 SSL.SSLOptions.VerifyDepth = 0
 SSL.SSLPort = 0
 SSL.SSLPassword = ''
end

You need to configure the parameters in that file according to your SSL setup. The format is identical to Delphi's DFM text format because it is the serialized SSL property of your ServerModule.

All you need to do is open your ServerModule and copy the current SSL configuration into the ssl.cfg file.

Example ServerModule excerpt showing SSL settings:

ssl.cfg

object UniServerModule: TUniServerModule
 OldCreateOrder = False
 TempFolder = 'temp\'
 Title = 'New Application'
 SuppressErrors = []
 Bindings = <>
 
 SSL.Enabled = True
 SSL.SSLOptions.RootCertFile = 'root.pem'
 SSL.SSLOptions.CertFile = 'cert.pem'
 SSL.SSLOptions.KeyFile = 'key.pem'
 SSL.SSLOptions.Method = sslvTLSv1_2
 SSL.SSLOptions.SSLVersions = [sslvTLSv1_2]
 SSL.SSLOptions.Mode = sslmUnassigned
 SSL.SSLOptions.VerifyMode = []
 SSL.SSLOptions.VerifyDepth = 0
 SSL.SSLPassword = 'fmsoft'
 
 ConnectionFailureRecovery.ErrorMessage = 'Connection Error'
 ConnectionFailureRecovery.RetryMessage = 'Retrying...'
 Height = 396
 Width = 560
endIf you already have an SSL setup

1

1. Open your project's ServerModule DFM file.

2. Copy all SSL-related lines (the SSL.* properties) from the ServerModule DFM.

3. Paste those lines into the <server_name>.ssl.cfg file used by HyperServer.

2

If you want to configure a new SSL setup

1. Create a new uniGUI application.

2. Configure SSL settings in the ServerModule and fully test the setup.

3. After verifying it works, copy the SSL-related lines from the ServerModule DFM into the <server_name>.ssl.cfg file.

Note: Do not change or remove any links/URLs referenced by your application; keep any query parameters intact when copying configuration references or certificate paths.