a5c-ai/aws-security-scanner

AWS Security Scanner Skill

Purpose

Automated AWS security configuration scanning and hardening to identify misconfigurations, compliance violations, and security risks across AWS accounts and organizations.

Capabilities

Prowler Security Assessments

• Run comprehensive Prowler security scans
• Execute CIS AWS Foundations Benchmark checks
• Run AWS Well-Architected security pillar assessments
• Check PCI DSS, HIPAA, GDPR compliance
• Generate multi-format reports (HTML, CSV, JSON)

IAM Security Analysis

• Analyze IAM policies for over-permissive access
• Check for unused credentials and access keys
• Identify IAM users without MFA
• Review cross-account access configurations
• Detect privilege escalation paths
• Analyze service control policies (SCPs)

S3 Bucket Security

• Identify publicly accessible buckets
• Check bucket encryption configurations
• Review bucket policies and ACLs
• Verify access logging enabled
• Check for sensitive data exposure
• Validate versioning and replication

Network Security Analysis

• Review security group configurations
• Analyze Network ACLs
• Check VPC flow log enablement
• Identify public-facing resources
• Validate VPC endpoint configurations
• Check for overly permissive rules

Encryption Verification

• Verify EBS volume encryption
• Check RDS encryption settings
• Validate S3 encryption configurations
• Review KMS key policies
• Check secrets manager configurations
• Verify certificate validity

Logging and Monitoring

• Validate CloudTrail configuration
• Check CloudWatch log retention
• Verify GuardDuty enablement
• Review Security Hub findings
• Check Config rule compliance
• Validate alarm configurations

Compliance Mapping

• Map findings to CIS Benchmarks
• Generate SOC 2 evidence
• Track PCI DSS compliance
• Document HIPAA controls
• Map to NIST frameworks

AWS Services Covered

| Category | Services | |----------|----------| | Identity | IAM, SSO, Organizations | | Compute | EC2, Lambda, ECS, EKS | | Storage | S3, EBS, EFS, Glacier | | Database | RDS, DynamoDB, Redshift | | Network | VPC, CloudFront, Route53 | | Security | Security Hub, GuardDuty, KMS | | Monitoring | CloudTrail, CloudWatch, Config |

Integrations

• Prowler: Open-source AWS security tool
• AWS Security Hub: Centralized security findings
• AWS Config: Configuration compliance
• AWS CloudTrail: API activity logging
• AWS GuardDuty: Threat detection
• AWS IAM Access Analyzer: Access analysis

Target Processes

• Cloud Security Architecture Review
• Compliance Monitoring
• Security Posture Assessment
• AWS Account Hardening

Input Schema

{
  "type": "object",
  "properties": {
    "scanType": {
      "type": "string",
      "enum": ["full", "cis", "pci", "hipaa", "gdpr", "custom"],
      "description": "Type of security scan"
    },
    "awsAccounts": {
      "type": "array",
      "items": { "type": "string" },
      "description": "AWS account IDs to scan"
    },
    "regions": {
      "type": "array",
      "items": { "type": "string" },
      "description": "AWS regions to scan"
    },
    "services": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Specific services to scan"
    },
    "severityThreshold": {
      "type": "string",
      "enum": ["critical", "high", "medium", "low", "informational"]
    },
    "complianceFrameworks": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": ["CIS", "PCI-DSS", "HIPAA", "GDPR", "SOC2", "NIST"]
      }
    },
    "excludeChecks": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Check IDs to exclude"
    }
  },
  "required": ["scanType"]
}

Output Schema

{
  "type": "object",
  "properties": {
    "scanId": {
      "type": "string"
    },
    "scanTimestamp": {
      "type": "string",
      "format": "date-time"
    },
    "accountsScanned": {
      "type": "array"
    },
    "regionsScanned": {
      "type": "array"
    },
    "summary": {
      "type": "object",
      "properties": {
        "totalChecks": { "type": "integer" },
        "passed": { "type": "integer" },
        "failed": { "type": "integer" },
        "warnings": { "type": "integer" }
      }
    },
    "findingsBySeverity": {
      "type": "object",
      "properties": {
        "critical": { "type": "integer" },
        "high": { "type": "integer" },
        "medium": { "type": "integer" },
        "low": { "type": "integer" }
      }
    },
    "findings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "checkId": { "type": "string" },
          "severity": { "type": "string" },
          "service": { "type": "string" },
          "region": { "type": "string" },
          "resourceId": { "type": "string" },
          "description": { "type": "string" },
          "remediation": { "type": "string" },
          "complianceMapping": { "type": "array" }
        }
      }
    },
    "complianceStatus": {
      "type": "object"
    },
    "recommendations": {
      "type": "array",
      "items": { "type": "string" }
    },
    "reportPaths": {
      "type": "object",
      "properties": {
        "html": { "type": "string" },
        "csv": { "type": "string" },
        "json": { "type": "string" }
      }
    }
  }
}

Usage Example

skill: {
  name: 'aws-security-scanner',
  context: {
    scanType: 'cis',
    awsAccounts: ['123456789012'],
    regions: ['us-east-1', 'us-west-2'],
    complianceFrameworks: ['CIS', 'SOC2'],
    severityThreshold: 'medium'
  }
}