Pour tester une application web en local, mieux vaut éviter les alertes HTTPS agaçantes avec les certificats auto-signés. mkcert franchit ce pas en simplifiant la création de certificats TLS fiables et reconnus sur Debian. Suivez le guide pour installer cet outil et sécuriser vos développements localement sans douleur.
mkcert : générer des certificats HTTPS reconnus en local sur Debian
mkcert est un utilitaire en ligne de commande qui crée une autorité de certification (CA) locale. Cette CA est alors ajoutée aux magasins de confiance de votre système et navigateurs. Du coup, tous les certificats générés avec cette autorité sont acceptés sans avertissement.
Autrement dit, fini les alertes exploreur qui cassent le rythme quand on travaille en local. L’outil produit des certificats valides pour localhost, des IP ou des domaines personnalisés internes.
mkcert ne touche pas à la configuration de vos serveurs, il fournit uniquement les certificats et clés à intégrer vous-même à un serveur comme Nginx ou Apache.
Pourquoi les certificats auto-signés posent problème
Un certificat auto-signé est son propre émetteur. Aucun tiers ne le cautionne, d’où les fameux avertissements de sécurité. En plus, il faut souvent répéter les exceptions sur chaque poste et navigateur.
mkcert prend les devants en créant une vraie CA locale qu’on installe une fois dans les magasins système et navigateurs. Ainsi, tous les certificats signés par cette autorité sont naturellement de confiance partout. Pas besoin d’ajouter d’exceptions répétitives.
C’est comme huiler un moteur avant de le démonter : ça facilite tout. Ici, on évite la corvée de config fastidieuse et on gagne du temps.
Installer mkcert sur Debian : méthode simple et efficace
La manière la plus directe est d’installer le paquet depuis les dépôts Debian. Une ligne suffit :
sudo apt install mkcert libnss3-tools
Le paquet libnss3-tools est indispensable pour mettre à jour le magasin de certificats des navigateurs comme Firefox et Chromium.
La version installée peut être vérifiée avec mkcert -version. Sur Debian, mkcert installe automatiquement la CA locale dans /usr/local/share/ca-certificates/ et met à jour les stores de confiance.
Créer la CA locale et l’installer dans les magasins de confiance
Un simple mkcert -install suffit à générer la CA et à la glisser dans les bons répertoires du système et navigateurs. L’opération réclame rarement un sudo explicite puisque mkcert élève ses privilèges de lui-même.
Pour Firefox récent, sous Debian, il faut parfois intégrer la CA à la main à l’aide de certutil si le magasin de certificats n’est pas détecté automatiquement. Ce souci vient des récentes modifications dans les emplacements des profils Firefox et Chromium.
On repère facilement sa base NSS avec find ~ -name "cert9.db", puis on importe le certificat racine avec :
certutil -A -d sql:$HOME/.config/mozilla/firefox/
Générer un certificat HTTPS adapté à vos services locaux
Une fois l’autorité installée, mkcert peut signer autant de certificats que nécessaire. Il suffit de passer la liste des noms (domaines, localhost, adresses IP) que le certificat doit couvrir.
Exemple :
mkcert app.local "*.app.local" localhost 127.0.0.1 ::1
Le wildcard doit être entre guillemets pour éviter que le shell ne l’interprète. Les certificats sont valides plus de 2 ans, ce qui évite les renouvellements trop fréquents.
Assurer la confiance sur plusieurs machines
mkcert ne diffuse pas la clé privée de la CA — et c’est évidemment une bonne chose. Pour étendre la confiance sur d’autres machines, il suffit de copier le fichier rootCA.pem.
Sur une autre machine Debian, on peut installer mkcert et pointer vers ce répertoire en exportant CAROOT. Ensuite, mkcert -install va injecter la CA dans tous les magasins concernés.
Sinon, on peut juste copier le certificat et l’installer dans le magasin système avec :
sudo cp rootCA.pem /usr/local/share/ca-certificates/mon-ca.crt && sudo update-ca-certificates
L’usage est un peu plus limité puisque les navigateurs comme Firefox ou Chrome ne prendront pas en compte ce dernier, mais c’est suffisant pour un serveur ou un container sans interface graphique.
Intégrer les certificats mkcert avec Nginx ou Apache sous Debian
Après génération, il faut placer les fichiers au bon endroit, généralement sous /etc/ssl/mkcert. On limite strictement l’accès à la clé privée avec chmod 600 et propriétaire root.
En Nginx, un hôte virtuel basique reprend la configuration classique avec les chemins vers le certificat et la clé. On active ensuite le site et recharge Nginx après vérification.
En Apache, activez le module SSL, créez un fichier de configuration avec les directives SSL, activez le site et rechargez le service avec systemctl.
Tester l’accès via https://votre-domaine-local doit afficher un cadenas sécurisé sans aucun avertissement, un sacré soulagement par rapport aux certificats auto-signés classiques.
Options mkcert utiles pour le quotidien
Quelques options facilitent la vie :
-ecdsa pour générer une clé elliptique plus compacte et performante,
-client pour des certificats d’authentification client (mTLS),
-pkcs12 pour produire un paquet .p12 utile sous Windows ou Java,
-uninstall si vous voulez retirer proprement la CA locale.
Simple, efficace, c’est la devise chuchotée par mkcert dans l’univers des tests locaux où HTTPS est vital sans complications inutiles.