Detection rules › YARA-L
YARA-L rules: 2z
| Rule | Severity |
|---|---|
| Google Workspace External User Added To Group | medium |
| Okta New API Token Created | medium |
Google Workspace External User Added To Group
#Identifies when an external user account is added to a group in Google Workspace. Security teams can monitor for unexpected user accounts being added to Google Workspace groups to prevent unauthorized access to data.
MITRE ATT&CK Coverage
| Tactic | Techniques |
|---|---|
| Initial Access |
Telemetry Coverage
| Platform | Record / event type |
|---|---|
| Google Workspace | ADD_GROUP_MEMBER: Group Member Creation |
Rules Detecting the Same Action
These rules filter on the same operation.
Rule Body
// Copyright 2023 Google LLC. Licensed under Apache-2.0.
rule google_workspace_external_user_added_to_group {
meta:
author = "Google Cloud Security"
description = "Identifies when an external user account is added to a group in Google Workspace. Security teams can monitor for unexpected user accounts being added to Google Workspace groups to prevent unauthorized access to data."
rule_id = "mr_c64af222-e029-4add-ac9c-b9285c5eb135"
rule_name = "Google Workspace External User Added To Group"
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.event_type = "GROUP_MODIFICATION"
$ws.metadata.product_event_type = "ADD_GROUP_MEMBER"
$group_domain = re.capture($ws.target.group.email_addresses, `@[a-zA-Z0-9\.]*`)
$user_domain = re.capture($ws.src.user.email_addresses, `@[a-zA-Z0-9\.]*`)
$group_domain != $user_domain
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)
$target_group_domain = $group_domain
$src_user_domain = $user_domain
$target_group_emails = array_distinct($ws.target.group.email_addresses)
$src_user_emails = array_distinct($ws.src.user.email_addresses)
$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)
$principal_user_id = $ws.principal.user.userid
condition:
$ws
}
YARA-L Rule Structure
Condition
Fires when at least one $ws event.
Events
$user_domain
$ws
metadata.product_event_type = "ADD_GROUP_MEMBER"
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) |
target_group_domain | $group_domain |
src_user_domain | $user_domain |
target_group_emails | array_distinct($ws.target.group.email_addresses) |
src_user_emails | array_distinct($ws.src.user.email_addresses) |
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) |
principal_user_id | $ws.principal.user.userid |
Okta New API Token Created
#Detects when a new API token is created.
MITRE ATT&CK Coverage
| Tactic | Techniques |
|---|---|
| Initial Access | |
| Persistence | |
| Privilege Escalation | |
| Stealth |
References
Telemetry Coverage
| Platform | Record / event type |
|---|---|
| Okta | System Log event type system.api_token.create: API token created |
Rules Detecting the Same Action
These rules filter on the same operation.
- Attempt to Create Okta API Token (Elastic)
- High-Risk Admin Activity (Kusto)
- New Device/Location sign-in along with critical operation (Kusto)
- Okta AD Agent Token Abuse - Behavioral (Panther)
- Okta API Key Created (Panther)
- Okta API Token Created (Sigma)
- Okta New API Token Created (Splunk)
- Query.Okta.ADAgentTokenAbuseBehavioral (Panther)
Rule Body
// Copyright 2023 Google LLC. Licensed under Apache-2.0.
rule okta_new_api_token_created {
meta:
author = "Google Cloud Security"
description = "Detects when a new API token is created."
rule_id = "mr_beca4f13-9526-4095-ab77-f0fc0610200c"
rule_name = "Okta New API Token Created"
reference = "https://developer.okta.com/docs/guides/tokens/"
mitre_attack_tactic = "Defense Evasion, Persistence, Privilege Escalation, Initial Access"
mitre_attack_technique = "Valid Accounts"
mitre_attack_url = "https://attack.mitre.org/techniques/T1078/"
mitre_attack_version = "v13.1"
type = "Alert"
data_source = "Okta"
severity = "Medium"
priority = "Medium"
events:
$token.metadata.product_name = "Okta"
$token.metadata.vendor_name = "Okta"
$token.metadata.product_event_type = "system.api_token.create"
$token.security_result.summary = "Create API token"
$token.security_result.action = "ALLOW"
$token.principal.user.userid = $userid
match:
$userid over 1h
outcome:
$risk_score = max(35)
$mitre_attack_tactic = "Defense Evasion, Persistence, Privilege Escalation, Initial Access"
$mitre_attack_technique = "Valid Accounts"
$target_user_agent = array_distinct($token.network.http.user_agent)
$principal_ip = array_distinct($token.principal.ip)
$principal_ip_country = array_distinct($token.principal.ip_geo_artifact.location.country_or_region)
$principal_ip_state = array_distinct($token.principal.ip_geo_artifact.location.state)
$principal_ip_city = array_distinct($token.principal.location.city)
$principal_user_email_addresses = array_distinct ($token.principal.user.email_addresses)
$security_result_summary = array_distinct($token.security_result.summary)
condition:
$token
}
YARA-L Rule Structure
Condition
Fires when at least one $token event in the 1h window.
Events
$token
metadata.product_event_type = "system.api_token.create"security_result.summary = "Create API token"security_result.action = "ALLOW"
Match and Correlation
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) |
target_user_agent | array_distinct($token.network.http.user_agent) |
principal_ip | array_distinct($token.principal.ip) |
principal_ip_country | array_distinct($token.principal.ip_geo_artifact.location.country_or_region) |
principal_ip_state | array_distinct($token.principal.ip_geo_artifact.location.state) |
principal_ip_city | array_distinct($token.principal.location.city) |
principal_user_email_addresses | array_distinct ($token.principal.user.email_addresses) |
security_result_summary | array_distinct($token.security_result.summary) |