Using a Custom app on G Suite for Accounts Sync, Gmail (IMAP) and Drive

This HOWTO will guide you on how to set up a Custom app on Google Developers website, to have mxHero connecting to your resources using an internally deployed Google G Suite app. For more information, please contact the mxHero support.

Setting up the Google Custom App

ss1.png

  • Provide a relevant project name and make sure it is associated with your organization (default).

ss2.png

  • With the project created, click on "Enable APIs and Services"

ss3.png

  • The APIs to enable are (each one individually, per step, searching on the top bar):
    • Admin SDK
    • G Suite Marketplace SDK
    • Gmail API
  • If you are using Google Drive, you will want to enable Google Drive too.

ss4.png

  • Back to the Project dashboard, click on Credentials and select "Service account".

ss5.png

  • New service account, give it a name, make it Project Editor and select P12 key type. Please download the P12 file and provide it to mxHero support.

ss6.png

  • Now, click on "Manage service accounts" on the right side.

ss7.png

  • Click on the service account created.

ss8.png

  • Click then on Edit on the top, check "Enable G Suite Domain-wide Delegation" and click Save.

ss9.png

  • Back to the Project dashboard, go to Credentials and open the tab "OAuth consent screen". Make the Application Type "Internal" and give it a name. Then Save.

ss10.png

  • Again on the Project dashboard, click on the "G Suite Marketplace SDK".

ss11.png

  • Now, just copy the settings as seen in the screenshots below. You can customize the name and logos to follow the taxonomy defined previously.

ss12.png

ss13.png

ss14.png

  • Now please set these additional configurations in the screen and Save.

ss15.png

  • Now click on Publish on the left menu and add the information as per below screenshots, the click Publish:

ss17.png

ss18.png

ss19.png

  • On the Project dashboard, clicking on Credentials, your page should look like the following now.

ss16.png

  • If it's not, please review the steps above.

 

Now you just need to install the new app on your G Suite organization:

And lastly, provide the following information to the mxHero support:

  1. G Suite Administrator email address
  2. Service Account email address (Service account creation)
  3. P12 file created on the steps above (Service account creation)
  4. Application ID retrieved on the steps above (G Suite Marketplace)

All set!

 

Have more questions? Submit a request

Comments

Powered by Zendesk