5. Instalação no Cliente e Acesso aos Dados

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/ no navegador. Se estiver tudo certo, aparece: 

 {"status":"Running"} 

 Ou, se preferir, pelo 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.