Skip to main content

Introduction

This guide walks you through setting up Multi-Factor Authentication (MFA) using a Cloud-based Authenticator app. Cloud-based Authenticator uses apps such as Google Authenticator, Microsoft Authenticator, or Authy to generate time-based one-time passcodes (TOTP), adding an extra layer of security to your MileApp account.

Step 1: Add MFA Permission to a Role

Before users can enable Cloud-based Authenticator MFA, an administrator must first enable the permission for the appropriate role.
Required permission:
  • View Role
  • Edit Role
  1. Log in to your account using your existing credentials.
  2. Navigate to the Setting menu, then click the Permission tab.
  3. Select the role you want to enable MFA for (e.g., Admin).
  4. Scroll down to the Multi-factor authentication section under Advanced.
  5. Toggle on Multi-factor authentication by Cloud-based Authenticator.
  6. Save your changes.
image

Enable Cloud-based Authenticator MFA permission for a role

Step 2: Navigate to Multi-Factor Authentication Page

Once the administrator has enabled the MFA permission for your role, you can set up Cloud-based Authenticator from your profile.
  1. Click on your profile icon in the top-right corner of the page.
  2. Select Multi-Factor Authentication from the dropdown menu.
image

Access Multi-Factor Authentication from the profile menu

Step 3: Set Up the Authenticator App

On the Multi-Factor Authentication page, you will see the setup form with the status showing Disabled. Follow these steps to enable it:
  1. Download and install an authenticator app on your mobile device (e.g., Google Authenticator, Microsoft Authenticator, or Authy).
  2. Scan the QR code displayed on the page with your authenticator app. Alternatively, you can copy the code shown under “Or enter this code manually” and enter it into your authenticator app.
  3. Enter the 6-digit verification code generated by your authenticator app into the “Enter verification code” field.
  4. Enter your account password in the “Confirm Password” field.
  5. Click the Enable button.
image

Scan the QR code and enter the verification code to enable MFA

Step 4: MFA Enabled Successfully

After successfully entering the verification code and confirming your password, the status will change to Enabled along with the date and time it was activated.
image

Multi-Factor Authentication is now enabled for your account

To disable MFA, enter your password in the “Confirm Password” field and click the Disable button.

Using MFA

After MFA is enabled, you will be prompted to enter an authenticator code during the sign-in process. Here’s how to use MFA with Cloud-based Authenticator:
  1. Enter your username and password as usual on the sign-in page.
  2. Click the Sign In button.
  3. Open your authenticator app and find the 6-digit code for your MileApp account.
  4. Enter the code in the Authenticator Code field.
  5. Click the Submit button.
  6. If the code is correct, you will gain access to your account. If the code is incorrect or has expired, wait for a new code to be generated by your authenticator app and try again.
image

Enter the 6-digit authenticator code during sign-in

Can’t get the code or lost access to your authenticator app? Contact your administrator.

Using MFA on Mobile

MFA is also required when signing in through the MileApp Field mobile app. After entering your credentials, the app will display the Multi-Factor Authentication screen:
  1. Open the MileApp Field mobile app and sign in with your username and password.
  2. The app will navigate to the Multi-Factor Authentication screen.
  3. Open your authenticator app and find the 6-digit code for your MileApp account.
  4. Enter the code in the Authenticator Code field.
  5. Tap the Submit button.
  6. If the code is correct, you will gain access to the app. If the code is incorrect or has expired, wait for a new code to be generated by your authenticator app and try again.
image

Enter the 6-digit authenticator code on the MileApp mobile app