Google Workspace User Unsuspended

Severity: medium
Type: Alert
Author: Google Cloud Security
Source: github.com/chronicle/detection-rules

Identifies when a user account is unsuspended in Google Workspace.

MITRE ATT&CK coverage

Tactic	Techniques
Initial Access	`T1078.004` Valid Accounts: Cloud Accounts

Telemetry coverage

Platform	Record / event type
Google Workspace	UNSUSPEND_USER: User Unsuspension

Rules detecting the same action

These rules filter on the same operation.

Google Workspace Suspended User Account Renewed (Elastic)

Rule body

// Copyright 2023 Google LLC. Licensed under Apache-2.0.

rule google_workspace_user_unsuspended {

  meta:
    author = "Google Cloud Security"
    description = "Identifies when a user account is unsuspended in Google Workspace."
    rule_id = "mr_6bf3e4c9-b380-4562-9aa8-6416a9126ee1"
    rule_name = "Google Workspace User Unsuspended"
    mitre_attack_tactic = "Initial Access"
    mitre_attack_technique = "Valid Accounts: Cloud Accounts"
    mitre_attack_url = "https://attack.mitre.org/techniques/T1078/004/"
    mitre_attack_version = "v13.1"
    type = "Alert"
    data_source = "Workspace Activity"
    severity = "Medium"
    priority = "Medium"

  events:
    $ws.metadata.vendor_name = "Google Workspace"
    $ws.metadata.product_name = "admin"
    $ws.metadata.product_event_type = "UNSUSPEND_USER"

  outcome:
    $risk_score = max(35)
    $mitre_attack_tactic = "Initial Access"
    $mitre_attack_technique = "Valid Accounts: Cloud Accounts"
    $mitre_attack_technique_id = "T1078.004"
    $event_count = count_distinct($ws.metadata.id)
    $principal_ip = array_distinct($ws.principal.ip)
    $principal_country = array_distinct($ws.principal.ip_geo_artifact.location.country_or_region)
    $principal_state = array_distinct($ws.principal.ip_geo_artifact.location.state)
    $principal_user_emails = array_distinct($ws.principal.user.email_addresses)
    $target_user_emails = array_distinct($ws.target.user.email_addresses)
    $principal_user_id = $ws.principal.user.userid

  condition:
    $ws
}

YARA-L rule structure

Condition

Fires when at least one $ws event.

Events

`$ws`

metadata.product_event_type = "UNSUSPEND_USER"

Outcome

Outcome variables add context to a detection. When the rule generates an alert, $risk_score is displayed with it.

Field	Expression
`risk_score`	`max(35)`
`event_count`	`count_distinct($ws.metadata.id)`
`principal_ip`	`array_distinct($ws.principal.ip)`
`principal_country`	`array_distinct($ws.principal.ip_geo_artifact.location.country_or_region)`
`principal_state`	`array_distinct($ws.principal.ip_geo_artifact.location.state)`
`principal_user_emails`	`array_distinct($ws.principal.user.email_addresses)`
`target_user_emails`	`array_distinct($ws.target.user.email_addresses)`
`principal_user_id`	`$ws.principal.user.userid`