Two factor SSH auth with Yubikeys

A while ago I wrote about how to do this exact thing but with an older version of openssh.

If you're running a newer version of SSH, then the command syntax has been updated somewhat.

Firstly, once you've got your yubikey, you'll need to enable EPEL for EL6/7 and install the pam_yubico package.

You'll then need to modify the sshd pam file /etc/pam.d/sshd. There are two options here. 1) You require just the OTP; or 2) You want the OTP and a password.

If you want just the OTP, you add this just after the #%PAM-1.0 header: auth sufficient id=16 authfile=/etc/yubikey_mappings

If you want both password AND OTP, you add this: auth required id=16 authfile=/etc/yubikey_mappings

Now to create the /etc/yubikey_mappings user to key mapping. The README says:

Create a /etc/yubikey_mappings, the file must contain a user name and the Yubikey token ID separated by colons (same format as the passwd file) for each user you want to allow onto the system using a Yubikey.

The mappings should look like this, one per line:

first user name:yubikey token ID1:yubikey token ID2:…. second user name:yubikey token ID3:yubikey token ID4:…. ------

Now, if you want to go further and require both a ssh key AND an OTP, you can add the following to /etc/ssh/sshd_config: AuthenticationMethods publickey,password

Now after you supply a valid ssh key you will be asked for your password. If you've set this up correctly, this will either be your password + OTP or just OTP.


Update 21/Jun/2015 One common question I get is how they can allow access without a yubikey while in the office, but force its usage outside of the office. This has a couple of parts - mainly, you'll probably want to use a public key from inside, but force say a publickey + yubikey outside.

We do this by using a Match block in /etc/ssh/sshd_config as follows: AuthenticationMethods publickey,keyboard-interactive   Match Address AuthenticationMethods publickey

In this method, we set that EVERYONE must use a public key and a keyboard-interactive method to authenticate, then we allow exceptions for small address spaces that we trust. I also recommend making the following changes: PasswordAuthentication no ChallengeResponseAuthentication yes

This disallows skipping the yubikey auth and just using a password. Although, now we're using PAM as the auth source, you can still use a password via PAM - so we need to disable this in /etc/pam.d/sshd: #auth substack password-auth

password include password-auth

Hope this helps.


Comments powered by Disqus