Voir la source de Sécuriser ses sites avec letsencrypt et acme-tiny

[[Category:serveur]]
[[Category:debian]]
[[Category:security]]
Les tutos [[Installation_et_configuration_d'un_serveur_http_apache_2.2|Installation et configuration d'un serveur http apache 2.2]] ainsi que [[Installation_et_configuration_de_OpenSSL|Installation et configuration de OpenSSL]] vous expliquent comment générer des certificats auto-signés et configurer vos vhosts Apache.

Ceci dit les certificats auto-signés présentent un inconvénient majeur : ils génèrent des alertes de sécurité dans les navigateurs.

Ils conviennent donc tout à fait pour sécuriser une interface d'admin, mais dès lors où votre site est ouvert au "public" ils ne sont plus utilisables, les messages d'alertes dans les navigateurs étant plus que dissuasifs.

Depuis peu une nouvelle autorité de certification a vu le jour : https://letsencrypt.org/

Cette autorité vise à fournir gratuitement des certificats de sécurité reconnus dans les navigateurs (grâce dès aujourd'hui à une signature croisée avec une autre autorité)

Il n'y a donc plus d'excuses pour ne pas proposer de HTTPS sur vos sites !

=Pourquoi acme-tiny ?=
Letsencrypt propose un client officiel qui se charge de presque tout pour vous mais qui a plusieurs défauts, entre autre le fait que vous n'avez pas vraiment la main sur son fonctionnement, qu'il nécessite pas mal de dépendances, doit tourner en root, etc.

Letsencrypt étant un projet OpenSource, il existe de nombreux autres scripts proposant plus ou moins de fonctionnalités, acme-tiny en fait parti : https://github.com/diafygi/acme-tiny

Ce script vous permet de générer le certificat en passant par letsencrypt tout en gardant la main sur votre config Apache, la façon dont vous gérez les certificats, etc.

=Pré-configuration (pour la première utilisation)=
Avant de générer les certificats, commencez par créer un utilisateur dédié qui se chargera de faire tourner le script.
Nous partirons sur un utilisateur nommé acme, avec un home dans /home/acme et dont les mails sont redirigés vers root :
<pre>
adduser --disabled-login --disabled-password acme
echo "acme:   root" >> /etc/aliases
postalias /etc/aliases
</pre>

Avec cet utilisateur (su - acme) :
<pre>
cd /home/acme
mkdir work secrets
chmod 750 work
chmod 700 secrets
git clone https://github.com/diafygi/acme-tiny.git
chmod +x acme-tiny/acme_tiny.py
</pre>

Le répertoire secrets servira à héberger les clés (fichiers .key), le work hébergera les différents fichiers des certifiats (crt, csr, pem).

On restreint les droits sur les dossiers et enfin on récupère le script et on le rend exécutable.

=Génération des clés=
Afin de communiquer avec letsencrypt il vous faut un fichier de clé qui vous authentifie auprès d'eux. Ce fichier est extrêmement important (pensez à bien le sauvegarder) et bien sûr totalement privé.

Si vous n'en avez pas encore vous pouvez le générer de la façon suivante :
<pre>
openssl genrsa 4096 > /home/acme/secrets/account.key
chmod 600 /home/acme/secrets/account.key
</pre>
Ce fichier de clé est réutilisable sur tous vos domaines.

Ensuite il vous faudra un fichier de clé par domaine que vous voulez sécuriser, même principe :
<pre>
openssl genrsa 4096 > /home/acme/secrets/networklab.fr.key
chmod 600 /home/acme/secrets/networklab.fr.key
mkdir /home/acme/work/networklab.fr
chmod -R 750 /home/acme/work/
chmod -x /home/acme/work/*/*
</pre>
Ici pour le domaine networklab.fr, à adapter dans votre cas. On créé également un répertoire dédié au domaine dans work.

=Configuration pour la demande du certificat=
Afin de demander votre certificat il est nécessaire de générer une demande de certificat.
Si vous n'avez qu'une adresse qui sera derrière votre certificat :
<pre>openssl req -new -sha256 -key /home/acme/secrets/networklab.fr.key -subj "/CN=networklab.fr" -out /home/acme/work/networklab.fr/networklab.fr.csr</pre>
Mais plus généralement vous en aurez au moins deux (une avec et une sans le www) :
<pre>openssl req -new -sha256 -key /home/acme/secrets/networklab.fr.key -subj "/" -reqexts SAN -config <(cat /etc/ssl/openssl.cnf <(printf "[SAN]\nsubjectAltName=DNS:networklab.fr,DNS:www.networklab.fr")) -out /home/acme/work/networklab.fr/networklab.fr.csr</pre>

Vous pouvez vérifier les différentes informations entrés dans le CSR avec la commande suivante :
<pre>openssl req -in /home/acme/work/networklab.fr/networklab.fr.csr -noout -text</pre>

Avant de générer votre certificat, letsencrypt vient vérifier que votre site vous appartient bien. Pour cela le script va déposer un fichier de "challenge" à l'endroit que vous lui définissez et qui doit être accessible à l'adresse /.well-known/acme-challenge/.

Pour cela il faut donc que votre utilisateur acme puisse écrire dans un dossier de votre site.

Ici nous partons du principe que vous avez un couple d'utilisateur/groupe par site que vous hébergez. Si vous avez une configuration d'Apache avec un seul utilisateur ça n'en sera que plus simple.

En root :
<pre>usermod -a -G networklab.fr acme</pre>
On ajoute le groupe networklab.fr en groupe secondaire de l'utilisateur acme.

Avec l'utilisateur correspondant à votre site (pour nous networklab.fr) :
<pre>
cd /home/networklab.fr/www/
mkdir challenges
chmod g+w challenges/
</pre>
Le dossier challenges hébergera le fichier de challenge que letsencrypt va vérifier. On donne le droit d'écriture au groupe pour que l'utilisateur acme puisse y écrire.

Enfin en root dans la configuration Apache de votre site il faudra ajouter :
<pre>
<Directory "/home/networklab.fr/www/challenges">
    DirectoryIndex disabled
    Options -Indexes -FollowSymLinks
    AllowOverride None
    Require all granted
</Directory>
Alias /.well-known/acme-challenge "/home/networklab.fr/www/challenges"
</pre>

Pensez à bien reload Apache après cette modification.

'''Attention : letsencrypt viendra chercher le fichier de challenge en HTTP et non en HTTPS. Si vous redirigez automatiquement en HTTPS pensez à mettre une exception sur cette adresse.'''

'''De même si vous sécurisez un domaine "d'administration" avec ne protection par .htpasswd pensez également à mettre une exception.'''

Pour cela ajoutez dans le .htaccess :
<pre>
SetEnvIf Request_URI "(challenges/)$" allow
SetEnvIf Request_URI "(\.well-known/acme-challenge/)$" allow
</pre>

=Génération du certificat=
De retour en utilisateur acme, voici le script vous permettant de générer votre certificat :
<pre>
#! /bin/bash
umask 022
python /home/acme/acme-tiny/acme_tiny.py --account-key /home/acme/secrets/account.key --csr /home/acme/work/networklab.fr/networklab.fr.csr --acme-dir /home/networklab.fr/www/challenges/ > /home/acme/work/networklab.fr/networklab.fr.crt
umask 027
wget -O /home/acme/work/networklab.fr/intermediate.pem.new https://letsencrypt.org/certs/lets-encrypt-x3-cross-signed.pem

openssl x509 -in /home/acme/work/networklab.fr/networklab.fr.crt -text -noout &> /dev/null
error=$?
if [ ! $error == 0 ] ; then
        echo "ERROR: ACME output is not a valid x509 certificate"
        exit 1
fi

openssl x509 -in /home/acme/work/networklab.fr/intermediate.pem.new -text -noout &> /dev/null
error=$?
if [ ! $error == 0 ] ; then
        echo "ERROR: intermediate.pem is not a valid x509 certificate"
        exit 1
fi

#only done if no error
mv /home/acme/work/networklab.fr/intermediate.pem.new /home/acme/work/networklab.fr/intermediate.pem
cp /home/acme/work/networklab.fr/networklab.fr.crt /home/acme/work/networklab.fr/networklab.fr.pem
chmod o-r /home/acme/work/networklab.fr/*
</pre>
Le changement d'umask permet d'écrire le fichier de challenges avec des droits permettant à Apache de servir le fichier (le fichier étant créé en acme:acme, l'umask 027 ne le permet pas).
On lance ensuite le script acme-tiny qui prend en paramètres :
* la clé de votre compte
* le csr (demande de certificat)
* l'emplacement où il doit écrire le fichier de challenge
Et en sortie on récupère le certificat.

On repasse ensuite en umask 027, on récupère le certificat intermédiaire de letsencrypt.

Enfin on combine notre certificat au certificat intermédiaire.

Le script est exactement le même pour un renouvellement de certificat. Vous pouvez donc l'enregistrer (dans notre cas /home/acme/networklab.fr.sh).

Configurez ensuite une tâche cron pour renouveler régulièrement votre certificat.

Actuellement les certificats letsencrypt sont valables 90 jours.

Vous pouvez par exemple partir sur une génération mensuelle :
<pre>
0 4 21 * * /home/acme/networklab.fr.sh
</pre>
''Tous les 21 du mois à 4H00.''

=Configuration de la vhost et reload d'Apache=
Dernière étape en root, il est nécessaire de configurer votre vhost en HTTPS.
Si vous n'aviez que du HTTP vous pouvez rajouter :
<pre>
<VirtualHost *:443>
        SSLEngine on
        SSLCertificateChainFile /home/acme/work/networklab.fr/intermediate.pem
        SSLCertificateFile /home/acme/work/networklab.fr/networklab.fr.pem
        SSLCertificateKeyFile /home/acme/secrets/networklab.fr.key
        Header always set Strict-Transport-Security "max-age=63072000; includeSubDomains"
        Header always set X-Frame-Options DENY
        ServerName networklab.fr
        ServerAlias www.networklab.fr
        Include /etc/apache2/sites-config/networklab.fr.conf
</VirtualHost>
</pre>
On retrouve la configuration du certificat intermédiaire, du certificat de notre domaine et de la clé.
Ensuite différentes configurations SSL, à adapter selon la date à laquelle vous lirez ce tuto.

Exemple de redirection automatique vers HTTPS :
<pre>
RewriteEngine on
RewriteCond %{HTTPS} off
RewriteCond %{REQUEST_URI} !^/.well-known/acme-challenge/.*
RewriteRule ^/?(.*) https://%{SERVER_NAME}/$1 [R=301,L]
</pre>
Vous noterez l'exemption qui est faite à <code>/.well-known/acme-challenge/</code> pour que letsencrypt vienne toujours vérifier les challenges en HTTP et éviter un blocage lié à un certificat expiré.

Dernière étape, configurer un reload d'Apache juste après la date prévue pour le renouvellement de vos certificats.
Vous pouvez au choix :
* donner le droit à l'utilisateur acme de reload Apache et le rajouter à votre script
* faire un cron en root à une date/heure définie juste après tous vos scripts de renouvellement

Ici nous utiliserons le cron en root :
<pre>
5 4 21 * * /etc/init.d/apache2 reload
</pre>
''Tous les 21 du mois à 4H05.''

Et voilà, vous aurez dorénavant un site en HTTPS avec renouvellement automatique du certificat. Vous pouvez facilement reproduire la chose pour d'autres domaines en refaisant les étapes 3 à 6.
Pensez à surveiller que vos certificats se renouvellent bien (idéalement avec du monitoring qui vous alertera en cas de soucis !)