Setting up Trusona for Buildkite using Two-Factor Authentication with TOTP

This guide details the steps required to set up Trusona as a Two-Factor Authenticator with TOTP for Buildkite

By Trusona Engineering
Updated May 29, 2020

• 1. Log in to Buildkite
• 2. Personal Settings
• 3. Two-Factor Authentication & Email Security
• 4. Password Verification
• 5. App Setup
• 6. Recovery Codes
• 7. Scan the QR Code
• 8. 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 Buildkite

Log in to Buildkite

2. Personal Settings

Select Personal Settings from the dropdown menu.

Click on Personal Settings

3. Two-Factor Authentication & Email Security

Locate the navigation menu on the left-side of the page and select the Two-Factor Authentication tab.

Select Two-Factor Authentication

Make sure you have verified your email address before proceeding. Buildkite won't allow you to enable Two-Factor Authentication until you have verified it.

Verify your email address

4. Password Verification

You will be asked to re-enter your account password for security purposes. Type it in and click on Confirm Password

Re-enter your account password

5. App Setup

Make sure to have the Trusona app installed on your mobile device before clicking on Setup Two-Factor Authentication.

Click on Setup Two-Factor Authentication

6. Recovery Codes

You will be prompted to save some recovery codes for account access, should you not have access to the Trusona app. Make sure to store them someplace securely before clicking Next.

Securely store recovery codes

7. 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

8. Finalize

Enter the code from the app into the screen, then click Activate It should now show that two-factor authentication is Enabled.

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

Finalize

---