Two-Factor Authentication

Last update: Edit

1 Introduction

In the Deploy and Operate categories of the Developer Portal, there are several operations that require Two-Factor Authentication. In addition, Technical Contacts are required to use 2FA with their Mendix account when they access licensed cloud node details, specifically for transporting MDA files (deployment archives) to the production environment.

This document describes the purpose and the functionality of two-factor authentication.

2 The Purpose

Two-factor authentication (2FA) validates a second authentication mechanism next to your password. It is required for Mendix Cloud node activities done on a production environment. 2FA ensures that you are authenticated when performing sensitive activities, such as deploying packages and handling production data.

For more information, see Google Authentication.

3 How It Works

Before performing an operation on the production environment, you will be required to provide the authentication code.

After entering the authentication code, your browser session is authorized for the next eight hours.

4 Setting Up & Disabling

To transport your deployment package into the production environment, follow these steps:

  1. In your app project, go to the Deploy tab.
  2. Click Deploy below the package you want to deploy.
  3. In the Environments section click Transport to Production for the deployment package you want to transfer from your test environment to acceptance and then to production.
  4. Click Use Google Authenticator in the dialog box that opens. Note that the installation screens are different per smartphone type. The following steps are based on an Android phone.
  5. Open the Google Authenticator app on your smartphone.
  6. Select Set up account on the main page.
  7. Select Scan a barcode or Enter provided key.
  8. Scan the barcode or enter the six-digit time-based code.
  9. Once Google Authenticator is set up you will be asked to confirm by entering the Google Authenticator code.

Your account is now secured with 2FA and ready to use. You will get a six-digit number that expires every minute. You will need to enter that number to validate your account every time you access production.

If you change your device or phone number, you must contact Mendix Support to disable the authenticator on your Mendix account.

You can re-activate 2FA by triggering any action that requires 2FA on your production environment.

5 Changing the Authentication Method

After you have set up your authentication method, you cannot change the authentication method yourself. Only Mendix Support is able to disable the current authentication method. After the authentication method has been disabled, it can be set to a different method.

For example, if you want to change your authentication method from SMS Authentication to Google Authentication, submit a Mendix support request citing Reset Authenticator.

6 Technical Contact

Team members with App Team – Deploy Permissions are authorized to have node permissions. The Technical Contact can grant those members different permissions that can differ per environment. For example, you might want to limit the access of external developers to only the acceptance environment.

For more information, see Node Permissions.

7 Read More