Histórico da Página

Configurando o Application Server como servidor Web para o SmartClient HTML

A partir da build 131227A o Application Server responde nativamente como um servidor Web, fornecendo segurança e escalabilidade ao ambiente Cloud do ERP TOTVS.

A seguir demonstraremos a configuração, de fato muito simples, deste ambiente.

Requisitos

• O ambiente do ERP TOTVS previamente configurado;
• Copiar para a pasta do Application Server o arquivo webapp.dll (windows) ou webapp.so (linux).

Editando o arquivo de configuração do Application Server

Sendo o administrador do ambiente, edite o arquivo de configuração appserver.ini.

Importante:
Após a configuração do arquivo será necessário reiniciar o Application Server para que a camada Web seja devidamente inicializada.

1 - Porta para o acesso HTTP

Indica a porta da onde o servidor ira disponibilizar o acesso ao SmartClient HTML.

[WEBAPP]
port=8080

2 - Configuração do ambiente HTTPS (camada de segurança)

Caso o cliente opte por utilizar conexões HTTP seguras, é necessário a configuração dos certificados.

Para isso indique o método que será usado e o caminho para o arquivo de certificado e chave.

[WEBAPP]
port=8080
ssl_method=SSL/TLS
ssl_certificate=C:\TOTVS\certificate.pem
ssl_key=C:\TOTVS\certificate.key

3 - Configuração para descriptografar o protocolo

Caso o cliente opte por descriptografar o protocolo (necessário para emulação de carga do sistema), é necessário desabilitar a chave obfuscate_protocol.

[webapp]
obfuscate_protocol = 0

Ao efetuar essa configuração, os dados trafegados são passíveis de leitura (sniffing)

4 - Configuração para controle de acesso HTTP (CORS)

Caso o cliente opte por permitir que o Smartclient HTML seja acessado por um domínio diferente, é necessário informar a chave httpheaders_options.

Essa chave deve ser informada em formato JSON.

Quando não for definida esta chave, o Smartclient HTML só será acessado por páginas web do mesmo domínio (default).

Para especificar um domínio diferente, a chave httpheaders_options deve conter a informação "Access-Control-Allow-Origin".

• httpheaders_options = {"Access-Control-Allow-Origin": "*"}, o Smartclient HTML será acessado por páginas web de qualquer domínio.
• httpheaders_options = {"Access-Control-Allow-Origin": "http://exemplo.com"}, o Smartclient HTML será acessado por páginas web do mesmo domínio e por páginas do domínio http://exemplo.com.

[webapp]
httpheaders_options = {"Access-Control-Allow-Origin": "http://exemplo.com"}

Tela de parâmetros do Smartclient HTML

Ao exibir corretamente a página de parâmetros, o ambiente já estará devidamente configurado.

Tela de login do Smartclient HTML