Atenção: Este artigo foi inteiramente gerado por IA e ainda não passou por revisão humana. Prossiga com cuidado.
Este artigo explica como a Ema.IA passa a ser instalada diretamente no ambiente do cliente, o que muda no processo de implantação, e como os aplicativos (celular, desktop e navegador) conseguem consultar os dados do ERP sem que a TI do cliente precise abrir portas ou expor o servidor na internet.Este artigo descreve o novo modelo de instalação, com registro automático. Clientes configurados pelo modelo anterior (token gerado no Painel Administrador) continuam funcionando normalmente e serão migrados aos poucos.
--- ### Como a Ema.IA acessa os dados do cliente Os dados do cliente estão no banco de dados do ERP, dentro da rede dele. Já o usuário pode estar em qualquer lugar — inclusive no celular, usando os dados móveis. A pergunta que a TI do cliente sempre faz é: **"Então vocês precisam que eu abra uma porta ou exponha o servidor na internet?"** Não. E o motivo é simples: **invertemos o sentido da conexão**. Junto com a Ema.IA é instalado no servidor do cliente um componente chamado **Runtime Local**. Assim que ele sobe, é **ele** quem liga para o servidor da Ema — e deixa essa ligação aberta o tempo todo. Quando a Ema precisa de alguma informação, ela apenas fala na linha que já está aberta. Pense assim: em vez de a Ema tocar a campainha da casa do cliente (e para isso precisar do endereço e de alguém para abrir o portão), é o cliente que liga para a Ema quando acorda e deixa o telefone fora do gancho. Para o firewall do cliente, isso é apenas uma **saída HTTPS** — o mesmo tipo de tráfego de um navegador abrindo um site. Praticamente toda rede corporativa já libera isso por padrão. ##### - O caminho de uma pergunta Quando o usuário pergunta algo no celular, acontece o seguinte: - O Runtime Local, no servidor do cliente, já está conectado ao servidor da Ema desde que o serviço subiu. - O celular envia a pergunta **apenas para o servidor da Ema**, pela internet normal. - O servidor da Ema repassa o pedido pela conexão que já estava aberta. - O Runtime Local consulta o banco do ERP ali mesmo, dentro da rede do cliente. - O resultado volta pelo mesmo caminho até o celular. O ponto que resolve tudo: **o celular nunca fala com o servidor do cliente**. Ele nem sabe onde esse servidor fica. Os dois lados falam com a Ema, e a Ema faz a ponte. Isso vale igualmente para o aplicativo desktop e para o navegador — nenhum deles precisa estar dentro da rede do cliente. ##### - O que o Runtime Local pode e não pode fazer A conexão aberta não dá acesso livre ao servidor. O Runtime Local só sabe executar aquilo que veio programado dentro dele, e hoje isso é uma coisa só: **consulta de leitura no banco de dados**. - Ele recusa qualquer comando que não seja uma consulta. Não existe caminho para alterar, apagar ou incluir dados. - O volume de linhas retornado por consulta é limitado. - Não existe pasta onde seja possível "soltar" uma função nova: ampliar o que o runtime faz exige uma nova versão do programa, assinada e distribuída pela Ema. - Cada cliente tem sua própria credencial, e o pedido de um cliente nunca alcança o runtime de outro.Para interromper o acesso a qualquer momento, basta parar o serviço no servidor do cliente ou revogar a credencial daquele cliente no Painel Administrador.
--- ### O que muda na implantação: o registro é automático No modelo anterior era necessário gerar um token no Painel Administrador e colá-lo no assistente de configuração dentro do Ema ERP. **Isso não é mais necessário.** Agora, na primeira vez que sobe, o Runtime Local se registra sozinho: - Ele lê a chave de registro que já existe na base do cliente e identifica de qual cliente Ema se trata. - Consulta o servidor da Ema, que confere se a licença é válida e se o cliente tem a Ema.IA contratada. - Recebe a credencial, grava na própria base e já conecta. Se o processo for interrompido no meio (queda de internet, por exemplo), ele simplesmente tenta de novo na próxima vez, sem duplicar nada e sem perder a credencial já criada.O registro automático depende da licença do cliente estar em dia e com a Ema.IA contratada. Se o cliente não aparecer no Painel Administrador depois da instalação, verifique a licença antes de acionar o suporte.
--- ### Onde a Ema.IA é instalada A instalação varia conforme o ambiente do cliente: ##### - Cliente com Ema ERP em servidor É o caso mais comum. A Ema.IA e o Runtime Local são instalados na pasta do Contas ERP, e o Runtime Local é registrado como um **serviço do Windows**, para subir sozinho junto com o servidor, sem depender de alguém estar logado na máquina. ##### - Estação de trabalho Nas máquinas dos usuários é instalado apenas o aplicativo da Ema.IA, na pasta do próprio usuário, sem necessidade de permissão de administrador. Essas máquinas não têm Runtime Local — elas usam o que está no servidor. ##### - Cliente sem Ema ERP Apenas o aplicativo, com atalho no menu iniciar. Não existe Runtime Local nesse caso, pois não há banco do ERP para consultar. As atualizações são automáticas nos três casos. Quando o Runtime Local é atualizado, ele espera as consultas em andamento terminarem antes de reiniciar, e se a nova versão falhar ao subir ele volta sozinho para a versão anterior. --- ### O que precisa ser liberado na rede do cliente Somente a **saída** para o domínio `ema.ia.br`, em HTTPS. Nada de entrada. Para conferir se está liberado, no servidor do cliente abra o link [https://ema.ia.br/api/v1/](https://ema.ia.br/api/v1/) no navegador. Se estiver tudo certo, aparece: ```json {"status":"Running"} ``` Ou, se preferir, pelo PowerShell: ```powershell (Invoke-WebRequest https://ema.ia.br/api/v1/).StatusDescription ``` Se a resposta for diferente de `OK`, existe algo bloqueando a conexão — normalmente o firewall ou o proxy da rede. --- ### Conferindo se a instalação deu certo - O serviço do Runtime Local está em execução no servidor (Serviços do Windows). - O cliente aparece no Painel Administrador Ema.IA. - Uma pergunta feita no aplicativo que dependa de dados do ERP é respondida com os dados corretos. Se algo não funcionar, os registros de funcionamento ficam na pasta `runtime\logs`, dentro da pasta de instalação da Ema.IA no servidor, organizados por data. Eles são o primeiro lugar a olhar e o que o suporte vai pedir. ##### - Situações comuns - **O serviço sobe e fica tentando conectar:** normal enquanto o banco de dados ainda está subindo. Ele tenta sozinho, esperando um pouco mais a cada tentativa. - **O serviço sobe e para logo em seguida:** normalmente configuração de banco incorreta ou credencial recusada. Nesses casos ele para de propósito, para não mascarar o problema — confira o log. - **O cliente não aparece no Painel Administrador:** o registro não foi concluído. Confira a licença e a chave de registro na base. - **A conexão cai quando a máquina hiberna ou troca de rede:** esperado. O runtime percebe sozinho e reconecta, sem precisar de intervenção. --- ### Perguntas frequentes da TI do cliente **Precisa abrir porta no firewall?** Não. Apenas saída HTTPS para `ema.ia.br`. **Precisa de IP fixo, DNS público ou VPN?** Não. **O banco de dados fica exposto na internet?** Não. Só o Runtime Local, de dentro da rede, conversa com o banco. **A Ema consegue alterar dados no sistema?** Não. A única operação disponível é consulta de leitura. **Como interromper o acesso?** Parando o serviço no servidor ou revogando a credencial do cliente no Painel Administrador. --- ### Ficou alguma dúvida? Entre em contato com o suporte da Ema.IA. Se a dúvida for recorrente, atualizaremos este artigo — sugestões são bem-vindas.