Aegis Eight

Permissions Aegis Eight requests

Aegis Eight connects to Google Workspace via domain-wide delegation (DWD) — a read-only service account your Super Admin authorizes in the Admin Console. We read security configuration and audit metadata to assess Essential Eight posture, and never access Gmail, Drive, Chat, or Calendar content.

The short version

What we access

  • Directory users, roles, and 2-Step Verification enrollment status
  • Admin audit and login reports (metadata only)
  • ChromeOS device inventory and policy configuration
  • Chrome browser policy settings applied to managed devices
  • Google Vault retention policies (when Vault is licensed)

What we never access

  • Gmail message content
  • Google Drive or Shared Drive file content
  • Google Chat or Meet message content
  • Calendar event details beyond directory metadata
  • Passwords or 2SV secrets — we cannot change anything
  • Any customer other than the one that granted delegation

How you grant access

Unlike Microsoft Entra’s one-click admin consent, Google Workspace uses domain-wide delegation configured by your Super Admin:

  1. Copy Aegis Eight’s service account Client ID from the connect wizard.
  2. In Admin Console, open Security → API controls → Domain-wide delegation and add the Client ID with the OAuth scopes listed below.
  3. Provide a delegated admin email (Super Admin or dedicated read-only admin) for impersonation during scans.
  4. Click Verify connection in the Aegis Eight portal.

For the wider operational picture — data flows, retention, tenant isolation, sub-processors — see the Security & Privacy page. When you start a free scan and choose Google Workspace, the in-app connect wizard walks through the same steps.

Why we need these permissions

Each scope maps to a specific ASD Essential Eight control. Aegis Eight requests the minimum read-only set required to score your maturity automatically — instead of relying on a questionnaire. The detailed breakdown below names every scope, what it reads, and which control it supports.

Honest parity note: Some controls have limited Google API signal (e.g. Windows/macOS desktop patching, native Google Docs macro settings). Those are scored as no visibility or not applicable rather than guessed — see Security & Privacy for the full model.

We preserve evidence, not just a score

Most Essential Eight tools are questionnaire engines with a few API checks bolted on. Aegis Eight is different: every Google API response that informs a finding is captured, sha256-hashed, and the hash is stamped into the finding itself.

The result is a cryptographically verifiable evidence chain — an auditor, cyber insurer, or regulator can confirm that the data we scored is exactly what your tenant returned, without taking our word for it. See how it works in the evidence-chain section of the whitepaper.

Core scan scopes

Every scope below is read-only. Required for every Workspace customer.

https://www.googleapis.com/auth/admin.directory.user.readonly

Read directory users

Lists users in your Workspace directory so findings can name accounts (e.g. dormant users, accounts without 2-Step Verification).

Essential Eight control: Multi-factor authentication, user hygiene

https://www.googleapis.com/auth/admin.directory.user.security

Read user security settings

Reads 2-Step Verification enrollment flags and related security settings per user — the primary MFA signal for Google Workspace.

Essential Eight control: Multi-factor authentication

https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly

Read admin role assignments

Counts Super Admin and other privileged role holders, similar to Entra directory role membership for restrict-admin scoring.

Essential Eight control: Restrict administrative privileges

https://www.googleapis.com/auth/admin.directory.customer.readonly

Read customer (tenant) metadata

Reads your Google Workspace customer ID and organisation metadata to bind scan results to the correct tenant.

Essential Eight control: Tenant identity

https://www.googleapis.com/auth/admin.directory.domain.readonly

Read verified domains

Lists verified domains on the customer account for tenant identity and domain-matching during connect.

Essential Eight control: Tenant identity

https://www.googleapis.com/auth/admin.reports.audit.readonly

Read admin and login audit reports

Reads sign-in and admin activity audit events (metadata only) to detect MFA bypass patterns and privileged admin actions.

Essential Eight control: Multi-factor authentication, Restrict administrative privileges

https://www.googleapis.com/auth/admin.reports.usage.readonly

Read usage reports

Reads account activity reports to flag inactive or dormant users for governance findings.

Essential Eight control: Security governance (supplementary)

Chrome Management scopes

Chrome browser and ChromeOS policy and inventory signals for application control, hardening, and patch posture.

https://www.googleapis.com/auth/chrome.management.policy.readonly

Read Chrome management policies

Reads Chrome browser and ChromeOS policies applied to managed devices — application control and user-application hardening signals.

Essential Eight control: Application control, User application hardening

https://www.googleapis.com/auth/chrome.management.reports.readonly

Read Chrome management reports

Reads ChromeOS device inventory and applied policy state for patch and compliance evidence on managed Chromebooks.

Essential Eight control: Patch operating systems, Patch applications

Optional scopes

These scopes extend coverage where the corresponding Google product is licensed. If you omit them from DWD, related collectors degrade gracefully to no visibility rather than failing the whole scan.

Google Vault

Retention policy metadata when Vault is licensed — supports Regular backups (partial).

https://www.googleapis.com/auth/ediscovery.readonlyOPTIONAL

Read Google Vault retention policies

Reads Vault retention and hold policies where Vault is licensed — partial signal for Regular backups.

Why we’d ask: Vault retention policy evidence where licensed; otherwise manual attestation.

Essential Eight control: Regular backups

Mobile Management

Enrolled Android and iOS device inventory for endpoint visibility beyond ChromeOS.

https://www.googleapis.com/auth/admin.directory.device.mobile.readonlyOPTIONAL

Read mobile device inventory

Lists enrolled Android and iOS devices managed in Admin Console for endpoint visibility beyond ChromeOS.

Why we’d ask: Mobile device enrollment and compliance inventory for Android/iOS endpoints.

Essential Eight control: Patch operating systems (mobile)

Data-handling promises

Revoking access

A Super Admin can remove Aegis Eight’s access at any time by deleting our service account Client ID from Admin Console → Security → Access and data control → API controls → Domain-wide delegation. Revocation is immediate: any subsequent API call from Aegis Eight fails authorization and no new tenant data can be collected. Aegis Eight detects the loss of access on the next scan attempt and stops. You can additionally request deletion of any data already collected (purged within 30 days — see the Security & Privacy whitepaper).

Questions about a specific scope? Email [email protected]. Compare with Microsoft 365 permissions or read the full Security & Privacy whitepaper.