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. Image Modified
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. Image Modified Para instalação no WindowsApós o download do instalador, basta iniciar sua instalação, que irá seguir sem intervenção do usuário. Image Modified O programa ficará disponível no menu, como neste exemplo utilizando o Windows 11. Image Modified 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. Image Modified
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 Image Modified 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 Image Modified 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. Image Modified Para usuários WindowsO 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. Image ModifiedPara usuários Linux Image Modified 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
Image Modified
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 Image Modified
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 Image Modified
Image Modified Red Hat 8.xImage Modified Para usuários macOSPara mais detalhes acesse a documentação oficial da Apple aqui: - Após a instalação do WebAgent
- Localize o arquivo totvs_certificate_CA.crt na pasta /Applications/web-agent.app/Contents/MacOS
- No app Acesso às Chaves (keychain access) Image Modified, selecione as chaves de início de sessão ou de Sistema.
- Arraste o arquivo do certificado para o app Acesso às Chaves.
- Configure a confiança do certificado clicando com o botão direito sobre o mesmo e escolhendo a opção Get Info. Na interface aberta expanda a opção Trust e coloque Always Trust para todas as opções disponíveis, conforme as imagens abaixo. Se for solicitado que você forneça um usuário, utilize um usuário com acesso de administrador.
Image ModifiedImage ModifiedImage Modified Habilitar 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 Modified Escolha a porta de inicialização do WebAgent (por padrão é a 21021). Image Modified Na sequencia feche essa janela clicando no X na parte superior da janela de configuração. Image Modified 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. Image Modified 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! Image Modified
Para maiores informações, acesse: 2. WebApp - WebAgent |