Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

JEMH Cloud allows users to connect with Gmail using OAuth. The generated authentication token will be used to secure the SMTP and IMAP connections from JEMHC to your gmail mail box. 

Table of Contents
minLevel1
maxLevel7

Whitelisting JEMH Cloud

Personal google email accounts are not supported.

...

  1. Navigate to App Access Control:

    1. Shortcut: https://admin.google.com/ac/owl/list?tab=apps

    Image Modified
  2. Click Add app, and search for JEMHC, select it and hit Add:

    Image Modified
  3. Add a filter, type JEMHC to see JEMHC listed:

    Image Modified

Creating Message Source by Signing in with Google

  1. Go to JEMHCloud > Messaging > Message Sources > Click Sign in with Google.

    Image Modified
  2. This will take you to the google confirmation screen

    Image RemovedImage Added
  3. Select the Account you with to authenticate and JEMHC access to your support email account

    Image RemovedImage Added
  4. Once accepted, close the tab and go back to JEMH Cloud.

  5. You will then see a new message source which is connected to the gmail account.

    Image Modified

Create Message Source IMAP to Gmail using OAuth

  1. Go to JEMH Cloud > Messaging > Message Sources > Click the Create button. 

  2. In the Create Message Source screen enter a Name and select the Type IMAP GMAIL OAuth OAuth

    Image RemovedScreenshot from 2024-02-20 08-35-04.pngImage Added
  3. Click on the Authorize link. This will take you to the Google confirmation screen. 

    Image RemovedScreenshot from 2024-02-20 08-37-21.pngImage Added
  4. Select the account you want to authorize and allow JEMHC the access to your support email account. 

    Image RemovedScreenshot from 2024-02-20 08-40-10.pngImage Added
  5. Once accepted, close the tab and go back to JEMH Cloud.

  6. The Message Source should appear authorized. The Username should be automatically filled. If not, enter the same email address as the selected account.

    Image RemovedScreenshot from 2024-02-20 08-41-27.pngImage Added
  7. Submit the configuration. Once the configuration is tested, the connection will be created. 

    Image RemovedScreenshot from 2024-02-20 08-42-34.pngImage Added

Create Message Outbound SMTP to Gmail using OAuth

  1. Go to JEMH Cloud → Messaging → Message Outbounds → Click the Create button. 

  2. In the Create Message Source screen enter a Name and select the Type SMTP GMAIL OAuth 

    Image RemovedScreenshot from 2024-02-20 08-47-42.pngImage Added
  3. Click on the Authorize link. This will take you to the Google confirmation screen. 

    Image RemovedScreenshot from 2024-02-20 08-37-21.pngImage Added
  4. Select the email account that you want JEMHC to be able to access.

    Image RemovedScreenshot from 2024-02-20 08-40-10.pngImage Added
  5. Once accepted, close the tab and go back to JEMH Cloud.

  6. The Message Outbound should appear authorised. The Username should be automatically filled. If not, enter the same email address as the selected account.

    Image RemovedScreenshot from 2024-02-20 08-50-35.pngImage Added

  7. Submit the configuration. Once the configuration is tested, the connection will be created. 

...

Troubleshooting

  1. Screenshot from 2024-02-20 08-51-17.pngImage Added

Troubleshooting

Why re-authorization is required

See Refresh token expiry for more reasons:

Denied authorization

During OAuth ‘authorization' its possible to get denied (below) typically this means that the account used is not a GSuite account (app not going through Verification for public use are disabled for ‘free’ accounts). To resolve this, create an ‘incognito’ browser session, login only to Jira, then follow the authorization flow.

...

Outbound mail being added as inbound mail

It appears that when you use a filter for stopping mail from going to the spam, when this is configured it will add the Sent mail into the Inbox which would cause the email to be seen as inbound mail. To solve this you would need to either remove the filter or modify the filter so that it does not match the address used for Outbound emails.

Note: This only applies if you are using the same Gmail mail server for Inbound and Outbound Mail processing.

For more info see: https://thepluginpeople.atlassian.net/wiki/spaces/KB/pages/3930390542/Gmail+is+adding+the+Outbound+Mail+as+Incoming+Mail