O Smartclient Desktop e o Broker se comunicam trocando mensagens com headers de um protocolo pseudo HTTP.
Abaixo está o formato dos header das mensagens trocadas entre Smartclient Desktop e Broker.
PUT /D/xxxxxx/yyyyyyyyy HTTP/1.1
User-Agent: Totvs Proxy v1.6
Content-Length: 000398
X-V-Session: 00000002
dados ... dados ...dados
É possível visualizar esses headers no log do broker ativando as chaves abaixo:
LOG_MSG = 1
LOG_MSG_SIZE = Tamanho
na seção BALANCE_SMART_CLIENT_DESKTOP. Tamanho indica quantos caracteres serão gravados no log, incluindo headers e dados.
Observações.
1) o formato das mensagens usam um protocolo HTTP simplificado
2 as mensagens sempre são no formato acima, nos 2 sentidos
3) o campo xxxxxx é um sequencial numérico, começando por 1 e incrementado de 1 a cada nova mensagem
4) o campo yyyyyyyyy é o tamanho acumulado das mensagens trocadas, começando por 0
5) o header User-Agent sempre tem esse valor fixo: "Totvs Proxy v1.6"
6) header X-C-Session tem um valor numérico variável
7) o header Content-Length tem o mesmo significado do HTTP padrão
8) esses headers são sempre enviados em plain text, não encriptados
9) em situações muito raras situações a primeira linha poderá ser
PUT /P/xxxxxx/yyyyyyyyy HTTP/1.1
com um "P" no lugar de um "D"
10) existe uma exceção às regras acima
em algumas situações o smartclient envia um request HTTP padrão
GET /TOTVS_BROKER_QUERY/ping HTTP/1.1
e o broker responde com uma resposta HTTP padrão
HTTP/1.1 200 OK
Estes headers podem ser usados para a configuração de firewalls entre o Smartclient Desktop e o Broker.
As mensagens entre o Smartclient Desktop e o Broker não devem ser alteradas pelo firewall.
==/==