> ## Documentation Index
> Fetch the complete documentation index at: https://moengage-user-guide.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up 2-Step Verification on Your Device

MoEngage allows you to secure your MoEngage account (workspace) with 2-step verification. To enable 2-step verification for your account, you must configure a one-time verification setup on your device using an authenticator app. After completing this one-time setup, the app on your device generates an authentication code. You can log in to your MoEngage account using the latest authentication code generated by your authenticator app.

<Tip>
  **Prerequisites**

  You must have an authenticator app downloaded on your phone or device. MoEngage supports 2-step verification through apps such as Google Authenticator, Twilio Authy, etc.

  * You can download the Google Authenticator from the following links:
    * [Google Play](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2\&hl=en_IN\&gl=US)
    * [App Store](https://apps.apple.com/us/app/google-authenticator/id388497605)
  * You can download Twilio Authy from the following links:
    * [Google Play](https://play.google.com/store/apps/details?id=com.authy.authy)
    * [App Store](https://apps.apple.com/us/app/twilio-authy/id494168017)
</Tip>

# Scenarios for Setting up 2-Step Verification on Your Device

The following are the scenarios for enabling 2-step verification on your device:

* When your Admin [signs up for MoEngage](/user-guide/getting-started/initial-setup/sign-up-with-moengage-or-create-a-new-account-in-moengage) or creates a new workspace, MoEngage enables 2-step verification by default to protect the workspace from unauthorized access. When your admin tries to log in, MoEngage prompts them to set up 2-step verification on their device.
* Your Admin invites you to join a workspace with 2-step verification enabled at the workspace level. When you finish [setting up your account](/user-guide/getting-started/initial-setup/finish-your-account-setup-as-an-invited-user), MoEngage prompts you to set up 2-step verification on your device.
* Your Admin has not enabled 2-step verification at the workspace level, and you have logged in to your account. You enable 2-step verification for your account [in **My profile**](/user-guide/getting-started/initial-setup/manage-your-profile). You log out of your account or close the browser. During your next login, MoEngage prompts you to set up 2-step verification on your device.
* Your [Admin enables 2-step verification](/user-guide/settings/account/security/2-step-verification-or-two-factor-authentication-2fa) after you have logged in to your account, and you are automatically logged out. During your next login, MoEngage prompts you to set up 2-step verification on your device.

The scenarios above take you to the 2-Step Verification page:

<img src="https://mintcdn.com/moengage-user-guide/bJLqVfYJ9gjNIQJ6/images/moengage_3a7ace.png?fit=max&auto=format&n=bJLqVfYJ9gjNIQJ6&q=85&s=45b88b72393d22471793754379bdeae5" alt="2-Step Verification Page" width="2880" height="1364" data-path="images/moengage_3a7ace.png" />

# Configure 2-Step Verification on Your Device

1. On the 2-Step Verification page, click **Setup your device**.
   <img src="https://mintcdn.com/moengage-user-guide/bJLqVfYJ9gjNIQJ6/images/moengage_3a7ace.png?fit=max&auto=format&n=bJLqVfYJ9gjNIQJ6&q=85&s=45b88b72393d22471793754379bdeae5" alt="Setup your device" width="2880" height="1364" data-path="images/moengage_3a7ace.png" />
   The Set your device authentication page appears. <img src="https://mintcdn.com/moengage-user-guide/EBKc9Ylp_fnUkuBK/images/moengage_8c9228.png?fit=max&auto=format&n=EBKc9Ylp_fnUkuBK&q=85&s=2eab966c461c91385c5756f4a9a79d8a" alt="Set your device authentication" width="2880" height="1370" data-path="images/moengage_8c9228.png" />
2. Open the authenticator app on your device now (for example, Google Authenticator) and tap the **+** icon.
   <img src="https://mintcdn.com/moengage-user-guide/dQRIDUQKJ6sJ-GxT/images/moengage_2e8e23.png?fit=max&auto=format&n=dQRIDUQKJ6sJ-GxT&q=85&s=5883079813688a3592f4b1f9a73f77c0" style={{ width:"35%" }} alt="Authenticator Plus Icon" width="652" height="1348" data-path="images/moengage_2e8e23.png" />
   The Add an authentication code screen appears.
   <img src="https://mintcdn.com/moengage-user-guide/OEZzGRSFwifpX5UP/images/moengage_2d1624.png?fit=max&auto=format&n=OEZzGRSFwifpX5UP&q=85&s=fe9b1a58306fa16b6a6967884d2aa215" style={{ width:"36%" }} alt="Add authentication code" width="526" height="1058" data-path="images/moengage_2d1624.png" />
3. Use one of the following authentication options:
   * **Using a QR code**
     1. Tap **Scan a QR code**. The Scan code screen appears.
        <img src="https://mintcdn.com/moengage-user-guide/FL-P7uwjwPpxTJrP/images/moengage_9ecee6.png?fit=max&auto=format&n=FL-P7uwjwPpxTJrP&q=85&s=9e6579f3729f34430ad7e19f4aa68d9e" style={{ width:"35%" }} alt="Scan QR code" width="656" height="1360" data-path="images/moengage_9ecee6.png" />
     2. Scan the QR code on the **Set your device authentication** page in the MoEngage dashboard. An authentication is added to your device. Your authentication app generates a 6-digit code.
   * **Using a setup key**
     1. Tap **Enter a setup key**.
        <img src="https://mintcdn.com/moengage-user-guide/LNSaIrgVyFV18WvY/images/moengage_e6d745.png?fit=max&auto=format&n=LNSaIrgVyFV18WvY&q=85&s=b45f4664d269928e2a7aa1c1104fa31c" style={{ width:"36%" }} alt="Enter setup key" width="526" height="1058" data-path="images/moengage_e6d745.png" />
     2. On the **Enter account details** screen, enter the following details:
        | Fields                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
        | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
        | Account name                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Optional | Type your account name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
        | Your key                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Yes      | Type the 32-digit secret key displayed on the **Set your device authentication** page in the MoEngage dashboard. <br /><img alt="Setup Key Example" src="https://mintcdn.com/moengage-user-guide/C3sQ-tnT4DXc9cXk/images/moengage_331114.png?fit=max&auto=format&n=C3sQ-tnT4DXc9cXk&q=85&s=462fd343efbd8cbadbcf6f504ee3e7a1" width="2880" height="1374" data-path="images/moengage_331114.png" />kk |
        | Type of key                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Optional | This is the type of your key. Supported values are: <br /> - **Time based**: The OTP is generated based on the current time. <br /> - **Counter based**: The OTP is generated based on an incrementing counter. <br /> Select an option. In the following example, *Time based* is selected.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
        | <img src="https://mintcdn.com/moengage-user-guide/2_RVsiG3-M8LaX3k/images/moengage_c59fc2.png?fit=max&auto=format&n=2_RVsiG3-M8LaX3k&q=85&s=51ee6f507f44eb3cf06fb87eb6d0d0ea" alt="Key Type Selection" width="650" height="1364" data-path="images/moengage_c59fc2.png" /> |          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
     3. Tap **Add**.
     4. An authentication is added to your device with the name you entered in the **Account name** box. Your authentication app generates a 6-digit code.
        <img src="https://mintcdn.com/moengage-user-guide/yg1ulbvLZqjzcAb8/images/moengage_bf333b.png?fit=max&auto=format&n=yg1ulbvLZqjzcAb8&q=85&s=7bf7a0d5a5bf50beb2fe969dab5cf435" style={{ width:"36%" }} alt="Authentication Added" width="502" height="1026" data-path="images/moengage_bf333b.png" />
4. In the **Enter the 6 digit verification code** box, type the 6-digit authentication code generated by your authentication app.
   <Info>
     Each authentication code your authentication app generates is valid only for 30 seconds. After that, your authentication app generates a new code.
   </Info>
   <img src="https://mintcdn.com/moengage-user-guide/8iz16AheqipjeI8D/images/moengage_1a5937.png?fit=max&auto=format&n=8iz16AheqipjeI8D&q=85&s=7fcb451c5a93d07459faa411c8a60f70" alt="Enter Verification Code" width="2880" height="1370" data-path="images/moengage_1a5937.png" />
5. Click **Confirm**. You have successfully configured 2-step verification on your device for your MoEngage account.

<img src="https://mintcdn.com/moengage-user-guide/EBKc9Ylp_fnUkuBK/images/moengage_8d89ae.png?fit=max&auto=format&n=EBKc9Ylp_fnUkuBK&q=85&s=6890cc588ffa275036d7e2bae954eab9" alt="Success Message" width="2880" height="1364" data-path="images/moengage_8d89ae.png" />

6. Click **Download recovery codes** to access your account without your device. The recovery codes will be downloaded in the CSV file.
   <Info>
     You should store these codes securely and not share them with others. They serve as a backup or alternative method to verify your identity if you lose access to your primary 2-step verification device. For more information, refer to [Recovery Codes](/user-guide/getting-started/initial-setup/recovery-codes).
   </Info>
7. Click **Login**. The Login to your accounts page appears.

<img src="https://mintcdn.com/moengage-user-guide/8iz16AheqipjeI8D/images/moengage_1a0416.png?fit=max&auto=format&n=8iz16AheqipjeI8D&q=85&s=07146376ea6099d51ac7e47e63ceb25e" alt="Login Page" width="2880" height="1366" data-path="images/moengage_1a0416.png" />

8. You can log in to your account now. For more information, refer to [Log in to MoEngage](/user-guide/getting-started/initial-setup/log-in-to-moengage).

# Troubleshoot Issues with 2-Step Verification

If you are facing challenges with 2-step verification, perform the following steps:

* The 2-step verification code is only valid for 30 seconds, so make sure that the device you are using to access MoEngage and the device where the authenticator is installed both have the same timezone.
* Clear the browser’s cookies and cache.
* Each MoEngage customer is hosted in a separate data center. When logging in, make sure you use the correct URL for your workspace. You can find the correct login URL by referring to the mapping of the workspace [here](/user-guide/data/key-concepts/data-centers-in-moengage) and the API endpoints.
* If you do not receive the email to reset your authenticator device, ensure that your administrative team has not blocked the MoEngage domain.

If you still face challenges after performing the above steps, contact the MoEngage Support team.

For further assistance, please contact your MoEngage Customer Success Manager (CSM) or the Support team.
