New to Claude Skills? Learn how to install them →

mukul975 on GitHub

AWS Account Enumeration with ScoutSuite

Free

Assess AWS security posture with comprehensive audits.

Get this skill

Free · Opens the source repo

What AWS Account Enumeration with ScoutSuite does

ScoutSuite is an open-source tool designed for security auditing of AWS environments, developed by NCC Group. It allows users to perform agentless security assessments by querying AWS APIs to gather configuration data across various services. The tool is particularly useful for identifying misconfigurations and generating detailed interactive HTML reports that highlight areas of concern. By employing read-only IAM credentials, ScoutSuite can safely assess the security posture of AWS accounts without making any changes to the environment.

The process begins by installing ScoutSuite via pip and configuring AWS credentials. Once set up, users can initiate scans across all AWS services or target specific services and regions. The resulting reports provide a comprehensive overview of the AWS account's security status, categorizing findings by severity levels such as danger, warning, and good. This structured approach helps users prioritize remediation efforts effectively.

This skill is tailored for security professionals conducting audits, compliance reviews, or incident response procedures. It is particularly beneficial for organizations looking to validate their security controls through hands-on testing. By leveraging ScoutSuite, users can ensure that their AWS configurations align with best practices and regulatory requirements, ultimately improving their cloud security posture.

In addition to the initial scan, ScoutSuite supports ongoing security assessments by allowing users to schedule regular scans and integrate the tool into CI/CD pipelines. This ensures that security remains a continuous focus as infrastructure changes occur, helping organizations maintain a proactive stance against potential vulnerabilities.

When to use it

Use this skill when performing security assessments or compliance reviews of AWS accounts, especially with read-only permissions.

When not to use it

This skill is not suitable for environments where write access is required or for real-time monitoring of AWS resources.

What you can build with it

Conducting a Security Audit

Use ScoutSuite to perform a thorough security audit of your AWS account, identifying misconfigurations and vulnerabilities.

Compliance Review

Leverage ScoutSuite to validate compliance with security best practices during audits or regulatory assessments.

Integrating into CI/CD Pipelines

Incorporate ScoutSuite into your CI/CD process to automatically check for security issues as part of your development workflow.

How to install AWS Account Enumeration with ScoutSuite

View source

1. Install with the skills CLI

npx skills add mukul975/anthropic-cybersecurity-skills/performing-aws-account-enumeration-with-scout-suite --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by mukul975

Performing AWS Account Enumeration with ScoutSuite

Overview

ScoutSuite is an open-source multi-cloud security auditing tool developed by NCC Group that enables comprehensive security posture assessment of AWS environments. It queries AWS APIs to gather configuration data across all services, stores results locally, and generates interactive HTML reports highlighting high-risk areas. ScoutSuite is agentless and works by analyzing how cloud resources are configured, accessed, and monitored.

When to Use

  • When conducting security assessments that involve performing aws account enumeration with scout suite
  • When following incident response procedures for related security events
  • When performing scheduled security testing or auditing activities
  • When validating security controls through hands-on testing

Prerequisites

  • Python 3.6+ installed
  • AWS CLI configured with appropriate IAM credentials
  • Read-only IAM permissions across target AWS services (SecurityAudit managed policy recommended)
  • pip package manager for ScoutSuite installation
  • Network access to AWS API endpoints

Installation and Setup

Install ScoutSuite

pip install scoutsuite

Verify installation

scout --version

Configure AWS credentials

aws configure
# Or use environment variables:
export AWS_ACCESS_KEY_ID=<your-key>
export AWS_SECRET_ACCESS_KEY=<your-secret>
export AWS_DEFAULT_REGION=us-east-1

Required IAM Policy

Attach the AWS managed policy SecurityAudit and ViewOnlyAccess to the IAM user or role running ScoutSuite. For comprehensive scanning, a custom policy may be needed:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "acm:Describe*",
        "acm:List*",
        "cloudformation:Describe*",
        "cloudformation:Get*",
        "cloudformation:List*",
        "cloudtrail:Describe*",
        "cloudtrail:Get*",
        "cloudtrail:List*",
        "cloudwatch:Describe*",
        "cloudwatch:Get*",
        "cloudwatch:List*",
        "config:Describe*",
        "config:Get*",
        "config:List*",
        "dynamodb:Describe*",
        "dynamodb:List*",
        "ec2:Describe*",
        "ec2:Get*",
        "elasticloadbalancing:Describe*",
        "iam:Generate*",
        "iam:Get*",
        "iam:List*",
        "iam:Simulate*",
        "kms:Describe*",
        "kms:Get*",
        "kms:List*",
        "lambda:Get*",
        "lambda:List*",
        "logs:Describe*",
        "logs:Get*",
        "rds:Describe*",
        "rds:List*",
        "redshift:Describe*",
        "route53:Get*",
        "route53:List*",
        "s3:Get*",
        "s3:List*",
        "ses:Get*",
        "ses:List*",
        "sns:Get*",
        "sns:List*",
        "sqs:Get*",
        "sqs:List*",
        "ssm:Describe*",
        "ssm:Get*",
        "ssm:List*"
      ],
      "Resource": "*"
    }
  ]
}

Running ScoutSuite

Full AWS scan

scout aws

Scan specific services only

scout aws --services s3 iam ec2 rds

Scan specific regions

scout aws --regions us-east-1 us-west-2 eu-west-1

Use an assumed role for cross-account scanning

scout aws --profile target-account-profile

Exclude specific services from scan

scout aws --skip iam ec2

Specify output directory

scout aws --report-dir /tmp/scoutsuite-reports/

Report Analysis

ScoutSuite generates an interactive HTML report stored locally. The report includes:

  1. Dashboard: Overview of findings by severity (danger, warning, good)
  2. Service-level findings: Grouped by AWS service (IAM, S3, EC2, RDS, etc.)
  3. Rule-based checks: Each finding maps to a security best practice rule
  4. Resource inventory: Complete listing of enumerated resources

Key areas to review in the report

ServiceCritical Checks
IAMRoot account MFA, password policy, unused credentials, overprivileged policies
S3Public buckets, unencrypted buckets, versioning disabled, logging disabled
EC2Security groups with 0.0.0.0/0, unencrypted EBS volumes, public IPs
RDSPublic accessibility, unencrypted databases, backup retention
CloudTrailLogging disabled, log file validation, multi-region disabled
LambdaPublic access, environment variable secrets, VPC configuration

Interpreting Findings

Severity Levels

  • Danger (Red): Critical security issues requiring immediate remediation (e.g., S3 buckets with public write access)
  • Warning (Orange): Moderate risk findings that should be addressed (e.g., unused IAM access keys)
  • Good (Green): Security best practices that are properly configured

Common High-Risk Findings

  1. IAM root account without MFA: The AWS root account has no multi-factor authentication enabled
  2. S3 bucket policy allows public access: Bucket policies with Principal set to "*"
  3. Security group allows unrestricted SSH: Inbound rule allowing 0.0.0.0/0 on port 22
  4. CloudTrail not enabled in all regions: Audit logging gaps allow unmonitored API activity
  5. RDS instance publicly accessible: Database endpoints reachable from the internet

Remediation Workflow

  1. Run ScoutSuite scan to establish baseline
  2. Export findings and prioritize by severity
  3. Create remediation tickets for danger and warning findings
  4. Implement fixes (update security groups, enable encryption, restrict access)
  5. Re-run ScoutSuite to verify remediation
  6. Schedule regular scans (weekly or after infrastructure changes)

Integration with CI/CD

# Run ScoutSuite in CI/CD pipeline and fail on danger findings
scout aws --services s3 iam ec2 --no-browser --report-dir ./scout-report/

# Parse results programmatically
python -c "
import json
with open('./scout-report/scoutsuite-results/scoutsuite_results.json') as f:
    results = json.load(f)
    for service in results.get('services', {}):
        findings = results['services'][service].get('findings', {})
        for finding_id, finding in findings.items():
            if finding.get('flagged_items', 0) > 0 and finding.get('level') == 'danger':
                print(f'CRITICAL: {finding_id} - {finding.get(\"description\", \"\")}')
"

Multi-Cloud Capability

ScoutSuite supports multiple cloud providers using the same framework:

# Azure
scout azure --cli

# GCP
scout gcp --user-account

# AWS with specific profile
scout aws --profile production

References

Frequently asked questions about AWS Account Enumeration with ScoutSuite

Similar skills