Setup SSH Authentication with YubiKey
Posted on 12 Feb 2021, tagged
YubiKey is a kind of hardware security token. The idea is to authenticate a person not only based on something he knows (password), but also on something he owns. It can be a digital file, but a more secure option would be a hardware token like Yubikey since no one can steal it without physical access. I use it for a lot of services. Not surprisingly, it can also be used in ssh authentication. But the official Yubikey tutorials are not very straightforward and the
Archlinux wiki pages are more generic instead of Yubikey specific. So in this article, I’ll introduce how to setup ssh to include Yubikey in the authentication process. The operating system I’m using is Arch Linux, but the process for other Linux systems should be very similar.
Generate OpenSSH Hardware Token
The most easy way is to generate a ssh key file based on Yubikey. OpenSSH supports this since 8.2.
ssh-keygen -t ecdsa-sk
- Touch the Yubikey for a few seconds.
Then you can use the generated ssh key like other key files with
-i option. After type in the login command, you need to touch Yubikey for a few seconds, then you should be able to login.
Update: this way only works while the key is plugged into the ssh host, which makes it useless for SSH. However, it’s still useful for things like local login.
A more generic way is to use PAM with Yubikey. It’s a modular authentication mechanism not only for SSH, but also for lots of other things like local login.
1. Install packages
PAM should be installed by default for Archlinux. So the only package we need to install is the PAM module for Yubikey
2. Generate u2f mapping file
Run this command first:
Touch your Yubikey for a few seconds and save the command result to a configuration file, for example,
3. Config PAM for SSH
The PAM config file for ssh is located at
/etc/pam.d/sshd. In order to add Yubikey as part of the authentication, add this line to the file:
required means Yubikey authentication is necessary. The other options are
optional. Refer to Redhat document for more details.
The parts after
pam_u2f.so are the parameters.
authfile is one of them. For all the supported parameters, refer to Yubico pam-u2f document.
4. Config SSH to include password authentication
In order to actually use PAM in ssh, ssh server needs to include password as part of authorization methods. The configuration is
sshd_config. For example, if you want to use password + Yubikey + ssh key file, you can config it like this:
And make sure
ChallengeResponseAuthentication are both
After this, restart sshd then you can login with Yubikey authentication: type in ssh login command, input user password and press enter, touch the Yubikey for a few seconds, then you should be able to login!