Manufatura - Linha Datasul - APP Minha Manutenção - Configurando o Datasul-Valve no servidor JBoss

 Tempo aproximado para leitura: 00:02:30 min

Dúvida
Para utilização do APP - Aplicativo Minha Manutenção, como realizar a configuração do Datasul-Valve no servidor JBoss para acessar o aplicativo?

Ambiente
TOTVS Manufatura - TOTVS Manufatura (Linha Datasul) - Aplicativo Minha Manutenção - Versão 12

Solução
O acesso ao APP Minha Manutenção pode ocorrer por conexão direta, que é o acesso mais simplificado em que os usuários irão acessar o APP conectados a partir da rede de dados Wi-Fi da empresa, ou via Mingle, que requer a criação de uma Alias e é recomendado quando há necessidade de que os técnicos/usuários acessem o APP, a partir de conexão em redes de dados fora do ambiente da empresa.

Para a conexão via Mingle ou direta do APP com o Datasul é necessário realizar a configuração do Datasul-Valve no servidor JBoss, para que o produto atue nas headers das requisições e os credentials sejam trafegados em requisições do tipo CORS. Para isso:

1. Localizar o arquivo server.xml, que pode ser encontrado na instância do Jboss:
   ...\deploy\jboss-web.deployer\server.xml
   
   
2. Adicionar as linhas abaixo como elemento filho da tag <Host ...>:
   

   <Valve className="com.datasul.framework.valve.DatasulValve" 
       allowHeaders="Content-Type,Accept,Accept-Language,Content-Language,Authorization,tenantId,userId,companyId,authorization,returnformatversion,x-totvs-appcode"
       contextsToValidate="/dts/datasul-rest,/api,/webexecbo,/josso"
       allowOrigin="http://localhost http://localhost:8100"
       allowMethods="GET, POST, DELETE, PUT, PATCH, HEAD, OPTIONS"
       allowCredential="true" />
   

3. Adicionar o arquivo datasul-framework-valve.jar no diretório lib, relacionada à instância do JBoss.
   Este arquivo pode ser encontrado em: https://tdn.totvs.com/download/attachments/514438300/datasul-framework-valve.jar?api=v2
   

Importante
- A propriedade do Datasul-valve chamada allowOrigin="*", deve receber o valor allowOrigin= "http://localhost http://localhost:8100" para o correto funcionamento da conexão.
- A porta para o APP de manutenção industrial é fixa 8100.
- Para adicionar mais de um host basta adicionar os valores separados por espaço.
- A tag Valve deve estar configurada como o último elemento da tag Host. Caso exista algum Header da request diferente dos informados anteriormente - allowHeaders, estes devem ser incluídos nessa tag. 

Saiba mais
Mais informações sobre Datasul-Valve com Jboss.
Para acessar o guia de uso do APP Minha Manutenção - Manutenção Industrial clique aqui