Prerequisites

  • Google Workspaces User with Admin Permissions is needed for this integration
  • Google Workspaces Licensing above Free Tier
  • An active Blumira Sensor

Create a GCP Project

  1. With Google Workspaces Admin Permissions, go to the GCP Console: https://console.cloud.google.com.
  2. Create a GCP Project:
    1. Next to the Google Cloud Platform Header – Select the New Project – Dropdown
    2. Click New Project
    3. In the New Project window that appears, enter a unique project name
    4. Select the Organization you’d like to use (typically the default listed is best)
    5. Enter the parent organization in the Location box if it isn’t pre-populated (usually matches the organization domain)
    6. When finished, click Create
    7. Once created, select the Project you’ve created in the Project drop down near the GCP header in the top left of your screen
  3. Create GCP Service Account (for fetching logs):
    1. From the GCP Console, switch to the project you created or desire to use in the top left.
    2. On the left toolbar, select IAM & Admin > Service Accounts.
    3. Select +Create Service Account at the top of the page.
    4. Enter a unique service account name.
    5. Enter a unique service account ID
    6. Enter a service description.
    7. Click Create and continue.
    8. Select the drop-down Select A Role,and choose Service Account in the left column and Service Account Token Creator in the right column.
    9. Click Continue.
    10. Click Done at the bottom.
    11. Select your new service account from the list.
    12. Click on the KEYS tab.
    13. Click Add Key > Create New Key.
    14. Select JSON format for key. The json file should automatically download from your browser.
  4. Find your Client_ID:
    1. Open the JSON Key file on your local machine in a plain text editor (Notepad, Wordpad, Notepad++).
    2. Find the Client_ID and copy the number.
    3. Save the File to use it again in later steps.

Enable Google APIs

  1. Enable the Google Admin SDK API:
    1. From the GCP Main Console Page, select the same project you created in previous steps on the top left.
    2. Navigate to APIs & Services > Library.
    3. In the search bar – Type “Admin SDK”.
    4. Select the Admin SDK API.
    5. Select Enable.
  2. Enable the Identity and Access Management (IAM) API:
    1. Return to the same API Library page as shown in the previous section.
    2. In the search bar, type “IAM API”.
    3. Select the Identity and Access Management (IAM) API.
    4. Select Enable.

Link APIs to Google Workspaces

  • Go to https://admin.google.com and log in as a global admin.
  • In the left side toolbar – go to Security > Access and data control > API Controls .
  • Scroll to the bottom section called “Domain-Wide Delegation”.
  • Select Manage Domain Wide Delegation.
  • Select Add New.
  • In the Add a new Client ID window, enter the Client_ID number saved from the JSON file in previous steps.
  • Copy and paste the following into the OAuth Scopes section: https://www.googleapis.com/auth/admin.reports.audit.readonly,https://www.googleapis.com/auth/iam
  • Click Authorize.
    Note: Per Google’s Delegation of Authority documentation: “Only users with access to the Admin APIs can access the Admin SDK Reports API, therefore your service account needs to impersonate one of those users to access the Admin SDK Reports API.” In other words, you’ll need to provide the email address of one of your Workspaces users with admin console access so that the module can use the account to fetch your Google logs.

Configuring Blumira

Lastly, you’ll need to connect Google Workspaces (formerly GSuite) to the Blumira platform. Start by logging into the Blumira Console, as an administrator.

  • Go to the left side toolbar and select Settings > Sensors.
  • Select the Sensor you’d like to use.
  • Scroll down to the Modules section – Select Add Module on the right.
  • Type in Gsuite and select the most current module.
  • The window below will appear:
  1. Log Source Name – Optional – Enter anything you’d like to name it.
  2. GCP Service Account Credential JSON – Copy and paste the JSON file from previous steps into the window.
  3. GSuite Admin Email Address – Enter an email address of an existing user in Google Workspaces with Domain Admin privileges.
  4. Click Install.
  5. Within minutes, the module will be operational and collect the last 90 days worth of logs into the Blumira platform.