Google Workspace Investigations

Google Workspace Forensics for BusinessesAdmin Audit Logs, Drive Activity, Vault, and OAuth Token Abuse

Google Workspace centralizes email, documents, and identity for many small and mid sized businesses, which makes its audit trail the primary evidence source when an account or a whole domain is compromised. This page explains what the admin console records, how long it stays available, and where an investigation needs Vault or OAuth analysis to close the gaps.

Updated August 2026 · Reviewed by Elite Digital Forensics examiners · Nationwide breach response

6 monthsCommon default retention window for many Workspace audit log event types before rolloff at standard license tiers.
Hours of lagSome audit events can take hours to appear in the admin console, which affects how early notifications should be worded.
Vault holdsLitigation holds placed in Google Vault can preserve mail and Drive content that would otherwise be deleted by users or retention policy.

Quick answer

Google Workspace forensics is the analysis of admin console audit logs, Drive and login activity, and Vault exports to determine how an account or domain was compromised and what data was accessed. The Admin console records login, Drive, token, and admin activity events with retention that commonly runs about six months depending on license and event type, and some events post with a noticeable lag, so preservation should begin as soon as compromise is suspected.

Common questions, answered in one line

QuestionOne line answer
How long are Workspace audit logs kept?Retention varies by event type and license, commonly around six months, though some categories are shorter.
Can Workspace logs show a file was downloaded?Drive audit events show view, edit, download, and sharing actions when audit logging is enabled for that event type.
What is Google Vault used for in an investigation?Vault applies litigation holds and exports mail, Drive, and chat content that might otherwise be deleted by users or retention rules.
Can an attacker read email without a password reset?Yes, most often through a malicious OAuth application granted access by the user, which does not require the account password.
Does Takeout replace a forensic export?No, Takeout is a self service user export with no admin authentication metadata and no chain of custody controls.
Who should pull the logs?An independent examiner working with the Workspace super administrator, so scope and methodology are documented and defensible.

Key terms defined

TermWhat it means
Admin console audit logThe centralized record of login, admin, Drive, token, and group activity across a Workspace domain, viewable and exportable by a super administrator.
Login audit logRecords of successful and failed sign in attempts, including IP address, device, and the authentication method used.
Drive audit logRecords of file view, edit, download, share, and permission change events for content stored in Drive.
Token audit logRecords of OAuth application authorizations and revocations, showing which third party apps were granted access to a user account.
Google VaultThe Workspace retention and eDiscovery product used to place litigation holds and export mail, Drive, and chat content for legal matters.
OAuth token abuseUse of a maliciously authorized or stolen third party application token to access account data without needing the account password.

What the Workspace admin console actually records

A Workspace super administrator has access to several distinct audit log categories, and an investigation typically needs more than one to build a complete picture of a compromise.

  • Login audit log, which shows every successful and failed sign in with IP address, approximate location, device type, and the login challenge that was satisfied.
  • Admin audit log, which records changes made in the admin console itself, including new admin roles, security setting changes, and mail routing modifications an attacker might use to hide activity.
  • Drive audit log, which shows file access, edits, downloads, and sharing changes, including externally shared links.
  • Token audit log, which records every OAuth application a user has authorized and any scopes granted, a critical source when the compromise runs through a third party app rather than a stolen password.
  • Groups and user accounts audit logs, which can reveal attacker persistence through group membership changes or new delegate access to a mailbox.

Retention and lag are separate problems

Retention determines how far back an event can be found at all. Lag determines how quickly a recent event becomes visible. Both matter in an active incident: some Workspace event types can take hours to populate, which means an examiner working the first day of a compromise may need to re-query the console after that lag window has passed rather than concluding an event did not happen because it was not yet visible.

Google Vault: holds, exports, and their limits

Google Vault is Workspace built in retention and eDiscovery tool, and it plays two distinct roles in an investigation. First, an immediate litigation hold on the affected accounts prevents user side deletion of mail, Drive files, or chat messages while the review is underway. Second, Vault exports produce mail and Drive content in formats suitable for review platforms, with export activity itself logged.

Vault capabilityWhat it doesWhat it does not do
Litigation holdPreserves content against user deletion and standard retention rulesDoes not by itself capture metadata about who accessed a file before the hold was applied
Mail exportProduces account mail in standard formats for reviewRequires the export to be requested for the correct date range and accounts, or evidence is missed
Drive exportCaptures file versions and some sharing metadataDoes not always preserve full audit trail context for older sharing changes
Chat and Meet exportCaptures chat spaces and meeting metadata where retention appliesCoverage depends on the specific Chat and Meet product configuration in use

Applying a hold correctly and quickly

  1. Identify every account and shared drive potentially in scope, not only the account believed to be compromised.
  2. Apply a Vault hold immediately to prevent further deletion, before any account remediation such as a password reset or session revoke.
  3. Export the admin audit log, login log, Drive log, and token log for the full available retention window before it ages out.
  4. Coordinate the export request with counsel where litigation or regulatory exposure is anticipated, so the hold and export are documented for later authentication.
  5. Preserve a copy of the domain wide security settings and delegated admin roles at the time of discovery, since attackers sometimes modify these to maintain access.

Compromise found in a Google Workspace domain

Every hour without a litigation hold and a documented log export is an hour of exposure to deletion and rolloff. We can scope and begin preservation the same day.

OAuth token abuse: access without a stolen password

One of the most consequential and least understood Workspace attack paths does not involve stealing a password at all. A user is phished or socially engineered into authorizing a malicious third party application, and that application receives an OAuth token with scopes to read mail, list files, or access Drive content. The token can persist and be used long after the phishing message is gone, and a password reset alone does not revoke it.

Consent phishing

A fake application impersonating a familiar service requests broad Gmail or Drive scopes and the user clicks allow without reading the permission screen.

Persistent access

The token remains valid until explicitly revoked in the Workspace admin console or by the user, independent of password changes or even multi factor status.

Silent data access

API based access through a valid token frequently does not trigger the same alerting as an interactive login, leaving fewer visible signals.

Token audit visibility

The token audit log is often the only reliable record of which application was authorized, when, and with what scopes, making it essential evidence.

Investigating a suspected token compromise means reviewing the token audit log for every account in scope, checking application names and publisher verification status, and cross referencing authorization timestamps against phishing email delivery and click events from the mail security platform. Revocation should happen for any application that cannot be positively verified as legitimate business software.

Determining scope: one mailbox or a domain wide compromise

Small business Workspace incidents commonly begin as a single compromised account but the real question for notification and remediation purposes is always whether the compromise reached further, through shared drives, delegated mailbox access, or an administrator account.

Step 1

Confirm which accounts show anomalous login activity, unfamiliar IP ranges, or new device registrations in the login audit log.

Step 2

Check whether any compromised account held super administrator or delegated admin privileges, which would expand the blast radius to domain wide settings.

Step 3

Review the Drive audit log for the compromised accounts for external sharing changes and bulk download activity, which distinguishes read access from data exfiltration.

Step 4

Check the token audit log across the domain for the same malicious application appearing on other accounts, which indicates a phishing campaign rather than an isolated compromise.

Step 5

Document what could not be determined due to retention rolloff or missing audit log categories, since Workspace license tier affects which events are even captured.

What matters most

  • Speed of the litigation hold, since Vault holds stop deletion but do not retroactively create missing audit history.
  • License tier awareness, because some premium audit event categories require a higher Workspace edition to even exist.
  • Token audit review whenever phishing is suspected, since password resets alone do not remove OAuth access.
  • Separating read access from exfiltration, using Drive download and external sharing events rather than assuming any access equals data theft.
  • Independent documentation of the export process so counsel, a carrier, or a regulator can rely on it.

Common misconceptions

Resetting the password fixes a Workspace compromise

It does not revoke OAuth tokens or active sessions on their own. Both need to be explicitly revoked in the admin console.

Google Takeout is good enough for an investigation

Takeout is a self service export with no chain of custody or admin level metadata and it can be triggered by the compromised account itself.

The admin console shows everything instantly

Some event categories post with a delay of hours, and query results should be treated as provisional during the first day of response.

Only large enterprises need Vault holds

Any Workspace domain with Vault licensing available can and should apply a hold the moment litigation or regulatory exposure is possible.

When this applies, and when it does not

This applies when

  • A business email compromise or phishing incident affected one or more Google Workspace accounts.
  • A regulator, carrier, or counterparty requires documentation of what data was accessed in a Workspace domain.
  • A departing employee is suspected of taking data through Drive sharing or downloads before departure.
  • An admin account or delegated admin role may have been used to change domain wide security settings.

This does not apply when

  • The organization uses Microsoft 365 rather than Google Workspace, where the relevant evidence source is the Unified Audit Log.
  • The incident is confined to a personal Gmail account with no organizational Workspace domain involved.
  • No audit logging was ever enabled and the retention window for any relevant events has already passed with no export taken.

How Elite Digital Forensics helps

We are engaged by businesses, outside counsel, and cyber insurance carriers to independently investigate Google Workspace compromises, from a single phished mailbox to domain wide administrator abuse. Our examiners coordinate directly with Workspace super administrators to apply holds, pull logs across every relevant category, and produce findings that hold up under scrutiny.

Emergency Vault hold and log export

Same day litigation hold and export of login, admin, Drive, and token audit logs before rolloff and before remediation actions overwrite evidence.

OAuth token compromise review

Analysis of the token audit log across the domain to identify malicious application authorizations and their scope.

Scope determination

A defensible finding on whether a compromise was limited to one account or reached shared drives, delegated mailboxes, or admin settings.

Exfiltration assessment

Correlation of Drive download and sharing events with login activity to support or refute a claim that data left the organization.

Notification support

Evidence based input for counsel on whether the facts support a reportable event under applicable breach notification law.

Expert witness testimony

Court qualified examiners able to explain Workspace audit logging, Vault, and OAuth mechanics under direct and cross examination.

Problems we solve

  • A mailbox was phished and you do not know if the attacker read, forwarded, or downloaded anything.
  • An unfamiliar application shows up in a user token audit and no one can say when it was authorized.
  • Your admin console shows nothing suspicious but the user swears their account acted strangely.
  • Counsel needs a defensible account of what data was accessed before a notification deadline.
  • A departing employee shared company Drive files externally before resigning.

Talk with a forensic examiner about your incident

Consultations are confidential. We work directly with affected businesses, with outside counsel, and with cyber insurance carriers and brokers nationwide.

About Elite Digital Forensics

Elite Digital Forensics is an independent digital forensics firm serving businesses, attorneys, and insurers nationwide. Our examiners include former law enforcement forensic examiners who have testified as court qualified expert witnesses in state and federal proceedings. We do not sell security software and we do not manage client networks, so our findings carry no conflict of interest when the question is whether an environment was adequately secured.

Every engagement follows documented chain of custody, defensible acquisition methods, and reporting written for attorney review, insurer submission, regulator response, or courtroom use. Work performed at the direction of counsel is generally treated as attorney work product prepared in anticipation of litigation. Call (833) 292-3733 or request a confidential consultation.

Frequently asked questions

How long does Google Workspace keep audit logs?

Retention varies by event category and Workspace edition, but many core audit log types are commonly available for around six months. Some categories are shorter, and higher license tiers unlock additional event types and longer windows, so confirming the applicable retention for the specific domain is an early investigative step.

Can Google Workspace logs prove a file was downloaded?

Yes, when Drive audit logging is enabled for that event type, download, view, and sharing actions appear in the Drive audit log tied to the acting account and timestamp. This is a key source for distinguishing mere access from likely exfiltration.

Does a password reset stop a Google Workspace compromise?

Not fully. A password reset does not revoke previously granted OAuth application tokens or necessarily terminate every active session. Both need to be explicitly revoked in the admin console as part of a complete remediation.

Is Google Takeout acceptable for a forensic investigation?

Takeout is designed as a self service personal data export and lacks admin level audit metadata, chain of custody documentation, and independence, since it can be triggered by the account under investigation. It has narrow uses but should not substitute for admin console log export and Vault.

What does Google Vault add that the admin console does not?

Vault applies litigation holds that prevent user side deletion of mail, Drive, and chat content, and it produces formatted exports for legal review. The admin console shows activity logs, while Vault preserves and exports the underlying content itself.

Can Google Workspace investigations determine if an entire domain was compromised?

Often yes, by combining login audit review across all accounts, admin audit review for privilege or setting changes, and token audit review for a shared malicious application. Confidence depends on which audit categories were enabled and how quickly logs were preserved.

References and authoritative sources

  1. Google Workspace Admin Help, Data retention and lag times for audit logs — https://support.google.com/a/answer/7061566
  2. Google Vault Help Center — https://support.google.com/vault
  3. Google, Download your data (Takeout) — https://support.google.com/accounts/answer/3024190
  4. MITRE ATT&CK Enterprise Matrix — https://attack.mitre.org/matrices/enterprise/
  5. NIST SP 800-86, Guide to Integrating Forensic Techniques into Incident Response — https://csrc.nist.gov/pubs/sp/800/86/final
  6. Federal Rule of Civil Procedure 37(e), Failure to Preserve Electronically Stored Information — https://www.law.cornell.edu/rules/frcp/rule_37

#DigitalForensics #ComputerForensics #CellPhoneForensics #ExpertWitness #DigitalForensicExperts #EliteDigitalForensics #ForensicInvestigation #DataBreachResponse #DataBreachInvestigation #IncidentResponse #CyberForensics #GoogleWorkspace #GoogleVault #OAuthSecurity #CloudForensics

This content is for educational and informational purposes only and does not constitute legal advice. Elite Digital Forensics provides independent digital forensic services and expert witness testimony; we do not provide legal representation. Every case is fact specific; outcomes depend on the evidence, jurisdiction, and counsel. Retain qualified legal counsel for advice about your matter.

Assistant Icon Elite Digital Forensics Assistant
πŸ‘‹ Live Chat Now!
Free Virtual Consultation 24/7
Chat Now!

By submitting this form, you consent to be contacted by email, text, or phone. Your information is kept secure and confidential. Reply Stop to opt out at anytime.Β 

IMPORTANT: Please remember to check your spam or junk folder