Accueil » Formations » Hygiène numérique » Authentification multifacteur : TOTP, FIDO2 et bonnes pratiques » TP04 – Authentification SSH par clé de sécurité FIDO2

TP04 – Authentification SSH par clé de sécurité FIDO2

← Authentification multifacteur : TOTP, FIDO2 et bonnes pratiques

// travaux pratiques · Hygiène numérique

TP04 - Authentification SSH par clé de sécurité FIDO2

  • TP 4 / 6
  • 7 étapes
  • ≈ 45 min
  • Accès libre

Objectif : créer une clé SSH stockée sur une clé de sécurité FIDO2 (ed25519-sk ou ecdsa-sk), exiger le toucher et le PIN à chaque connexion, et adapter la politique sshd du TP03 pour un administrateur équipé de cette clé.

Contexte

Pour les comptes d’administration, l’objectif est un facteur résistant à l’hameçonnage et impossible à copier. Une clé SSH classique est un fichier : un logiciel malveillant qui la lit peut l’utiliser ailleurs. Avec les types -sk introduits par OpenSSH 8.2, la partie privée reste dans la clé de sécurité ; le fichier du poste ne contient qu’une « poignée » inutilisable sans l’objet physique, et chaque signature exige un geste de l’utilisateur.

Avec l’option verify-required (OpenSSH 8.4), la clé vérifie aussi un PIN : la connexion combine alors possession (la clé) et connaissance (le PIN), ce qui constitue à elle seule une authentification à deux facteurs. À la fin du TP, vous saurez générer, déployer, exiger et récupérer une clé SSH FIDO2.

Prérequis : TP03 terminé ; une clé de sécurité FIDO2 (pour ed25519-sk sur YubiKey, micrologiciel 5.2.3 ou plus récent, sinon utilisez ecdsa-sk) ; un poste client Linux avec OpenSSH 8.4 ou plus récent compilé avec la prise en charge FIDO (c’est le cas des paquets Debian 12 et 13 et Ubuntu 22.04 et plus) ; le serveur de la VM en OpenSSH 8.5 ou plus, nécessaire pour la directive PubkeyAcceptedAlgorithms utilisée à l’étape 5 (Debian 12 fournit la 9.2). Sous Windows, OpenSSH 8.9 au minimum ; l’OpenSSH fourni avec macOS ne prend pas en charge FIDO.

Durée estimée : 45 minutes.

Actions à réaliser

1. Vérifier les versions et définir le PIN

ssh -V
ssh alice@IP_DE_LA_VM 'ssh -V'

Définissez un PIN FIDO2 sur la clé si ce n’est pas fait, avec l’outil du fabricant (par exemple Yubico Authenticator) ou via les paramètres de clé de sécurité du système. Résultat attendu : le poste affiche OpenSSH 8.4 ou plus, le serveur 8.5 ou plus, et la clé possède un PIN.

2. Générer la clé SSH sur l’authentificateur

Branchez la clé de sécurité sur le poste client et lancez la commande recommandée par Yubico :

ssh-keygen -t ed25519-sk -O resident -O verify-required -C "alice-yubikey-1"
  • -t ed25519-sk : type de clé adossé à un authentificateur FIDO (ecdsa-sk en repli) ;
  • -O resident : la clé est « résidente », récupérable plus tard depuis l’authentificateur ;
  • -O verify-required : chaque signature exige le PIN en plus du toucher ;
  • -C : commentaire qui identifiera la clé dans authorized_keys.

Résultat attendu : ssh-keygen demande le PIN puis un toucher de la clé, et crée ~/.ssh/id_ed25519_sk (la poignée) et ~/.ssh/id_ed25519_sk.pub. Protégez la poignée par une phrase de passe si l’outil le propose.

3. Déployer la clé publique

ssh-copy-id -i ~/.ssh/id_ed25519_sk.pub alice@IP_DE_LA_VM

La connexion utilisée pour la copie passe encore par la clé classique et le code TOTP du TP03. Résultat attendu : une ligne commençant par sk-ssh-ed25519@openssh.com et terminée par alice-yubikey-1 est ajoutée à ~/.ssh/authorized_keys sur la VM.

4. Exiger la vérification de l’utilisateur côté serveur

Sur la VM, préfixez la ligne de la clé FIDO2 dans ~alice/.ssh/authorized_keys par l’option verify-required, qui oblige le serveur à refuser une signature produite sans PIN :

verify-required sk-ssh-ed25519@openssh.com AAAA… alice-yubikey-1

On peut aussi l’imposer à toutes les clés FIDO avec la directive PubkeyAuthOptions verify-required dans la configuration de sshd. Résultat attendu : la ligne modifiée est la seule de ce type dans le fichier.

5. Adapter AuthenticationMethods pour alice

Une clé FIDO2 avec PIN apporte déjà deux facteurs : redemander un code TOTP n’ajoute pas grand-chose. Pour cet utilisateur seulement, on autorise la clé publique seule, tout en conservant clé + TOTP pour les autres comptes. Ajoutez à la fin de /etc/ssh/sshd_config.d/50-mfa.conf :

Match User alice
    AuthenticationMethods publickey
    PubkeyAcceptedAlgorithms sk-ssh-ed25519@openssh.com,sk-ecdsa-sha2-nistp256@openssh.com
sudo sshd -t && sudo systemctl reload ssh

PubkeyAcceptedAlgorithms restreint alice aux seules clés FIDO : sa clé classique ne suffit plus. Résultat attendu : sshd -t ne signale rien ; gardez la session de secours ouverte.

6. Tester la connexion

ssh -i ~/.ssh/id_ed25519_sk alice@IP_DE_LA_VM
ssh -i ~/.ssh/id_ed25519 alice@IP_DE_LA_VM

Résultat attendu : la première commande demande le PIN et un toucher, puis ouvre la session sans code TOTP. La seconde, avec la clé classique, est refusée. Débranchez la clé de sécurité et relancez la première : la connexion échoue.

7. Récupérer la clé sur un autre poste

Comme la clé est résidente, un nouveau poste peut retrouver la poignée depuis l’authentificateur (OpenSSH 8.3 et plus) :

cd ~/.ssh
ssh-keygen -K

Résultat attendu : après saisie du PIN, des fichiers id_ed25519_sk_rk… et leur .pub sont écrits dans le répertoire courant ; ils permettent la connexion depuis ce poste.

Vérification

  • La connexion d’alice exige la présence physique de la clé, le PIN et le toucher.
  • La clé SSH classique d’alice est refusée ; les autres comptes restent soumis à clé + TOTP.
  • sudo sshd -T -C user=alice,host=poste,addr=IP_DU_POSTE | grep -i authenticationmethods affiche publickey.

Problèmes fréquents

  • ssh-keygen indique un type de clé inconnu ou un fournisseur de clé de sécurité absent. Cause : OpenSSH trop ancien ou compilé sans FIDO (cas de l’OpenSSH de macOS). Correction : utiliser un client récent compilé avec libfido2.
  • Erreur à la génération en ed25519-sk. Cause : authentificateur qui ne gère pas Ed25519. Correction : générer en ecdsa-sk.
  • Connexion refusée malgré le toucher. Cause : verify-required côté serveur alors que la clé a été générée sans PIN. Correction : régénérer avec -O verify-required après avoir défini le PIN.
  • Le TOTP est encore demandé. Cause : bloc Match placé avant d’autres directives globales ou nom d’utilisateur erroné. Correction : le bloc Match doit être en fin de fichier ; vérifier avec sshd -T -C.

Bonnes pratiques et sécurité

  • Enregistrez deux clés de sécurité par administrateur ; la seconde est conservée en lieu sûr et ajoutée dans authorized_keys dès le départ.
  • Exigez le PIN (verify-required) pour les comptes à privilèges : une clé volée seule ne suffit pas.
  • Nommez les clés dans le commentaire pour pouvoir révoquer précisément celle qui est perdue.
  • Inventoriez les clés publiques autorisées sur les serveurs et retirez celles des personnes parties.

Questions de contrôle

1. Que contient le fichier id_ed25519_sk du poste ?

Voir la réponse

Une poignée qui désigne la clé dans l’authentificateur ; la clé privée elle-même ne quitte pas la clé de sécurité.

2. Pourquoi peut-on se passer du TOTP pour alice ?

Voir la réponse

La clé FIDO2 avec PIN combine déjà possession et connaissance, et elle n’est pas copiable : c’est une authentification multifacteur à elle seule.

3. À quoi sert -O resident ?

Voir la réponse

À stocker la clé dans l’authentificateur pour pouvoir la récupérer sur un autre poste avec ssh-keygen -K.

Pour aller plus loin

  • Utilisez la même clé de sécurité comme clé d’accès WebAuthn sur vos applications web, par exemple derrière Authelia, qui gère WebAuthn en plus du TOTP.
  • Explorez les certificats SSH, qui existent aussi pour les types -sk, pour centraliser l’autorisation.

Conservez la configuration : le TP05 simule la perte de la clé et du téléphone.

// 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