Setting up Trusona for Heroku using 2-Step Verification with TOTP

This guide details the steps required to set up Trusona as a 2-step verification authenticator with TOTP for Heroku

By Trusona Engineering
Updated Apr 21, 2020

• 1. Log in to Heroku
• 2. Account Settings
• 3. Managing Account & Two-factor Authentication
• 4. Enabling Two-factor Authentication Overview
• 5. Two-factor Authentication App Selection
• 6. Scan the QR code
• 7. Finalize

Installing the Trusona App

Before you get started with the instructions below you'll need to install and register with the Trusona App.

1. Download the Trusona App on the Apple App Store or Google Play Store.
2. Follow the registration steps in the App.
3. Verify your email by clicking the link from Trusona.
4. You're setup and ready to go!

1. Log in to Heroku

Log in to Heroku

2. Account Settings

Click on Account settings

Account Settings

3. Managing Account & Two-factor Authentication

Under the Account tab, scroll all the way down to Two-factor Authentication and click on Set Up Two-factor Authentication

Account Tab

Two-factor Authentication

4. Enabling Two-factor Authentication Overview

You will be shown a quick overview of the process. Continue to click on Set Up Two-factor Authentication

Enable Two-factor Authentication

5. Two-factor Authentication App Selection

You will be shown a list of suggested Authentication apps to install. Make sure you have the Trusona app installed on your device before proceeding

Click HERE for the guide on how to install the Trusona app

Software developers need to adhere to the warning regarding API tokens and make sure to update their scripts and tools

App installation and updating

6. Scan the QR code

A QR code will be shown on the screen.

1. Open the Trusona app, and tap on the Settings menu
2. Tap 2-step verification (TOTP)
3. Scan the QR code
4. Type in the number you see from the Trusona app

Scanning the code

7. Finalize

Enter the code from the app into the screen, then click Enable Two-factor Authentication It should now show that Two-factor Authentication is Enabled

Setup complete! The next time you log in to Heroku and are prompted for a One-time passcode, you can use the Trusona app to log in.

It is advised to follow the suggestions by Heroku to set up a recovery option

Finalize

---