Detection rules › Kusto

AWSCloudTrail - User IAM Enumeration

Status
available
Severity
medium
Time window
10m
Group by
UserIdentityAccountId, UserIdentityArn, UserIdentityPrincipalid
Source
github.com/Azure/Azure-Sentinel

Detects enumeration of IAM account configuration via repeated API calls to list roles, users, groups, and policies within a short time period. The threshold can be adjusted to reduce false positives from authorized cloud scanners such as Wiz.

MITRE ATT&CK coverage

TacticTechniques
DiscoveryT1580 Cloud Infrastructure Discovery

Rules detecting the same action

Other rules on this platform that filter on the same API call or operation.

Rule body kusto

id: cfaaf0bc-16d1-48df-ac8b-9d901bbd516a
name: AWSCloudTrail - User IAM Enumeration
description: |
  Detects enumeration of IAM account configuration via repeated API calls to list roles, users, groups, and policies within a short time period. The threshold can be adjusted to reduce false positives from authorized cloud scanners such as Wiz.
severity: Medium
status: Available
requiredDataConnectors:
  - connectorId: AWS
    dataTypes:
      - AWSCloudTrail
queryFrequency: 10m
queryPeriod: 10m
triggerOperator: gt
triggerThreshold: 0
tactics:
  - Discovery
relevantTechniques:
  - T1580
query: |
 let threshold = 50; 
 AWSCloudTrail
 | where EventName in ("ListAttachedRolePolicies","ListRoles","ListGroupsForUser","ListAttachedUserPolicies","ListAccessKeys","ListUsers")
 | summarize
     count(),
     make_set(AWSRegion),
     make_set(UserAgent),
     make_set(SourceIpAddress),
     make_set(ErrorCode),
     make_set(ErrorMessage),
     make_set(EventName)
     by bin(TimeGenerated, 10m), UserIdentityPrincipalid, UserIdentityArn, UserIdentityAccountId
 | where count_ > threshold
 | mv-expand set_SourceIpAddress
 | extend UserName = substring(UserIdentityPrincipalid, indexof_regex(UserIdentityPrincipalid, ":") + 1)
 | extend Name = split(UserName,'@')[0],UpnSuffix = split(UserName,'@')[1]
entityMappings:
  - entityType: Account
    fieldMappings:
      - identifier: Name
        columnName: Name
      - identifier: UPNSuffix
        columnName: UpnSuffix
  - entityType: IP
    fieldMappings:
      - identifier: Address
        columnName: set_SourceIpAddress
customDetails:
  EventCount: count_
  AWSAccountId: UserIdentityAccountId
  PrincipalId: UserIdentityPrincipalid
alertDetailsOverride:
  alertDisplayNameFormat: IAM enumeration detected - {{count_}} API calls by {{UserIdentityPrincipalid}}
  alertDescriptionFormat: User {{UserIdentityPrincipalid}} performed {{count_}} IAM enumeration API calls within a 10-minute window from account {{UserIdentityAccountId}}.
version: 1.0.1
kind: Scheduled

Stages and Predicates

Parameters

let threshold = 50;

Stage 1: source

AWSCloudTrail

Stage 2: where

| where EventName in ("ListAttachedRolePolicies","ListRoles","ListGroupsForUser","ListAttachedUserPolicies","ListAccessKeys","ListUsers")

Stage 3: summarize

| summarize
    count(),
    make_set(AWSRegion),
    make_set(UserAgent),
    make_set(SourceIpAddress),
    make_set(ErrorCode),
    make_set(ErrorMessage),
    make_set(EventName)
    by bin(TimeGenerated, 10m), UserIdentityPrincipalid, UserIdentityArn, UserIdentityAccountId

Stage 4: where

| where count_ > threshold

Stage 5: mv-expand

| mv-expand set_SourceIpAddress

Stage 6: extend

| extend UserName = substring(UserIdentityPrincipalid, indexof_regex(UserIdentityPrincipalid, ":") + 1)

Stage 7: extend

| extend Name = split(UserName,'@')[0],UpnSuffix = split(UserName,'@')[1]

Indicators

Each row is a field, operator, and value that the rule matches. The corpus column counts how many other rules in the catalog look for the same combination: high numbers point to widely-used, community-vetted indicators. Blank or 1 shows that the indicator is specific to this rule.

FieldKindValues
EventNamein
  • ListAccessKeys transforms: cased
  • ListAttachedRolePolicies transforms: cased
  • ListAttachedUserPolicies transforms: cased
  • ListGroupsForUser transforms: cased
  • ListRoles transforms: cased
  • ListUsers transforms: cased
count_gt
  • 50 transforms: cased

Output fields

Fields the rule emits when it matches. Chronicle authors list these in the outcome block; they appear on the detection and $risk_score drives alerting. Sentinel / Defender XDR rules build them up through project / summarize / extend stages. Sentinel maps these into alert fields via entityMappings and customDetails; Defender XDR custom detections surface them as alert fields directly.

FieldSource
UserIdentityAccountIdsummarize
UserIdentityArnsummarize
UserIdentityPrincipalidsummarize
UserNameextend
Nameextend
UpnSuffixextend