Como Resolver o Erro de Handshake no WebAgent TOTVS
O erro de Handshake no WebAgent normalmente está relacionado à validação de segurança realizada durante a comunicação entre o WebAgent e o sistema TOTVS Protheus.
A partir da versão 1.1.0 do WebAgent, a TOTVS passou a utilizar JWT (JSON Web Token) para validar a origem da conexão durante o processo de handshake. Por esse motivo, qualquer divergência de data, hora ou fuso horário do servidor ou da estação pode impedir a autenticação e ocasionar falhas na comunicação.
Antes de realizar outras verificações, confirme que a data, o horário e o fuso horário da máquina estão corretos e sincronizados. Também é importante verificar se o serviço responsável pela sincronização de horário do Windows está funcionando corretamente.
Verificando o serviço de sincronização de horário do Windows
O serviço w32time é responsável pela sincronização do relógio do Windows. Caso exista alguma inconsistência, é possível recriar o serviço seguindo os passos abaixo.
Parar o serviço
net stop w32time
Desinstalar o serviço
w32tm /unregister
Instalar novamente o serviço
w32tm /register
Iniciar o serviço
net start w32time
Forçar a sincronização do horário
w32tm /resync
Recomendações adicionais
Se o problema persistir após a sincronização do horário, verifique também:
- Data, hora e fuso horário configurados corretamente no Windows.
- Sincronização do relógio com um servidor NTP confiável.
- Versão do WebAgent compatível com a versão do Protheus utilizada.
- Comunicação entre WebAgent e Application Server sem bloqueios de firewall ou antivírus.
- Certifique-se de que não exista diferença significativa de horário entre cliente e servidor.
Na maioria dos casos, a correção da sincronização de horário resolve o erro de Handshake causado pela validação do JWT implementada nas versões mais recentes do WebAgent.
Gostou do conteúdo?
Compartilhe este conteúdo com desenvolvedores ADVPL, analistas TOTVS Protheus, consultores ERP, equipes de sustentação, administradores de infraestrutura, especialistas em integração, profissionais de TI, suporte técnico e desenvolvedores que trabalham com ambientes corporativos.
Deixe seu comentário compartilhando sua experiência ou outras soluções que possam ajudar a comunidade.
#TOTVS #Protheus #WebAgent #Handshake #JWT #ADVPL #AppServer #ERP #Windows #W32Time #SincronizacaoDeHorario #NTP #SuporteTOTVS #Infraestrutura #Tecnologia #AutomacaoEmpresarial #Desenvolvimento #Integracao #TI #ProtheusERP
