Google Workspace Connector

Google Workspace Configuration Requirements and Setup

Creating a New Project

1. Navigate to the Manage Resources page in the Google Cloud console.
2. Click Create Project.
3. In the New Project window, provide a project name. A project name should consist of letters, numbers, single quotes, hyphens, spaces, or exclamation points. It must be between 4 and 30 characters in length.
   
4. Enter the parent organization or folder resource in the designated box. If No organization is an option, select it to create a top-level project.
5. Once all details are entered, click Create.
   

Adding Credentials to Project

1. Go to the Google Cloud Platform Console and select the desired project from the projects list.
   
2. If not already open, navigate to the APIs & services page.
3. Click Credentials and then New Credentials, selecting OAuth client ID.
   
4. Under Authorized redirect URIs, add a line with: https://developers.google.com/oauthplayground.
5. Choose the application type as Desktop App and click Create.
   
6. After creating the app, copy the client ID and client secret for integration configuration.
   

Enabling Gmail API Service

1. Go to the API Console and select the desired project from the projects list.
   
2. Click the Gmail API and then on ENABLE.
   

Creating OAuth Code

1. Go to the OAuth2 Playground.
2. Click the gear icon and ensure Use your own OAuth credentials is checked.
3. Set OAuth flow to Server-side and access type to Offline.
4. Enter the OAuth2 client ID and OAuth2 client secret obtained earlier.
   
5. Select Google Ads API and its scope, https://www.googleapis.com/auth/adwords, under Step 1 – Select & authorize APIs, then click Authorize APIs.
   
6. Sign in to the relevant account if prompted and click Accept to grant access.
7. In Step 2 – Exchange authorization code for tokens, click Exchange authorization code for tokens.
   
8. Copy the Refresh token into the configuration file along with the client ID and client secret for connector configuration.
   

Configuration of Google Workspace Connector

Ingestion

1. Navigate to the Connector page in the XDR portal and select Ingestion.
2. Select Google Workspace Message Downloader Connector and click Configure.
3. Enter the OAuth Code, Client Email ID, Client ID, and Client Secret.
4. Click Validate and Save.

Configuration of Google Workspace Response Connector

Response

1. Navigate to the Connector page in the XDR portal and select Response.
2. Select Google Workspace Response Connector and click Configure.
3. Enter the Client Dedicated Email ID, Service Account Email ID, and Private Key.
4. Click Validate and Save.