FT-BRIDGE-ORACLE· 1.2.3Integrações

Banco Oracle como origem (via lefia-bridge)

Como usar um banco Oracle atrás de VPN como origem, via agente lefia-bridge (read-only).

Atualizado em 8/6/2026

Conecte um banco Oracle que vive atrás de VPN sem expor nada: o lefia-bridge (agente Docker instalado na rede da sua empresa) executa a consulta dentro da rede e envia os resultados pra plataforma por conexões de SAÍDA — nenhuma porta aberta, o banco nunca fica acessível da internet.

Pré-requisito: lefia-bridge instalado e online (guia de instalação gerado na criação do bridge). A imagem precisa incluir o driver Oracle (oracledb).

Configurando a conexão de origem:

Protocolo: Oracle (banco)
Host, Porta (1521) e Service Name do banco
Usuário/senha — recomende um usuário somente-leitura
Query (SELECT): define o que sincronizar (projeção + filtro). Por segurança, o agente executa apenas SELECT — nunca alterações.
Campo chave do documento (opcional): coluna que identifica o registro (ex.: ID) — mesma linha alterada vira atualização, não duplicata.

Fluxo: Testar conexão (valida bridge → banco) → Detectar campos (amostra as primeiras linhas e registra o formato) → Mapping → Agendamento. A partir daí funciona como qualquer origem: dedup por conteúdo, revisões em alteração, monitor e execuções.

Histórico de versões

1.2.3
Rename residual (#432): últimas URLs nexiohub.ai removidas do agente (README + header). Imagem/workflow/guias já eram lefia-bridge; parceiro deve baixar a imagem atual em /admin/bridges.
8/28/2026 · updated
1.2.2
Telemetria: resultado de sql_query carimbava o nome do driver RFC (mock no agente sem SAP SDK) em vez do driver Oracle que executou o job — resultados reais do Oracle apareciam como driver:"mock". executeJob agora carimba executedBy por branch (sql_query → oracle.name: oracledb-thin/mock-oracle). VERSION do agente 0.1.0→0.1.1 pra rastrear pelo heartbeat quando o cliente atualizar a imagem.
8/11/2026 · updated
1.1.4
Fix piloto DQ: os 3 fluxos (create-integration, update-integration, wizard finalize) perdiam as options da origem Oracle — sqlQuery/documentKeyField/bridgeId nunca chegavam em connection.options (conexao nascia sem query, "Conexao Oracle sem query configurada") e base_url ficava com o host cru. extractConnectionOptions + buildBaseUrl aplicados na SOURCE nos tres fluxos no mesmo commit (regra wizard↔manual↔edit). Wizard ainda PULAVA a conexao oracle inteira (gate fields.baseUrl que o protocolo nao tem).
8/10/2026 · updated
1.2.1
Fix: rotas test-connection/test-integration agora passam bridgeContext+options — botão "Testar" de conexão Oracle funciona (SELECT 1 FROM DUAL via bridge). RFC deixou de ser desviado pro teste OData. Testes de regressão do conector Oracle adicionados.
8/9/2026 · updated
1.2.0
Rename técnico fase 1 (rebranding Lefia): agente vira lefia-bridge — env vars LEFIA_URL/LEFIA_BRIDGE_TOKEN/LEFIA_IDOC_SERVER/LEFIA_INTEGRATION_ID, imagem/container/tar.gz lefia-bridge, Program ID SM59 LEFIA_BRIDGE, LefiaClient. Workflow CI, rota de download (Blob privado) e guia de instalação atualizados juntos. Corte limpo sem fallback (nenhum agente em campo). Quem baixou guia/compose antes de 06/08 precisa regenerar (envs NEXIO_* não existem mais).
8/6/2026 · updated
1.1.3
Fix critico de acesso: a whitelist de developer em /admin/* NUNCA funcionou — o layout lia o header x-next-pathname que ninguem setava (pathname sempre vazio → todo developer redirecionado pro /dev em qualquer /admin/*). Pego no piloto DQ: parceiro clicava em Bridges e voltava pra pagina principal. Middleware agora propaga request.nextUrl.pathname no header. isLoginPage do layout tambem passa a funcionar como projetado.
8/4/2026 · updated
1.0.3
Card "Operacao & Infra" no /admin (Bridges + Job Queue + Operations Health, movidos de Plataforma/Suporte, flags por link preservadas) + secao espelho no hub Developer /dev. i18n 3 idiomas nos dois namespaces.
8/3/2026 · updated
1.1.2-a
Botao "Baixar imagem do agente" na tela de Bridges + rota GET /api/admin/bridges/image + workflow publica no Blob (1a iteracao; store privado corrigido no 0f5c51c). Guia atualizado: imagem baixada na plataforma.
8/3/2026 · updated
1.1.2
Imagem do agente baixavel PELA PLATAFORMA: workflow publica o nexio-bridge.tar.gz no Vercel Blob (store PRIVADO, o mesmo dos snapshots) e a tela de Bridges ganha o botao "Baixar imagem do agente" — GET /api/admin/bridges/image serve em STREAMING com a mesma autorizacao escopada (super/support/developer). Nenhuma URL publica; unico caminho e o endpoint autenticado. Guia atualizado (download na plataforma). Parceiro nao precisa de GitHub.
8/3/2026 · updated
1.1.1
Workflow "Build nexio-bridge image" (workflow_dispatch): gera a imagem linux/amd64 e publica como artifact (30 dias) — onde conseguir o nexio-bridge.tar.gz sem Docker local. Dois fixes achados na 1ª build real: (1) oracledb saiu de optionalDependencies (o fallback --omit=optional derrubava o driver Oracle junto quando o node-rfc falhava sem SDK) — agora dependencia normal + sanity require(oracledb) na imagem final; (2) Dockerfile sem SDK quebrava no COPY /usr/local/sap — mkdir incondicional. Run 30800761426 verde.
8/3/2026 · updated
1.1.0
Role DEVELOPER acessa /admin/bridges ESCOPADA aos proprios tenants (resolveBridgeScope): super=tudo, support=leitura cross-tenant, developer=ve/cria/opera bridges SO dos tenants onde tem membership (IDOR-safe server-side nas 3 camadas: layout whitelist, pagina, APIs GET/POST/PATCH/DELETE). Caso real: parceiro DQ cria o bridge e baixa o guia sem depender do super_admin. Titulo/subtitulo da pagina atualizados (SAP + Oracle).
7/31/2026 · updated
1.0.2
Card "Operação & Infra" no /admin (Bridges + Job Queue + Operations Health, MOVIDOS de Plataforma/Suporte com flags de visibilidade preservadas por link) + seção espelho no hub Developer /dev. Guia de instalação do bridge atualizado pra Oracle: intro SAP+Oracle, garantia read-only, pré-requisitos rede 1521 + usuário somente-leitura, verificação oracle=true no heartbeat. Guias já gerados não mudam (estáticos por design); bridges novos saem atualizados. i18n 3 idiomas.
7/31/2026 · updated
1.0.1
Navegação: label "Bridges RFC" → "Bridges (on-premise)" (o bridge agora fala RFC E Oracle) no card Plataforma do /admin + link novo na seção Plataforma do hub Developer (/dev). i18n 3 idiomas.
7/31/2026 · updated
1.0.0
Origem ORACLE via nexio-bridge (opcao B do caso Dataquantica): job sql_query no agente (#79) executa o SELECT dentro da rede do cliente (read-only — agente recusa DML/DDL) e devolve as linhas pela fila outbound-only; banco atras de VPN nunca e exposto, nenhuma API pra construir. Protocolo "oracle" no seletor, test-connection SELECT 1 FROM DUAL via bridge, detect de campos via amostra ROWNUM<=25, executor com ingest COMPARTILHADO com o REST (ingest-records.ts extraido). Driver node-oracledb thin, capability no heartbeat, mock pra dev. ⚠️ Validacao contra Oracle real pendente — caso DQ sera o piloto.
7/30/2026 · new