New We just updated our search to make it easier to find the information you need. Check it out!
Tutorials & Solutions
Orders management
Inventory and shipping
Subscriptions
Payments
Catalog
Prices
Rates & Benefits
Insights
Master data
Message Center
Sales Policies
CMS
Checkout
Sellers
Integrations
Account management
Billing
Apps
Other

Enabling 2-factor authentication login

Breno Barreto
Breno Barreto
Last updated
12/31/2019

Two-factor Authentication (2FA) is an authentication method that dramatically increases the security of your store login.

EN- LoginAdmin

That happens because at the time of login, in addition to requiring email and password, the system asks for an extra key (which, in case of VTEX, can be a code sent by SMS or generated by an app).

Since this key is generated at the time of login and has a short life, it becomes almost impossible for someone to enter your store using your credentials without authorization. Without 2FA, someone would only need your email and password to have full access to your store account.

From November 16, 2017, 2-factor authentication (2FA) becomes mandatory for all emails in VTEX Admin.

Without 2FA you won't be able to log in using email and password. This requirement is valid only for login with email and password, and not for other login methods (Google, Facebook and token).

How to enable 2FA

If you have not yet set up 2-factor authentication, whenever you access Admin using email and password, a screen appears where the 2FA configuration is offered.

2fa1

Click Set up.

There are two authentication options:

  • Through a key generated by an authentication app.
  • Through a key sent by phone message (SMS).

2fa2EN

We strongly recommend that you choose the option of authentication through the app, since with SMS authentication you will depend on the telephone operator to have no failures. Using an app, the access key will always be available when needed.

Enabling 2FA through an app

To enable app-based authentication, follow the steps below: 1. Click the Configure the application button. 2. You will be taken to the screen below, where a unique QR Code should be read with the application.2fa3EN

But before you need, of course, to download the app. We recommend Google Authenticator.

It can be downloaded from the App Store (for iphone) and Google Play:

After installing the app, follow these steps:

  1. Enter the app and, in the case of Google Authenticator, click on Begin (other applications have similar configuration).2fa7-2EN
  2. You can choose whether to read the QR Code or enter the code provided (which appears on the VTEX login screen if you click Can not read the code?).2fa8-2EN
  3. Use the camera phone to read the QR Code or manually enter the code.
  4. You will immediately see a 6-digit key in the application.2fa9-2EN
  5. On the login screen, click Continue.2fa10EN
  6. On the next screen, enter the 6-digit key and hit Enter.2fa4EN

Great, 2FA is set up for this email, and your account is secure.

If you sign in using email and password on the same computer, Admin will only prompt you for the key every 3 days. When this happens, simply open the app, check the key that appears for your VTEX access email and enter it on the login screen.

Enabling 2FA via SMS

As said before, we strongly recommend that you use the app instead of SMS. That's because we can not guarantee that your telephone company will be able to deliver the access key whenever necessary.

To set up 2-factor authentication via SMS, follow the steps below: 1. On the Ways to Login screen, click the Register your phone number button. 2. Enter your phone number.2fa5EN 3. Enter the code received by SMS and click Enter .2fa6EN

2FA for telesales operators

As in some companies telesales operators can not use cell phone, VTEX users who only have the telesales access profile are not required to enable 2 factor authentication.

What if I already have 2FA and want to change something?

Let's say you have 2FA through SMS set up for your email but would like to enable 2FA through app.

When you log in, the screen offering the 2FA configuration, shown above, doesn’t appear. Therefore, in order to change your 2FA configuration, you need to access the My User screen. Follow the steps below:

  1. In the Admin’s right corner, click on your name’s abbreviation.
  2. Click on user settings
  3. Click on the two-step authentication option.
  4. Select Manage 2-step authentication.
  5. Choose the option you wish to configure

To set up 2FA through SMS:

  1. Click on the add phone number option
  2. A screen will open to the right-hand side
  3. Type in the country code and the phone number with area code
  4. Click on send code

To configure 2FA through the app:

  1. Click on the Configure option of the Google Authenticator App option
  2. A window will open to the right-hand side
  3. Follow the steps as shown in the window
  4. A code will be sent to your phone
  5. Type in the code and confirm
Still got questions?
Ask the community
Find solutions and share ideas in VTEX's community.
Talk to our experts
Get in touch if you have something specific to ask about the platform.
  • PT
  • ES
VTEX website