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

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!

Download on the App Store Get it on Google Play

1. Log in to Buildkite

Log in to Buildkite

2. Personal Settings

Select Personal Settings from the dropdown menu.

Click on Personal Settings
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
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
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
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
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
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
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.





Get started guides
Implementation guides
Users guides


Mobile SDKs
Server SDKs
Web SDKs


Authentication Service
ID Proofing Service
Mobile Auth for Browsers Service