Google Workspace Integration

Connect QuantAssure to Google Workspace to monitor user security settings and compliance.

What It Collects

  • User Directory — All users in your Google Workspace domain as assets
  • Security Compliance — Findings from the Google Workspace Compliance extension (Pro plan), including:
    • Users and admins without MFA enabled or enforced
    • Stale user and admin accounts (the thresholds are the Stale User Threshold and Stale Admin Threshold fields)
    • Email security settings: DMARC, SPF and DKIM
    • Google Workspace login or admin audit logging that is not active

Prerequisites

  • Google Workspace admin access
  • A Google Cloud Platform (GCP) project
  • A service account with domain-wide delegation
  • Required OAuth scopes:
    • https://www.googleapis.com/auth/admin.directory.user.readonly

Setup Steps

1. Create a GCP Project

  1. Go to the Google Cloud Console
  2. Create a new project (or use an existing one)
  3. Note your project ID

2. Enable Required APIs

  1. In your GCP project, go to APIs & Services → Library
  2. Search for and enable Admin SDK API

3. Create a Service Account

  1. Go to APIs & Services → Credentials
  2. Click Create Credentials → Service account
  3. Name it (e.g., "QuantAssure")
  4. Grant it the Editor role (or a custom role with Admin SDK access)
  5. Click the service account to edit it
  6. Go to Keys → Add Key → Create new key → JSON
  7. Save the JSON key file — you'll need this

4. Configure Domain-Wide Delegation

  1. In the service account details, find Domain-wide delegation and note the Client ID
  2. Go to your Google Workspace Admin Console
  3. Navigate to Security → API Controls → Domain-wide delegation
  4. Click Add new
  5. Enter the service account Client ID
  6. Add the required scope: https://www.googleapis.com/auth/admin.directory.user.readonly
  7. Click Authorize

5. Configure in QuantAssure

  1. Go to Inventory → Systems and click Add system, or open a system and click Edit
  2. In the Data Source section, turn on Google Workspace
  3. Enter your Workspace Domain (e.g., yourcompany.com)
  4. Enter the Admin Email of a Workspace admin for the service account to act as
  5. Upload or paste your Service Account JSON key
  6. Click Create system, or save your changes if you are editing

6. Run Your First Collection

On the system page, click Run Now to collect data from Google Workspace.

What to Expect

After your first run:

  • Assets: One asset per user in your Workspace domain
  • Findings: Security compliance violations:
    • Users and admins without MFA
    • Stale user and admin accounts
    • Missing or weak DMARC, SPF and DKIM settings

Troubleshooting

"Insufficient permissions" error

  • Verify domain-wide delegation is configured correctly
  • Check that the OAuth scope is added in Admin Console
  • Ensure the service account key is valid

No users appearing

  • Verify your domain is correct
  • Check that the service account has Admin SDK access
  • Confirm domain-wide delegation is authorised for the correct Client ID

Missing compliance findings

  • 2FA status requires directory read access
  • Some user attributes may require additional scopes