# Google Workspace

---
title: Connecting Google Workspace to WatchDog Security
category: Integrations
integration_type: oauth
products_supported:
  - Posture Management
  - Inventory
  - Compliance Center
---
This guide explains how to connect **Google Workspace** to WatchDog Security using OAuth authentication.

Once connected, WatchDog will begin monitoring your Google Workspace environment for security posture risks, configuration issues, and asset inventory data.

---

## What WatchDog Monitors

:::tip[]
WatchDog operates in **read-only mode** and does **not modify configuration settings** within your Google Workspace environment.
:::

After the integration is connected, WatchDog may monitor:

<Accordion title="Scopes" defaultOpen>

**User and Identity Information**

- Users within your Google Workspace domain
- User profile information
- User aliases configured for each account

**Domain and Customer Information**

- Customer account metadata
- Domains associated with the Google Workspace organization

**Administrative Access**

- Delegated administrator roles
- Admin privilege assignments

**Audit and Activity Logs**

- Google Workspace audit logs
- Administrative activity logs
- Security event logs

**Usage and Reporting Data**

- Workspace usage statistics
- User activity reports
- Service usage reporting

</Accordion>

The exact information collected depends on the permissions granted during authorization.

---

## Requirements

Before connecting the integration, ensure the following:

- You have **administrator access** to Google Workspace
- You're an **Account Owner** or **Security Admin** in the WatchDog Security portal

---

## Step 1 — Open the Integration in WatchDog

1. Log into the **WatchDog Security Portal**
2. Navigate to **Management → Integrations**
3. Locate **Google Workspace**
4. Click **Connect**

---

## Step 2 — Authorize the Integration

:::note[]
After authorization is completed, you will be redirected back to WatchDog Security automatically.
:::

You will be redirected to the **Google authorization page**.

1. Select the **Google Workspace administrator account**
2. Review the permissions requested by WatchDog
3. Click **Allow** to approve the connection

WatchDog will then establish a secure OAuth connection to your Google Workspace environment.

---

## Initial Sync

<Accordion title="After the integration is connected" defaultOpen>

- WatchDog will begin collecting data from Google Workspace
- The first synchronization typically completes within **5–10 minutes**

</Accordion>

<Accordion title="Data will appear within the following modules" defaultOpen>

- **Posture Management**
- **Inventory**
- **Compliance Center**

</Accordion>

---

## Troubleshooting

<AccordionGroup>

<Accordion title="Authorization Failed" defaultOpen>

Verify the following:

- You are logged in with a **Google Workspace administrator account**
- OAuth applications are permitted within your Google Workspace environment
- The browser was not blocked from completing the OAuth redirect

</Accordion>

<Accordion title="No Data Appears">

If no data appears after connecting:

- Wait for the initial synchronization to complete
- Verify the integration shows **Connected** in WatchDog
- Disconnect and reconnect the integration if necessary

</Accordion>

</AccordionGroup>

---

## Related Documentation

- https://knowledge.workspace.google.com/admin/users/prebuilt-administrator-roles