...

Obs: Caso as propriedades JWT não apareça para o usuário, é preciso conferir as permissões de acesso ao programa de menu no bas_prog_dtsul (MEN/MEN012AA.r):

Documentos relacionados:
CFG - JWT

3. Bibliotecas duplicadas no ambiente (Somente para ambientes Jboss)

...

Troubleshoot (Erros frequentes)

1. Erro ao tentar efetuar login no aplicativo

Primeiro passo, tente entrar com o mesmo usuário diretamente no ERP, caso não consiga, revise as configurações de usuário no foundation.

Segundo passo, faça uma uma simulação de conexão diretamente do prompt de comando do Windows.

Abra o Prompt de comando do Windows através do Executar (Win + R): 
Image Modified

Ou através do menu iniciar do Windows, procure por Prompt de comando

Em seguida, digitar a seguinte linha no prompt (Substituindo os dados pelas informações do seu servidor e usuário/senha)

Exemplo:

...

Image Added

Ao executar o comando deverá obter uma resposta como:

...

Image Added

Para que tudo esteja OK, o retorno deverá conter HTTP/1.1 200 na primeira linha e um json {"data": ... } na última linha.
Caso o resultado não seja conforme o esperado acima, entre em contato com o suporte TOTVS enviando um print do erro juntamente com os logs do tomcat e appserver.

2. Erro "Problema de Conexão: Timeout has occurred" (Somente para conexão via Mingle)

Ao acessar o aplicativo (principalmente durante o login), caso ocorra o erro "Problema de Conexão: Timeout has occurred", siga os passos abaixo:

Primeiro passo, acessar o log do Tomcat e buscar pelos trechos abaixo:

com.totvs.sso.JwtUtil.loadMinglePem URL MINGLE: https://mingle.totvs.com.br/api/v1/services/certificate
java.net.ConnectException: Connection timed out (Connection timed out)
    at java.net.PlainSocketImpl.socketConnect(Native Method)
    at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350)
    at java.net.AbstractPlainSocketImpl.connectToAddress(AbstractPlainSocketImpl.java:206)
    at java.net.AbstractPlainSocketImpl.connect(AbstractPlainSocketImpl.java:188)
    at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:392)

...

Seguido por:

com.totvs.sso.JwtUtil.getXTotvsApp Ocorreu um erro ao efetuar a conversao do token JWT!
com.totvs.sso.JwtUtil.getXTotvsApp Connection timed out (Connection timed out)
com.totvs.sso.JwtUtil.getXTotvsApp java.net.ConnectException: Connection timed out (Connection timed out)
    at java.net.PlainSocketImpl.socketConnect(Native Method)
    at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350)
    at java.net.AbstractPlainSocketImpl.connectToAddress(AbstractPlainSocketImpl.java:206)
    at java.net.AbstractPlainSocketImpl.connect(AbstractPlainSocketImpl.java:188)
    at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:392)
    at java.net.Socket.connect(Socket.java:607)

...

Nessa situação, possivelmente o seu servidor de aplicação não consegue acessar a URL do certificado Mingle, localizado em https://mingle.totvs.com.br/api/v1/services/certificate, isso pode ocorrer devido a um bloqueio de firewall ou falta de acesso a internet por parte do servidor, nessa situação siga para o segundo passo.

Segundo passo, realize um ping de dentro do servidor que roda o tomcat para o endereço mingle.totvs.com.br

Abra o Prompt de comando do Windows através do Executar (Win + R): 
Image Added

Ou através do menu iniciar do Windows, procure por Prompt de comando

Em seguida, digitar a seguinte linha no prompt

Exemplo de resultado esperado:
Image Added

Caso o ping não possa ser realizado, verifique permissões de firewall e conexão de internet juntamente com sua equipe de TI.

3. Erro "JWT_APP_ERROR" (Somente para conexão via Mingle)

Ao ocorrer o erro JWT_APP_ERROR quando utilizando conexão via mingle conforme imagem abaixo:
Image Added

Primeiro passo, consulte o log do tomcat e procure pelo trecho:

com.totvs.framework.util.JwtUtil.getXTotvsApp PKIX path building failed: sun.security.provider.certpath.
SunCertPathBuilderException: unable to find valid certification path to requested target
com.totvs.framework.util.JwtUtil.getXTotvsApp javax.net.ssl.SSLHandshakeException:
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

Segundo passo, caso o trecho seja localizado, indica que o certificado HTTPS do ambiente Mingle necessitar ser instalado no servidor que executa o tomcat conforme documentação:
Configuração de certificado para consultar serviço com conexão HTTPS