Two Factor Authentication

This guide will take you through everything related to the managment of Two Factor Authentication on your Linux servers. Each user will need to setup Two Factor Authentication on thier account if you have enabled Two Factor Authentication on the Server Group.

Setup Two Factor Authentication

1. Click "Keys and Codes" on the menu and then "Two Factor Auth"

2. If you don't have Two Factor Authentication already setup then you will be prompted to create a new Two Factor Secret. Click "Create"

   

3. Follow the prompts on screen by clicking "Next" until you are presented with a large QR Code. At this point use your mobile phone and a Two Factor Authentication app to scan the QR code. Each application has a different process to complete this, so we won't detail that here, rather refer to your Two Factor Authentication app documentation

   

4. A list of Two Factor Authentication apps for Android and iPhone is available here

5. Once you have scanned the QR code you will be given a 6 digit code by the Two Factor Authentication app. Enter in the 6 digit code and click "Next"

   

6. If you have entered in the code correctly then you will be presented with the successful setup page which lists your Backup Codes. You can use these codes to login to any of the servers in an emergency or if you don't have access to your mobile phone. Store these backup codes in a secure place and do not share them.

   

7. Click "Finish" to complete the process. Your account is now setup for Two Factor Authentication when connecting to servers that have Two Factor Authentication enabled.

Re-setup Phone

If you have permanently lost your mobile phone or your previous Two Factor Authentication setup then you can re-setup your phone to get Two Factor Authentication working again.

1. Click "Keys and Codes" on the menu and then "Two Factor Auth"
2. Click the large "Re-setup Phone" button.

3. Follow the prompts and complete the process as detailed in the Setup Two Factor Authentication section

   

Backup Codes

If you have temporarily lost access to your Two Factor Authentication app on your mobile phone then you can make use of Backup Codes.

1. Click "Keys and Codes" on the menu and then "Two Factor Auth"
2. Click the large "Backup Codes" button.

3. Enter in a backup code on the SSH login screen when prompted for a 6 digit code.

   

Disable Two Factor Authentication

If you are concerend that your Two Factor Authentication secret has been compromised, or you no longer wish to use Two Factor Authentication, then simply disable it as follows:

1. Click "Keys and Codes" on the menu and then "Two Factor Auth"

2. Click the large "Disable" button.