Âncora
Top Top

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

• WebApp -

  WebAgent

• As vantagens do WebAgent em conjunto com o WebApp

• WebAgent em linha de comando

• A evolução do WebApp

  • Configurando o WebApp a partir do Application Server

• Segurança

• Entendendo as arquiteturas 32 e 64 bits para uso do WebAgent

• Instalação (Camada Server e Client)

  • Habilitar automáticamente uma porta para o WebAgent de todos os usuários

• Registro do Certificado (SSL) para uso do WebAgent

• Habilitar WebAgent na Tela de Parâmetros

• Sistemas Operacionais homologados

• Exemplos de uso

Âncora
WebAgent WebAgent

WebAgent (topo)

...

O WebAgent é um serviço que permite ao Smartclient WebApp os mesmos acessos à estação de trabalho do SmartClient Desktop, dentre eles:

...

Consulte a lista dos navegadores homologados para o SmartClient WebApp.

Âncora
Vantagens Vantagens

As vantagens do WebAgent em conjunto com o WebApp (topo)

...

• Simplificação na montagem de ambientes:
  • O navegador é o SmarClient!
• Instalação e Atualização mais rápida, devido ao menor numero de arquivos do WebAgent;
• Ambiente HTML sempre atualizado, preparado para os mais novos Frameworks de mercado.

Âncora
command_line command_line

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:

...

Sintaxe:

webagent launch "ip+porta+*parâmetros" --browser="caminho para o navegador"
*Parâmetros são opcionais.

...

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

Âncora
WebApp WebApp

A evolução do WebApp (topo)

...

O WebAgent irá trabalhar em conjunto com o SmartClient WebApp versão 9.0.0 ou superior.

O Front-end do WebApp 9.0.0 foi reescrito utilizando o conceito de Web Components, trazendo melhorias significativas de performance, e uma experiência mais fluida no uso do nosso ERP a partir dos navegadores.

Âncora
Seguranca Seguranca

Segurança (topo)

...

Os navegadores atuais possuem um ambiente de execução segura, chamado Sandbox, que impede o acesso ao dispositivo.

...

• Conexão entre o navegador e o WebAgent exclusivamente via Websocket Secure (wss);
• Conexão entre o navegador e o WebAgent exclusivamente através do endereço localhost, bloqueando ataques de IPs externos;
• Uso do mesmo protocolo de comunicação utilizado entre SmartClient Desktop e o Appserver, um motor utilizado a mais de 20 anos, e conhecidamente seguro.

Âncora
Arquitetura Arquitetura

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

...

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

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

Cenário 1

Utilizar o Windows 64 bits, porém ferramentas 32 bits (exemplos abaixo), nesse caso será necessária a instalação do WebAgent 32 bits para integração.

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

Cenário 2

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

...

Âncora
Instalacao Instalacao

Instalação (topo)

...

Para o Administrador do Sistema

Para disponibilizar a opção de download do WebAgent na Tela de Parâmetros do SmartClient WebApp é necessário configurar a origem dos instaladores.

1. Definindo no appserver.ini o arquivo que conterá os instaladores para download

🚨 No nosso exemplo utilizaremos o arquivo de configuração com o nome webagent.json, na mesma pasta do AppServer, mas tanto o nome do arquivo quanto o diretório são de sua escolha, ajuste então a configuração de acordo com sua necessidade, por exemplo:

...

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

2. Criando o arquivo webagent.json

Seguindo nosso exemplo, crie agora o arquivo webagent.json na mesma pasta do AppServer.

...

{
    "version": "1.0.0-RC1",
   
    "windows_x86": "webagent/web-agent-1.0.0-RC1-windows-x86-release.setup.exe",
    "windows_x64": "webagent/web-agent-1.0.0-RC1-windows-x64-release.setup.exe",

    "darwin_x64": "webagent/web-agent-1.0.0-RC1-darwin-x64-release.dmg",
    "darwin_arm64": "webagent/web-agent-1.0.0-RC1-darwin-x64-release.dmg",
    "darwin_universal": "webagent/web-agent-1.0.0-RC1-darwin-x64-release.dmg",

    "linux_x64_deb": "webagent/web-agent-1.0.0-RC1-linux-x64-release.deb",  
    "linux_x64_rpm": "webagent/web-agent-1.0.0-RC1-linux-x64-release.rpm"
}

3. Habilitar automáticamente uma porta para o WebAgent de todos os usuários 

Âncora
AgentPort AgentPort

É possivel habilitar automáticamente uma porta para o WebAgent de todos os seus usuários, impedindo que ele altere esta configuração.

...

🚨 Após a configuração deve-se reiniciar o/s AppServer/s.

Para o usuário do ERP

sudo dnf install libappindicator-gtk3

...

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.

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

...

O SmartClient 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.

Âncora
Certificado Certificado

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

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
      
      
      

  • 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
      
      
      

  • 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 Red Hat

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

  • Para o Microsoft Edge:

    • O Edge utiliza o certificado do Sistema Operacional, utilize os comandos abaixo para resgistrar:

      • 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:
      • https://docs.fedoraproject.org/en-US/quick-docs/using-shared-system-certificates/
      • https://www.redhat.com/sysadmin/ca-certificates-cli

Image Modified Para usuários macOS

Para 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) , selecione as chaves de início de sessão ou de Sistema.
• Arraste o arquivo do certificado para o app Acesso às Chaves.
• Se for solicitado que você forneça um usuário, utilize um usuário com acesso de administrador.

Âncora
Configuracao Configuracao

Habilitar WebAgent na Tela de Parâmetros (topo)

...

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

...

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.

Âncora
Sistemas Sistemas

Sistemas Operacionais homologados (topo)

...

O WebAgent estará disponível para os Sistemas Operacionais:

...

Âncora
Exemplos Exemplos

Exemplos de uso (topo)

...

Nesta seção listamos alguns exemplos de integração possíveis através do WebAgent:

...