Yubikey vérification
- Utilitaire ykman
- HMAC Challenge réponse
- Alternatives compatibles
- Le point essentiel
- Recommandation pratique
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 infoindique 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, avecykman 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 listpeut demander un mot de passe si l’applet OATH est protégée. Pour afficher aussi les codes en cours, utilisezykman oath accounts code.ykman fido credentials listdemande 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
pcscdest actif (systemctl status pcscd). - Si
ykman infomontre 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 infoavant 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(commandenk3 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 :
pcscddoit 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.