Acessando a Tela de Parâmetros do WebApp, agora será exibida a tela para download dos instaladores:
Importante 🚨O Popup para instalação do WebAgent deixará de ser exibido assim que a primeira conexão entre ele 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" deve 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. ![](/download/attachments/515688278/image2022-7-8_13-36-7.png?version=1&modificationDate=1719930612790&api=v2)
O instalador vai sugerir o Sistema Operacional, caso utilize o Windows 64 bits, mas possua o Microsoft Office 32 bits, poderá instalar o WebAgent 32 bits para garantir essa integração, mais detalhes aqui. ![](/download/attachments/515688278/image2022-7-8_13-41-30.png?version=1&modificationDate=1719930612897&api=v2)
Processo de instalação
Deck of Cards |
---|
| Processo de instalação Card |
---|
| Para instalação no WindowsApós o download do instalador, basta iniciar sua instalação, que irá seguir sem intervenção do usuário. ![](/download/attachments/515688278/image2022-2-1_15-0-48.png?version=1&modificationDate=1719930612980&api=v2)
O programa ficará disponível no menu, como neste exemplo utilizando o Windows 11. ![](/download/attachments/515688278/image2022-2-1_14-59-42.png?version=1&modificationDate=1719930613073&api=v2)
O WebApp irá iniciar o WebAgent sempre que necessário a partir deste momento, mais detalhes consulte a seção Habilitar WebAgent na Tela de Parâmetros. Apenas para testes, você pode iniciar a aplicação, será exibido o ícone na bandeja, como no exemplo abaixo. ![](/download/attachments/515688278/image2022-2-1_15-7-9.png?version=1&modificationDate=1719930613147&api=v2)
|
Card |
---|
| Para instalação no LinuxApós baixar o arquivo para o seu respectivo Linux, sendo o arquivo .deb para Ubuntu e .rpm para o Red Hat. Para Ubuntu ![](/download/attachments/515688278/image2020-3-4_7-35-57.png?version=1&modificationDate=1719930654207&api=v2) No diretório onde o arquivo .deb foi copiado
sudo apt install . /web-agent <versao>.deb
|
Caso 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
|
Para Red hat 8.x ![](/download/thumbnails/515688278/image2023-6-21_11-37-54.png?version=1&modificationDate=1719930654307&api=v2) Pré requisito: Necessário instalar a biblioteca libappindicator
sudo dnf install libappindicator-gtk3
|
No diretório onde o arquivo .rpm foi copiado
sudo dnf install . /web-agent <versao>.rpm
|
Caso 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
|
Registro do Certificado (SSL) para uso do WebAgent (topo)
Para utilizar o Websocket Secure (wss) é necessário registrar o TOTVS Certificate em seu sistema operacional. Para usuários Windows
O registro é automático para Windows 10/11, 32 ou 64 bits, e será efetivado na primeira execução do WebAgent. 🚨 Importante: Na primeira execução do WebAgent, caso seja apresentada a tela de confirmação para o registro do certificado, selecione a opção Sim. Para usuários Linux
Ubuntu - Após a instalação do WebAgent
- Localize o arquivo totvs_certificate_CA.crt na pasta /opt/web-agent
- Acesse seu navegador e efetue o registro:
- Para 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
![](/download/attachments/515688278/image2022-2-17_16-11-11.png?version=1&modificationDate=1719930654607&api=v2)
Para 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
![](/download/attachments/515688278/image2022-2-17_16-22-25.png?version=1&modificationDate=1719930654687&api=v2)
Para 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
![](/download/attachments/515688278/image2022-2-17_16-26-32.png?version=1&modificationDate=1719930654777&api=v2)
Red Hat 8.x |
|
Habilitar WebAgent na Tela de Parâmetros (topo)Parâmetros
Para habilitar o uso do WebAgent pelo WebApp, na Tela de Parâmetros, selecione o botão de configuração. ![](/download/thumbnails/515688278/image2022-2-1_15-15-0.png?version=1&modificationDate=1719930655247&api=v2)
Escolha a porta de inicialização do WebAgent (por padrão é a 21021). ![](/download/attachments/515688278/image2021-12-15_16-10-4.png?version=1&modificationDate=1719930655337&api=v2)
Na sequencia feche essa janela clicando no X na parte superior da janela de configuração. ![](/download/attachments/515688278/image2022-2-1_15-19-15.png?version=1&modificationDate=1719930655427&api=v2)
Assim que 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. ![](/download/attachments/515688278/image2022-2-1_15-23-17.png?version=1&modificationDate=1719930655517&api=v2)
Após dez tentativas de conexão malsucedidas ou caso a solicitação de autorização seja ignorada, será exibida a seguinte mensagem: Falha ao conectar com o WebAgent! ![](/download/attachments/515688278/webagent-ignore.png?version=1&modificationDate=1719930655613&api=v2)
Para maiores informações, acesse: 2. WebApp - WebAgent |