Setting Up Two-Factor Authentication (2FA) in Ambience/Repertoire

Ambience 202x
,
1

Users can configure their own Two-Factor Authentication (2FA) once the option has been enabled globally in the application.conf file. Ambience/Repertoire 202x supports TOTP (Time-based One-Time Password) authentication using standard authenticator apps.

Configuration Steps:

  1. Open up application.conf and add the configuration below:

    ambience.user-settings.enable-panel.totp = true

  2. Under simple-server.clients.ambience, locate show-totp and set it to true. This enables the TOTP option at the login screen.

    image
    image299×227 29.9 KB

  3. User Setup in Report Portal (Please restart the server after making the above changes)

  1. Register with Authenticator App
  • Open a TOTP authenticator app (e.g., Google Authenticator) on your phone.
  • Scan the QR code.
  • The app will register as ElixirAmbience (username) and generate a 6-digit code that refreshes every 30 seconds.
  • Ambience allows a one-minute window for clock drift. Ensure your phone and server clocks are in sync.
  1. Confirm Setup
  • Enter the 6-digit code (with or without spaces) and click Confirm.
  • Once successful, the TOTP 2FA Enabled panel will appear.
  • Incorrect or incomplete codes will trigger error messages.
  1. Testing 2FA
  • Log out and log back in.
  • You will be prompted for the 2FA code.
  • Entering an incorrect code will display an error in the login dialog.

Disabling 2FA

  • Open up the user settings and click on the 2FA tab
  • Enter the current 6-digit code and click Disable.
  • A notification will confirm that 2FA has been disabled.
  • If you have the mod-identity privilege, use the Identity module to reset 2FA for a user.