How do I get around multi factor authentication for xTConnect?

An app password is a 16-digit passcode that gives a less secure app permission to access your Google or Microsoft account. If you are using gmail or outlook for your xTconnect, you will need to create an app password for that gmail account.

Create & use app passwords - Gmail

Important: To create an app password, you need 2-Step Verification on your Google Account.

Google information on the above can be found here 
.

You will need to sign into the Google Account associated with xTConnect.

We recommend creating a user in your Google account specifically for xTConnect, “internal” i.e. internal@ourdomain.com but you can use anything.

 
Log into that account, then;
> Manage Your Google Account > Security > 2-Step Verification
  • Turn on - 2-Step Verification
 
In the 2-Step Verification page scroll down to "App passwords”
  • Type in App name i.e. xTuple xTConnect
    • Create
      • Returns a "Generated app password"
 
The Generated app password is a 16 alpha code which used as the password - you may need to include the spaces.
 

How to create an app password Microsoft

To create an app password, take the following steps. You can repeat these steps to create an app password for as many apps or devices as you need.  microsoft support article


  1. Go to the Advanced security options of your Microsoft account dashboard and scroll down to the App passwords section.Create password

  2. Enter this app password where you would enter your normal Microsoft account password in the application.

 
 
 Once you have the app password: 
In the (Batch Manger) app , the email account is internal@ourdomain.com the password is e.g. 16 alpha code Google provided, let’s say; gyds ygay pwqj hfbr
 
The host should smtp.gmail.com and the port will need to be 465 for SSL or 587 for TLS
 

 

Screenshot 2025-05-15 at 4.10.20 PM

 

If you’ve set up 2-Step Verification but can’t find the option to add an app password, it might be because: