Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

...

Nota
iconfalse

📢  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
Aviso
iconfalse
titleImportante

🚨 Após ajustar as configurações abaixo, é necessário reiniciar o/s AppServer/s.

...

Nota

...

icon

...

false

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.

Aviso
iconfalse
titleImportante

🚨 Para atualização automática aceitar o instalador no formato MSI, a versão mínima do WebAgent deve obrigatoriamente ser a 1.0.15.

Âncora
InstAdmin1
InstAdmin1

1. Configurando o download do WebAgent a partir do arquivo AppServer.INI(topo)

Para consultar todas as opções de configuração acesse aqui.

...

Para consultar todas as opções de configuração acesse esse link.

ParâmetroDescriçãoObservações
VERSION
Define a versão dos instaladores do WebAgent disponíveis pra download
  • Sempre que atualizar os instaladores na pasta de download é necessário atualizar também sua versão no arquivo AppServer.INI;
  • O versão pode ser alterada tanto para update quanto para downgrade do WebAgent.
PORT(opcional)

Habilita uma porta específica para o WebAgent de todos os usuários

  • Essa configuração impede que os usuários alterem a porta do WebAgent.
  • 🚨 Importante: Essa configuração impede que os usuários utilizem o ERP sem o WebAgent instalado/registrado em suas estações.

...

ParâmetroDescrição
Windows_x86
Windows 10/11 32 bits
Windows_x64
Windows 10/11 64 bits
Darwin_universal
masOS 64 bits Universal Apps(mais informações aqui)
Linux_x64_deb
Linux 64 bits pacote DEB (Ubuntu)
Linux_x64_rpm
Linux 64 bits pacote RPM (Fedora, Oracle Linux e Red Hat)
Bloco de código
languagec#
themeRDark
titleExemplo de Configuração do WebAgent via AppServer.INI - Linux - Usando path relativo (diretório atual do AppServer)
[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

...

Ao habilitar essa chave, a opção "Habilita/Desabilita o Agente Local" não será mais exibida na tela de configuração para o usuário.

Image Modified

Âncora

...

InstAdmin4

...

InstAdmin4

4. Atualização automática de arquivos extras, exemplo, SIGALOJA.DLL (topo)

Acessando a Tela de Parâmetros do WebApp, agora será exibida a tela para download dos instaladores:

Nota
titleImportante

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 do WebAgent será automática após sua intalação, e acontecerá sempre que o Administrador do ERP atualizar a versão.

Image Removed

O instalador vai sugerir o Sistema Operacional e a Arquitetura(32/64 bits).
Caso utilize o Windows 64 bits, mas precise integrar o ERP com o Microsoft Office 32 bits, poderá baixar o WebAgent 32 bits, mais detalhes aqui.

Image Removed

...

Image Removed Instalando no Windows (topo)

Após o download do instalador, basta iniciar sua instalação, que irá seguir sem intervenção do usuário.

Image Removed

O programa ficará disponível no menu, como neste exemplo utilizando o Windows 11.

Image Removed

O WebApp irá iniciar o WebAgent sempre que necessário, mais detalhes consulte a seção Habilitar WebAgent na Tela de Parâmetros.

Apenas para testes, você pode iniciar o WebAgent manualmente, ele será exibido na bandeja de ícones:

Image Removed

...

Image Removed Instalando no Linux (topo)

Após baixar o arquivo para o seu respectivo Linux, sendo o arquivo .deb para Ubuntu e .rpm para o Red Hat.

Image Removed Ubuntu

Bloco de código
languagebash
themeRDark
titleNo diretório onde o arquivo .deb foi copiado
sudo apt install ./web-agent<versao>.deb
Bloco de código
languagebash
themeRDark
titleCaso tenha problema durante a instalação, o comando abaixo define o arquivo como um instalador, execute e na sequencia repita o comando acima
sudo chmod +x ./web-agent<versao>.deb
Aviso
iconfalse
title🚨 Importante

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

Image Removed Red hat 8.x

Bloco de código
languagebash
themeRDark
titlePré requisito: Necessário instalar a biblioteca libappindicator
sudo dnf install libappindicator-gtk3
Bloco de código
languagebash
themeRDark
titleNo diretório onde o arquivo .rpm foi copiado
sudo dnf install ./web-agent<versao>.rpm
Bloco de código
languagebash
themeRDark
titleCaso tenha problema durante a instalação, o comando abaixo define o arquivo como um instalador, execute e na sequencia repita o comando acima
sudo chmod +x ./web-agent<versao>.rpm
Informações
iconfalse

🚨 Na sequencia, será necessário habilitar o system tray para o WebAgent, mais informações acesse aqui.

Aviso
iconfalse
title🚨 Importante

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

...

Resultado de imagem para logo apple 2020 pngImage Removed Instalando no macOS (topo)

Aviso
iconfalse
title🚨 Importante

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:

Image Removed

Este exemplo de instalação/autorização se baseia no macOS Sequoia. (💡 Dica: Clique nas imagens para melhor visualização )

Após baixar o arquivo de instalação para macOS (Universal), com a extenção .dmg, execute o instalador e na sequencia arraste o web-agent para pasta Aplicações (Applications)

Image Removed

Caso esteja atualizando o web-agent, pressione o botão Atualizar (Replace)

Image Removed

Abra o web-agent na pasta Aplicações e pressione o botão Done

Image Removed

Acesse as configurações do seu Mac e na sequencia Privacidade e Segurança (Privacy & Security)

Role até localizar a seção Segurança (Security) e na sequencia clique em Abrir Mesmo Assim (Open Anyway)

Image Removed

Confirme, cliquando em Abrir Mesmo Assim (Open Anyway)

Image Removed

Clique em Use sua Senha (Use Password)

Image Removed

Digite o usuário e senha de um usuário com autorização de Administrador do equipamento

Clique no botão OK para autorizar a execução do WebAgent

Image Removed

Aviso
iconfalse
title🚨 Importante

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

...

A partir do WebAgent 1.0.15,é possivel definir a atualização automática de arquivos extras, como por exemplo, os arquivos do FrontLoja.

Esta implementação foi feita exclusivamente para Windows.

As chaves a seguir definem o caminho para um arquivo ZIP, que deverá conter a estrutura de diretórios e arquivos que o cliente deseja descompactar na pasta do WebAgent.

📢 Estas chaves estão disponiveis tanto no arquivo AppServer.INI quanto no arquivo JSON de configuração.

ParâmetroDescrição
Windows_x86_extras
Caminho para o arquivo ZIP que deverá conter a estrutura de diretórios e arquivos, na arquitetura 32 bits, que será descompactada na pasta do WebAgent.
Windows_x64_estras
Caminho para o arquivo ZIP que deverá conter a estrutura de diretórios e arquivos, na arquitetura 64 bits, que será descompactada na pasta do WebAgent.
Bloco de código
languagec#
themeRDark
titleTrecho do arquivo AppServer.ini
[WEBAGENT]
Windows_x86_extras=C:\totvs\files\DLL_SIGALOJA_Win32.zip
Windows_x64_extras=C:\totvs\files\DLL_SIGALOJA_Win64.zip

Âncora
InstUser
InstUser

Para o usuário do ERP (topo)

Acessando a Tela de Parâmetros do WebApp, agora será exibida a tela para download dos instaladores:

Nota
titleImportante

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 do WebAgent será automática após sua intalação, e acontecerá sempre que o Administrador do ERP atualizar a versão.

Image Added

O instalador vai sugerir o Sistema Operacional e a Arquitetura(32/64 bits).
Caso utilize o Windows 64 bits, mas precise integrar o ERP com o Microsoft Office 32 bits, poderá baixar o WebAgent 32 bits, mais detalhes aqui.

Image Added

Âncora
InstWindows
InstWindows

Image Added Instalando no Windows (topo)

Após o download do instalador, basta iniciar sua instalação, que irá seguir sem intervenção do usuário.

Image Added

O programa ficará disponível no menu, como neste exemplo utilizando o Windows 11.

Image Added

O WebApp irá iniciar o WebAgent sempre que necessário, mais detalhes consulte a seção Habilitar WebAgent na Tela de Parâmetros.

Apenas para testes, você pode iniciar o WebAgent manualmente, ele será exibido na bandeja de ícones:

Image Added

Âncora
InstLinux
InstLinux

Image Added Instalando no Linux (topo)

Após baixar o arquivo para o seu respectivo Linux, sendo o arquivo .deb para Ubuntu e .rpm para o Fedora, Oracle Linux e Red Hat.

Image Added Ubuntu

Bloco de código
languagebash
themeRDark
titleNo diretório onde o arquivo .deb foi copiado
sudo apt install ./web-agent<versao>.deb
Bloco de código
languagebash
themeRDark
titleCaso tenha problema durante a instalação, o comando abaixo define o arquivo como um instalador, execute e na sequencia repita o comando acima
sudo chmod +x ./web-agent<versao>.deb
Aviso
iconfalse
title🚨 Importante

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

Image AddedFedora, Image AddedOracle Linux e Image Added Red Hat (utilizando o desktop GNOME) 

Bloco de código
languagebash
themeRDark
titlePré requisito EXCLUSIVO para o Oracle Linux 9.x, antes da instalação da libappindicator
sudo dnf install oracle-epel-release-el9
sudo dnf update
Bloco de código
languagebash
themeRDark
titlePré requisito: Necessário instalar a biblioteca libappindicator
sudo dnf install libappindicator-gtk3
Bloco de código
languagebash
themeRDark
titleNo diretório onde o arquivo .rpm foi copiado
sudo dnf install ./web-agent<versao>.rpm
Bloco de código
languagebash
themeRDark
titleCaso tenha problema durante a instalação, o comando abaixo define o arquivo como um instalador, execute e na sequencia repita o comando acima
sudo chmod +x ./web-agent<versao>.rpm
Informações
iconfalse

🚨 Na sequencia, será necessário habilitar o system tray para o WebAgent, mais informações acesse aqui.

Aviso

Para utilizar o Websocket Secure (wss) é necessário registrar o TOTVS Certificate em seu sistema operacional.

Aviso
iconfalse
title🚨 Importante

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

...

Image Removed Para usuários Windows (automático) (topo)

O registro é automático para Windows 10/11, 32 ou 64 bits, e será efetivado na primeira execução do WebAgent.

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
Image Removed
Clicar em "Aceitar o risco e continuar"
Image Removed
  • Na barra de pesquisa digite: security.enterprise_roots.enabled e mude a opção para true (verdadeiro) clicando no botão a direita.
    Image Removed
  • Informações
    iconfalse
    title🚨 Importante

    Durante a primeira execução do WebAgent, caso seja apresentada a tela de confirmação para Caso esteja instalando pela primeira vez o WebAgent, será necessário proceder com 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.

    Image Removed

    Informações
    titleDicas para configuração do Firefox

    ...

        Image Removed Ubuntu    

    • Após a instalação o WebAgent
    • Localize o arquivo totvs_certificate_CA.crt na pasta /opt/web-agent
    • Acesse seu navegador e efetue o registro:

      Informações
      iconfalse
      titlePara o Google Chrome
      • Na barra de navegação digite: chrome://settings/certificates
      • Acesse: Authorities (autoridades)
      • Na sequência: Import (importar)
      • Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
      • Selecione todos os Trusts, e por fim, o botão OK
        Image Removed
      Informações
      iconfalse
      titlePara o Microsoft Edge
      • Na barra de navegação digite: edge://settings/privacy/manageCertificates

      • Acesse: Authorities (autoridades)

      • Na sequência: Import (importar)

      • Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
      • Selecione todos os Trusts e Okay
        Image Removed

      Informações
      iconfalse
      titlePara o Firefox
      • Na barra de navegação digite: about:preferences#privacy

      • Acesse: View Certificates… (verificar certificados)

      • Acesse: Authorities (autoridades)

      • Na sequência: Import (importar)

      • Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
      • Selecione todos os Trusts e OK
        Image Removed

       Image Removed Red Hat 8.x

    ...

    Certificado SSL, mais detalhes acesse aqui.

    Âncora
    InstMacOS
    InstMacOS

    Resultado de imagem para logo apple 2020 pngImage Added Instalando no macOS (topo)

    Aviso
    iconfalse
    title🚨 Importante

    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:

    Image Added

    Este exemplo de instalação/autorização se baseia no macOS Sequoia. (💡 Dica: Clique nas imagens para melhor visualização )

    Após baixar o arquivo de instalação para macOS (Universal), com a extenção .dmg, execute o instalador e na sequencia arraste o web-agent para pasta Aplicações (Applications)

    Image Added

    Caso esteja atualizando o web-agent, pressione o botão Atualizar (Replace)

    Image Added

    Abra o web-agent na pasta Aplicações e pressione o botão Done

    Image Added

    Acesse as configurações do seu Mac e na sequencia Privacidade e Segurança (Privacy & Security)

    Role até localizar a seção Segurança (Security) e na sequencia clique em Abrir Mesmo Assim (Open Anyway)

    Image Added

    Confirme, cliquando em Abrir Mesmo Assim (Open Anyway)

    Image Added

    Clique em Use sua Senha (Use Password)

    Image Added

    Digite o usuário e senha de um usuário com autorização de Administrador do equipamento

    Clique no botão OK para autorizar a execução do WebAgent

    Image Added

    Aviso
    iconfalse
    title🚨 Importante

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

    Âncora
    Certificado
    Certificado

    Registrando o certificado SSL para uso do WebAgent (topo)

    ...

    Para utilizar o Websocket Secure (wss) é necessário registrar o TOTVS Certificate em seu sistema operacional.

    Aviso
    iconfalse
    title🚨 Importante

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

    Âncora
    CertWin
    CertWin

    Image Added Para usuários Windows (automático) (topo)

    O registro é automático para Windows 10/11, 32 ou 64 bits, e será efetivado na primeira execução do WebAgent.

    Informações
    iconfalse
    title

    ...

    Copie o certificado da pasta do web-agent para a pasta de certificados

    ...

    Registre o certificado

    ...

    • trust list | grep TO    
      label: TOTVS certificate CA

    ...

    🚨 Importante

    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.

    Image Added

    Informações
    titleDicas para configuração do Firefox

    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
      Image Added

    • Clicar em "Aceitar o risco e continuar"
      Image Added

    • Na barra de pesquisa digite: security.enterprise_roots.enabled e mude a opção para true (verdadeiro) clicando no botão a direita.
      Image Added

    Âncora
    CertLinux
    CertLinux

    Image Added Para usuários Linux(topo)

    Informações

    ...

    Este processo deve ser executado para dois arquivos, o 
    Aviso
    iconfalse
    title🚨 Importante

    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:

    Image Removed

    Informações
    iconfalse
    title🚨 Importante

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

        Image Added Ubuntu    

    Este exemplo de registro do certificado se baseia no macOS Sequoia.  (💡 Dica: Clique nas imagens para melhor visualização )

    ...

    • Após a instalação o WebAgent
    • Localize o arquivo totvs_certificate_CA.crt na pasta /opt/web-agent
    • Acesse seu navegador e efetue o registro:

      Informações
      iconfalse
      titlePara o Google Chrome
      • Na barra de navegação digite: chrome://settings/certificates
      • Acesse: Authorities (autoridades)
      • Na sequência: Import (importar)
      • Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
      • Selecione todos os Trusts, e

    ...

      • por fim, o botão OK
        Image Added
      Informações
      iconfalse
      titlePara o Microsoft Edge
      • totvs_certificate_CA.crt na pasta /

    ...

      • opt/web-agent

    ...

    Ao confirmar as informações, se for solicitado usuário e senha, utilize um usuário com acesso de administrador.

    ...

    Para habilitar o uso do WebAgent pelo WebApp, na Tela de Parâmetros, selecione o botão de configuração.

    Image Removed

    Escolha a porta de inicialização do WebAgent (por padrão é a 21021).

    Image Removed

    Na sequencia feche essa janela clicando no X na parte superior da janela de configuração.

    Image Removed

    Ao confirmar os dados na Tela de Parâmetros será exibida a mensagem abaixo, solicitando autorização para abertura do WebAgent, basta clicar no botão Abrir.

    Image Removed

    Caso a conexão com o WebAgent falhe ou a solicitação de autorização seja ignorada, será exibida a mensagem de erro a seguir:

    Image Removed

    ...

    O WebAgent pode ser iniciado via linha de comando, os parâmetros podem ser usados em conjunto, as opções são:

    ...

    Exibe help com essas opções

    ...

    Inicia o WebAgent em console(linha de comando) omitindo o systray(icone na bandeja), nesse exemplo iniciamos o WebAgent em console na porta 21023:

    web-agent -c --port 21023

    ...

    Exibe a versão do WebAgent, exemplo:

    web-agent -v
    v1.0.9-RC3 - x64

    ...

    Abre o WebAgent via systray (default)

    ...

    Define uma porta específica para o WebAgent (a porta padrão é a 21021)

    ...

    0 (default):  Desabilita o log de execução;
    1:
    Habilita a geração de log de execução (necessário apenas quando solicitado por nosso Suporte).

      • Selecione todos os Trusts e Okay
        Image Added

      Informações
      iconfalse
      titlePara o Firefox
      • Na barra de navegação digite: about:preferences#privacy

      • Acesse: View Certificates… (verificar certificados)

      • Acesse: Authorities (autoridades)

      • Na sequência: Import (importar)

      • Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
      • Selecione todos os Trusts e OK
        Image Added

            Image AddedFedora, Image AddedOracle Linux e Image Added Red Hat

    • Para Google Chrome e Firefox o registro do certificado segue os mesmos passos do Ubuntu.

      Informações
      iconfalse
      titlePara o Microsoft Edge
      • O Edge utiliza o certificado do Sistema Operacional, proceda da seguinte forma para o registro:

        • Copie o certificado da pasta do web-agent para a pasta de certificados

          • sudo cp /opt/web-agent/totvs_certificate_CA.crt /etc/pki/ca-trust/source/anchors/

        • Registre o certificado

          • sudo update-ca-trust

        • Verifique se o certificado foi instalado
          • trust list | grep TO    
            label: TOTVS certificate CA
    • Acesse os links abaixo para mais informações:

    Âncora
    CertMacOS
    CertMacOS

    Resultado de imagem para logo apple 2020 pngImage Added Para usuários macOS(topo)

    Aviso
    iconfalse
    title🚨 Importante

    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:

    Image Added

    Informações
    iconfalse
    title🚨 Importante

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

    Este exemplo de registro do certificado se baseia no macOS Sequoia.  (💡 Dica: Clique nas imagens para melhor visualização )

    Após instalar o WebAgent, localize o arquivo totvs_certificate_CA.crt na pasta /Applications/web-agent.app/Contents/MacOS
    Image Added
    No App Acesso às Chaves (Keychain Access) Image Added, selecione Sistema (System), e nasequência Certificados (Certificates).

    ...

    Permite abrir uma janela destacada do navegador a partir do WebAgent.

    Image Removed

    Aviso
    iconfalse
    title🚨 Importante

    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.

    Informações
    titleDicas importantes

    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.

    Bloco de código
    languagebash
    themeRDark
    titleSintaxe
    webagent launch "ip+porta+[parâmetros<opcional>]" --browser="caminho para o navegador"

    Exemplos:

    Nos exemplos abaixo será aberto o SIGAFAT e preenchidos os parâmetros de abertura (&A=), artificio utilizado em produtos como SIGALOJA, e útil em algumas customizações.

    ...

    languagebash
    themeRDark
    titleExemplo de abertura do WebAgent em linha de comando em Windows

    ...

    Importante

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


    Image Added

    Arraste o arquivo do certificado para o App Acesso às Chaves (Keychain Access).
    Image Added

    Configure a confiança do certificado, clicando com o botão direito do mouse sobre o arquivo, e escolhendo a opção Obter Informações (Get Info).
    Image Added

    Expanda a opção Confiança (Trust), e coloque Confiar Sempre (Always Trust)para todas as opções disponíveis.
    Image Added

    Ao confirmar as informações, se for solicitado usuário e senha, utilize um usuário com acesso de administrador.

    Âncora
    AbleSystray
    AbleSystray

    Habilitando o icone da bandeja (topo)

    ...

    Informações
    iconfalse

    Este processo é necessário em distros Linux como FedoraOracle Linux e Red Hat, que utilizam o GNOME como desktop padrão, mas não possuem suporte nativo ao system tray, caso utilize, por exemplo, o Fedora com Desktop XFCE, este processo não é necessário.

    📢 Este processo não é necessário no Ubuntu.

    💡 Dica: Clique nas imagens para melhor visualização

    Abra o Firefox, digite about:addons na barra de endereços, e na sequencia procure por GNOME.

    Image Added

    Selecione GNOME Shell integration

    Image Added

    Pressione Adicionar ao Firefox (Add to Firefox)

    Image Added

    Pressione Adicionar (Add)

    Image Added

    Selecione a opção Permitir esta extensão em janelas privativas, e na sequência, pressione Okay

    Image Added

    Na barra de endereços do Firefox digite https://extensions.gnome.org/ , busque por appindicator e selecione a opção AppIndicator and KStatusNotifierItem Support.

    Image Added

    Selecione a opção OFF para instalar a extensão.

    Image Added

    Pressione Instalar (Install).

    Image Added

    Na sequência, a opção mudará automáticamente para ON.

    Image Added

    Apenas para teste, já que o proprio navegador irá instanciar o WebAgent, siga os passos a seguir:

    Bloco de código
    languagebash
    themeRDark
    titleExemplo de abertura do WebAgent em linha de comando em Linux
    cd /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"

    Lista de parâmetros disponíveis:

    ...

    Indica o nome do ambiente que será utilizado para definições gerais.

    ...

    (seleção) O parâmetro de linha &A pode ser utilizado multiplas vezes.

    (informação) O valor recebido pelo programa através do parâmetro é do tipo caractere, mesmo que seja preenchido um valor numérico.

    ...

    A partir da versão 1.0.9 do WebAgent será possível executar programas sem interface gráfica, com o objetivo de dinamizar automações, testes e etc.

    Nesse modo é recomendado o uso dos navegadores Google Chrome, Microsoft Edge ou Mozilla Firefox

    Bloco de código
    languagebash
    themeRDark
    titleSintaxe
    webagent launch "ip+porta+[parâmetros<opcional>]" --browser="caminho para o navegador" --headless

    Exemplos:

    O exemplo abaixo executa a função de usuário u_headless em um navegador sem interface gráfica.

    Bloco de código
    languagebash
    themeRDark
    titleExemplo de execução headless do WebAgent em Windows
    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
    Bloco de código
    languagebash
    themeRDark
    titleExemplo de execução headless do WebAgent em Linux
    /opt/web-agent/web-agent launch "http://10.173.9.215:5011?E=padrao&P=u_headless" --browser="/usr/bin/microsoft-edge" --headless
    Bloco de código
    languagebash
    themeRDark
    titleExemplo de execução headless do WebAgent em MacOS
    /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
    Aviso
    iconfalse
    title🚨 Importante

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

    Informações
    titleDica importante

    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:
    Bloco de código
    languagexml
    themeRDark
    titleConteúdo do arquivo distribution\policies.json
    {
    "policies": {
    "Certificates": {
        "ImportEnterpriseRoots": true,
        "Install" [
                   "/opt/web-agent/totvs_certificate_CA.crt"
                   ]
             }
        }
    }

    ...

    Entendendo as arquiteturas 32 e 64 bits para uso do WebAgent (topo)

    O WebAgent para Linux e macOS será distribuido somente na versão 64 bits.

    Para Windows ele será distribuido também na versão 32 bits, devido a dois cenários:

    Informações
    iconfalse
    titleCenário 1

    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.
    Informações
    iconfalse
    titleCenário 2

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

    Neste caso é possível instalar as duas versões do WebAgent, 32 e 64 bits, e executá-las em portas diferentes, a partir da configuração da Tela de Parâmetros, usando, por exemplo, o WebAgent 32 bits na porta 21021 e o 64 bits na porta 21022:

    Image Removed

    🚨 Para que este segundo cenário funcione será necessário abrir duas sessões distintas do WebApp no navegador.
          Mesmo procedimento adotado caso fosse necessário utilizar simultaneamente as versões do SmartClient Desktop 32 e 64 bits.

    Mais alguns detalhes sobre arquitetura clique aqui.

    Nota
    titleImportante

    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.

    ...

    Exemplos de integração utilizando o WebAgent (topo)

    Integração com o Microsoft Excel, mais informações aqui (💡 Dica: Clique nas imagens para melhor visualização )

    Image Removed

    Consumindo uma DLL através da função ExeDllRun3:

    Image Removed

    Executando uma aplicação nativa através da função ShellExecute:

    Image Removed

    Retornando as pastas e arquivos de um diretório através da função Directory:

    Image Removed

    ...

    Image Removed

    ...

    Habilitando o icone da bandeja (topo)

    Informações
    iconfalse

    Este processo é necessário em distros Linux como Red Hat, Fedora e Oracle Linux, que utilizam o GNOME como desktop padrão, mas não possuem suporte nativo ao system tray.

    *Este processo não é necessário no Ubuntu.

    💡 Dica: Clique nas imagens para melhor visualização

    Abra o Firefox, digite about:addons na barra de endereços, e na sequencia procure por GNOME.

    Image Removed

    Selecione GNOME Shell integration

    Image Removed

    Pressione Adicionar ao Firefox (Add to Firefox)

    Image Removed

    Pressione Adicionar (Add)

    Image Removed

    Selecione a opção Permitir esta extensão em janelas privativas, e na sequência, pressione Okay

    Image Removed

    Na barra de endereços do Firefox digite https://extensions.gnome.org/ , busque por appindicator e selecione a opção AppIndicator and KStatusNotifierItem Support.

    Image Removed

    Selecione a opção OFF para instalar a extensão.

    Image Removed

    Pressione Instalar (Install).

    Image Removed

    Na sequência, a opção mudará automáticamente para ON.

    Image Removed

    Apenas para teste, já que o proprio navegador irá instanciar o WebAgent, siga os passos a seguir:

    Bloco de código
    languagebash
    themeRDark
    cd /opt/web-agent
    ./web-agent

    Image Removed

    Para visualizar as opções do WebAgent, basta clicar em seu ícone.

    Image Removed

    A partir deste ponto, seu Linux estará pronto para testes.

    Image Removed

    ...

    Aviso

    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.

    Aviso

    O WebAgent não é homologado para sistemas operacionais :

    • ChromeOS/ChromeOS Flex
    • iOS
    • iPadOs
    • Android

    O WebAgent está disponível e homologado para os seguintes Sistemas Operacionais:

    Informações
    iconfalse

    Image Removed Window 32 e 64 bits

    • Windows 10 Pro/Enterprise ou superior
    • Windows 11 Pro/Enterprise ou superior
    Informações
    iconfalse

    Image Removed Linux 64 bits

    • Image Removed Ubuntu 22.04 LTS ou superior
    • Image Removed Red Hat Enterprise Linux Desktop 8.x

    ...

    iconfalse

    Resultado de imagem para logo apple 2020 pngImage Removed macOS x86_64 e Universal(ARM64) 

    • macOS 12.0 Monterey ou superior

    ...

    Image Added

    Para visualizar as opções do WebAgent, basta clicar em seu ícone.

    Image Added

    A partir deste ponto, seu Linux estará pronto para testes.

    Image Added

    Âncora
    Configuracao
    Configuracao

    Habilitando o WebAgent na Tela de Parâmetros (topo)

    ...

    Para habilitar o uso do WebAgent pelo WebApp, na Tela de Parâmetros, selecione o botão de configuração.

    Image Added

    Escolha a porta de inicialização do WebAgent (por padrão é a 21021).

    Image Added

    Na sequencia feche essa janela clicando no X na parte superior da janela de configuração.

    Image Added

    Ao confirmar os dados na Tela de Parâmetros será exibida a mensagem abaixo, solicitando autorização para abertura do WebAgent, basta clicar no botão Abrir.

    Image Added

    Caso a conexão com o WebAgent falhe ou a solicitação de autorização seja ignorada, será exibida a mensagem de erro a seguir:

    Image Added

    Âncora
    command_line
    command_line

    Executando o WebAgent em linha de comando (topo)

    ...

    O WebAgent pode ser iniciado via linha de comando, os parâmetros podem ser usados em conjunto, as opções são:

    ParâmetroDescrição
    web-agent -h ou --help

    Exibe help com essas opções

    web-agent -c ou --console

    Inicia o WebAgent em console(linha de comando) omitindo o systray(icone na bandeja), nesse exemplo iniciamos o WebAgent em console na porta 21023:

    web-agent -c --port 21023
    web-agent -v ou --version

    Exibe a versão do WebAgent, exemplo:

    web-agent -v
    v1.0.9-RC3 - x64
    web-agent -t ou --tray

    Abre o WebAgent via systray (default)

    web-agent --port

    Define uma porta específica para o WebAgent (a porta padrão é a 21021)

    web-agent --locallog <n>

    0 (default):  Desabilita o log de execução;
    1:
    Habilita a geração de log de execução (necessário apenas quando solicitado por nosso Suporte).

    Âncora
    Launch
    Launch
    Comando launch: Abrindo o navegador diretamente pelo WebAgent (topo)

    Permite abrir uma janela destacada do navegador a partir do WebAgent.

    Image Added

    Aviso
    iconfalse
    title🚨 Importante

    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.

    Informações
    titleDicas importantes

    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.

    Bloco de código
    languagebash
    themeRDark
    titleSintaxe
    webagent launch "ip+porta+[parâmetros<opcional>]" --browser="caminho para o navegador"

    Exemplos:

    Nos exemplos abaixo será aberto o SIGAFAT e preenchidos os parâmetros de abertura (&A=), artificio utilizado em produtos como SIGALOJA, e útil em algumas customizações.

    Bloco de código
    languagebash
    themeRDark
    titleExemplo de abertura do WebAgent em linha de comando em Windows
    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"
    Bloco de código
    languagebash
    themeRDark
    titleExemplo de abertura do WebAgent em linha de comando em Linux
    /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"

    Lista de parâmetros disponíveis:

    Parâmetro de linha para a URLDescriçãoObservações
    &E=
    Indica o nome do ambiente que será utilizado para definições gerais.

    &P=Identifica o programa inicial que será executado.
    &A=Identifica um parâmetro que será passado para o programa inicial.

    (seleção) O parâmetro de linha &A pode ser utilizado multiplas vezes.

    (informação) O valor recebido pelo programa através do parâmetro é do tipo caractere, mesmo que seja preenchido um valor numérico.

    Âncora
    Headless
    Headless

    Comando --headless: Executando aplicações sem interface através do WebAgent (topo)

    A partir da versão 1.0.9 do WebAgent será possível executar programas sem interface gráfica, com o objetivo de dinamizar automações, testes e etc.

    Nesse modo é recomendado o uso dos navegadores Google Chrome, Microsoft Edge ou Mozilla Firefox

    Bloco de código
    languagebash
    themeRDark
    titleSintaxe
    webagent launch "ip+porta+[parâmetros<opcional>]" --browser="caminho para o navegador" --headless

    Exemplos:

    O exemplo abaixo executa a função de usuário u_headless em um navegador sem interface gráfica.

    Bloco de código
    languagebash
    themeRDark
    titleExemplo de execução headless do WebAgent em Windows
    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
    Bloco de código
    languagebash
    themeRDark
    titleExemplo de execução headless do WebAgent em Linux
    /opt/web-agent/web-agent launch "http://10.173.9.215:5011?E=padrao&P=u_headless" --browser="/usr/bin/microsoft-edge" --headless
    Bloco de código
    languagebash
    themeRDark
    titleExemplo de execução headless do WebAgent em MacOS
    /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
    Aviso
    iconfalse
    title🚨 Importante

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

    Informações
    titleDica importante

    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:
    Bloco de código
    languagexml
    themeRDark
    titleConteúdo do arquivo distribution\policies.json
    {
    "policies": {
    "Certificates": {
        "ImportEnterpriseRoots": true,
        "Install" [
                   "/opt/web-agent/totvs_certificate_CA.crt"
                   ]
             }
        }
    }

    Âncora
    Arquitetura
    Arquitetura

    Entendendo as arquiteturas 32 e 64 bits para uso do WebAgent (topo)

    ...

    O WebAgent para Linux e macOS será distribuido somente na versão 64 bits.

    Para Windows ele será distribuido também na versão 32 bits, devido a dois cenários:

    Informações
    iconfalse
    titleCenário 1

    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.
    Informações
    iconfalse
    titleCenário 2

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

    Neste caso é possível instalar as duas versões do WebAgent, 32 e 64 bits, e executá-las em portas diferentes, a partir da configuração da Tela de Parâmetros, usando, por exemplo, o WebAgent 32 bits na porta 21021 e o 64 bits na porta 21022:

    Image Added

    🚨 Para que este segundo cenário funcione será necessário abrir duas sessões distintas do WebApp no navegador.
          Mesmo procedimento adotado caso fosse necessário utilizar simultaneamente as versões do SmartClient Desktop 32 e 64 bits.

    Mais alguns detalhes sobre arquitetura clique aqui.

    Nota
    titleImportante

    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.

    Âncora
    Exemplos
    Exemplos

    Exemplos de integração utilizando o WebAgent (topo)

    ...

    Integração com o Microsoft Excel, mais informações aqui (💡 Dica: Clique nas imagens para melhor visualização )

    Image Added


    Consumindo uma DLL através da função ExeDllRun3:

    Image Added


    Executando uma aplicação nativa através da função ShellExecute:

    Image Added


    Retornando as pastas e arquivos de um diretório através da função Directory:

    Image Added


    Recuperando a configuração da estação de trabalho através do Shift+F6.

    Image Added

    Âncora
    Sistemas
    Sistemas

    Sistemas Operacionais homologados (topo)

    ...

    Aviso

    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.

    Aviso

    O WebAgent não é homologado para sistemas operacionais :

    • ChromeOS/ChromeOS Flex
    • iOS
    • iPadOs
    • Android
    Nota
    titleImportante

    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:
    • 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:

    🚨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.

    O WebAgent está disponível e homologado para os seguintes Sistemas Operacionais:

    Informações
    iconfalse

    Image Added Window 32 e 64 bits

    • Windows 10 Pro/Enterprise ou superior
    • Windows 11 Pro/Enterprise ou superior
    Informações
    iconfalse

    Image Added Linux 64 bits

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

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

    • Image Added 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.

    Informações
    iconfalse

    Resultado de imagem para logo apple 2020 pngImage Added macOS x86_64 e Universal(ARM64) 

    • macOS 12.0 Monterey ou superior

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

    Image Added

    Âncora
    EmHomolog
    EmHomolog

    Sistemas Operacionais em homologação (topo)

    ...

    Aviso

    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

    ...

    Aviso

    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.

    Image RemovedProcesso de homologação do Fedora 41

    Previsão de inicio em 04/11/2024 previsão de finalização em 02/12/2024.

    Após instalar o WebAgent (mais informações acesse aqui), siga os passos abaixo.

    Bloco de código
    languagebash
    themeRDark
    // Instale as dependencias do WebAgent para o Fedora 41
    sudo dnf install libappindicator-gtk3
    
    // Registre o certificado do WebAgent
    sudo cp /opt/web-agent/totvs_certificate_CA.crt /etc/pki/ca-trust/source/anchors/
    sudo update-ca-trust
    Informações
    iconfalse

    🚨 Na sequencia, será necessário habilitar o system tray para o WebAgent, mais informações acesse aqui.

    Image RemovedProcesso de homologação do Oracle Linux 9.x

    Previsão de inicio em 04/11/2024 previsão de finalização em 02/12/2024.

    Após instalar o WebAgent (mais informações acesse aqui), siga os passos abaixo.

    Bloco de código
    languagebash
    themeRDark
    // Instale as dependencias do WebAgent para Oracle Linux 9.x
    sudo dnf install oracle-epel-release-el9
    sudo dnf update
    sudo dnf install libappindicator-gtk3
    
    // Registre o certificado do WebAgent
    sudo cp /opt/web-agent/totvs_certificate_CA.crt /etc/pki/ca-trust/source/anchors/
    sudo update-ca-trust
    Informações
    iconfalse

    🚨 Na sequencia, será necessário habilitar o system tray para o WebAgent, mais informações acesse aqui.