Árvore de páginas

Informação

A partir da release 12.1.2311, a biblioteca totvs-valve-<VERSAO>.jar é expedida com o produto, portanto basta configurar sua utilização conforme recomendações a seguir.

CONTEÚDO

  1. Visão Geral
  2. Configuração
  3. Exemplo de utilização
  4. Anexos

01. VISÃO GERAL

Esta documentação tem como objetivo demonstrar as configurações necessárias para efetuar o tratamento de erros HTTP status 500 e 404 com um retorno de página tratada, evitando assim vulnerabilidades de Error Hanling

02. CONFIGURAÇÃO

TOMCAT

Para efetuar o tratamento dos erros descritos anteriormente, é necessário efetuar algumas configurações no Apache Tomcat (versão 9.X):

  • Localizar a instalação do Tomcat e editar o arquivo ../conf/server.xml
  • Localizar a tag Host utilizada na inicialização do serviço e adicionar o atributo errorReportValveClass com o valor apresentado no exemplo abaixo:
server.xml
<Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true"
			errorReportValveClass="com.totvs.valve.HttpCustomPage">
  • Editar o arquivo ../conf/catalina.properties
  • Inserir o diretório ${catalina.home}/lib/datasul-lib/*.jar nas definições de common.loader. Inserir este mesmo valor em server.loader e shared.loader caso exista algum diretório configurado 
catalina.properties
...
common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.home}/lib/datasul-lib/*.jar"
...
  • Criar o diretório datasul-lib em ../lib

  • Inserir os arquivos .jar abaixo no diretório recém criado (anexo datasul-lib.zip com os arquivos necessários)
lib/datasul-lib
commons-logging-1.2.jar
totvs-fwk-log-<VERSAO>-NFRW-SNAPSHOT.jar
totvs-valve-3.0.jar

Aviso

Caso o servidor de aplicação Tomcat possuir um totvs-valve-X.0.jar em ../lib, é necessário remove-lo, pois a nova versão 3.0 também contempla o controle de requisições CORS e Rastreabilidade de Logs.

03. EXEMPLO DE UTILIZAÇÃO

Após efetuada as configurações, caso ocorra algum erro HTTP 404 ou 500, não será exibido informações sensíveis a ataques, mas sim uma página customizada:

AntesDepois

04. ANEXOS