Multi-Factor Authentication (MFA)
Multi-Factor Authentication refers to when your account requires more than one layer of verification prior to access, to increase its security. Whether your account requires MFA or not depends on whether it is enforced at a company level. In other words, if your company requires all its accounts to use MFA, you will not be able to bypass this.
If your an account owner and interested in setting this up, please read our other article, Enabling Multi-Factor Authentication (MFA) For Your Team.
Setting up Your MFA
When you log into your account for the first time after the setting is enforced, you will see the instructions along with a QR code.
Download an Authenticator app
- Microsoft Authenticator – Android or iOS
- Google Authenticator – Android or iOS
- Authy Authenticator – Desktop, Android, or iOS
Once the application is installed, continue with the instructions below.
Using a QR Code
If you are able to scan the QR Code with your phone (e.g. if you logged into Buddy from a different device), then follow these instructions:
- Download an authenticator app on your phone, unless you already have one.
If your company requires you to use a specific authenticator, make sure to follow the company policy in your choice of application - Open the authentication application
- In your app, select the option to Add an account and select the QR Code method
- Direct your camera towards Buddy's QR Code and scan it
- Insert the 6-digit key onto Buddy
- If the 6-digit key is correct, you will be logged into Buddy
Using a Setup Key
If you are logging in from your phone, then you might be unable to scan the QR Code. In that case, follow the instructions below:
- Download an authenticator app on your phone, unless you already have one.
If your company requires you to use a specific authenticator, make sure to follow the company policy in your choice of application - Log into your Buddy account
- Click the Show Setup Key (as seen in the screenshot in the section above).
- Click Copy (as seen in the screenshot below)
- Open the authentication application
- In your app, select the option to add an account and select the Setup Key method
- Insert the account name (we recommend including Buddy in the account name)
- Paste the Setup Key (that you copied in step 4)
- Insert the 6-digit key onto Buddy
- If the 6-digit key is correct, you will be logged into Buddy
What Should You See on your Authenticator App?
There are several authenticator apps that may be used for your Buddy MFA, and hence it will look a bit different based on which application you are using.
During Setup of the MFA
When you open the app, you should see a list of your linked accounts. If you have not yet setup Buddy, there is usually an option either on the top right or bottom right of your app to add a new account.
Retrieving the 6-digit key
If you have successfully set up the MFA, then Buddy will be listed in your accounts. In some authenticator apps, you might have to click this to view the one-time password.
Once you access the 6-digit key, simply copy it and write it into your Buddy account to log in.
Troubleshooting
- QR code will not scan → Use the manual setup key instead of scanning.
- Invalid or expired code → Wait for a new code to generate and re-enter it.
- Authenticator app not generating codes → Ensure your device date and time are set to update automatically.
- Lost or changed device → Contact your IT or support team to reset MFA/2FA. Admins should reach out to Buddy's support team instead.
FAQs
A: No. This setup is only required during your first login or if your MFA/2FA settings are reset.
A: Only one app can be linked during setup. Additional methods must be added by an administrator if supported.
A: No. Once set up, authenticator apps generate codes offline.