Improve this doc

Preferences

Two Factor Authentication

We offer the option to enable Two Factor Authentication - this is a feature that prompts you to input a code from your smartphone/computer in addition to your password, providing an additional layer of security for your account.

Note: We use the industry standard Time-based One-time Password Algorithm to implement this functionality.

Enabling Two-Factor Authentication

Sign up for an account (or log in if you already have one) and go to your preferences page:-

Preferences Page

From here, click on the 'Two factor authentication' tab then click ENABLE to switch it on:-

Two Factor Authentication Tab, Disabled

Once you've enabled two factor authentication you will be given a QR code and prompted for a pairing code as shown below:-

Note: Two factor authentication will only be enabled once you have finished configuring it against your smartphone/computer, so no need to worry about logging out before finishing the configuration then not having access to your account!

Two Factor Authentication Tab, Configuring

In order to use your phone/computer as your added layer of security you will need to download a free authenticator application. There are many available, but one that works well and has been successfully tested against resin.io is Google Authenticator - download it for Android or iOS.

Once installed, navigate to the barcode scanner:-

Note: The Android application is shown here - if you already have accounts installed, tap the 3 vertical dots in the top right-hand corner and select 'Set up account', otherwise you should be given the option when you first start the app.

Google Authenticator Scan Barcode Menu

When you tap the option to scan a barcode your phone will turn on your camera and all you need to do to pair with your account is to simply point it at the QR code displayed on your monitor.

Once configured, you'll see a 6 digit generated code with a graphic beside it indicating a countdown. Once the countdown expires, the code becomes invalid:-

Google Authenticator Codes

Next you'll need to input the displayed code into the 'Pairing code' input on the preferences page.

Once you've paired your authenticator to your resin.io account you'll be all set up and the two factor authentication page will simply give you the option to disable it should you wish to later:-

Note: It's best to wait for the countdown to show plenty of time remaining before doing this as the window during which the code is valid is rather short!

Two Factor Authentication Tab, Enabled

Now when you log in you will be prompted for the code displayed in your authenticator app after you've input your username and password. Enjoy your added layer of security!

List of verified authenticator applications