Detection rules › YARA-L

O365 Recently Created Entra ID User Assigned Roles

Severity
medium
Type
alert
Time window
90m
Match by
userid
Author
Google Cloud Security
Source
github.com/chronicle/detection-rules

Detects when a user is created in Entra ID and assigned roles within a defined time window.

MITRE ATT&CK coverage

Telemetry coverage

Rules detecting the same action

These rules filter on the same operation.

Rule body

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

rule o365_recently_created_entra_id_user_assigned_roles {

  meta:
    author = "Google Cloud Security"
    description = "Detects when a user is created in Entra ID and assigned roles within a defined time window."
    rule_id = "mr_c0406a96-4ed1-4dd2-9629-aa5a2c881222"
    rule_name = "O365 Recently Created Entra ID User Assigned Roles"
    tactic = "TA0003"
    technique = "T1098.003"
    assumption = "The list msgraph_watchlist_roles is populated with role names, ie Application Administrator"
    type = "alert"
    platform = "azure"
    data_source = "o365"
    severity = "Medium"
    priority = "Medium"

  events:
    (
        $create.metadata.event_type = "USER_CREATION" and
        $create.metadata.product_event_type = "Add user." and
        $create.metadata.product_name = "Office 365" and
        $create.security_result.action = "ALLOW" and
        $create.target.user.userid = $userid
    )
    $create.metadata.event_timestamp.seconds < $role.metadata.event_timestamp.seconds
    (
        $role.metadata.event_type = "USER_UNCATEGORIZED" and
        $role.metadata.product_event_type = "Add member to role." and
        $role.metadata.product_name = "Office 365" and
        $role.security_result.action = "ALLOW" and
        //The reference list msgraph_watchlist_roles matches on the role name. List contents example row: Global Administrator //manage all aspects of Azure AD and Microsoft services that use Azure AD identities 62e90394-69f5-4237-9190-012177145e10
        //If you wanted to detect on specific roles, they could be added to a reference list and the following line uncommented
        //$role.target.resource.attribute.roles.name in %msgraph_watchlist_roles and
        $role.target.user.userid = $userid
    )

  match:
    $userid over 90m

  outcome:
    $risk_score = max(if($role.target.resource.attribute.roles.name = /Administrator/ nocase, 85, 35))
    $security_summary = array_distinct($role.security_result.summary)
    $user_agent = array_distinct($role.network.http.user_agent)
    $assigned_role = array_distinct($role.target.resource.attribute.roles.name)
    //added to populate alert graph with additional context
    $principal_user_userid = array_distinct($create.principal.user.userid)
    $target_user_userid = array_distinct($create.target.user.userid)

  condition:
    $create and $role
}

YARA-L rule structure

Condition

Fires when at least one $create event in the 90m window and at least one $role event in the 90m window.

Events

$create USER_CREATION

  • metadata.product_event_type = "Add user."
  • security_result.action = "ALLOW"

$role USER_UNCATEGORIZED

  • metadata.product_event_type = "Add member to role."
  • security_result.action = "ALLOW"

Match and correlation

Order
$create before $role
Match key
$userid (target.user.userid)
Within
90m

Outcome

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

FieldExpression
risk_scoremax(if($role.target.resource.attribute.roles.name = /Administrator/ nocase, 85, 35))
security_summaryarray_distinct($role.security_result.summary)
user_agentarray_distinct($role.network.http.user_agent)
assigned_rolearray_distinct($role.target.resource.attribute.roles.name)
principal_user_useridarray_distinct($create.principal.user.userid)
target_user_useridarray_distinct($create.target.user.userid)