Setting up Trusona for GitLab 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 GitLab.

By Trusona Engineering
Updated Apr 22, 2020

• 1. Log in to GitLab
• 2. Settings
• 3. Account
• 4. Two-Factor Authentication
• 5. Scan the QR Code
• 6. 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 GitLab

Log in to GitLab.

2. Settings

Click on Settings from the dropdown menu

Click on Settings

3. Account

Under User Settings click on Account.

Click on Account

4. Two-Factor Authentication

To the right the Two-Factor Authentication status is set as Disabled. Click on the Enable two-factor authentication button.

Enable Two-factor authentication

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

6. Finalize

Enter the code from the app into the screen, then click Register with Two-factor app.

You will also be prompted to save backup codes for account access should you not have access to the app. Make sure to store them somewhere safe.

The status should now show that Two-factor authentication is Enabled. The next time you log in to GitLab and are prompted for a One-time passcode, you can use the Trusona app to log in.

Finalize

---