Overview
Multi-Factor Authentication (MFA) adds an extra layer of security to your Agencio account by requiring two forms of verification when you login: your password and a time-based code from an authenticator app on your mobile device.
This guide will walk you through the process of logging into Agencio OS using MFA, and how to set up MFA if you have not done so already.
Why MFA? MFA significantly reduces the risk of unauthorized access to your account, even if your password is compromised. It is a security best practice required for enterprise accounts.
Prerequisites
Before you begin, make sure you have:
- An active Agencio account with your email and password
- A smartphone with an authenticator app installed
- Access to the email address associated with your account
Recommended Authenticator Apps
You can use any TOTP (Time-based One-Time Password) compatible authenticator app. Here are some popular options:
Setting Up MFA for the First Time
If you have not yet enabled MFA on your account, follow these steps:
Navigate to Security Settings
Click on your profile icon in the top right corner, then select "Settings" followed by "Security".
Enable MFA
Click "Enable Multi-Factor Authentication" and you will see a QR code displayed on screen.
Scan the QR Code
Open your authenticator app and scan the QR code. This will add Agencio to your authenticator and begin generating 6-digit codes.
Enter Verification Code
Enter the 6-digit code shown in your authenticator app to verify the setup. The code changes every 30 seconds.
Save Recovery Codes
You will be shown recovery codes. Save these in a secure location - they can be used to access your account if you lose access to your authenticator app.
Important: Store your recovery codes securely. These are the only way to recover your account if you lose access to your authenticator app. Each code can only be used once.
Logging In with MFA
Once MFA is enabled, here is how to login:
Open Your Authenticator App
After entering your password, you will be prompted for an MFA code. Open your authenticator app on your phone.
Enter the 6-Digit Code
Find the Agencio entry in your authenticator app and enter the current 6-digit code. Note that codes refresh every 30 seconds.
Access Granted
Once verified, you will be logged into the Agencio platform.
Tip: If your code is about to expire (timer nearly at 0), wait for the next code to appear. This gives you more time to enter it correctly.
Troubleshooting
Code Not Working
If your MFA code is being rejected:
- Check the time: Ensure your phone's clock is set to automatic. TOTP codes are time-sensitive and require accurate time synchronization.
- Use a fresh code: Wait for a new code to appear and try again immediately.
- Correct account: If you have multiple accounts in your authenticator, make sure you are using the code for Agencio.
Lost Access to Authenticator
If you have lost your phone or cannot access your authenticator app:
- Use a recovery code: On the MFA screen, click "Use recovery code" and enter one of your saved recovery codes.
- Contact support: If you do not have recovery codes, contact support@agencio.cloud for account recovery assistance. You will need to verify your identity.
Setting Up on a New Device
If you have a new phone and need to transfer your MFA:
- Login to Agencio using your old device or a recovery code
- Go to Settings > Security > Multi-Factor Authentication
- Click "Reset MFA" to generate a new QR code
- Scan the new QR code with your new device's authenticator app
- Verify with a code from the new device
- Save your new recovery codes