TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 19

changes.mady.by.user Tatiane Vieira Matias

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Daniel Otto Bolognani

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Composition Setup
import.css=/download/attachments/6062824/tecnologia.css
Portuguese


Configurando o Application Server

...

para

...

uso do SmartClient

...

WebApp

Utilizando o WebApp, o Application Server

...

passa a responder nativamente como um

...

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

Requisitos

Servidor Web, permitindo uso dos ERP TOTVS (Protheus/Logix) a partir dos navegadores homologados, em um ambiente seguro e escalável, sendo uma excelente opção para instalações em ambiente Cloud.


Nota
titleBalanceamento de carga 

📢  O Broker é o responsável pelo balanceamento de carga para o WebApp, mais informações acesse aqui:
📢  Entenda também sobre o Limite de conexões por browser, uma proteção dos navegadores que limita o numero de conexões abertas com o AppServer.

Requisitos

  • Ambiente

...

  • ERP TOTVS previamente configurado;

...

  • Copie o arquivo webapp.dll (

...

  • para AppServer Windows) ou webapp.so (

...

  • Linux) para a raiz da pasta onde esta instalado seu AppServer;
  • Para baixar os arquivos webapp.dll ou webapp.so acesse a seção Downloads no Portal de Clientes, e pesquise por webapp.

Image Added

Clique na imagem para visualização full.

Editando o arquivo de configuração do Application Server

...

O Administrador do ambiente

...

deve editar o arquivo de configuração appserver.ini.


Importante:
Portuguese

Após a 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.

Bloco de código
[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.

básica do WebApp exige apenas definir a porta de acesso, como no exemplo abaixo:
Para conhecer todas as configurações, consulte seção [Webapp]

code
Bloco de código
themeRDark
titleExemplo
[WEBAPP]
portPort=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.

Bloco de código
[webapp]
obfuscate_protocol = 0

(aviso) 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.
Bloco de código
[webapp]
httpheaders_options = {"Access-Control-Allow-Origin": "http://exemplo.com"}
8089


🚨 Importante:
Após a configuração deve-se reiniciar o/s AppServer/s.

SmartClient WebApp em uso

Tela de Parâmetros do Smartclient WebApp

Ao exibir a Tela de Parâmetros, o ambiente estará devidamente configurado.

Nota
titleImportante
|📢  Caso esteja utilizando a porta Multiprotocolo o acesso ao webapp deve ser feito por ela e para identificar o serviço, adicionar /webapp ao final da URL. Por exemplo https://localhost:1234/webapp

Image Added

Tela de login do Smartclient HTML (tradicional)

Image Added

Tela de login do Smartclient HTML (PO-UI)

Image Added


O Cross-origin resource sharing (CORS) (ou compartilhamento de recursos de origem cruzada), é a especificação de segurança implementada pelos browsers e que define meios pelo qual um navegador e um servidor web podem interagir para determinar se permiti ou não que seus recursos sejam acessados por uma página web de um domínio diferente.

Para mais opções de cabeçalho HTTP, consultar https://www.w3.org/TR/cors/

Tela de parâmetros do Smartclient HTML

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

Image Removed

Tela de login do Smartclient HTML

Image Removed📢  O Broker é o responsável pelo balanceamento de carga para o WebApp, mais informações acesse aqui:
📢  Entenda também sobre o Limite de conexões por browser, uma proteção dos navegadores que limita o numero de conexões abertas com o AppServer.

Nota
titleBalanceamento de carga 
Nota