Comment installer ModSecurity pour Nginx sur CentOS 7, Debian 8 et Ubuntu 16.04

• Conditions préalables
• Étape 1: mettre à jour le système
• Étape 2: installer les dépendances
• Étape 3: Compiler ModSecurity
• Étape 4: compiler Nginx
• Étape 4: configurer ModSecurity et Nginx
• Étape 5: Testez ModSecurity

ModSecurity est un module de pare-feu d'applications Web open source (WAF) qui est idéal pour protéger Apache, Nginx et IIS contre diverses cyberattaques qui ciblent les vulnérabilités potentielles de diverses applications Web.

Dans cet article, nous allons installer et configurer ModSecurity pour Nginx sur CentOS 7, Debian 8 et Ubuntu 16.04.

Conditions préalables

• Une installation à jour de CentOS 7, Debian 8 ou Ubuntu 16.04 64 bits.
• Se connecter en tant que root.

Étape 1: mettre à jour le système

En suivant ce guide , mettez à jour le noyau et les packages de votre serveur vers la dernière version disponible.

Étape 2: installer les dépendances

Avant de pouvoir compiler Nginx et ModSecurity avec succès, vous devez installer plusieurs packages logiciels comme suit.

a) Sur CentOS 7:

yum groupinstall -y "Development Tools"
yum install -y httpd httpd-devel pcre pcre-devel libxml2 libxml2-devel curl curl-devel openssl openssl-devel
shutdown -r now

b) Sur Debian 8 ou Ubuntu 16.04:

apt-get install -y git build-essential libpcre3 libpcre3-dev libssl-dev libtool autoconf apache2-dev libxml2-dev libcurl4-openssl-dev automake pkgconf

Étape 3: Compiler ModSecurity

En raison de plusieurs instabilités signalées sur la branche principale ModSecurity for Nginx, pour l'instant, il est officiellement recommandé d'utiliser la dernière version de la nginx_refactoringbranche dans la mesure du possible.

Téléchargez la nginx_refactoringbranche de ModSecurity pour Nginx:

cd /usr/src
git clone -b nginx_refactoring https://github.com/SpiderLabs/ModSecurity.git

Compiler ModSecurity:

a) Sur CentOS 7:

cd ModSecurity
sed -i '/AC_PROG_CC/a\AM_PROG_CC_C_O' configure.ac
sed -i '1 i\AUTOMAKE_OPTIONS = subdir-objects' Makefile.am
./autogen.sh
./configure --enable-standalone-module --disable-mlogc
make

Remarque: les deux sedcommandes ci-dessus sont utilisées pour empêcher les messages d'avertissement lors de l'utilisation de nouvelles versions d'automake.

b) Sur Debian 8 ou Ubuntu 16.04:

cd ModSecurity
./autogen.sh
./configure --enable-standalone-module --disable-mlogc
make

Étape 4: compiler Nginx

Téléchargez et désarchivez la dernière version stable de Nginx qui est Nginx 1.10.3au moment de la rédaction:

cd /usr/src
wget https://nginx.org/download/nginx-1.10.3.tar.gz
tar -zxvf nginx-1.10.3.tar.gz && rm -f nginx-1.10.3.tar.gz

a) Sur CentOS 7:

Tout d'abord, vous devez créer un utilisateur dédié nginxet un groupe dédié nginxpour Nginx:

groupadd -r nginx
useradd -r -g nginx -s /sbin/nologin -M nginx

Compilez ensuite Nginx tout en activant les modules ModSecurity et SSL:

cd nginx-1.10.3/
./configure --user=nginx --group=nginx --add-module=/usr/src/ModSecurity/nginx/modsecurity --with-http_ssl_module
make
make install

Modifiez l'utilisateur par défaut de Nginx:

sed -i "s/#user  nobody;/user nginx nginx;/" /usr/local/nginx/conf/nginx.conf

b) Sur Debian 8 ou Ubuntu 16.04:

Tout d'abord, vous devez utiliser l'utilisateur existant www-dataet le groupe existant www-data.

Compilez ensuite Nginx tout en activant les modules ModSecurity et SSL:

cd nginx-1.10.3/
./configure --user=www-data --group=www-data --add-module=/usr/src/ModSecurity/nginx/modsecurity --with-http_ssl_module
make
make install

Modifiez l'utilisateur par défaut de Nginx:

sed -i "s/#user  nobody;/user www-data www-data;/" /usr/local/nginx/conf/nginx.conf

Après avoir installé Nginx avec succès, les fichiers associés seront situés à:

nginx path prefix: "/usr/local/nginx"
nginx binary file: "/usr/local/nginx/sbin/nginx"
nginx modules path: "/usr/local/nginx/modules"
nginx configuration prefix: "/usr/local/nginx/conf"
nginx configuration file: "/usr/local/nginx/conf/nginx.conf"
nginx pid file: "/usr/local/nginx/logs/nginx.pid"
nginx error log file: "/usr/local/nginx/logs/error.log"
nginx http access log file: "/usr/local/nginx/logs/access.log"
nginx http client request body temporary files: "client_body_temp"
nginx http proxy temporary files: "proxy_temp"
nginx http fastcgi temporary files: "fastcgi_temp"
nginx http uwsgi temporary files: "uwsgi_temp"
nginx http scgi temporary files: "scgi_temp"

vous pouvez tester l'installation avec:

/usr/local/nginx/sbin/nginx -t

Si rien ne va mal, la sortie doit être:

nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful

Pour votre commodité, vous pouvez configurer un fichier d'unité systemd pour Nginx:

cat <<EOF>> /lib/systemd/system/nginx.service
[Service]
Type=forking
ExecStartPre=/usr/local/nginx/sbin/nginx -t -c /usr/local/nginx/conf/nginx.conf
ExecStart=/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf
ExecReload=/usr/local/nginx/sbin/nginx -s reload
KillStop=/usr/local/nginx/sbin/nginx -s stop

KillMode=process
Restart=on-failure
RestartSec=42s

PrivateTmp=true
LimitNOFILE=200000

[Install]
WantedBy=multi-user.target
EOF

À l'avenir, vous pouvez démarrer / arrêter / redémarrer Nginx comme suit:

systemctl start nginx.service
systemctl stop nginx.service
systemctl restart nginx.service

Étape 4: configurer ModSecurity et Nginx

4.1 Configurer Nginx:

vi /usr/local/nginx/conf/nginx.conf

Recherchez le segment suivant dans le http {}segment:

location / {
    root   html;
    index  index.html index.htm;
}

Insérez les lignes ci-dessous dans le location / {}segment:

ModSecurityEnabled on;
ModSecurityConfig modsec_includes.conf;
#proxy_pass http://localhost:8011;
#proxy_read_timeout 180s;

Le résultat final devrait être:

location / {
    ModSecurityEnabled on;
    ModSecurityConfig modsec_includes.conf;
    #proxy_pass http://localhost:8011;
    #proxy_read_timeout 180s;
    root   html;
    index  index.html index.htm;
}

Sauvegarder et quitter:

:wq!

Remarque: La configuration Nginx ci-dessus n'est qu'un exemple de configuration pour utiliser Nginx comme serveur Web plutôt que comme proxy inverse. Si vous utilisez Nginx comme proxy inverse, supprimez le #caractère des deux dernières lignes et apportez-y les modifications appropriées.

4.2 Créez un fichier nommé /usr/local/nginx/conf/modsec_includes.conf:

cat <<EOF>> /usr/local/nginx/conf/modsec_includes.conf
include modsecurity.conf
include owasp-modsecurity-crs/crs-setup.conf
include owasp-modsecurity-crs/rules/*.conf
EOF

Remarque: La configuration ci-dessus appliquera toutes les règles de base OWASP ModSecurity dans le owasp-modsecurity-crs/rules/répertoire. Si vous souhaitez appliquer uniquement des règles sélectives, vous devez supprimer la include owasp-modsecurity-crs/rules/*.confligne, puis spécifier les règles exactes dont vous avez besoin après l'étape 4.5.

4.3 Importation des fichiers de configuration ModSecurity:

cp /usr/src/ModSecurity/modsecurity.conf-recommended /usr/local/nginx/conf/modsecurity.conf
cp /usr/src/ModSecurity/unicode.mapping /usr/local/nginx/conf/

4.4 Modifiez le /usr/local/nginx/conf/modsecurity.conffichier:

sed -i "s/SecRuleEngine DetectionOnly/SecRuleEngine On/" /usr/local/nginx/conf/modsecurity.conf

4.5 Ajouter des fichiers OWASP ModSecurity CRS (Core Rule Set):

cd /usr/local/nginx/conf
git clone https://github.com/SpiderLabs/owasp-modsecurity-crs.git
cd owasp-modsecurity-crs
mv crs-setup.conf.example crs-setup.conf
cd rules
mv REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf.example REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf
mv RESPONSE-999-EXCLUSION-RULES-AFTER-CRS.conf.example RESPONSE-999-EXCLUSION-RULES-AFTER-CRS.conf

Étape 5: Testez ModSecurity

Démarrer Nginx:

systemctl start nginx.service

Ouvrez le port 80 afin de permettre un accès extérieur:

a) Sur CentOS 7:

firewall-cmd --zone=public --permanent --add-service=http
firewall-cmd --reload

b) Sur Debian 8:

iptables -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
iptables -A INPUT -p tcp --dport 80 -j ACCEPT
iptables -A INPUT -p tcp --dport 22 -j ACCEPT
iptables -A INPUT -p icmp --icmp-type echo-request -j ACCEPT
iptables -P INPUT DROP
iptables -P OUTPUT ACCEPT
iptables -P FORWARD DROP
touch /etc/iptables
iptables-save > /etc/iptables

c) Sur Ubuntu 16.04:

ufw allow OpenSSH
ufw allow 80
ufw default deny
ufw enable    

Dirigez votre navigateur Web vers:

http://203.0.113.1/?param="><script>alert(1);</script>

Utilisez greppour récupérer les messages d'erreur comme suit:

grep error /usr/local/nginx/logs/error.log

La sortie doit inclure plusieurs messages d'erreur similaires à:

2017/02/15 14:07:54 [error] 10776#0: [client 104.20.23.240] ModSecurity: Warning. detected XSS using libinjection. [file "/usr/local/nginx/conf/owasp-modsecurity-crs/rules/REQUEST-941-APPLICATION-ATTACK-XSS.conf"] [line "56"] [id "941100"] [rev "2"] [msg "XSS Attack Detected via libinjection"] [data "Matched Data:  found within ARGS:param: \x22><script>alert(1);</script>"] [severity "CRITICAL"] [ver "OWASP_CRS/3.0.0"] [maturity "1"] [accuracy "9"] [tag "application-multi"] [tag "language-multi"] [tag "platform-multi"] [tag "attack-xss"] [tag "OWASP_CRS/WEB_ATTACK/XSS"] [tag "WASCTC/WASC-8"] [tag "WASCTC/WASC-22"] [tag "OWASP_TOP_10/A3"] [tag "OWASP_AppSensor/IE1"] [tag "CAPEC-242"] [hostname ""] [uri "/index.html"] [unique_id "ATAcAcAkucAchGAcPLAcAcAY"]

C'est tout. Comme vous le voyez, le module ModSecurity a correctement enregistré cette attaque conformément à sa politique d'action par défaut. Si vous voulez faire plus de paramètres personnalisés, s'il vous plaît examiner attentivement et éditer /usr/local/nginx/conf/modsecurity.confet /usr/local/nginx/conf/owasp-modsecurity-crs/crs-setup.conffichiers.