Quick Start Guide

This guide will walk you through adding your first account to GAuth in just a few minutes.

Using the Hosted Application

The easiest way to get started is by using the officially hosted version of the application:

Open GAuth Web Application

Adding a New Account

Let's add a Google account as an example. The process is similar for other services like Dropbox, GitHub, or Amazon.

1. Navigate to your service's 2FA settings. For Google, go to your Google Account security settings and find the "2-Step Verification" section.

2. Add a new authenticator app. You will typically be shown a QR code to scan. Since GAuth is a web app, look for an option like "Can't scan it?" or "Set up manually".

3. Reveal the secret key. The service will display an account name (e.g., user@example.com) and a long string of characters called a "secret key" or "setup key". This key is in Base32 format.

4. Open GAuth and add the account.

   • In the GAuth application, click the Add button.
   • You will see a form with two fields:

   <form>
       <label for="keyAccount">Account name:</label>
       <input type="text" name="keyAccount" id="keyAccount" value="" autocorrect="off" autocapitalize="off" />
       <label for="keySecret">Secret key:</label>
       <input type="text" name="keySecret" id="keySecret" value="" autocorrect="off" autocapitalize="off" />
   </form>

   • Copy the Account name from your service into the Account name field in GAuth.
   • Copy the Secret key into the Secret key field. You can include spaces; GAuth will automatically remove them.

5. Save the account. Click the Add button in GAuth. You will be taken back to the main screen.

Viewing Your OTP Code

You will now see your new account listed on the main screen. A 6-digit one-time password will be displayed, along with a countdown timer indicating when it will refresh. You can now use this code to complete your 2FA login.