Buscar K
Aparência
Comunicação e Redes
O Agente do HorusETL foi projetado para ser Firewall Friendly — ele opera sem a necessidade de configurações complexas de rede ou abertura de portas de entrada (Inbound) na sua infraestrutura.
📡 Protocolo
Toda a comunicação entre o Agente (sua rede) e o Backend (Nuvem) é feita via WebSocket Seguro (WSS).
Isso garante:
- Criptografia — Todos os dados trafegados são criptografados (SSL/TLS)
- Tempo Real — O servidor pode enviar comandos instantâneos para o agente (start, stop, update) sem polling excessivo
- Eficiência — Uma única conexão persistente é mantida
🔌 Portas e Direção
A regra de ouro é: O Agente sempre inicia a conexão.
| Parâmetro | Valor |
|---|---|
| Origem | Sua infraestrutura (Agente) |
| Destino | backend.horusbi.com.br (Nuvem) |
| Porta | 443 (HTTPS) |
| Direção | Outbound (Saída) |
TIP
Para a equipe de Infra/Segurança: Não é necessário abrir nenhuma porta de entrada (Inbound) no firewall. Se o servidor onde o agente está instalado consegue acessar a internet via porta 443, o agente funcionará corretamente.
Fluxo de Conexão
- Ao iniciar, o Agente estabelece uma conexão com a nuvem na porta 443
- O handshake de segurança é feito e a conexão WebSocket é estabelecida
- O Agente fica aguardando tarefas através deste túnel já aberto
- Quando você clica em "Executar" na web, o comando desce por esse túnel
⚡ Latência e Performance
Como a conexão é persistente, a latência de comando é mínima (milissegundos). Isso permite que você veja os logs de execução na tela praticamente no mesmo instante em que eles são gerados no servidor local.