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.

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 GitLab

Log in to GitLab.

2. Settings

Click on Settings from the dropdown menu

Click on Settings
Click on Settings

3. Account

Under User Settings click on Account.

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

Integrations

Desktop
IAM and SSO
PAM
Productivity
RADIUS
VPN

Guides

Get started guides
Implementation guides
Users guides

SDKs

Mobile SDKs
Server SDKs
Web SDKs

APIs

Authentication Service
ID Proofing Service

TOTP

Business
E-commerce
Finance
Productivity
Social
Gaming
Other