Account Setup

MFA: Enable Multi-Factor Authentication (MFA) as a user

9min

Purple Hub



Summary

As a user, you can enable Multi-Factor Authentication (MFA) in any role to help secure your account. This means that every time you log in to the Purple Platform, you'll need to confirm your identity with a second device to prevent your credentials from being misused.

This article will guide you through setting up two-factor authentication with a third-party authenticator.

  • This article describes how to enable Multi-Factor Authentication (MFA) from Purple Hub. It works the same way in Purple Manager by clicking on your profile in the top right corner.
  • Once enabled, Multi-Factor Authentication (MFA) will always apply to your user within the entire Purple platform, not just the product component in which you've previously enabled it, as it is coupled with single sign-on across Purple.


Preconditions

Download one of these third-party authenticators to your mobile device:

  • FreeOTP, or Microsoft Authenticator, or Google Authenticator

Learn in this article, how the One Time Passwort device can be reset e.g. in case the device used for MFA isn't accessible anymore: MFA: Reset the OTP Device for a Team Member



How to

1. Go to Purple Hub and click on your username

Go to Purple Hub and click on your username


2. Click on 'Account Settings'

Click on 'Account Settings'


3. Below 'Account Security' click on 'Signing in'

Below 'Account Security' click on 'Signing in'


4. Below 'Two-factor authentication' click on 'Set up authenticator application'

Click on 'Set up authenticator application'


5. You are now prompted to the login screen to re-authenticate. Enter your Password into the entry field.

Enter your Password into the entry field


6. Click on 'Sign in'

Click on 'Sign in'


7. You will be taken to the Mobile Authenticator Setup screen. Open the Authenticator app on your smartphone and scan the QR code.

Scan the QR code


8. The Authenticator app on your smartphone will now display a code. Enter the code in the 'One Time Code' field.

Enter the code in the 'One Time Code' field


9. Below 'Device Name' enter a name for your device into the text field, e.g. 'iPhone'

Enter a name for your device into the text field, e.g. 'iPhone'


10. Click on 'Submit'

Click on 'Submit'


11. Below 'Two-factor authentication', you will now see the device name you added earlier.

find the before added device name listed


You have now successfully set up two-factor authentication for your Purple Hub user. Each time you log in, you will be prompted to enter a code generated by the authenticator app on your smartphone. This means that you will need to carry your smartphone with you whenever you are working with the Purple Hub.

Learn in this article, how the One Time Passwort (OTP) device can be reset by an Account Admin e.g. in case the device used for MFA isn't accessible anymore: MFA: Reset the OTP Device for a Team Member