import.css=/download/attachments/6062824/tecnologia.css

• WebApp - Configurando nativamente o Application Server como servidor Web
• O WebAgent é compatível com o WebApp 9.0 ou superior, o Application Server 20.3.0.x (Harpia) ou superior, e Lib Protheus 20221010 ou superior.
• O WebAgent ainda passará por homologação para uso com o Logix. (informação atualizada em Out/2022)

📢 Assista esse episódio do Explica aí pra Gente! para conhecer mais sobre a configuração e utilização do WebAgent.

Para uso das rotinas padrão, como cadastros e relatórios, não existe impedimento no uso do ERP sem a utilização do WebAgent.

📢  Existem dois modelos de configuração para download do WebAgent:

1. Configurando a partir do AppServer.INI
   1. Está liberado a partir do WebApp 9.0.3 ou superior
   2. Segue o padrão já conhecido pelos Administradores do Protheus
   3. A configuração precisa ser replicada para cada AppSever.INI do balanceamento de ambientes
      
      
2. Configurando a partir do arquivo JSON
   1. Esta liberado à partir do WebApp 9.0.0
      
   2. O arquivo JSON pode ser configurado uma única vez e compartilhado entre vários AppServers

A partir da versão 1.0.15 do WebAgent, seu instalador será distribuido também no formato MSI para Windows, que permite a instalação remota a partir do serviço de GPO, mais informações acesse aqui.

[WEBAGENT]
VERSION=1.x.x "<ajuste esta opção com a versão correta do WebAgent que será disponibilizado>"
Windows_x86=webagent/web-agent-1.x.x-windows-x86.setup.exe
Windows_x64=webagent/web-agent-1.x.x-windows-x64.setup.exe
Darwin_universal=webagent/web-agent-1.x.x-darwin-universal.dmg
Linux_x64_deb=webagent/web-agent-1.x.x-linux-x64.deb
Linux_x64_rpm=webagent/web-agent-1.x.x-linux-x64.rpm

[WEBAGENT]
VERSION=1.x.x "<ajuste esta opção com a versão correta do WebAgent que será disponibilizado>"
Windows_x86=C:\totvs\files\web-agent-1.x.x-windows-x86.setup.exe
Windows_x64=C:\totvs\files\web-agent-1.x.x-windows-x64.setup.exe
Darwin_universal=C:\totvs\files\web-agent-1.x.x-darwin-universal.dmg
Linux_x64_deb=C:\totvs\files\web-agent-1.x.x-linux-x64.deb
Linux_x64_rpm=C:\totvs\files\web-agent-1.x.x-linux-x64.rpm

[WEBAPP]
Port=5002
ENABLE=1
agentJsonUpdate=webagent.json

{
    "version": "1.x.x","<ajuste esta opção com a versão correta do WebAgent que será disponibilizado>"
    "windows_x86": "webagent\\web-agent-1.x.x-windows-x86-release.setup.exe",
    "windows_x64": "webagent\\web-agent-1.x.x-windows-x64-release.setup.exe",
    "darwin_universal": "20-10-10-p12_smartclient_web-agent_1.x.x_mac-universal.dmg",
    "linux_x64_deb": "webagent\\web-agent.deb",  
    "linux_x64_rpm": "webagent\\web-agent.rpm"
}

{
    "version": "1.x.x", "<ajuste esta opção com a versão correta do WebAgent que será disponibilizado>"
    "windows_x86": "webagent/web-agent-1.x.x-windows-x86-release.setup.exe",
    "windows_x64": "webagent/web-agent-1.x.x-windows-x64-release.setup.exe",
    "darwin_universal": "20-10-10-p12_smartclient_web-agent_1.x.x_mac-universal.dmg",
    "linux_x64_deb": "webagent/web-agent.deb",  
    "linux_x64_rpm": "webagent/web-agent.rpm"
}

[WEBAGENT]
Port=21021
...

Esta implementação foi feita exclusivamente para Windows.

[WEBAGENT]
Windows_x86_extras=C:\totvs\files\DLL_SIGALOJA_Win32.zip
Windows_x64_extras=C:\totvs\files\DLL_SIGALOJA_Win64.zip

O popup para instalação deixará de ser exibido assim que a primeira conexão entre o WebAgent e o Navegador for bem sucedida, para que não induza o usuário a instalar mais de uma vez a ferramenta.

O checkbox "Não mostrar novamente" pode ser usado caso o usuário não precise instalar o WebAgent, e também não queira que esta opção continue sendo exibida.

🚨 A atualização automática do WebAgent foi implementada apenas para o Windows, e acontecerá sempre que o Administrador do ERP atualizar a versão do WebAgent nos arquivos de configuração.

       Para Linux e macOS é necessário informar a senha do administrador do computador no momento da instalação/atualização, impossibilitando a atualização automática.

O registro do certificado de segurança para conexão entre o WebAgent e o navegador é automático a partir da versão 1.0.15.

Para versões anteriores este registro deve ser feito manualmente, mais detalhes acesse aqui.

sudo apt install ./web-agent<versao>.deb

chmod +x ./web-agent<versao>.deb

sudo dnf install oracle-epel-release-el9
sudo dnf update

sudo dnf install libappindicator-gtk3

🚨 O processo abaixo, para habilitar a exibição do ícone da bandeja do WebAgent, é necessário apenas para o desktop GNOME, caso utilize desktops como o XFCE ou KDE Plasma, pode pular este passo.

sudo dnf install gnome-extensions-app gnome-shell-extension-appindicator 

sudo dnf install ./web-agent<versao>.rpm

chmod +x ./web-agent<versao>.deb

O WebAgent, como qualquer aplicação que não seja disponibilizada via Apple Store, precisa ser autorizado manualmente para execução.

Este é o link para documentação oficial para o macOS Sequoia 15: https://support.apple.com/pt-br/guide/mac-help/mh40616/mac

Para consultar outra versão do sistema operacional, selecione a versão correta:

Caso esteja instalando pela primeira vez o WebAgent, será necessário proceder com o registro do Certificado SSL, mais detalhes acesse aqui.

Utilize os certificados disponibilizados na pasta de instalação do WebAgent, não utilize os certificados da pasta de instalação do AppServer.

Durante a primeira execução do WebAgent, caso seja apresentada a tela de confirmação para o registro do certificado, selecione a opção "SIM", "OK" ou "CONFIRMAR", essa opção que pode variar dependendo da versão do Windows em uso.

Na configuração do Firefox pode estar desabilitada a utilização de certificados do sistema, causando falha na conexão com o WebAgent, é necessário habilitar os certificados da seguinte maneira:

• Na barra de navegação digite: about:config
  
  
  
• Clicar em "Aceitar o risco e continuar"
  
  
  
• Na barra de pesquisa digite: security.enterprise_roots.enabled e mude a opção para true (verdadeiro) clicando no botão a direita.
  

A partir da versão 1.0.15 do WebAgent, seu instalador para Linux fará automaticamente o registro do certificado para conexão com o navegador, não sendo mais necessários os passos abaixo.

Importante: O processo de registro do certificado deve ser feito uma unica vez, atualizações do WebAgent assumirão o certificado já registrado automaticamente.

O WebAgent, como qualquer aplicação que não seja disponibilizada via Apple Store, precisa ter seus certificados instalados manualmente para execução.

Este é o link para documentação oficial para o macOS Sequoia 15: https://support.apple.com/pt-br/guide/keychain-access/kyca2431/mac

Para consultar outra versão do sistema operacional, selecione a versão correta:

Este processo deve ser executado para dois arquivos, o totvs_certificate_CA.crt e o arquivo totvs_certificate.crt.

🚨 No macOS Sequoia, o atalho pro Keychain mudou, sendo acessado pelo caminho: /System/Library/CoreServices/Applications/Keychain Access.app

O Firefox não respeita a instrução para ser instanciado sem as Abas e endereço de URL, seja em Windows ou Linux, mas sua operação ocorre normalmente utilizando o launch.

Durante a primeira execução com comando launch, a janela pode não ser exibida de forma maximizada, impedindo uma melhor experiência, maximize a janela, e nas próximas execuções o navegador irá respeitar o estado em que foi encerrado.

Importante: O comando launch deve obrigatóriamente ser o primeiro da linha de comando, exemplo:

web-agent launch...

Quando utilizado o comando launch, o WebAgent iniciará em uma porta aleatória, permitindo multiplas execuções, cada uma em sua porta específica.

*Para execução de aplicações que não utilizam interface, como processamentos e execução de jobs, utilize a opção --headless, mais informações acesse aqui.

webagent launch "ip+porta+[parâmetros<opcional>]" --browser="caminho para o navegador"

C:\Users\Administrator\AppData\Local\Programs\web-agent\web-agent.exe launch "http://10.173.9.215:5011?E=padrao&P=SIGAFAT&A=param1&A=param2&A=param3" --browser="C:\Program Files\Google\Chrome\Application\chrome.exe"

/opt/web-agent/web-agent launch "http://10.173.9.215:5011?E=padrao&P=SIGAFAT&A=param1&A=param2&A=param3" --browser="/usr/bin/microsoft-edge"

webagent launch "ip+porta+[parâmetros<opcional>]" --browser="caminho para o navegador" --headless

C:\Users\Administrator\AppData\Local\Programs\web-agent\web-agent.exe launch "http://10.173.9.215:5011?E=padrao&P=u_headless" --browser="C:\Program Files\Google\Chrome\Application\chrome.exe" --headless

/opt/web-agent/web-agent launch "http://10.173.9.215:5011?E=padrao&P=u_headless" --browser="/usr/bin/microsoft-edge" --headless

/Applications/web-agent.app/Contents/MacOS/web-agent launch "http://10.173.9.215:5011?E=padrao&P=u_headless" --browser="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless

O navegador Safari, no MacOS, não suporta o modo headless.

O Mozilla Firefox, em Linux e modo headless, pode recusar os certificados de autoridade CA já registrados, impossibilitando o uso.

É possível utilizar policies.json do navegador para contornar esse problema:

• Na pasta de instalação do Firefox (que depende do Linux utilizado, por exemplo /opt/firefox/ ou /usr/lib/firefox/)
• Localize a pasta distribution
• Crie nessa pasta um arquivo com o nome de policies.json com o conteúdo abaixo, apontando para o arquivo totvs_certificate_CA.crt da pasta de instalação do WebAgent:

{
"policies": {
"Certificates": {
    "ImportEnterpriseRoots": true,
    "Install" [
               "/opt/web-agent/totvs_certificate_CA.crt"
               ]
         }
    }
}

Utilizar o Windows 64 bits, porém ferramentas 32 bits, nesse caso será necessária a instalação do WebAgent 32 bits para integração com:

• Pacote Microsoft Office 32bits;
• DLLs 32 bits, para por exemplo, integração de equipamentos, como impressoras, balanças, caixas registradoras, etc.

Utilizar o Windows 64 bits, o Office 32 bits e uma integração com DLLs 64 bits (o inverso pode ocorrer).

Este cenário é mais complexo, faremos o mesmo processo que já era conhecido nessa situação para o SmartClient Desktop, manteremos duas instalações do WebAgent na estação do usuário, uma 32 e uma 64 bits.

Ao fim do processo abaixo, iremos executar cada WebAgent a partir do parâmetro launch:

1. Baixe os WebAgents nas duas arquiteturas, x86(32bits) e x64(64bits), seja a versão .EXE ou a versão .MSI. (clique nas imagens para melhor visualização)
   
   
   
   
2. Instale o WebAgent 32bits
3. Na sequência, faça uma coṕia da pasta de instalação, e renomeie essa cópia, inserindo o texto 32, exemplo:
   1. De...: C:\Users\seu_usuario_aqui\AppData\Local\Programs\web-agent\
   2. Para: C:\Users\seu_usuario_aqui\AppData\Local\Programs\web-agent32\
      
      
4. Instale agora o WebAgent 64bits
5. Esta segunda instalação irá sobrepor a anterior
   
   
6. Ao fim deste processo, você terá duas cópias do WebAgent, uma em cada arquitetura.
   
   
   
   
7. Ao executar o WebAgent, será necessário verificar a arquitetura da aplicação que deseja utilizar/integrar, consulte o administrador de seu ambiente caso tenha dúvidas, no exemplo abaixo, partiremos do princípio que faremos a integração com o Microsoft Office 32bits.
   
   
8. Abra o WebAgent 32bits a partir da linha de comando, utilizando o parâmetro launch, se seguiu nosso exemplo à risca, a linha de comando será a seguinte:
   C:\Users\seu_usuario_aqui\AppData\Local\Programs\web-agent32\web-agent.exe launch "http://127.0.0.1:5021/webapp/" --browser="C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
   
   Sintaxe do comando:

   web-agent.exe launch "ip:porta para o Servidor do WebApp" --browser="caminho completo para seu navegador"

   
   🚨Este processo pode ser simplificado para o usuário, criando um atalho em seu Desktop.
   
   
9. Ao executar este comando, será apresentada a rotina em uma tela destacada do navegador, com uma porta específica do WebAgent, escolhida automaticamente, proceda com o uso normal do ERP.
   
   
   
10. Continuando no exemplo, imagine que agora você precisa utilizar o ERP com uma impressora que depende da integração com uma DLL 64bits.
11. O ponto mais importânte é que você pode manter o WebAgent 32bits em execução, e repetir o processo agora para o WebAgent 64bits, pois cada um deles irá utilizar uma porta específica, não influenciando no processo um do outro.
    
    
12. Abra agora o WebAgent 64bits, seguindo nosso exemplo inicial:
    C:\Users\seu_usuario_aqui\AppData\Local\Programs\web-agent\web-agent.exe launch "http://127.0.0.1:5021/webapp/" --browser="C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
    
    
13. A partir deste ponto, a configuração está concluída.

Para verificar a arquitetura de seu pacote Microsoft Office clique aqui ou acione o suporte da Microsoft.

Para verificar a arquitetura das DLLs de alguma ferramenta que utilize, acione o suporte do equipamento ou ferramenta em questão.

O WebAgent não é homologado para navegadores utilizados a partir de Metaframes, RDPs ou Web enablers, como:

• Citrix;
• Windows Remote Desktop;
• Go Global.

Devido à simplificação na montagem do ambiente com o  WebApp, nossa arquitetura não depende das ferramentas acima para operação dos ERPs Protheus/Logix.

O WebAgent não é homologado para sistemas operacionais :

• ChromeOS/ChromeOS Flex
• iOS
• iPadOs
• Android

A homologação de uma distro base Linux permite o uso se suas flavors e spins Oficiais, pois essas variantes mantém as mesmas bibliotecas que sua base, exemplo:

• Ao homologar o Ubuntu 24.04, que utiliza o GNOME como interface/desktop, permite o uso de suas flavors, como Xubuntu, Kubuntu, etc, mais informações no link abaixo:
  • Ubuntu flavours | Ubuntu
• Ao homologar o Fedora 41,que também utiliza o GNOME como interface/Desktop, permite o uso de suas seus spins, como Fedora XFCE ou Fedora KDE Plasma, mais informações no link abaixo:
  • Fedora Spins | The Fedora Project

🚨Isso não significa que os spins são Homologados, eles serão mantidos como "Suportados", havendo diferenças de comportamentos nos flavors e spins, cada caso será avaliado, podendo impedir o suporte a essa determinada distro.

Window 32 e 64 bits

• Windows 10 Pro/Enterprise => Término do Suporte pela Microsoft em 14/Out/2025, mais informações aqui.
• Windows 11 Pro/Enterprise

Linux 64 bits

• Ubuntu 22.04 LTS (recomendamos o uso do Ubuntu 24.04 LTS)
• Ubuntu 24.04 LTS ou superior (a partir do WebAgent 1.0.15)

• Fedora 41 (a partir do WebAgent 1.0.15)

• Oracle Linux 9.x (a partir do WebAgent 1.0.15)
  
  

• Red Hat Enterprise Linux Desktop 8.x

  • 🚨 Recomendamos o uso do Fedora ou do Oracle Linux, ambas distros gratuitas, e com a mesma base do Red Hat.

macOS x86_64 e Universal(ARM64) 

• macOS 13.6 Ventura ou superior
  

🚨 A tentativa de utilizar a versão Universal em macOS anterior resultará no erro abaixo:

Esta seção manterá informações sobre os Sistemas Operacionais em processo de homologação para o WebAgent.

As datas de inicio e finalização da homologação poderão sofrer alterações dependendo do processo.