Using Google App Passwords with a Gmail IEM Account

For security reasons, Google will deprecate support for using basic authentication (which relies on your Google account's username and password) with third-party applications when using their Gmail service on May 30, 2022.

It is therefore necessary to use a Google App Password to allow Issuetrak to authenticate with Google when you are using their email service with Issuetrak's IEM feature to prevent disruption of service.

Creating the Google App Password

1. Enable 2-Step Verification on your Google account by navigating to this page and signing into the Google account corresponding with the mailbox that you wish to create an app password for, then following the prompts.
2. Once you've set up 2-Step Verification in the previous step, navigate to https://myaccount.google.com/apppasswords and (again) sign into the Google account corresponding with the mailbox that you wish to create an app password for.
3. Choose Mail for the "select app" drop down.
4. Choose the appropriate device for the "select device" drop down.
5. Click on GENERATE.
6. Copy and save the password shown in the next screen, as this will be the only time you will see this password.

 
Using the Google App Password for IEM Mailboxes

1. Log into the Issuetrak site to be updated.
2. Click the settings gear icon in the top right.
3. Click Incoming Email under the Email section to launch the mail settings.
   • To locate the setting faster, enter incoming email in the search field.
4. Depending on your specific usage, you may want to either edit an existing mailbox or create a new mailbox.
   1. To use the Google App Password on an existing mailbox:
      1. Click edit next to the mailbox to be updated.
      2. Under the "Email Account Information" section, paste the Google App Password into the password field.
      3. Click the Test Connection button to confirm that the settings are working as expected.
      4. Click the Update Mailbox button at the top left to save your settings.
   2. To use the Google App Password when creating a new mailbox:
      1. Click Add under the "Mailboxes" section on the right context menu.
      2. Configure all settings based on your mailbox settings and preferences.
      3. Under the "Email Account Information" section, paste the Google App Password into the password field.
      4. Click the Test Connection button to confirm that the settings are working as expected.
      5. Click the Add Mailbox button at the top left to create the mailbox.
      6. For further instructions on creating new mailboxes, please refer to this Help Center article.

Afterwards, you should test the functionality of IEM to ensure that emails are being turned into issues in your site.