Detection rules › YARA-L

GitHub Personal Access Token Auto Approve Policy Modified

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

Detects when changes are made to a GitHub organization's fine-grained Personal Access Token approval policy.

MITRE ATT&CK coverage

TacticTechniques
Defense Impairment

References

Telemetry coverage

Rule body

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

rule github_personal_access_token_auto_approve_policy_modified {

  meta:
    author = "Google Cloud Security"
    description = "Detects when changes are made to a GitHub organization's fine-grained Personal Access Token approval policy."
    rule_id = "mr_516c8368-2e3c-4585-afa1-c5df49b214ad"
    rule_name = "GitHub Personal Access Token Auto Approve Policy Modified"
    assumption = "Your GitHub enterprise audit log settings are configured to log the source IP address for events. Reference: https://docs.github.com/en/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/displaying-ip-addresses-in-the-audit-log-for-your-organization"
    type = "alert"
    severity = "Medium"
    priority = "Medium"
    platform = "GitHub"
    data_source = "github"
    mitre_attack_tactic = "Defense Evasion"
    mitre_attack_technique = "Impair Defenses: Disable or Modify Tools"
    mitre_attack_url = "https://attack.mitre.org/versions/v14/techniques/T1562/001/"
    mitre_attack_version = "v14"
    reference = "https://docs.github.com/en/enterprise-cloud@latest/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise"

  events:
    $github.metadata.vendor_name = "GITHUB" nocase
    $github.metadata.product_name = "GITHUB"
    (
        $github.metadata.product_event_type = "auto_approve_personal_access_token_requests.disable" or
        $github.metadata.product_event_type = "auto_approve_personal_access_token_requests.enable" or
        $github.metadata.product_event_type = "forbid_auto_approve_personal_access_token_requests.disable" or
        $github.metadata.product_event_type = "forbid_auto_approve_personal_access_token_requests.enable"
    )

  outcome:
    $risk_score = max(65)
    $mitre_attack_tactic = "Defense Evasion"
    $mitre_attack_technique = "Impair Defenses: Disable or Modify Tools"
    $mitre_attack_technique_id = "T1562.001"
    $principal_ip = array_distinct($github.principal.ip)
    $principal_user_userid = array_distinct($github.principal.user.userid)
    $principal_ip_country = array_distinct($github.principal.ip_geo_artifact.location.country_or_region)
    $principal_ip_state = array_distinct($github.principal.ip_geo_artifact.location.state)
    $principal_ip_city = array_distinct($github.principal.location.city)
    $security_result_summary = array_distinct($github.security_result.summary)

  condition:
    $github
}

YARA-L rule structure

Condition

Fires when at least one $github event.

Events

$github

  • metadata.product_event_type is one of:
    • auto_approve_personal_access_token_requests.disable
    • auto_approve_personal_access_token_requests.enable
    • forbid_auto_approve_personal_access_token_requests.disable
    • forbid_auto_approve_personal_access_token_requests.enable

Outcome

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

FieldExpression
risk_scoremax(65)
principal_iparray_distinct($github.principal.ip)
principal_user_useridarray_distinct($github.principal.user.userid)
principal_ip_countryarray_distinct($github.principal.ip_geo_artifact.location.country_or_region)
principal_ip_statearray_distinct($github.principal.ip_geo_artifact.location.state)
principal_ip_cityarray_distinct($github.principal.location.city)
security_result_summaryarray_distinct($github.security_result.summary)