Accueil » Formations » Hygiène numérique » Authentification multifacteur : TOTP, FIDO2 et bonnes pratiques » TP03 – Ajouter un second facteur TOTP à SSH avec PAM

TP03 – Ajouter un second facteur TOTP à SSH avec PAM

← Authentification multifacteur : TOTP, FIDO2 et bonnes pratiques

// travaux pratiques · Hygiène numérique

TP03 - Ajouter un second facteur TOTP à SSH avec PAM

  • TP 3 / 6
  • 7 étapes
  • ≈ 50 min
  • Accès libre

Objectif : exiger, pour se connecter en SSH au serveur du laboratoire, une clé SSH puis un code TOTP, grâce au module PAM pam_google_authenticator, sans jamais perdre l’accès pendant la configuration.

Contexte

Les accès d’administration à distance figurent en tête des usages pour lesquels la CNIL recommande la MFA. Une clé SSH seule protège bien contre le vol de mot de passe, mais pas contre le vol du fichier de clé privée sur un poste compromis, surtout si elle n’a pas de phrase de passe. Ajouter un code TOTP impose à l’attaquant de détenir aussi le téléphone de l’administrateur.

Le module pam_google_authenticator est développé en logiciel libre sur GitHub et packagé par Debian et Ubuntu (paquet libpam-google-authenticator) ; il n’envoie rien à Google, malgré son nom. À la fin du TP, vous saurez enrôler un utilisateur, configurer PAM et sshd pour exiger les deux méthodes, et tester sans risque de vous enfermer dehors.

Prérequis : TP01 et TP02 terminés ; VM Debian 12 ou 13 accessible en SSH par clé pour l’utilisateur alice (bases dans le cours SSH) ; horloge synchronisée ; accès console à la VM (hyperviseur) en secours.

Durée estimée : 50 minutes.

Actions à réaliser

1. Ouvrir une session de secours

Avant toute modification d’authentification, ouvrez deux sessions SSH sur la VM et passez root dans l’une (sudo -i). Elle restera ouverte jusqu’à la fin du TP : les sessions existantes ne sont pas coupées par un rechargement de sshd. Vérifiez aussi que vous avez accès à la console de la VM depuis l’hyperviseur.

Résultat attendu : une session root ouverte et inutilisée, prête à annuler une erreur.

2. Installer le module PAM

sudo apt update
sudo apt install libpam-google-authenticator

Résultat attendu : la commande google-authenticator est disponible et le module pam_google_authenticator.so est installé dans le répertoire des modules PAM.

3. Enrôler l’utilisateur alice

Connecté en tant qu’alice (pas root : le secret est stocké dans le répertoire personnel de l’utilisateur qui lance la commande), exécutez :

google-authenticator -t -d -f -r 3 -R 30 -w 3 -e 5
  • -t : codes temporels (TOTP) ;
  • -d : interdit la réutilisation d’un code déjà accepté (protection contre le rejeu) ;
  • -f : écrit le fichier sans poser de question ;
  • -r 3 -R 30 : au plus 3 tentatives de connexion toutes les 30 secondes ;
  • -w 3 : accepte le code précédent, le courant et le suivant (valeur par défaut) ;
  • -e 5 : génère 5 codes d’urgence (10 au maximum).

Résultat attendu : un QR code, la clé secrète, un code de vérification et les codes d’urgence s’affichent ; le fichier ~/.google_authenticator est créé. Scannez le QR code avec l’application du téléphone et copiez les codes d’urgence dans la base mfa-equipe.kdbx du TP02.

4. Vérifier les droits du fichier de secret

ls -l ~/.google_authenticator

Par défaut, le module refuse un fichier accessible à d’autres que son propriétaire (options no_strict_owner et allowed_perm pour assouplir, à éviter). Résultat attendu : le fichier appartient à alice et n’est lisible que par elle (droits -r-------- ou -rw-------).

5. Configurer PAM pour sshd

Dans /etc/pam.d/sshd, la documentation Ubuntu remplace l’inclusion de l’authentification par mot de passe par le module TOTP. Ainsi, après la clé SSH, seul le code est demandé, pas le mot de passe Unix.

sudo cp /etc/pam.d/sshd /etc/pam.d/sshd.bak
sudo nano /etc/pam.d/sshd

# remplacer la ligne :
@include common-auth
# par :
auth required pam_google_authenticator.so

On n’ajoute pas l’option nullok : elle laisserait entrer sans code les comptes non enrôlés. Résultat attendu : le fichier ne contient plus @include common-auth mais la ligne auth required pam_google_authenticator.so.

6. Configurer sshd et recharger

Créez un fichier dans /etc/ssh/sshd_config.d/, inclus par la configuration par défaut de Debian :

sudo nano /etc/ssh/sshd_config.d/50-mfa.conf

KbdInteractiveAuthentication yes
PasswordAuthentication no
AuthenticationMethods publickey,keyboard-interactive

sudo sshd -t
sudo systemctl reload ssh

KbdInteractiveAuthentication active la méthode qui transmet le code à PAM (sur les anciennes versions, la directive s’appelait ChallengeResponseAuthentication) ; AuthenticationMethods exige la clé publique puis le dialogue interactif. UsePAM yes et PubkeyAuthentication yes doivent rester actifs (valeurs de Debian). Résultat attendu : sshd -t ne renvoie rien, signe d’une syntaxe valide, et le rechargement réussit.

7. Tester depuis une troisième session

ssh alice@IP_DE_LA_VM

Résultat attendu : la clé SSH est utilisée sans message, puis le serveur affiche une invite Verification code:. Le code du téléphone ouvre la session. Essayez ensuite un code faux, puis le même code valide deux fois de suite dans la même période : les deux tentatives doivent être refusées.

Vérification

  • Une connexion sans le code est impossible, même avec la bonne clé.
  • Une connexion sans la clé échoue avant toute demande de code (ssh -o PubkeyAuthentication=no alice@IP_DE_LA_VM doit être refusé).
  • Un code d’urgence permet une connexion une seule fois.
  • sudo sshd -T | grep -i authenticationmethods affiche publickey,keyboard-interactive.

Problèmes fréquents

  • Aucune invite de code, connexion directe. Cause : fichier non chargé ou directive écrasée plus haut dans la configuration. Correction : sudo sshd -T pour lire la configuration effective ; sous Debian, la première valeur rencontrée l’emporte.
  • Le mot de passe Unix est demandé en plus du code. Cause : @include common-auth toujours présent dans /etc/pam.d/sshd. Correction : le remplacer comme à l’étape 5.
  • Tous les codes sont refusés. Cause : horloge décalée, ou fichier de secret trop permissif ou appartenant à root (enrôlement lancé avec sudo). Correction : timedatectl, puis refaire l’enrôlement en tant qu’alice ; consulter journalctl -u ssh.
  • Plus aucun accès. Cause : erreur de configuration rechargée. Correction : depuis la session de secours ou la console, restaurer /etc/pam.d/sshd.bak, supprimer 50-mfa.conf et recharger.

Bonnes pratiques et sécurité

  • Testez toujours avec une session de secours ouverte et un accès console.
  • N’utilisez pas nullok en production, sauf transitoire et documenté pendant une phase d’enrôlement.
  • Conservez la limitation de débit (-r, -R) et l’interdiction de réutilisation (-d).
  • Le fichier ~/.google_authenticator contient le secret : excluez-le des sauvegardes non chiffrées.
  • Combinez avec les mesures du cours SSH : connexion root interdite, utilisateurs autorisés listés.

Questions de contrôle

1. Pourquoi remplace-t-on @include common-auth ?

Voir la réponse

Pour que PAM demande uniquement le code TOTP après la clé SSH, au lieu du mot de passe Unix suivi du code.

2. Que se passerait-il avec l’option nullok ?

Voir la réponse

Un utilisateur sans fichier de secret pourrait se connecter avec sa seule clé : la MFA ne serait plus obligatoire.

3. Quel est le rôle de l’option -d ?

Voir la réponse

Elle interdit d’utiliser deux fois le même code, conformément à l’exigence anti-rejeu de la RFC 6238.

Pour aller plus loin

  • Révisez les fondamentaux et le durcissement de sshd dans le cours SSH : connexion à distance sécurisée avec OpenSSH.
  • Étudiez l’option grace_period du module, qui évite de redemander le code pendant une durée donnée depuis la même adresse IP, et pesez-en le risque.

Gardez cette configuration active : le TP04 la fera évoluer pour les comptes équipés d’une clé FIDO2.

// formation sur mesure

Former votre équipe sur ce sujet ?

Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.

Demander un programme
Défiler vers le haut