DokuWiki

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Durcissement de configuration Tomcat ======

Comme la grande majorité des logiciels, Tomcat est installé dans une configuration par défaut, qui est un compromis entre l'utilisabilité et la sécurité. Pour un environnement de développement, cette configuration par défaut permet de faire fonctionner Tomcat immédiatement sans agir sur sa configuration et aux développeurs de l'utiliser en ayant quelques infos de débogage. Quelques points de vigilance sont à prendre en considération pour préparer son serveur Tomcat en production.


----


<note important>
Ci-dessous le "mémo" simple de configuration Tomcat durcie un minimum. Merci de bien vouloir lire la suite de l'article pourvous assurer de bien comprendre ces éléments et mesurer les potentiels impacts que cela peut avoir sur les sites hébergés.
</note>

<code>
Ne pas exécuter le serveur Tomcat en root
Supprimer les applications par défaut : manager, host-manager, ROOT, tomcat-docs, jsp-examples, servlets-examples, webdav,balancer
</code>

Dans $TOMCAT_HOME/conf/server.xml :

<code>
Désactiver l'autodeploy : <Host name="localhost" autoDeploy="false">
Désactiver tous les connecteurs inutiles
</code>

Dans WEB-INF/web.xml :
<code>
<error-page>
  <exception-type>java.lang.Throwable</exception-type>
  <location>/error.jsp</location>
</error-page>
<session-config>
  <cookie-config>
    <http-only>true</http-only>
    <secure>true</secure>
  </cookie-config>
</session-config>
</code>

Dans $TOMCAT_HOME/conf/web.xml :
<code>
  <servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
    <init-param>
      <param-name>debug</param-name>
      <param-value>0</param-value>
    </init-param>
    <init-param>
      <param-name>listings</param-name>
      <param-value>false</param-value>
    </init-param>
    <init-param>
      <param-name>showServerInfo</param-name>
      <param-value>false</param-name>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
</code>


----


====== Explications de chaque directive ci-dessous. ======

===== Supprimer les applications par défaut =====

Selon les versions de Tomcat, les applications présentes par défaut ne sont pas toutes les mêmes. Toutes ces applications peuvent être supprimées. Dans le cas de Tomcat 9, il s'agit de supprimer dans $TOMCAT_HOME/webapps : docs, examples,host-manager, manager et ROOT.
  * ROOT est une page d'accueil par défaut mais présente à un attaquant potentiel des informations techniques comme la version précise de Tomcat
  * docs contient des documents statiques sans danger mais de la même manière expose des informations techniques à un attaquant
  * examples contient des examples de pages JSP ou de servlets s'exécutant sous Tomcat. Malheureusement, ces exemples sont peu sécurisés et peuvent permettre à un attaquant de compromettre le serveur en exploitant une vulnérabilité présente dans ces exemples.
  * manager (et host-manager qui lui est lié) est une petite console d'administration Web permettant essentiellement le déploiement d'application.
 
La suppression de ROOT, docs et examples ne pose aucun problème. La suppression du manager, potentiellement plus contraignante, est recommandée pour différentes raisons :
  * Que Tomcat soit directement exposé ou derrière un reverse proxy (qui souvent expose "/"), généralement le manager reste accessible publiquement et donc attaquable (bruteforce ou exploitation d'une vulnérabilité). La compromission du manager implique généralement la compromission immédiate du serveur, l'attaquant pouvant installer et exécuter du code arbitraire.
  * Des informations techniques sont exposées aux attaquants
  * La suppression du manager représente la suppression d'un point d'entrée potentiel et donc la réduction de la surface d'attaque La suppression du manager implique d'avoir une stratégie de déploiement qui passe par un accès direct au serveur ou mieux encore qu'elle soit automatisée par une chaîne de traitement (scripts shell, Jenkins, Ansible, Rundeck...). Dans le cas où il n'est vraiment pas possible de se passer du manager, il faut veiller à le sécuriser par une limitation de son exposition, s'assurer que les identifiants de connexions ne transitent que via HTTPS, une limitation des adresses IP autorisées à y accéder et bien sûr un mot de passe fort et unique (voir la section "Securing Manager Webapp" de [[https://www.owasp.org/index.php/Securing_tomcat|l'article de sécurisation Tomcat de l'OWASP]]).

===== Désactiver les connecteurs inutilisés =====

Tomcat propose 3 connecteurs activés par défaut à l'écoute sur les ports 8005 (connecteur d'arrêt), 8080 (connecteur HTTP),8009 (connecteur AJP). Le connecteur HTTPS, sur le port 8443 par défaut, est désactivé. Il est recommandé d'activer les connecteurs utiles dans votre architecture et de désactiver les autres.
Une architecture classique est de se reposer sur un reverse proxy (Apache par exemple) qui exposera l'application en HTTPS sur le port standard 443 et transférera les requêtes vers Tomcat (hébergé dans une zone réseau plus interne) sur son port 8080 (reverse proxy HTTP) ou 8009 (reverse proxy AJP). Celle-ci permet d'exposer son application sur le port HTTPS standard 443 sans nécessiter l'exécution du serveur Tomcat en root. Il est à noter que dans ce cas, les flux entre le reverse proxy et le serveur Tomcat ne seront pas chiffrés. Si cela est un besoin, le connecteur HTTPS devra être activé et configuré pour utilisé un certificat TLS stocké dans un keystore. D'une manière générale, la configuration du reverse proxy (et/ou load balancer selon les cas), doit s'assurer de ne pas exposer d'informations sensibles (ni le manager s'il est conservé, ni les arborescences WEB-INF des applications).
Il est recommandé de désactiver (par suppression ou mise en commentaire dans $TOMCAT_HOME/server.xml) les connecteurs inutilisés de manière à réduire la surface d'attaque exposée.

===== Désactiver le déploiement automatique =====

Dans une approche offensive, après découverte d'une vulnérabilité, un attaquant peut s'appuyer sur les fonctionnalités de déploiement automatique pour installer une autre application sur le serveur (par exemple un Webshell). Pour limiter ces possibilités, la désactivation au minimum de l'autodeploy est recommandé. Cela impliquera que le déploiement d'une nouvelle application nécessitera un redémarrage du serveur Tomcat.
La désactivation du déploiement au démarrage peut aussi être envisagée mais peut avoir des conséquences sur la stratégie de déploiement car cela nécessite que les contextes à déployer soient explicitement décrits dans le fichier $TOMCAT_HOME/conf/server.xml.

<code>
<Hostname="localhost" deployOnStartup="true|false" autoDeploy="false"><!-- deployOnStartup true ou false selon votre stratégie de déploiement (true par défaut) -->
</code>

===== Masquer les erreurs =====

Tomcat affiche par défaut des messages d'erreur présentant la pile d'appels (stacktrace) lors d'erreurs 500 et sa version qui représentent une fuite d'informations techniques utiles pour l'attaquant (et désagréables pour l'utilisateur).

La désactivation des informations de serveur se réalise aussi dans $TOMCAT_HOME/conf/web.xml :

<code>
  <servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
    <init-param>
      <param-name>debug</param-name>
      <param-value>0</param-value>
    </init-param>
    <init-param>
      <param-name>listings</param-name>
      <param-value>false</param-value>
    </init-param>
    <init-param>
      <param-name>showServerInfo</param-name>
      <param-value>false</param-name>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
</code>

Il est recommandé que la gestion des pages d'erreur soit configurée pour chaque application dans WEB-INF/web.xml enutilisant la balise <error-page> :
<code>
<error-page>
  <exception-type>java.lang.Throwable</exception-type>
  <location>/error.jsp</location>
</error-page>
</code>

Cela évitera à Tomcat d'afficher sa page par défaut contenant diverses informations techniques mais dirigera l'utilisateur versune page spécifique intégrée à l'application.

===== Sécuriser les entêtes de réponse HTTP =====

L'entête de réponse HTTP Server indique généralement la technologie serveur qui a envoyé cette réponse. Selon la configuration, le serveur peut parfois retourner exactement sa technologie et sa version. Jusqu'à la version 6, Tomcat retournait Server: Apache-Coyote/1.1, désormais, il ne retourne plus l'entête de réponse Server (et la configuration par défaut est donc recommandée). Néanmoins, celle-ci peut se configurer dans les connecteurs HTTP :

<code>
<Connector port="8080"server="Raspberry" /><!-- server header is now Raspberry -->
</code>

===== Désactivation du Directory Browsing =====

Par défaut, le parcours des répertoires Web est désactivé depuis Tomcat 8. Cela peut se vérifier dans $TOMCAT_HOME/conf/web.xml :

<code>
  <servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
    <init-param>
      <param-name>debug</param-name>
      <param-value>0</param-value>
    </init-param>
    <init-param>
      <param-name>listings</param-name>
      <param-value>false</param-value> <!-- make sure this is false -->
    </init-param>
    <init-param>
      <param-name>showServerInfo</param-name>
      <param-value>false</param-name>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
</code>

===== Protéger les cookies =====

Les attributs Http-Only et Secure doivent être positionnés sur les cookies. Cela peut se faire dans la partie <session-config> dufichier web.xml.
<code>
<session-config>
  <cookie-config>
    <http-only>true</http-only>
    <secure>true</secure>
  </cookie-config>
</session-config>
</code>

===== Protéger le shutdown =====

La commande "SHUTDOWN" passé en texte clair sur le port TCP 8005 permet d'éteindre le serveur. Il peut y avoir plusieurs moyens pour limiter les risques comme :
  * Désactiver ce service en positionnant la valeur -1 dans le port
  * Appliquer une règle sur le firewall local pour que seul les requêtes depuis localhost soit acceptée
  * Changer le mot "SHUTDOWN" par un mot plus complexe
  * Changer le port 8005 par un autre

La désactivation du service étant largement préférée.

<code>
<Server port="-1" shutdown="SHUTDOWN">
</code>

===== Plus d'infos =====

Les recommandations listées ci-dessus constituent un niveau minimal de durcissement de configuration. De manière à simplifier la maintenance (mises à jour correctives), l'usage des paquets Tomcat et Java intégrés aux distributions est préférable. D'autres mesures telles que la configuration du [[http://tomcat.apache.org/tomcat-9.0-doc/security-manager-howto.html|SecurityManager]], le blocage des déploiements au démarrage, la protection du service d'arrêt, le chiffrement des mots de passe ou la gestion des logs pourraient être évoquées. Vous trouverez d'autres infos sur la page de [[https://www.owasp.org/index.php/Securing_tomcat|sécurisation de Tomcat de l'OWASP]], sur [[https://geekflare.com/fr/apache-tomcat-hardening-and-security-guide/|ce site]], [[https://www.upguard.com/blog/15-ways-to-secure-apache-tomcat-8|ce site]] et sur la page de [[https://tomcat.apache.org/tomcat-9.0-doc/security-howto.html|sécurisation de Tomcat de la fondation Apache]].