Secure your SSH using two-factor authentication on Ubuntu 16.04

2fa on ubuntu

In this tutorial, we will describe the necessary steps to configure two-factor authentication (2FA) using Google authenticator on an Ubuntu 16.04 VPS. This application includes implementations of one-time passcode generators for several mobile platforms. This method adds another layer of protection to your server adding an extra step to the basic login procedure.

Login to your  server via SSH as user root

ssh root@IP_Address

Update all installed packages:

apt-get update && apt-get upgrade

Install the Google Authenticator package.

apt-get install libpam-google-authenticator

Once the package is installed, run the google-authenticator program to create a key for the user you will be logging with. The program can generate two types of authentication tokens – time-based and one-time tokens. Time-based passwords will change randomly at a certain amount of time, and one-time passwords are valid for a single authentication.

In our case, we will use time-based passwords. Run the program to create the keys


You will be asked if you want the authentication to be time-based.

Do you want authentication tokens to be time-based (y/n) y

Big QR code will be generated in your terminal. You can scan the code with the authenticator application on your Android/iOS/Windows phone or tablet or enter the secret key generated on the screen.

Emergency scratch codes will also be generated. You can use these codes for authentication in case you lose your mobile device.

Your emergency scratch codes are:

Save the authentication settings for the root user by answering YES to the next question

Do you want me to update your "/root/.google_authenticator" file (y/n) y

Next, you can configure the authenticator to generate one-time passwords. Since they last 30 seconds, all generated passwords can be used once.

Do you want to disallow multiple uses of the same authentication
token? This restricts you to one login about every 30s, but it increases
your chances to notice or even prevent man-in-the-middle attacks (y/n) y

You can use the next setting if you have time syncing issues across your devices, so we will not use this option

By default, tokens are good for 30 seconds and in order to compensate for
possible time-skew between the client and the server, we allow an extra
token before and after the current time. If you experience problems with poor
time synchronization, you can increase the window from its default
size of 1:30min to about 4min. Do you want to do so (y/n) n

The next setting prevents brute-force attacks. You will only have three chances per 30 seconds to enter the correct password.

If the computer that you are logging into isn't hardened against brute-force
login attempts, you can enable rate-limiting for the authentication module.
By default, this limits attackers to no more than 3 login attempts every 30s.
Do you want to enable rate-limiting (y/n) y

Now we have the Google Authenticator application configured and the next step is to configure the authentication settings in openSSH. To do so, open the “/etc/pam.d/sshd” file and add the following line to the end of the file:

# vim /etc/pam.d/sshd

auth required

Save the changes, and open the “/etc/ssh/sshd_config” file and enable Challenge Response Authentication.

# vim /etc/ssh/sshd_config

ChallengeResponseAuthentication yes

Save the file, and restart the SSH server for the changes to take effect.

systemctl restart ssh

If you closely followed this tutorial, two-factor authentication is enabled on your server and every time you try to login to your Ubuntu VPS via SSH you will have to enter your user’s password and the verification code generated by Google Authentication application on your mobile device.

Of course, you don’t have to do any of this if you use one of our Linux VPS Hosting services, in which case you can simply ask our expert Linux admins to help you to enable two-factor authentication on your server. They are available 24×7 and will take care of your request immediately.

PS. If you liked this post please share it with your friends on the social networks using the buttons below or leave a reply in the comments section. Thanks.

How to change the default SSH port on a Linux VPS
How to install Group-Office 6 on an Ubuntu 14.04 VPS
Install Chevereto on a CentOS 7 Linux VPS
  • Hector


    Author Reply

    Can this be implemented for any server or does it have to be a VPS? Thanks.

    • admin


      Author Reply

      You can implement two-factor authentication on any server.

  • Benjamin


    Author Reply

    Please continue this great work and I look forward to more of your awesome blog posts.