Documentação LBHM

Agente local

Alguns bancos do seu ambiente não estão acessíveis pela internet — ficam numa máquina da sua rede interna, atrás do firewall. É o caso típico de um arquivo Microsoft Access (.mdb/.accdb), que nem servidor de rede tem: só pode ser lido por um programa que rode ao lado do arquivo.

Para esses casos, o NEXUS Flow usa um agente local: um pequeno programa que você instala na máquina onde está o banco. Ele se conecta para fora, até o NEXUS Flow, busca as consultas que seus fluxos pedem, executa localmente e devolve só o resultado.

Importante: a comunicação é sempre de dentro para fora. O NEXUS Flow nunca inicia conexão para a sua rede — então não é preciso abrir nenhuma porta no seu firewall.

Como funciona, em resumo

  1. Você registra um agente no NEXUS Flow e recebe um token.
  2. Instala o agente na máquina onde está o banco e cola o token.
  3. Cadastra uma conexão (qual banco/arquivo consultar).
  4. Nos fluxos, usa o nó Banco local (via agente) com a consulta SQL.

1. Registrar o agente

  1. No menu, abra Agentes e clique em Novo agente.
  2. Dê um nome que identifique a máquina (ex.: servidor-financeiro).
  3. Ao criar, o token aparece uma única vez — copie e guarde. Ele é a credencial do agente; se perder, gere um novo pela mesma tela.

Na lista de agentes você acompanha o status (online/offline) e o último contato de cada um.

2. Instalar o agente na máquina do banco

Peça ao seu time de TI (ou ao suporte LBHM) para, na máquina onde está o arquivo:

  1. Instalar o Microsoft Access Database Engine 64-bit (o componente que permite ler arquivos .mdb/.accdb).

  2. Colocar o executável do agente numa pasta (ex.: C:\NexusFlowAgent).

  3. Criar o arquivo de configuração agent.json com o endereço do seu NEXUS Flow e o token copiado no passo 1:

    {
  "server_url": "https://SEU-AMBIENTE.nexusflow.lbhm.com.br",
  "agent_token": "cole-o-token-aqui",
  "read_only": true
}

  4. Instalar o agente como serviço do Windows (inicia sozinho com a máquina).

Em poucos segundos o agente aparece como online na tela Agentes.

Somente leitura: por padrão o agente só executa consultas de leitura (SELECT). É o recomendado para a maioria dos casos.

3. Cadastrar a conexão

A conexão diz qual banco o agente vai consultar. Os dados ficam guardados de forma cifrada no NEXUS Flow e são enviados ao agente apenas no momento da consulta.

  1. Abra Credenciais e escolha Banco local (via agente).
  2. Selecione o tipo de banco (ex.: Microsoft Access) e informe o caminho do arquivo na máquina do agente (ex.: C:\dados\base.mdb) e a senha, se houver.
  3. Salve.

4. Usar nos fluxos

No editor, adicione o nó Banco local (via agente) e configure:

  • Agente local — a máquina que vai executar (a que você registrou).
  • Conexão — a credencial "Banco local" do passo anterior.
  • SQL — a consulta, com expressões {{ }} se precisar (ex.: SELECT * FROM Clientes WHERE Codigo = {{ ID }}).

Ao rodar, o nó aguarda o agente executar e devolve uma linha por item, exatamente como o nó Banco SQL. Se o agente estiver offline ou demorar além do tempo limite, o fluxo acusa o erro.

Dúvidas comuns

  • Preciso abrir porta no firewall? Não. O agente só faz conexões de saída.
  • A senha do banco fica na máquina? A conexão é guardada cifrada no NEXUS Flow e enviada ao agente apenas durante a consulta.
  • Posso ter vários agentes? Sim — um por máquina/rede. Cada nó escolhe qual agente usar.
  • Serve só para Access? O Access é o primeiro caso. O mesmo agente pode atender outros bancos da rede interna conforme forem liberados.