AWS IAM Assume Role Policy Update

Identifies attempts to modify an AWS IAM Assume Role Policy. An adversary may attempt to modify the AssumeRolePolicy of a misconfigured role in order to gain the privileges of that role.

Elastic rule (View on GitHub)

  1[metadata]
  2creation_date = "2020/07/06"
  3integration = ["aws"]
  4maturity = "production"
  5min_stack_comments = "AWS integration breaking changes, bumping version to ^2.0.0"
  6min_stack_version = "8.9.0"
  7updated_date = "2024/04/14"
  8
  9[rule]
 10author = ["Elastic"]
 11description = """
 12Identifies attempts to modify an AWS IAM Assume Role Policy. An adversary may attempt to modify the AssumeRolePolicy of
 13a misconfigured role in order to gain the privileges of that role.
 14"""
 15false_positives = [
 16    """
 17    Verify whether the user identity, user agent, and/or hostname should be making changes in your environment. Policy
 18    updates from unfamiliar users or hosts should be investigated. If known behavior is causing false positives, it can
 19    be exempted from the rule.
 20    """,
 21]
 22from = "now-60m"
 23index = ["filebeat-*", "logs-aws.cloudtrail-*"]
 24interval = "10m"
 25language = "kuery"
 26license = "Elastic License v2"
 27name = "AWS IAM Assume Role Policy Update"
 28note = """## Triage and analysis
 29
 30### Investigating AWS IAM Assume Role Policy Update
 31
 32An IAM role is an IAM identity that you can create in your account that has specific permissions. An IAM role is similar to an IAM user, in that it is an AWS identity with permission policies that determine what the identity can and cannot do in AWS. However, instead of being uniquely associated with one person, a role is intended to be assumable by anyone who needs it. Also, a role does not have standard long-term credentials such as a password or access keys associated with it. Instead, when you assume a role, it provides you with temporary security credentials for your role session.
 33
 34The role trust policy is a JSON document in which you define the principals you trust to assume the role. This policy is a required resource-based policy that is attached to a role in IAM. An attacker may attempt to modify this policy by using the `UpdateAssumeRolePolicy` API action to gain the privileges of that role.
 35
 36#### Possible investigation steps
 37
 38- Identify the user account that performed the action and whether it should perform this kind of action.
 39- Investigate other alerts associated with the user account during the past 48 hours.
 40- Contact the account and resource owners and confirm whether they are aware of this activity.
 41- Check if this operation was approved and performed according to the organization's change management policy.
 42- If you suspect the account has been compromised, scope potentially compromised assets by tracking servers, services, and data accessed by the account in the last 24 hours.
 43
 44### False positive analysis
 45
 46- False positives may occur due to the intended usage of the service. Tuning is needed in order to have higher confidence. Consider adding exceptions — preferably with a combination of the user agent and user ID conditions — to cover administrator activities and infrastructure as code tooling.
 47
 48### Response and remediation
 49
 50- Initiate the incident response process based on the outcome of the triage.
 51- Disable or limit the account during the investigation and response.
 52- Identify the possible impact of the incident and prioritize accordingly; the following actions can help you gain context:
 53    - Identify the account role in the cloud environment.
 54    - Assess the criticality of affected services and servers.
 55    - Work with your IT team to identify and minimize the impact on users.
 56    - Identify if the attacker is moving laterally and compromising other accounts, servers, or services.
 57    - Identify any regulatory or legal ramifications related to this activity.
 58- Use AWS [policy versioning](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-versioning.html) to restore the trust policy to the desired state.
 59- Investigate credential exposure on systems compromised or used by the attacker to ensure all compromised accounts are identified. Reset passwords or delete API keys as needed to revoke the attacker's access to the environment. Work with your IT teams to minimize the impact on business operations during these actions.
 60- Check if unauthorized new users were created, remove unauthorized new accounts, and request password resets for other IAM users.
 61- Consider enabling multi-factor authentication for users.
 62- Review the permissions assigned to the implicated user to ensure that the least privilege principle is being followed.
 63- Implement security best practices [outlined](https://aws.amazon.com/premiumsupport/knowledge-center/security-best-practices/) by AWS.
 64- Determine the initial vector abused by the attacker and take action to prevent reinfection via the same vector.
 65- Using the incident response data, update logging and audit policies to improve the mean time to detect (MTTD) and the mean time to respond (MTTR).
 66
 67## Setup
 68
 69The AWS Fleet integration, Filebeat module, or similarly structured data is required to be compatible with this rule."""
 70references = ["https://labs.bishopfox.com/tech-blog/5-privesc-attack-vectors-in-aws"]
 71risk_score = 21
 72rule_id = "a60326d7-dca7-4fb7-93eb-1ca03a1febbd"
 73severity = "low"
 74tags = [
 75    "Domain: Cloud",
 76    "Data Source: AWS",
 77    "Data Source: Amazon Web Services",
 78    "Data Source: AWS STS",
 79    "Use Case: Identity and Access Audit",
 80    "Resources: Investigation Guide",
 81    "Tactic: Privilege Escalation"
 82]
 83timestamp_override = "event.ingested"
 84type = "query"
 85
 86query = '''
 87event.dataset:aws.cloudtrail and event.provider:iam.amazonaws.com and event.action:UpdateAssumeRolePolicy and event.outcome:success
 88'''
 89
 90
 91[[rule.threat]]
 92framework = "MITRE ATT&CK"
 93[[rule.threat.technique]]
 94id = "T1078"
 95name = "Valid Accounts"
 96reference = "https://attack.mitre.org/techniques/T1078/"
 97
 98
 99[rule.threat.tactic]
100id = "TA0004"
101name = "Privilege Escalation"
102reference = "https://attack.mitre.org/tactics/TA0004/"

Triage and analysis

Investigating AWS IAM Assume Role Policy Update

An IAM role is an IAM identity that you can create in your account that has specific permissions. An IAM role is similar to an IAM user, in that it is an AWS identity with permission policies that determine what the identity can and cannot do in AWS. However, instead of being uniquely associated with one person, a role is intended to be assumable by anyone who needs it. Also, a role does not have standard long-term credentials such as a password or access keys associated with it. Instead, when you assume a role, it provides you with temporary security credentials for your role session.

The role trust policy is a JSON document in which you define the principals you trust to assume the role. This policy is a required resource-based policy that is attached to a role in IAM. An attacker may attempt to modify this policy by using the UpdateAssumeRolePolicy API action to gain the privileges of that role.

Possible investigation steps

  • Identify the user account that performed the action and whether it should perform this kind of action.
  • Investigate other alerts associated with the user account during the past 48 hours.
  • Contact the account and resource owners and confirm whether they are aware of this activity.
  • Check if this operation was approved and performed according to the organization's change management policy.
  • If you suspect the account has been compromised, scope potentially compromised assets by tracking servers, services, and data accessed by the account in the last 24 hours.

False positive analysis

  • False positives may occur due to the intended usage of the service. Tuning is needed in order to have higher confidence. Consider adding exceptions — preferably with a combination of the user agent and user ID conditions — to cover administrator activities and infrastructure as code tooling.

Response and remediation

  • Initiate the incident response process based on the outcome of the triage.
  • Disable or limit the account during the investigation and response.
  • Identify the possible impact of the incident and prioritize accordingly; the following actions can help you gain context:
    • Identify the account role in the cloud environment.
    • Assess the criticality of affected services and servers.
    • Work with your IT team to identify and minimize the impact on users.
    • Identify if the attacker is moving laterally and compromising other accounts, servers, or services.
    • Identify any regulatory or legal ramifications related to this activity.
  • Use AWS policy versioning to restore the trust policy to the desired state.
  • Investigate credential exposure on systems compromised or used by the attacker to ensure all compromised accounts are identified. Reset passwords or delete API keys as needed to revoke the attacker's access to the environment. Work with your IT teams to minimize the impact on business operations during these actions.
  • Check if unauthorized new users were created, remove unauthorized new accounts, and request password resets for other IAM users.
  • Consider enabling multi-factor authentication for users.
  • Review the permissions assigned to the implicated user to ensure that the least privilege principle is being followed.
  • Implement security best practices outlined by AWS.
  • Determine the initial vector abused by the attacker and take action to prevent reinfection via the same vector.
  • Using the incident response data, update logging and audit policies to improve the mean time to detect (MTTD) and the mean time to respond (MTTR).

Setup

The AWS Fleet integration, Filebeat module, or similarly structured data is required to be compatible with this rule.

References

Related rules

to-top