Sample configuration for IMAP using OAuth2 authentication for polling mails from Gmail in KIC

Issue

How to configure IMAP Gmail polling using Oauth2 authentication.

Solution

This is a sample setup for polling emails from Gmail via IMAP using OAuth2 authentication.

Using guides like these:
- https://support.google.com/cloud/answer/6158849?hl=en
- https://developers.google.com/adwords/api/docs/guides/authentication
you can setup your own Project to enable the Gmail API in order to setup and get the "Client ID" and "Client Secret" you need for logging in.

Here you can see the Credentials page for a Web application called "KIC - OAuth" for a Project called "KFXGoogleOauth".

If you already have your project ready to go, take note of your "Client ID", "Client Secret" and "Redirect URI".

In KIC the configuration looks like this:
Create a new mailbox import and configure your user.

Click on "Configure OAuth" and subsequently on "Manage" to create a new Authorization Server.

Create a new Authorization Server by clicking "Add" and enter the needed urls as they are documented here in the Online documentation.

Click OK and Select this newly created Authorization server in the "Configure OAuth" window.
Also add your "Client ID", "Redirect URI" and "Client Secret".

Click "Authorize" and log in with the configured user.
After logging in with the user name and password and allowing the app to access the mailbox, a new webpage pops up.

Since we're using "https://localhost:8080" as the Redirect URI, this page doesn't show much.

Copy the contents of the Address bar of this page and paste it into the "Authorization code" field in your KIC configuration.

Now click on "OK" and if everything was set up correctly, a new pop-up should be shown that shows "Login successful"

Click "OK" again, the "Configue OAuth" window automatically closes and you can now click the "Test Mailbox" button prior to exiting out of the configuration and restarting the Plug-in.

Level of Complexity 

Moderate

 

Applies to  

Product	Version	Build	Environment	Hardware
Kofax Import Connector	2.10	FP3

References

Add any references to other internal or external articles