Skip to main content
The AWS integration provides visibility into cloud infrastructure activity and enables response to cloud-based threats.

Capabilities

Query Tools

Action Tools

All actions require explicit approval before execution.

Setup

Connection Method

Hiro connects via IAM AssumeRole with temporary credentials. You create an IAM role in your AWS account that Hiro can assume.
1

Create an IAM role

Create a new IAM role in your AWS account:
  1. Go to IAM > Roles > Create role
  2. Select Custom trust policy
  3. Use this trust policy (replace YOUR_EXTERNAL_ID with a unique identifier):
The External ID can be any unique string (e.g., your organization ID, a UUID, or a random string). It prevents confused deputy attacks by ensuring only authorized parties can assume the role.
2

Attach permissions

Attach the AWS managed policy for your desired access level:For investigations (recommended):
  • arn:aws:iam::aws:policy/ReadOnlyAccess - Full read access across all AWS services
Alternative options:
  • arn:aws:iam::aws:policy/SecurityAudit - Security-focused read access
  • arn:aws:iam::aws:policy/job-function/ViewOnlyAccess - Limited read access (not recommended - missing IAM visibility)
For remediation actions (optional):Create a custom policy with:
3

Connect in Hiro

In Hiro, go to Settings > Integrations > AWS:
  1. Enter the Role ARN (e.g., arn:aws:iam::123456789012:role/HiroSecurityRole)
  2. Enter the External ID (must match what you configured in the trust policy)
  3. Click Connect

Investigation Examples

Search CloudTrail

Hiro searches CloudTrail and returns:
  • API actions performed
  • Source IP addresses
  • Success/failure status
  • Request parameters

Investigate an access key

Analyze IAM permissions

Hiro analyzes the role and reports:
  • Attached policies
  • Effective permissions
  • Security issues and risk score
  • Recommendations

Discover auth patterns

Hiro analyzes CloudTrail to identify:
  • Identity Center
  • SAML federation
  • OIDC federation
  • IAM users
  • Access keys

Remediation Actions

Example action proposal:

Multi-Account Support

To monitor multiple AWS accounts:
  1. Create the IAM role in each account
  2. Add each Role ARN in Hiro’s AWS integration settings
  3. Hiro will aggregate activity across all accounts during investigations

What’s Not Supported

  • S3-specific tools
  • RDS, Lambda, DynamoDB tools
  • CloudFormation management

Troubleshooting

”Access Denied” on AssumeRole

If you see errors like User is not authorized to perform: sts:AssumeRole:
  1. Verify the trust policy - Ensure Hiro’s account (605862532274) is in the Principal
  2. Check the External ID - The External ID in Hiro must exactly match your trust policy condition
  3. Confirm the Role ARN - Double-check for typos in the role name or account ID

”Access Denied” on specific actions

If AssumeRole succeeds but queries fail (e.g., iam:GetRole denied):
  • Your role is missing permissions. Attach ReadOnlyAccess for full read access
  • ViewOnlyAccess is not sufficient - it lacks IAM visibility

Missing events

CloudTrail events can take up to 15 minutes to appear. Recent activity may not show immediately.

Multi-account issues

When monitoring multiple accounts, ensure the IAM role exists in each account with the same trust policy pointing to Hiro’s account.

Next Steps

Okta

Connect identity management.

CrowdStrike

Connect endpoint protection.