Instalação do Agente Local

Conecte seu ERP Winthor à nuvem WebThor de forma segura e eficiente.

Privacidade e Segurança Total

A WebThor NÃO sincroniza nem armazena dados do seu banco de dados na nuvem. O agente atua apenas como um túnel seguro em tempo real. Seus dados permanecem exclusivamente no seu servidor local, garantindo sigilo absoluto.

Baixar Agente Local (v1.0.2)

Tamanho: ~50MB • Formato: .zip

i Pré-requisitos

Sistema Operacional

  • Windows 10, 11 ou Server 2016+
  • Linux (Ubuntu 20.04+ / Debian 11+)
  • Docker Desktop ou Engine instalado

Nota Windows: O Docker utiliza WSL 2. Em alguns casos, o instalador pode solicitar a ativação deste recurso.

Rede e Acesso

  • Acesso à internet (Porta 443)
  • Acesso ao Banco Oracle do Winthor
  • Usuário de banco usado no Winthor

Firewall: Não é necessário abrir portas de entrada. A conexão é apenas de saída (segura).

Entenda a Arquitetura 

┌────────────────────┐
│   Sistema Web      │  ← Você usa aqui (apps WebThor)
│   (WebThor)        │
└─────────┬──────────┘
          │ Internet
          ↓
┌─────────────────────┐
│  Servidor WebSocket │  ← Na nuvem
│  (wss://...)        │
└─────────┬───────────┘
          │ WebSocket Seguro
          ↓
┌─────────────────────┐
│  Docker Container   │  ← >>> Instalação local (na sua rede) <<<
│  ws-sql-client      │    Segurança e privacidade total!
└─────────┬───────────┘    Dados trafegam criptografados, sem sincronização em nuvem
          │ Rede Local
          ↓
┌─────────────────────┐
│  Oracle Winthor     │  ← Seu ERP
│  (192.168.1.50)     │
└─────────────────────┘
1

Instalação do Docker Desktop

Se você já tem o Docker instalado e rodando, pode pular para o próximo passo.

1.1

Baixe o instalador no site oficial: Download Docker Desktop ↗

1.2

Execute o instalador como Administrador.

1.3

Durante a instalação, certifique-se de marcar a opção:
Use WSL 2 instead of Hyper-V (Recomendado).

1.4

Após a instalação, reinicie seu computador.

1.5

Abra o Docker Desktop e aguarde o ícone da baleia (🐋) ficar estático na barra de tarefas.

2

Download e Extração do Agente

Baixe o arquivo client.zip clicando no botão no topo da página e extraia o conteúdo em uma pasta de sua preferência. Recomendamos criar uma pasta na raiz do disco C:

C:\WebThor\Client
3

Configuração (.env)

Dentro da pasta extraída, localize o arquivo .env e edite as variáveis com os dados do seu Oracle/Winthor e com as credenciais do agente (obtidas no portal WebThor).

Onde pegar o CLIENT_ID e o CLIENT_SECRET

Você gera essas credenciais dentro do Portal WebThor. Siga o passo a passo abaixo:

1) Criar conta
Acesse o portal e faça seu cadastro.
2) Fazer login
Entre com seu email e senha (ou Google).
3) Abrir API Keys
Crie a credencial e copie o secret.
Abrir Portal WebThor → API Keys
Se você ainda não estiver logado, o portal vai te levar para a tela de login.
# Credenciais do Banco Oracle (Winthor)
DB_HOST=192.168.1.100
DB_PORT=1521
DB_SERVICE=wint
DB_USER=WINTHOR
DB_PASS=SUA_SENHA_AQUI

# Credenciais do Agente (obtidas no portal WebThor)
CLIENT_ID=00000000000000
CLIENT_SECRET=webthor_seu_secret_aqui

⚠️ Atenção aos Dados de Identificação:

CLIENT_ID: é sempre o CNPJ da empresa (14 dígitos, apenas números).
Importante: use exatamente o mesmo CNPJ cadastrado na página API Keys.

CLIENT_SECRET: É a "senha" do agente. Usada apenas aqui no arquivo .env para garantir que a conexão entre seu servidor e a WebThor seja segura e exclusiva.

Dica: ao criar uma credencial nova em API Keys, o client_secret aparece uma única vez. Copie e guarde com segurança.

Se você perdeu o secret, use o botão Regenerar Secret na página de API Keys (isso invalida o secret anterior).

4

Instalação e Execução

Na pasta onde extraiu os arquivos, execute o script de instalação automática. Este script irá configurar o container Docker e iniciar o serviço.

Windows

Clique duas vezes no arquivo:

deploy.bat

Nota: Pode ser necessário executar como Administrador se o Docker não estiver iniciado.

Linux / Docker Manual

Abra o terminal na pasta e execute:

docker-compose up -d
5

Verificação

Para confirmar se o agente está rodando corretamente, verifique os logs do container:

docker logs -f ws-sql-client

✅ Você deverá ver uma mensagem: "Conectado ao servidor WebSocket com sucesso".

Dúvidas Comuns

Por que preciso instalar o Docker?
O Docker simplifica a instalação ao empacotar tudo que o sistema precisa (Python, driver Oracle, bibliotecas) em um único container. Assim você não precisa instalar e configurar dependências manualmente, evitando conflitos no seu servidor.
Como atualizar para uma nova versão?
Basta executar novamente o arquivo deploy.bat (Windows) ou docker-compose up -d. O sistema baixará automaticamente a versão mais recente e reiniciará o serviço mantendo suas configurações.
O container não inicia ou fecha logo após abrir
  • Verifique se o arquivo .env foi configurado corretamente (sem aspas em excesso).
  • Confirme se o CLIENT_ID inserido é válido.
  • Certifique-se de que o Docker Desktop está rodando (ícone da baleia na barra de tarefas).
  • Veja o erro exato rodando: docker logs ws-sql-client.
Erro de conexão com o Banco Oracle

Verifique:

  • O IP do banco (DB_HOST) está acessível desta máquina? Tente um ping.
  • A porta (DB_PORT) está correta? (Padrão: 1521).
  • Usuário ou senha expirados no Oracle.
  • Firewall do Windows bloqueando saída para a rede local.
O agente precisa estar na mesma máquina do banco?
Não necessariamente. O agente precisa apenas estar em uma máquina que tenha acesso de rede à porta do banco Oracle (geralmente 1521).
Preciso liberar portas no Firewall?
O agente faz uma conexão de SAÍDA para a internet (HTTPS/WSS na porta 443). Geralmente não é necessário abrir portas de entrada, o que torna a solução muito segura.