Suporte SSL no HyperServer

A configuração SSL não é necessária para o modo DLL, pois seu servidor web (por exemplo IIS) gerencia as configurações e certificados SSL.

Para os modos Standalone e Service, a configuração SSL é feita usando um arquivo chamado <server_name>.ssl.cfg onde server_name é o nome do seu executável HyperServer.

Abaixo está um conteúdo padrão de ssl.cfg:

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

Você precisa configurar os parâmetros nesse arquivo de acordo com sua configuração SSL. O formato é idêntico ao formato de texto DFM do Delphi porque é a propriedade SSL serializada do seu ServerModule.

Tudo o que você precisa fazer é abrir seu ServerModule e copiar a configuração SSL atual para o arquivo ssl.cfg.

Exemplo de trecho do ServerModule mostrando configurações SSL:

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
endSe você já possui uma configuração SSL

1

1. Abra o arquivo DFM do ServerModule do seu projeto.

2. Copie todas as linhas relacionadas ao SSL (as propriedades SSL.*) do DFM do ServerModule.

3. Cole essas linhas no <server_name>.ssl.cfg arquivo usado pelo HyperServer.

2

Se você deseja configurar uma nova instalação SSL

1. Crie uma nova aplicação uniGUI.

2. Configure as definições SSL no ServerModule e teste completamente a configuração.

3. Após verificar que funciona, copie as linhas relacionadas ao SSL do DFM do ServerModule para o <server_name>.ssl.cfg arquivo.

Observação: Não altere ou remova quaisquer links/URLs referenciados pela sua aplicação; mantenha quaisquer parâmetros de consulta intactos ao copiar referências de configuração ou caminhos de certificados.