Yubikey vérification

Yubikey vérification

Notes

Utilitaire ykman

Check-up

Un check-up complet se fait avec quelques commandes, à lancer avec la clé branchée.

1
2
3
4
ykman list                 # clés détectées (modèle, série)
ykman info                 # firmware, numéro de série, applications activées (USB / NFC)
ykman config usb --list    # applications activées en USB
ykman config nfc --list    # applications activées en NFC (si la clé en a)

Puis, application par application, ce qui est réellement programmé :

1
2
3
4
5
6
7
ykman otp info                    # slots 1 et 2 : programmé ou vide
ykman fido info                   # PIN défini ou non, essais restants, passkeys
ykman fido credentials list       # passkeys résidentes (demande le PIN FIDO2)
ykman oath info                   # applet TOTP/HOTP : protégée par mot de passe ou non
ykman oath accounts list          # comptes TOTP enregistrés
ykman piv info                    # certificats et clés par slot PIV
ykman openpgp info                # état de l'applet OpenPGP

Comme vous gérez plusieurs clés, un script qui lance tout d’un coup pour la clé branchée :

1
2
3
4
5
6
#!/usr/bin/env bash
for cmd in "info" "otp info" "fido info" "oath info" "oath accounts list" "piv info" "openpgp info"; do
  echo "===== ykman $cmd ====="
  ykman $cmd 2>&1
  echo
done

Ce qu’il faut savoir pour interpréter les résultats :

  • ykman otp info indique seulement si un slot est « programmed » ou « empty ». Il ne dit pas s’il s’agit de Yubico OTP, de challenge-response HMAC ou d’un mot de passe statique, ni si la touche est exigée. Le seul moyen de le vérifier est de tester, avec ykman otp calculate 1 <défi> : une réponse prouve que c’est du challenge-response, et une pression demandée confirme le touch (c’est ce que fait votre script de vérification).
  • ykman oath accounts list peut demander un mot de passe si l’applet OATH est protégée. Pour afficher aussi les codes en cours, utilisez ykman oath accounts code.
  • ykman fido credentials list demande le PIN FIDO2 et liste les sites avec passkey résidente, sans rien révéler de secret.
  • PIV, OpenPGP et OATH passent par PC/SC : si une commande répond qu’elle ne peut pas se connecter à la clé, vérifiez que pcscd est actif (systemctl status pcscd).
  • Si ykman info montre une application désactivée alors que vous en avez besoin, ykman config usb --enable OTP (ou FIDO2, PIV…) la réactive.

Complément

ykman otp info ne répond que « programmed » ou « empty » : il ne dit pas à quoi sert un slot, et le secret ne peut de toute façon pas être relu. Il faut donc le déduire par de petits tests.

1. Tester le challenge-response (le cas qui vous intéresse)

1
2
ykman otp calculate 1 00112233
ykman otp calculate 2 00112233
  • Une réponse en hexadécimal : le slot est en challenge-response HMAC-SHA1. Une demande de pression indique l’option touch.
  • Une erreur du type « slot non configuré pour le challenge-response » : le slot est programmé pour autre chose.
  • Ce test ne modifie rien.

2. Reconnaître les autres usages en touchant la clé

Faites-le dans un éditeur de texte, jamais dans un champ de mot de passe ou un terminal root. Un appui bref déclenche le slot 1, un appui long (environ 2 à 3 secondes) le slot 2.

Ce que la clé tape Usage du slot
Rien du tout Challenge-response HMAC (ou slot vide)
44 caractères commençant par cccccc, vvvvvv, etc., dont les 12 premiers restent fixes et le reste change Yubico OTP (réglage d’usine du slot 1)
Une chaîne identique à chaque appui Mot de passe statique
6 ou 8 chiffres qui changent HOTP

Attention au HOTP : chaque appui incrémente le compteur, et plusieurs appuis dans le vide peuvent le désynchroniser par rapport au serveur. N’insistez pas si vous soupçonnez ce cas.

3. Cas particuliers

  • Un slot 1 « programmed » que vous n’avez jamais touché est presque toujours le Yubico OTP d’usine, enregistré auprès de YubiCloud. Si vous ne l’utilisez pas, on peut le supprimer.
  • Pour effacer un slot et le réutiliser : ykman otp delete 2. C’est irréversible, donc seulement si vous êtes sûr de l’usage.

Pour vos 4 clés, la méthode la plus rapide est donc ykman otp info pour l’état, puis ykman otp calculate sur chaque slot programmé pour repérer le challenge-response.

HMAC Challenge réponse

Plusieurs clés peuvent ouvrir la même base si elles contiennent le même secret HMAC

. Un retour d’utilisateur sur le forum Nitrokey confirme que cela fonctionne entre une Nitrokey 3 et une OnlyKey.

Secret HMAC aléatoire

Si vous aviez laissé l’outil de Yubico générer un secret aléatoire sans le noter, vous ne pourrez pas le copier sur une autre marque. Dans ce cas, deux solutions :

  • reprogrammer un secret que vous connaissez sur vos YubiKey (ce qui change la protection de la base, donc à faire avec une sauvegarde) ;
  • ou ajouter la nouvelle clé comme protection d’une autre base.

Secret HMAC sauvegardé

Voici une version où le défi n’est plus obligatoire : par défaut il est aléatoire (nouveau à chaque lancement), et -c permet de le fixer si tu veux un défi reproductible.

Saisie du secret

  • Collage : le texte collé depuis le presse-papiers s’affiche en * au fur et à mesure, ce qui permet de voir qu’il a bien été pris en compte.
  • Espaces : les espaces, tabulations et retours à la ligne accidentels sont supprimés avant la validation, ce qui arrive souvent avec un copier-coller.
  • Message d’erreur : il indique le nombre de caractères reçus (${#SECRET}). Tu vois ainsi tout de suite s’il en manque, par exemple 39 au lieu de 40. Le secret lui-même n’est jamais affiché.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
#!/usr/bin/env bash
# Vérifie le mode challenge-response HMAC-SHA1 d'une YubiKey.
# Usage : ./check-hmac.sh [-s SLOT] [-c DEFI_HEX] [-h]
#   -s  slot OTP à tester : 1 ou 2                          (défaut : 1)
#   -c  défi fixe en hexadécimal, longueur paire             (défaut : aléatoire, 16 octets)
# Une seule clé branchée à la fois.

set -u

SLOT=1
CHALLENGE=""

usage() {
  sed -n '2,6p' "$0" | sed 's/^# \{0,1\}//'
  exit "${1:-0}"
}

while getopts ":s:c:h" opt; do
  case $opt in
    s) SLOT=$OPTARG ;;
    c) CHALLENGE=$OPTARG ;;
    h) usage 0 ;;
    :) echo "Option -$OPTARG : argument manquant." >&2; usage 2 ;;
    *) echo "Option inconnue : -$OPTARG" >&2; usage 2 ;;
  esac
done

# --- Dépendances ---
for cmd in ykman openssl xxd; do
  command -v "$cmd" >/dev/null || { echo "Commande manquante : $cmd" >&2; exit 3; }
done

# --- Validation / génération du défi ---
[[ $SLOT =~ ^[12]$ ]] || { echo "Slot invalide : '$SLOT' (1 ou 2)." >&2; exit 2; }

if [[ -z $CHALLENGE ]]; then
  CHALLENGE=$(openssl rand -hex 16)
  echo "Défi aléatoire généré."
else
  CHALLENGE=$(printf '%s' "$CHALLENGE" | tr 'A-F' 'a-f')
  if ! [[ $CHALLENGE =~ ^([0-9a-f]{2}){1,64}$ ]]; then
    echo "Défi invalide : hexadécimal, longueur paire, 1 à 64 octets." >&2
    exit 2
  fi
fi

# --- Saisie du secret (affiche un * par caractère) ---
read_secret() {
  local prompt=$1 char=""
  SECRET=""
  printf '%s' "$prompt" >&2
  while IFS= read -rsn1 char; do
    [[ -z $char ]] && break                       # Entrée : fin de saisie
    if [[ $char == $'\177' || $char == $'\b' ]]; then
      if [[ -n $SECRET ]]; then                   # Retour arrière
        SECRET=${SECRET%?}
        printf '\b \b' >&2
      fi
    else
      SECRET+=$char
      printf '*' >&2
    fi
  done
  echo >&2
}

trap 'unset SECRET' EXIT
read_secret "Secret HMAC (40 caractères hexa) : "
SECRET=$(printf '%s' "$SECRET" | tr -d '[:space:]' | tr 'A-F' 'a-f')
[[ $SECRET =~ ^[0-9a-f]{40}$ ]] || { echo "Secret invalide : 40 caractères hexadécimaux attendus (${#SECRET} reçus)." >&2; exit 2; }

# --- Valeur attendue ---
EXPECTED=$(printf '%s' "$CHALLENGE" | xxd -r -p \
  | openssl dgst -sha1 -mac HMAC -macopt hexkey:"$SECRET" | awk '{print $NF}')

# --- Valeur obtenue de la clé ---
echo "Clé détectée :"
ykman list || { echo "Aucune clé détectée." >&2; exit 4; }
echo "Slot $SLOT, défi $CHALLENGE"
echo "Touchez la clé quand elle clignote..."
ACTUAL=$(ykman otp calculate "$SLOT" "$CHALLENGE" | tr -d '[:space:]' | tr 'A-F' 'a-f') \
  || { echo "Échec du calcul (slot non configuré en challenge-response ?)." >&2; exit 4; }

echo "Attendu : $EXPECTED"
echo "Obtenu  : $ACTUAL"

if [ "$EXPECTED" = "$ACTUAL" ]; then
  echo "OK : le secret correspond."
  exit 0
fi

echo "DIFFÉRENT : le secret ne correspond pas."
read -rp "Reprogrammer le slot $SLOT (avec touch) ? Cela écrase sa configuration. [o/N] " R
if [[ $R =~ ^[oOyY]$ ]]; then
  ykman otp chalresp --touch --force "$SLOT" "$SECRET" \
    && echo "Slot reprogrammé. Relancez le script pour vérifier." \
    || { echo "Échec de la reprogrammation." >&2; exit 5; }
fi
exit 1

Utilisation

1
2
3
./check-hmac.sh                                         # slot 1, défi aléatoire
./check-hmac.sh -s 2                                    # slot 2, défi aléatoire
./check-hmac.sh -c 00112233445566778899aabbccddeeff    # défi fixé

Le défi aléatoire convient bien ici, car le test compare le calcul de la clé avec celui du script sur le même défi. Il n’a donc pas besoin d’être identique d’une clé à l’autre.

Si tu préfères un défi figé dans le script, remplace simplement CHALLENGE="" par la valeur voulue en haut du fichier. Il faudra alors adapter le test if [[ -z $CHALLENGE ]].

Quelques précisions pour cette configuration :

  • Pression à faire deux fois si reprogrammation : une fois pour le calcul de vérification, puis à nouveau lors du test après reprogrammation.
  • Le slot 1 est celui de Yubico OTP par défaut sur une clé neuve. Si une de vos clés l’utilise encore pour ça, la reprogrammation l’écrasera. Un ykman otp info avant de commencer vous montre l’état des deux slots.
  • Une clé qui répond « slot non configuré » n’a simplement pas de challenge-response sur le slot 1 : le script proposera de le programmer.
  • Une fois les 4 clés alignées, testez l’ouverture de la base avec chacune.

Autres fabricants compatibles challenge réponse

Nitrokey 3

  • KeePassXC 2.7.6 prend en charge la Nitrokey 3 pour le challenge-response. La modification a été fusionnée dans KeePassXC en juillet 2023. nitrokey
  • Le secret HMAC s’écrit avec l’outil nitropy (commande nk3 secrets add-challenge-response), sur l’un des deux slots disponibles. Il faut un firmware récent (1.5.0 minimum d’après Nitrokey).
  • Sous Linux, la clé passe par PC/SC : pcscd doit tourner et libccid doit être en version 1.5.0 ou plus.

OnlyKey

  • Depuis son firmware 2.1.0, son challenge-response est compatible YubiKey, et l’on peut utiliser les deux indifféremment si elles partagent la même clé HMAC https://docs.onlykey.io/keepassxc-upgrade/.

Pour remplacer vos YubiKeys dans KeePassXC, les alternatives directement compatibles avec le même mécanisme HMAC-SHA1 Challenge-Response sont surtout OnlyKey et Nitrokey. Vous pouvez configurer le même secret sur plusieurs clés afin qu’elles déverrouillent la même base.

Alternatives compatibles

Clé Compatibilité KeePassXC Remarques
OnlyKey Oui, en HMAC-SHA1 challenge-response, compatible avec le format YubiKey. [github][crp][onlykey.discourse] Bonne option si vous voulez un remplacement direct ; nécessite de configurer le secret en hexadécimal. [support.nitrokey]
Nitrokey 3 Oui, avec le même secret HMAC-SHA1, via nitropy nk3 secrets add-challenge-response. [support.nitrokey] Compatible KeePassXC ; des utilisateurs documentent l’interchangeabilité Nitrokey 3 / OnlyKey / YubiKey avec le même secret. [support.nitrokey]
SoloKey Possible selon firmware/version, car certaines implémentations visent la compatibilité HMAC-SHA1, mais ce n’est pas le remplacement le plus éprouvé pour KeePassXC. [panicvault] À vérifier précisément avant achat : le support challenge-response KeePassXC n’est pas aussi clairement documenté que OnlyKey/Nitrokey.

Le point essentiel

KeePassXC utilise un challenge-response HMAC-SHA1, un schéma défini à l’origine par Yubico. Ce n’est donc pas le protocole FIDO2 qui compte ici : une clé très bonne pour FIDO2 peut être inutilisable pour KeePassXC si elle n’implémente pas ce mode HMAC-SHA1.2)]

Pour conserver l’accès à votre base avec plusieurs clés, vous devez mettre exactement le même secret HMAC-SHA1 dans chaque clé. Un exemple documenté consiste à générer un secret aléatoire, le sauvegarder, puis l’installer à la fois sur OnlyKey et Nitrokey 3 ; les deux peuvent alors déverrouiller la même base KeePassXC

Recommandation pratique

  • Remplacement le plus direct : OnlyKey, car son mode HMAC-SHA1 est explicitement compatible avec l’implémentation YubiKey utilisée par KeePassXC
  • Alternative sérieuse : Nitrokey 3, si vous préférez un matériel européen/open source et acceptez la configuration via nitropy.
  • À éviter comme remplacement automatique : une clé FIDO2 seule sans mode HMAC-SHA1 challenge-response, même si elle gère FIDO2, U2F, OTP ou OpenPGP

Avant de migrer, configurez d’abord la nouvelle clé avec le même secret, testez l’ouverture de la base avec elle, puis conservez une sauvegarde chiffrée du secret dans un endroit très sûr : sans ce secret ni une clé configurée, la base protégée par challenge-response ne peut plus être déverrouillée.