How duo-labs/cloudmapper works
CloudMapper is an AWS environment analysis tool. Its main workflow collects account metadata, stores it as JSON, then runs analysis commands that produce findings, reports, and resource views. The README documents additional IAM, exposure, unused-resource, statistics, and trust-analysis capabilities. Network visualization is explicitly no longer maintained. The graph includes the separate CloudMapper Auditor deployment; unsampled command implementations are represented by their exact paths, with documented capabilities and evidence limits noted rather than assumed call chains.
Main entry points: cloudmapper.py Command dispatcher · report.py Account report · collect.py AWS metadata collection · audit.py Audit rules
Components 25
CLI and collection
- Command dispatcher
cloudmapper.py - AWS metadata collection
commands/collect.py - Account JSON data
account-data - Collected-data reader
shared/query.py
Security analysis
- Misconfiguration audit
commands/audit.py - Audit rules
shared/audit.py - IAM policy analysis
shared/iam_audit.py - Admin discovery
commands/find_admins.py - Public exposure scan
commands/public.py - Unused resource scan
commands/find_unused.py - Shared analysis utilities
shared/common.py
Reports and mapping
- Account report
commands/report.py - IAM report
commands/iam_report.py - Network preparation
commands/prepare.py - Local web server
commands/webserver.py - Network map UI
web/js/cloudmap.js - AWS resource model
shared/nodes.py
Account insights
- Resource statistics
commands/stats.py - Security-group IPs
commands/sg_ips.py - Web of trust
commands/weboftrust.py - Organization discovery
shared/organization.py
CloudMapper Auditor
- Auditor infrastructure
auditor/lib/cloudmapperauditor-stack.js - Alarm forwarder
auditor/resources/alarm_forwarder/main.py
Other components
- Operator
- AWS account
Connections 30
- Operator → Command dispatcher: runs commands
- Command dispatcher → AWS metadata collection: dispatches to
cloudmapper.py - Operator → AWS metadata collection: requests collection
- AWS metadata collection → AWS account: reads metadata
- AWS metadata collection → Account JSON data: records JSON
- Account JSON data → Collected-data reader: loads data
shared/query.py - Command dispatcher → Misconfiguration audit: dispatches to
cloudmapper.py - Misconfiguration audit → Audit rules: runs checks
commands/audit.py - Audit rules → Collected-data reader: reads collected data
shared/audit.py - Audit rules → IAM policy analysis: uses IAM checks
shared/audit.py - Command dispatcher → Admin discovery: dispatches to
cloudmapper.py - Admin discovery → IAM policy analysis: analyzes policies
commands/find_admins.py - Command dispatcher → Account report: dispatches to
cloudmapper.py - Account report → Audit rules: includes findings
commands/report.py - Account report → Public exposure scan: includes exposure data
commands/report.py - Account report → AWS resource model: uses resource model
commands/report.py - Command dispatcher → IAM report: dispatches to
cloudmapper.py - IAM report → AWS resource model: uses resource model
commands/iam_report.py - Command dispatcher → Network preparation: dispatches to
cloudmapper.py - Network preparation → AWS resource model: builds resource model
commands/prepare.py - Network preparation → Account JSON data: reads account data
commands/prepare.py - Operator → Local web server: starts server
- Local web server → Network map UI: serves map
- Command dispatcher → Public exposure scan: dispatches to
cloudmapper.py - Command dispatcher → Unused resource scan: dispatches to
cloudmapper.py - Command dispatcher → Resource statistics: dispatches to
cloudmapper.py - Command dispatcher → Security-group IPs: dispatches to
cloudmapper.py - Command dispatcher → Web of trust: dispatches to
cloudmapper.py - Command dispatcher → Organization discovery: dispatches to
- Auditor infrastructure → Alarm forwarder: configures forwarder
auditor/lib/cloudmapperauditor-stack.js