How can 2-factor authentication help me?

2-factor authentication (2FA) adds one more layer to your login process, but it’s worth it. It helps protect your account even if someone steals your password. When trying to sign in, after you type in your password, you’ll also need to enter a code from your phone or app: even if someone knows your password, they still can’t get in, making it way harder to hack.

How to enable 2FA

Launch CLI

Launch Multilogin, then open Command Prompt or Terminal, go to the CLI folder and run CLI executable:

Sign in to authenticate

In order to get your API token, you will need to first sign in to your account via the login command.

Paste this command: xcli login --username your username --password your password:

Windows

1. Paste this prompt to sign in: 

   xcli login --username 'your username' --password 'your password'

2. Replace values of the flags  (--username and --password) with your email and password

 

 

macOS

1. Paste this prompt to sign in: 

   ./xcli login --username 'your username' --password 'your password'

2. Replace values of the flags  (--username and --password) with your email and password

 

 

Linux

1. Paste this prompt to sign in: 

   ./xcli login --username 'your username' --password 'your password'

2. Replace values of the flags  (--username and --password) with your email and password

 

 

Enable 2FA for the user

If you wish to activate 2FA for the current user in Multilogin CLI:

1. Enter xcli enable-2fa --device devicename
   • devicename → choose the name it will appear in the 2FA application

xcli enable-2fa --device devicename

./xcli enable-2fa --device devicename

2. Once the command is parsed, the CLI tool will automatically generate a QR code

3. Open your desired authenticator app (such as Google Authenticator, Microsoft Authenticator)
4. Choose to add a new QR code and scan the output → this will create an entry in your authenticator app called MLX
   • Note: if you already have an authenticator input called MLX, you will be prompted to choose a new name
5. Find the code shown in your authenticator → type it into the code area
6. Once done, you will see a success message alongside your backup codes. Store them in a safe place.

Enable 2FA for the workspace

Want to activate the use of 2FA for all users in the workspace, instead of just your own? Follow the steps below:

1. Make sure you have completed all the steps to enable 2FA in the previous section
2. Once the activation is complete, you are able to activate this same key for the workspace
3. Enter xcli enable-2fa-for-workspace  

xcli enable-2fa-for-workspace

./xcli enable-2fa-for-workspace

How to disable 2FA

Disable 2FA for the user

Disabling 2FA is even easier than enabling it! Just enter xcli disable-2fa-for-user and that's it! No flags needed. Your previously enabled 2FA will be turned off.

xcli disable-2fa-for-user

./xcli disable-2fa-for-user

Disable 2FA for the workspace

Disabling 2FA for the workspace affects all its members. To proceed, just enter xcli disable-2fa-for-workspace, no extra flags needed.

xcli disable-2fa-for-workspace

./xcli disable-2fa-for-workspace

How to view 2FA backup codes

Need to recheck your backup codes? It is as easy as one-step in CLI! It is easy to check what are your current backup codes. Just type view-backup-codes:

xcli view-backup-codes

./xcli view-backup-codes

2FA commands table