Google DMI Integration – NINJIO Help Center

▶ Click here to view our step-by-step demo

Introduction

Direct Message Injection (DMI) allows you to bypass regular email delivery and put emails directly into your users' mailboxes, increasing the delivery success rate and removing the requirement for allow-listing. This method is used as an alternative to the standard allowlisting process for Google.

Part A: Creating a Google Cloud Project

You will need a Google Cloud project to create a service account.

1. Open the Manage Resources page in the Google Cloud Console

2. Click Create Project

3. Enter a Project name (NINJIO DMI) and then click Create

The project will take a few moments to provision, and the console will notify you once it's ready. It should appear under Manage Resources if you refresh the page. Failing that, clicking Google Cloud at the top of page will take you to your welcome page. A dropdown should appear where you can select your new project.

Part B: Enabling Gmail API

You will need to enable the Gmail API on this project to use it with the sync.

1. Go to APIs and Services > Enable APIs and Services and then click Enable APIs and Services at the top of the page.

2. Enter "Gmail API" into the search field and select Gmail API from the results.

You can also access the Gmail API here.

3. Click Enable to enable this API on the project.

Part C: Creating a Service Account

Next, you will need to create a service account if you do not have one already.

1. Go to IAM and Admin > Service Accounts

2. Select your new NINJIO DMI and click Create Service Account at the top

3. Enter a Service Account Name and then click Create and Continue

4. Click Done to complete the process

Make a note of the service account's Unique ID, you'll need it later on.

Part D: Creating a Key

A key is required to set up the sync's service account authentication. You can create one by:

1. Select the service account you wish to use

2. Click on the Keys tab

3. Click Add Key and select Create new key

4. Select JSON and click Create

5. This will save a JSON to your computer containing your service account. You will need this later on.

Part E: Setting Up Domain-wide Delegation

The service account will need domain-wide delegation of authority for the scopes covered by the sync, so it can use the service account to access the Google Directory API.

1. Open the Google Admin Console

2. Go to Security > Access and Data Control > API Controls

3. Click the Domain-wide delegation section and click Manage Domain-wide delegation

4. Click Add new next to API Clients

5. Enter the Client ID for your service account - This is the service account's Unique ID, you will need to get it from the Google Cloud Console

6. Add the scopes listed below under OAuth Scopes and click Authorize

oAuth Scopes Required

https://www.googleapis.com/auth/gmail.insert

7. Click Authorize.

Part F: Integrating the NINJIO Platform

1. Once you have followed the steps above, go to your NINJIO Settings, click on Sync, then Google DMI, then click Add.

2. Type the email domain that your key is authorized to and upload the JSON file.

3. Click Save.

You should be all set to launch simulated phishing emails to your users with the authorized email domain.

This setup will be verified during your onboarding call.

If you have any questions, please reach out to support@ninjio.com.

Related to

Getting Started
Google DMI
Integrations
Direct Message Injection

Related articles