# CloudAuditor

Universal AWS Resource Discovery & Audit Engine

[View on GitHub](https://github.com/jonathanbglass/cloudauditor) [Star](https://github.com/jonathanbglass/cloudauditor/stargazers) 549+ Resource Types ~18s Discovery Time 100% Visibility 4 Lambda Functions

## Overview

CloudAuditor is a high-performance AWS resource discovery engine that evolved from a research tool into a production-grade auditing platform. It provides comprehensive visibility across your entire AWS organization using an intelligent multi-layer fallback strategy.

Built with Python 3.13 and AWS serverless technologies, CloudAuditor automatically discovers, tracks, and reports on AWS resources across multiple accounts and regions, making it essential for security auditing, compliance reporting, and resource governance.

## Key Features

#### Universal Discovery

Discovers 549+ AWS resource types using a hybrid approach: AWS Resource Explorer 2 (primary), AWS Config (secondary), and Cloud Control API (fallback).

#### Multi-Account Support

Native AWS Organizations integration with Hub-and-Spoke discovery model via STS AssumeRole and Resource Explorer Multi-Account Search.

#### Persistent Monitoring

Aurora Serverless v2 (PostgreSQL 15.8) database with IAM authentication, temporal asset tracking, and point-in-time audit capabilities.

#### Excel Reporting

Automated Excel workbook generation with executive summaries, per-service tabs, and temporal tracking using pandas and openpyxl.

#### Global Coverage

Automatic parallel scanning across all active AWS regions with proper normalization of global resources (IAM, S3, CloudFront).

#### Security First

Granular IAM policies for zero-trust cross-account discovery, VPC-bridged Lambda architecture, and Secrets Manager integration.

#### High Performance

Discovers hundreds of resources in ~18 seconds with intelligent caching and parallel processing across regions.

#### Infrastructure as Code

Fully automated deployment using AWS SAM with GitHub Actions CI/CD pipeline for testing and deployment.

## Architecture

CloudAuditor uses a lean 4-Lambda architecture focused on global resource discovery, persistence, and VPC-bridged reporting:

- **cloudauditor-discovery-dev** - Universal AWS Resource Discovery Engine with multi-layer fallback strategy
- **cloudauditor-query-dev** - VPC-bridged query service providing JSON-based fleet inventory data
- **cloudauditor-report-generator-dev** - Managed reporting service generating Excel workbooks from Aurora and uploading to S3
- **cloudauditor-db-init-dev** - Automated database schema management and initialization via CloudFormation Custom Resources

## Technology Stack

AWS Lambda Python 3.13 Aurora Serverless v2 PostgreSQL 15.8 AWS SAM boto3 pandas GitHub Actions

## Use Cases

- **Security Auditing** - Comprehensive visibility into all AWS resources for security assessments and threat detection
- **Compliance Reporting** - Automated evidence collection for SOC 2, ISO 27001, and other compliance frameworks
- **Resource Governance** - Track resource sprawl, identify unused resources, and optimize cloud spend
- **Multi-Account Management** - Centralized visibility across AWS Organizations for enterprise cloud management
- **Change Tracking** - Temporal asset tracking enables point-in-time audits and change detection
- **Disaster Recovery Planning** - Complete inventory of infrastructure for DR planning and testing

[View on GitHub](https://github.com/jonathanbglass/cloudauditor) [Back to Open Source Projects](https://jonathanglass.cloud/opensource.html)
