LLI Wiki — My Digital Knowledge Base

YubiKey : clés GPG et authentification SSH

Utiliser une YubiKey comme carte OpenPGP : codes PIN, authentification SSH via l'agent GPG et dépannage sous Windows.

Utiliser une YubiKey comme carte à puce OpenPGP : vérifier la carte, gérer les codes PIN, utiliser la clé GPG pour l'authentification SSH et résoudre les problèmes courants de l'agent GPG sous Windows. KEYID désigne l'identifiant d'une clé.

Vérifier et configurer la carte

gpg --card-status
gpg --card-edit

gpg --card-status affiche les clés présentes sur la YubiKey et le nombre d'essais restants. gpg --card-edit ouvre l'éditeur de la carte (taper admin pour les commandes d'administration, puis passwd pour changer les codes PIN).

Codes PIN d'usine de l'application OpenPGP : 123456 pour le PIN utilisateur et 12345678 pour le PIN administrateur. Changez-les dès la mise en service.

Pour modifier une clé et ses sous-clés (déplacer une sous-clé vers la carte avec keytocard, par exemple) :

gpg --expert --edit-key KEYID

Authentification SSH avec la clé GPG

L'agent GPG peut jouer le rôle d'agent SSH et utiliser la sous-clé d'authentification de la YubiKey.

  1. Activer le support SSH dans gpg-agent.conf (~/.gnupg/gpg-agent.conf sous Linux) :
    enable-ssh-support
    
    Sous Windows, avec PuTTY ou un client compatible Pageant, ajouter aussi :
    enable-putty-support
    
  2. Sous Linux, faire pointer SSH vers l'agent GPG :
    export SSH_AUTH_SOCK=$(gpgconf --list-dirs agent-ssh-socket)
    gpg-connect-agent updatestartuptty /bye
    
  3. Exporter la clé publique au format SSH et l'ajouter dans ~/.ssh/authorized_keys du serveur :
    gpg --export-ssh-key KEYID
    
  4. Vérifier que l'agent voit la clé :
    ssh-add -L
    

Redémarrer l'agent GPG sous Windows

Un chemin avec des espaces doit être entièrement entre guillemets, sinon cmd répond 'C:\Program' is not recognized as an internal or external command :

"C:\Program Files (x86)\GNU\GnuPG\gpg-connect-agent.exe" /bye

Arrêter puis relancer l'agent :

gpg-connect-agent killagent /bye
gpg-connect-agent /bye

Après killagent, un message ERR 67125247 Fin de fichier <Agent GPG> est normal : l'agent s'est arrêté avant de répondre.

Signer une clé et lui faire confiance

gpg --edit-key KEYID
gpg> sign
gpg> trust
gpg> q

GnuPG demande une confirmation puis la phrase de passe. Pour trust, choisir en général « confiance entière » (4) pour la clé d'un tiers que l'on a vérifiée.

Vérifier un fichier téléchargé avec sa signature détachée :

gpg --verify KeePass-2.35-Setup.exe.asc KeePass-2.35-Setup.exe

Récupérer l'identifiant d'une clé dans un script

gpg --list-keys --with-colons | awk -F: '/^pub/ {print $5}'
gpg --list-keys --with-colons | awk -F: '/^sub/ {print $5}'

Le format --with-colons est stable et prévu pour les scripts : le champ 5 contient l'identifiant long de la clé (ou de la sous-clé). L'ancienne méthode qui découpe 2048R/ABCD1234 dans la sortie lisible ne fonctionne plus avec GnuPG 2.1 et plus récent, qui affiche l'empreinte complète.

Débloquer le PIV avec le PUK sous Windows

Pour l'application PIV (pas OpenPGP) : sous Windows 7, le PUK se saisit en hexadécimal dans le champ « Response » (le PUK d'usine 12345678 devient 3132333435363738). Sous Windows 8, Server 2012 et plus récents, il se saisit en texte normal dans le champ de déblocage du PIN.

Disposition du clavier

En mode OTP, la YubiKey se comporte comme un clavier QWERTY américain. Sur un poste en AZERTY ou une autre disposition, certains caractères générés peuvent être faux : voir YubiKey and keyboard layouts.

Références

Remarques

Mastodon LLIMastodon SocialFosstodon