Rule body yaml
AnalysisType: rule
Filename: decoy_iam_assumed.py
RuleID: "Decoy.IAM.Assumed"
DisplayName: "Decoy IAM Assumed"
Enabled: false
LogTypes:
- AWS.SecurityFindingFormat
Severity: High
Description: Actor assumed decoy IAM role
DedupPeriodMinutes: 60
Threshold: 1
Reference: https://aws.amazon.com/blogs/security/how-to-detect-suspicious-activity-in-your-aws-account-by-using-private-decoy-resources/
InlineFilters:
- All: []
Tests:
- Name: IAM-Decoy-Assumed
ExpectedResult: true
Log:
Action:
ActionType: AWS_API_CALL
AwsApiCallAction:
Api: AssumeRole
CallerType: remoteIp
DomainDetails: {}
RemoteIpDetails:
City: {}
Country: {}
GeoLocation: {}
IpAddressV4: 11.1.111.11
Organization: {}
ServiceName: sts.amazonaws.com
DnsRequestAction: {}
NetworkConnectionAction:
LocalPortDetails: {}
RemotePortDetails: {}
PortProbeAction: {}
AwsAccountId: "123456789012"
CompanyName: Custom
CreatedAt: "2024-05-24 13:17:15.000000000"
Description: Private decoy IAM role arn:aws:iam::123456789012:role/Dummy-Test-InfoRole-ab21cde50f was accessed by arn:aws:iam::123456789012:user/tester. This IAM role has been provisioned to monitor and generate security events when accessed and can be an indicator of unintended or unauthorized access to your AWS Account.
FindingProviderFields:
Severity:
Label: HIGH
Normalized: 70
Types:
- Unusual Behaviors
GeneratorId: sts.amazonaws.com
Id: 1abc2de3-69ea-4e15-91c6-27eb4a07bd21
ProcessedAt: "2024-05-24T13:17:21.469Z"
ProductArn: arn:aws:securityhub:us-east-1:123456789012:product/123456789012/default
ProductFields:
Custom/DecoyDetector/apiResult: SUCCESS
Custom/DecoyDetector/requestID: ab1cd123-1986-4c45-8546-fdb1776e23b0
Custom/DecoyDetector/userAgent: AWS Signin, aws-internal/3 aws-sdk-java/1.12.720 Linux/5.10.215-181.850.amzn2int.x86_64 OpenJDK_64-Bit_Server_VM/17.0.11+10-LTS java/17.0.11 kotlin/1.3.72 vendor/Amazon.com_Inc. cfg/retry-mode/standard cfg/auth-source#unknown
aws/securityhub/CompanyName: Personal
aws/securityhub/FindingId: arn:aws:service:region:123456789012:resource/12345ab9-436d-4d59-ac58-ed6b3127e440
aws/securityhub/ProductName: Default
ProductName: DecoyDetector
RecordState: ACTIVE
Region: us-east-1
Resources:
- Id: arn:aws:iam::123456789012:role/Dummy-Test-InfoRole-ab21cde50f
Partition: aws
Region: us-east-1
ResourceRole: Target
Type: AwsIamRole
- Details:
AwsIamAccessKey:
AccessKeyId: ABC9ONWNS3155VIEJC8U
AccountId: "123456789012"
PrincipalId: ABCDEFGH0TOGJSGNQKI0:john.doe
PrincipalType: AssumedRole
SessionContext:
Attributes:
CreationDate: "2024-05-24T22:32:38Z"
MfaAuthenticated: false
SessionIssuer:
AccountId: "123456789012"
Arn: arn:aws:iam::123456789012:user/tester
PrincipalId: ABCDEFGH0TOGJSGNQKI0
Type: Role
UserName: user_ab21cde50f
Id: ABC9ONWNS3155VIEJC8U
Partition: aws
Region: us-east-1
ResourceRole: Actor
Type: AwsIamAccessKey
- Id: arn:aws:iam::123456789012:user/tester
Partition: aws
Region: us-east-1
ResourceRole: Actor
Type: AwsIamRole
SchemaVersion: "2018-10-08"
Severity:
Label: HIGH
Normalized: 70
Title: Suspicious activity detected accessing private decoy IAM role arn:aws:iam::123456789012:role/Dummy-Test-InfoRole-ab21cde50f
Types:
- Unusual Behaviors
UpdatedAt: "2024-05-24 13:17:15.000000000"
Workflow:
Status: NEW
WorkflowState: NEW
p_any_actor_ids: []
p_any_aws_account_ids: []
p_any_aws_arns: []
p_any_trace_ids: []
p_any_usernames: []
p_event_time: "2024-05-24 22:34:07.000000000"
p_log_type: AWS.SecurityFindingFormat
p_parse_time: "2024-05-24 22:35:04.272574202"
p_row_id: zjj8nmnw9f90uulxfa3bmen8rv5stlcx
p_schema_version: 0
p_source_id: bb4e16c5-43dd-450c-9227-39f0d152659c
p_source_label: AWS Security Hub
- Name: IAM-Decoy-Not-Assumed
ExpectedResult: false
Log:
Action:
ActionType: AWS_API_CALL
AwsApiCallAction:
Api: ListRoles
CallerType: remoteIp
DomainDetails: {}
RemoteIpDetails:
City: {}
Country: {}
GeoLocation: {}
IpAddressV4: 99.6.134.57
Organization: {}
ServiceName: sts.amazonaws.com
DnsRequestAction: {}
NetworkConnectionAction:
LocalPortDetails: {}
RemotePortDetails: {}
PortProbeAction: {}
AwsAccountId: "123456789012"
CompanyName: Custom
CreatedAt: "2024-05-24 13:17:15.000000000"
Description: Private decoy IAM role arn:aws:iam::123456789012:role/Dummy-Test-InfoRole-ab21cde50f was not accessed by arn:aws:iam::123456789012:user/tester. This IAM role has been provisioned to monitor and generate security events when accessed and can be an indicator of unintended or unauthorized access to your AWS Account.
FindingProviderFields:
Severity:
Label: HIGH
Normalized: 70
Types:
- Unusual Behaviors
GeneratorId: sts.amazonaws.com
Id: 1abc2de3-69ea-4e15-91c6-27eb4a07bd21
ProcessedAt: "2024-05-24T13:17:21.469Z"
ProductArn: arn:aws:securityhub:us-east-1:123456789012:product/123456789012/default
ProductFields:
Custom/DecoyDetector/apiResult: SUCCESS
Custom/DecoyDetector/requestID: ab1cd123-1986-4c45-8546-fdb1776e23b0
Custom/DecoyDetector/userAgent: AWS Signin, aws-internal/3 aws-sdk-java/1.12.720 Linux/5.10.215-181.850.amzn2int.x86_64 OpenJDK_64-Bit_Server_VM/17.0.11+10-LTS java/17.0.11 kotlin/1.3.72 vendor/Amazon.com_Inc. cfg/retry-mode/standard cfg/auth-source#unknown
aws/securityhub/CompanyName: Personal
aws/securityhub/FindingId: arn:aws:service:region:123456789012:resource/12345ab9-436d-4d59-ac58-ed6b3127e440
aws/securityhub/ProductName: Default
ProductName: DecoyDetector
RecordState: ACTIVE
Region: us-east-1
Resources:
- Id: arn:aws:iam::123456789012:role/Dummy-Test-InfoRole-ab21cde50f
Partition: aws
Region: us-east-1
ResourceRole: Target
Type: AwsIamRole
- Details:
AwsIamAccessKey:
AccessKeyId: ABC9ONWNS3155VIEJC8U
AccountId: "123456789012"
PrincipalId: ABCDEFGH0TOGJSGNQKI0:john.doe
PrincipalType: AssumedRole
SessionContext:
Attributes:
CreationDate: "2024-05-24T22:32:38Z"
MfaAuthenticated: false
SessionIssuer:
AccountId: "123456789012"
Arn: arn:aws:iam::123456789012:user/tester
PrincipalId: ABCDEFGH0TOGJSGNQKI0
Type: Role
UserName: user_ab21cde50f
Id: ABC9ONWNS3155VIEJC8U
Partition: aws
Region: us-east-1
ResourceRole: Actor
Type: AwsIamAccessKey
- Id: arn:aws:iam::123456789012:user/tester
Partition: aws
Region: us-east-1
ResourceRole: Actor
Type: AwsIamRole
SchemaVersion: "2018-10-08"
Severity:
Label: HIGH
Normalized: 70
Title: Non-Suspicious activity detected accessing private decoy IAM role arn:aws:iam::123456789012:role/Dummy-Test-InfoRole-ab21cde50f
Types:
- Unusual Behaviors
UpdatedAt: "2024-05-24 13:17:15.000000000"
Workflow:
Status: NEW
WorkflowState: NEW
p_any_actor_ids: []
p_any_aws_account_ids: []
p_any_aws_arns: []
p_any_trace_ids: []
p_any_usernames: []
p_event_time: "2024-05-24 22:34:07.000000000"
p_log_type: AWS.SecurityFindingFormat
p_parse_time: "2024-05-24 22:35:04.272574202"
p_row_id: zjj8nmnw9f90uulxfa3bmen8rv5stlcx
p_schema_version: 0
p_source_id: bb4e16c5-43dd-450c-9227-39f0d152659c
p_source_label: AWS Security Hub
Detection logic
Condition
GeneratorId eq "sts.amazonaws.com"
Action.AwsApiCallAction.Api in "AssumeRole"
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.
| Field | Kind | Values |
|---|---|---|
Action.AwsApiCallAction.Api | in |
|
GeneratorId | eq |
|