Integrate with Gmail using OAuth

Owned by Fernando Boucquez (PPL) (Deactivated)
Last updated: Apr 05, 2023 by Ryan Clifton
4 min read

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. 

Whitelisting JEMH Cloud

Personal google email accounts are not supported.

G Suite domain administrators must whitelist the JEMHC application, in order for it to be usable for OAuth with your Gmail domain. If whitelisting and/or app access is not granted to the account through which OAuth is occurring, likely the auth will fail due to ‘development’ limits being reached.

Controlling G Suite data for apps

https://support.google.com/a/answer/7281227?hl=en

Note that Domain Admins can limit what Applications individual users can use, i.e., for JEMHC usage only the mailbox user accounts need to have access to JEMHC.

Get your G Suite domain administrator to follow along:

  1. Navigate to App Access Control:

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

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

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

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 

  3. Click on the Authorize link. This will take you to the Google confirmation screen. 

  5. Select the account you want to authorize and allow JEMHC the access to your support email account. 

  7. Once accepted, close the tab and go back to JEMH Cloud.

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

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

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 

  4. Click on the Authorize link. This will take you to the Google confirmation screen. 

  6. Select the email account that you want JEMHC to be able to access.

  8. Once accepted, close the tab and go back to JEMH Cloud.

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

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

  12.  

Troubleshooting

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.

 

 

Related articles