Table of Contents
- Setup and System Requirements
- Install ndMail Add-on In Gmail for Administrators
- Configure ndMail for Gmail for Users
Setup and System Requirements
Before you use ndMail for Gmail, your administrator must install the ndMail add-on via a domain-wide deployment. It can be deployed to specific groups, if needed - you can find those steps here.
- Google Workspace account must be at least Business Starter (see here for more info).
- Supported desktop browsers:
- Google Chrome
- Microsoft Edge
Install ndMail Add-on In Gmail for Administrators
Follow the next steps to set up the service account with domain-wide access to configure your Gmail domain with NetDocuments:
- Go to Google Cloud Platform.
NOTE: If you get this dialog, choose your country, select the Terms of Service checkbox after reviewing them, and then select Agree and Continue.
- In the upper-left corner, click the Select a new project button, and then select the already created project, or choose New Project in the upper-right corner of the dialog.
- Enter the project name.
- Select the location of your organization.
- You will get a notification about your project creation with two options:
- The first option is the Select Project button. Select this button to see the project dashboard and two other tabs: Activity and Recommendations.
NOTE: In the Project info section, you can select the Add People To This Project button.
- The second option is the Add Members button. Select this to add a new member and select a role for him/her:
Enable Gmail API
- In the upper-left corner of the screen, click Select a project and go to your project.
- On the Navigation menu, go to APIs & Services, and then select Library.
- In the Google Workspace section, select Gmail API.
- Select the Enable button.
- On the Navigation menu, go to IAM & Admin, and then select Service Accounts.
- Create a service account.
- Set service account name:
- This will populate the service account ID for you.
- You do not need to set a description.
TIP: Save your service account ID somewhere since you’ll need to put that in the ndMail admin UI pages to set up your configuration.
- Select Create and Continue.
- In step 2, select Continue if you do not want to set a role.
- Select Done in step 3.
Note: It is not required to grant user access.
Now you’ll have a row for your service account.
- Select the More options icon in the Actions column, and then choose Manage Details.
- Select Show Domain-wide Delegation.
- Select the Enable Google Workspace Domain-wide Delegation.
- Enter a product name (for example, ndMail for Gmail).
- Select Save.
- Get your client ID.
TIP: Save your ID. You will need this in a later step.
- On the Keys tab, create a key.
- Select the JSON type and then select the Create button.
- After this, you will get a notification: Private key saved to your computer.
Manage Domain-wide Delegation
- Go to admin.google.com.
- Select Security.
- Scroll down to API.
- Select Manage Domain-wide Delegation.
- Select Add new on the upper-left side of the table.
- Enter your client ID and the following scopes:
- Select the Authorize button.
- Get your JSON file that will be downloaded to your computer.
TIP: Save this. You’ll need it to set up your configuration.
Create Connection with ndMail
- On the Navigation pane of NetDocuments Admin Console, select ndMail Configuration.
- On the Connections tab, select the Create Connection button.
- From the Connection type dropdown menu, select Gmail.
- Enter your email in the boxes:
- Gmail Service Account Email (from step 3 in the Service Account section of this article)
- Verification Email (a valid email address within your domain)
- Select a file for Gmail JSON Credential, and then select the Save button.
On the Cabinets tab, turn on the toggle for the cabinet(s) you want to use with ndMail.
Install the Add-on to Your Domain
- Go to the Google Workspace Marketplace to install ndMail for Gmail.
- Select Domain Install.
- In the Domain wide install dialog, select Continue.
- You can enable it by the full domain or by groups:
- In the authentication dialog, select the Terms of Service checkbox, and then choose Allow.
If you want to confirm installation:
- In the admin console, go to Apps → Google Workspace Marketplace apps.
- Select it, and you’ll see ndMail installed. You can select it to see what’s going on.
NOTE: You can revoke access from here, too.
Configure ndMail for Gmail for Users
Here’s how your users will get started with ndMail for Gmail.
Once you open Gmail, this is what you’ll see:
- When you select the add-on, you will see the panel.
- Select your host location, and then select Log In.
- When you get an OAuth dialog, select Allow.