# initstring/cloud_enum architecture

> Architecture diagram of the GitHub repository initstring/cloud_enum, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/initstring/cloud_enum
- Repository: https://github.com/initstring/cloud_enum

## Overview

##### Project Type and Purpose
- cloud_enum is a Python-based CLI OSINT tool for enumerating public cloud resources across AWS, Azure, and GCP.
- It consists of a single entrypoint script (cloud_enum.py) and a modular package (enum_tools) containing provider-specific checks, region configurations, and shared utilities.

##### File Structure
- Top-level:
- cloud_enum.py – main CLI driver
- requirements.txt / setup.py – packaging and dependencies
- manpage/ – offline documentation
- tests/ – unit tests for core utils
- enum_tools/ package:
- aws_checks.py, azure_checks.py, gcp_checks.py – provider engines
- azure_regions.py, gcp_regions.py – region lists
- utils.py – common routines (thread pools, HTTP/DNS wrappers)
- fuzz.txt – default mutation/brute-force wordlist

##### Pull Additional Insights from the README
- Supports threaded HTTP requests and DNS lookups
- CLI flags for keywords, mutations, brute lists, threads, nameserver, logging, format, and disabling specific providers
- Encourages customization of region lists for Azure and GCP

##### Main Components
a. User / CLI Layer
– cloud_enum.py uses argparse to parse flags
– Loads keywords, fuzz lists, config
b. Controller / Orchestration
– Reads user inputs
– Initializes thread pools (HTTP threads, DNS threads) via utils.py
– Dispatches enumeration tasks to provider modules
c. Provider Modules (plugins/strategy pattern)
– aws_checks.py
– azure_checks.py
– gcp_checks.py
Each module:
- Accepts seeds (keywords + mutations)
- Performs HTTP requests and DNS lookups concurrently
- Applies region-based logic (for Azure, GCP)
- Emits discoveries
d. Shared Utilities
– utils.py: thread pool management, HTTP/DNS wrappers, logging abstraction
– region files: azure_regions.py, gcp_regions.py
– fuzz list: enum_tools/fuzz.txt
e. External Systems
– Public Cloud Endpoints (S3, Blob storage, GCP APIs, etc.)
– DNS Servers (user-specified or system default)
f. Output / Persistence
– Console output (stdout)
– Optional log file (text/json/csv)

##### Relationships & Data Flows
1. User invokes cloud_enum.py with flags.
2. Main script loads fuzz.txt, regions configuration, and sets up thread pools.
3. For each cloud provider enabled:
- The controller enqueues tasks into the thread pool.
- Threads call provider module functions to generate target URLs / DNS names.
- HTTP threads reach out to cloud endpoints; DNS threads perform lookups.
4. Results stream back to the controller.
5. Controller writes discoveries to console and/or log file.

##### Architectural Patterns & Principles
- Modular / Plugin-style organization for each cloud vendor
- Separation of concerns:
- CLI parsing (cloud_enum.py)
- Orchestration (utils + main loop)
- Provider logic (aws_checks / azure_checks / gcp_checks)
- Concurrency via thread pools (threading or concurrent.futures)
- Configuration via flat files (fuzz.txt, region lists)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Code Components
    CLI["cloud_enum.py\n(CLI Parser)"]:::code
    Controller["Controller / Orchestration\n(init thread pools, main loop)"]:::code
    Utils["Utils\n(Thread pools, HTTP/DNS, logging)"]:::code
    AWS["AWS Provider Module\n(aws_checks.py)"]:::code
    Azure["Azure Provider Module\n(azure_checks.py)"]:::code
    GCP["GCP Provider Module\n(gcp_checks.py)"]:::code

    %% Config Files
    Fuzz["fuzz.txt\n(Wordlist)"]:::config
    AZReg["azure_regions.py\n(Region List)"]:::config
    GCPReg["gcp_regions.py\n(Region List)"]:::config
    Req["requirements.txt"]:::config
    Setup["setup.py"]:::config

    %% Documentation & Tests
    Man1["cloud_enum.1\n(Manpage)"]:::config
    ManTxt["cloud_enum.txt\n(Manpage)"]:::config
    TestUtils["tests/test_utils.py\n(Unit Tests)"]:::code

    %% External Systems
    CloudAPIs["Public Cloud Endpoints\n(S3, Blob, GCP APIs)"]:::external
    DNSSrv["DNS Servers"]:::external

    %% Output
    Output["Console Output\nLog File"]:::output

    %% Relationships
    CLI -->|"parse args, load config"| Controller
    Controller -->|"init thread pools"| Utils
    Controller -->|"dispatch tasks"| AWS
    Controller -->|"dispatch tasks"| Azure
    Controller -->|"dispatch tasks"| GCP
    Utils -->|"thread pool APIs"| AWS
    Utils -->|"thread pool APIs"| Azure
    Utils -->|"thread pool APIs"| GCP
    AWS -->|"HTTP GET"| CloudAPIs
    Azure -->|"HTTP GET"| CloudAPIs
    GCP -->|"HTTP GET"| CloudAPIs
    AWS -->|"DNS lookup"| DNSSrv
    Azure -->|"DNS lookup"| DNSSrv
    GCP -->|"DNS lookup"| DNSSrv
    AWS -->|"results"| Controller
    Azure -->|"results"| Controller
    GCP -->|"results"| Controller
    Controller -->|"write findings"| Output
    Fuzz -->|"load wordlist"| Controller
    AZReg -->|"load regions"| Azure
    GCPReg -->|"load regions"| GCP
    Req -->|"dependencies"| CLI
    Setup -->|"packaging"| CLI
    TestUtils -->|"tests utils"| Utils
    Man1 -.->|documentation| CLI
    ManTxt -.->|documentation| CLI

    %% Click Events
    click CLI "https://github.com/initstring/cloud_enum/blob/master/cloud_enum.py"
    click Controller "https://github.com/initstring/cloud_enum/blob/master/enum_tools/utils.py"
    click Utils "https://github.com/initstring/cloud_enum/blob/master/enum_tools/utils.py"
    click AWS "https://github.com/initstring/cloud_enum/blob/master/enum_tools/aws_checks.py"
    click Azure "https://github.com/initstring/cloud_enum/blob/master/enum_tools/azure_checks.py"
    click GCP "https://github.com/initstring/cloud_enum/blob/master/enum_tools/gcp_checks.py"
    click AZReg "https://github.com/initstring/cloud_enum/blob/master/enum_tools/azure_regions.py"
    click GCPReg "https://github.com/initstring/cloud_enum/blob/master/enum_tools/gcp_regions.py"
    click Fuzz "https://github.com/initstring/cloud_enum/blob/master/enum_tools/fuzz.txt"
    click Man1 "https://github.com/initstring/cloud_enum/blob/master/manpage/cloud_enum.1"
    click ManTxt "https://github.com/initstring/cloud_enum/blob/master/manpage/cloud_enum.txt"
    click Req "https://github.com/initstring/cloud_enum/blob/master/requirements.txt"
    click Setup "https://github.com/initstring/cloud_enum/blob/master/setup.py"
    click TestUtils "https://github.com/initstring/cloud_enum/blob/master/tests/test_utils.py"

    %% Styles
    classDef code fill:#D6EAF8,stroke:#2980B9,color:#154360
    classDef config fill:#FCF3CF,stroke:#F1C40F,color:#7D6608
    classDef external fill:#D5F5E3,stroke:#27AE60,color:#145A32
    classDef output fill:#E5E8E8,stroke:#ABB2B9,color:#566573
```
