{"id":12297,"date":"2026-03-10T21:47:02","date_gmt":"2026-03-11T02:47:02","guid":{"rendered":"https:\/\/www.rushworth.us\/lisa\/?p=12297"},"modified":"2026-05-20T15:47:52","modified_gmt":"2026-05-20T20:47:52","slug":"yubikey-biometric-on-fedora-using-fido2","status":"publish","type":"post","link":"https:\/\/www.rushworth.us\/lisa\/?p=12297","title":{"rendered":"Yubikey Biometric on Fedora using FIDO2"},"content":{"rendered":"<p># Insert key &#8211; was flashing green at first, flashing orange after software installed<br \/>\n# As root<br \/>\n# Install required packages<br \/>\nsudo dnf install pam-u2f fido2-tools yubikey-manager pamu2fcfg<\/p>\n<p># As the user<br \/>\n# See note below re: setting pin<br \/>\n# The FIDO2 PIN must be at least 4 characters, and supports any type of alphanumeric characters. Some YubiKeys can be configured to require a longer PIN. (https:\/\/docs.yubico.com\/software\/yubikey\/tools\/ykman\/FIDO_Commands.html)<br \/>\nykman fido access change-pin<\/p>\n<p># List current fingerprints &#8211; should be none, since no user is set up, will prompt for your pin<br \/>\nykman fido fingerprints list<br \/>\n# Add your fingerprint &#8211; RI stands for &#8220;right index&#8221; and is essentially a display name for the fingerprint (https:\/\/docs.yubico.com\/software\/yubikey\/tools\/ykman\/FIDO_Commands.html#ykman-fido-fingerprints-add-options-name)<br \/>\n# Green light is fast flashing &amp; prompted to touch sensor. Not a slide, touch and remove finger. It prompts with how many more scans are needed &amp; reports when the print is not read (capture failed, recenter your finger and try again)<br \/>\n# Key stopped flashing<br \/>\nykman fido fingerprints add RI<\/p>\n<p>&nbsp;<\/p>\n<p># Set up pam to use key\/print as auth<br \/>\nmkdir ~\/.config\/Yubico<br \/>\nchmod 700 ~\/.config\/Yubico<\/p>\n<p># Run command, when key flashes green touch it with the registered finger<br \/>\npamu2fcfg &#8211;username &#8220;$USER&#8221; &#8211;origin &#8220;pam:\/\/$(hostname)&#8221; &gt;&gt; ~\/.config\/Yubico\/u2f_keys<br \/>\nchmod 600 ~\/.config\/Yubico\/u2f_keys<\/p>\n<p>&nbsp;<\/p>\n<p># Back as root<br \/>\nauthselect current<\/p>\n<p># Results:<br \/>\nProfile ID: local<\/p>\n<p>with features:<br \/>\nwith-silent-lasting<br \/>\nwith-mdns4<br \/>\nwith-fingerprint<\/p>\n<p># If nothing is selected, run the following and use &#8220;-b sssd&#8221; instead of &#8220;-b local&#8221; below.<br \/>\n# authselect select sssd<\/p>\n<p>authselect create-profile yubikey -b local<br \/>\nauthselect select custom\/yubikey with-silent-lastlog with-mdns4 with-fingerprint<\/p>\n<p># Edit two files<br \/>\n\/etc\/authselect\/custom\/yubikey\/system-auth<br \/>\n\/etc\/authselect\/custom\/yubikey\/password-auth<\/p>\n<p># Add this line near the top of the auth section, before the usual pam_unix.so \/ pam_sss.so lines:<br \/>\nauth sufficient pam_u2f.so authfile=.config\/Yubico\/u2f_keys cue userverification=1<\/p>\n<p>authselect apply-changes<\/p>\n<p># Test before rebooting and losing the currently logged on session<\/p>\n<p>ctrl-al`-f3 and log into the alt console<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>Note: You may be prompted for the FIDO2 PIN in cases like:<br \/>\nYou haven\u2019t enrolled fingerprints (or user verification isn\u2019t available), and the system\/app requires verification.<br \/>\nToo many failed fingerprint attempts and the key requires a PIN to re-enable verification.<br \/>\nCertain management actions (adding\/removing fingerprints, resetting FIDO2, etc.).<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p># If not working, update the custom system-auth and password-auth to debug output<br \/>\nauth sufficient pam_u2f.so authfile=%h\/.config\/Yubico\/u2f_keys cue userverification=1 debug debug_file=\/var\/log\/u2f.log<\/p>\n<p># Initialize file, otherwise debug output goes to screen<br \/>\ntouch \/var\/log\/u2f.log<\/p>\n<p>On GUI logon, you have to hit enter (or the arrow) like you are logging in with a password (but you don&#8217;t have to type the password) and touch the thing when it flashes green<\/p>\n<p>If you register new fingerprints on the key, you do not need to regenerate your keys file<br \/>\nKDEWallet will prompt to store every new fingerprint you use.<\/p>\n","protected":false},"excerpt":{"rendered":"<p># Insert key &#8211; was flashing green at first, flashing orange after software installed # As root # Install required packages sudo dnf install pam-u2f fido2-tools yubikey-manager pamu2fcfg # As the user # See note below re: setting pin # The FIDO2 PIN must be at least 4 characters, and supports any type of alphanumeric &hellip;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[30],"tags":[2201,294,2202],"class_list":["post-12297","post","type-post","status-publish","format-standard","hentry","category-system-administration","tag-fido2","tag-linux","tag-yubikey"],"_links":{"self":[{"href":"https:\/\/www.rushworth.us\/lisa\/index.php?rest_route=\/wp\/v2\/posts\/12297","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.rushworth.us\/lisa\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.rushworth.us\/lisa\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.rushworth.us\/lisa\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.rushworth.us\/lisa\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=12297"}],"version-history":[{"count":1,"href":"https:\/\/www.rushworth.us\/lisa\/index.php?rest_route=\/wp\/v2\/posts\/12297\/revisions"}],"predecessor-version":[{"id":12298,"href":"https:\/\/www.rushworth.us\/lisa\/index.php?rest_route=\/wp\/v2\/posts\/12297\/revisions\/12298"}],"wp:attachment":[{"href":"https:\/\/www.rushworth.us\/lisa\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=12297"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.rushworth.us\/lisa\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=12297"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.rushworth.us\/lisa\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=12297"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}