Uso do Broker HTTP com Smartclient HTML e Porta Multi Protocolo

Quando se utiliza o TOTVS | Broker para balancear TOTVS | SmartClient HTML e o TOTVS | Application Server está utilizando a porta multi protocolo, na chave REMOTE_SERVER do ini do TOTVS | Broker devem ser colocados o IP e a porta multi protocolo de cada TOTVS | Application Server que está sendo balanceado pelo TOTVS | Broker.

Como o padrão da porta multi protocolo é conexão encriptada, então também vai ser necessário a configuração de comunicação encriptada com server no TOTVS | Broker.

Caso esteja sendo usada a porta multi protocolo sem encriptação, então não deve ser colocada a configuração de comunicação encriptada com server no TOTVS | Broker.

A configuração de comunicação encriptada entre o broker e o server é controlada pela chave SSL_ENCRYPT_UPSTREAM no ini do broker.

Com SSL_ENCRYPT_UPSTREAM=1 a comunicação entre broker e server é encriptada. Se esta chave não existir ou tiver o valor 0, a comunicação entre broker e server será não encriptada.

Além diso, quando o TOTVS | Application Server tem a chave APP_ENVIRONMENT=nome_environment e a porta multi protocolo está configurada com encriptação, o browser precisa ser utilizado com uma url https.

Neste caso, o broker precisa ser configurado com os certificados de segurança, como no exemplo abaixo.

Exemplo de configuração considerando porta multi protocolo encriptada e chave APP_ENVIRONMENT=nome_environment.

-------------------------------------------------------------

Configuração do TOTVS | Application Server (appserver.ini)

    [GENERAL]
    ....
    ....

    APP_ENVIRONMENT=nome_environment

    ....
    ....
    [DRIVERS] 
    ACTIVE=TCP

    [TCP]
    TYPE=TCPIP
    PORT=porta_multiprotocolo
    ....
    ....

-------------------------------------------------------------

Configuração do TOTVS | Broker (appserver.ini do broker)

    [BALANCE_HTTP]
   
    LOCAL_SERVER_PORT = porta_broker

    REMOTE_SERVER_01 = ip_appserver   porta_multiprotocolo_appserver
    REMOTE_SERVER_02 = ip_appserver   porta_multiprotocolo_appserver
    (etc)

    ; comunicação encriptada com o appserver
    SSL_ENCRYPT_UPSTREAM = 1

    ; comunicação encriptada com o client (browser)
    SSL_METHOD=SSL/TLS
    SSL_CERTIFICATE=totvs_certificate.crt
    SSL_KEY=totvs_certificate_key.pem          

    ....
    ....

-------------------------------------------------------------

Os certificados utilizados no exemplo acima são os disponibilizados no pacote do TOTVS | Application Server.

Para mais detalhes sobre estes certificados consultar a página https://tdn.totvs.com.br/display/tec/Application+Server+-+Porta+Multiprotocolo.

Fica a critério do cliente utilizar outros certificados.

O usuário vai acessar o broker via uma url https://ip_broker:porta_broker/webapp.