# aleibl/cloudscanner4internet architecture

> Architecture diagram of the GitHub repository aleibl/cloudscanner4internet, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aleibl/cloudscanner4internet
- Repository: https://github.com/aleibl/cloudscanner4internet

## Overview

##### AWS Cloud Infrastructure
- Multiple AWS Regions (show at least 3 regions as examples)
- EC2 Instances running the custom AMI
- Region-specific AMI IDs

##### Control Flow Components
- Main Controller (aws-run-scan.py)
- Scan Executor (run_scan.py)
- Data Transformer (transform-ip2asn.py)
- Startup Service (run-scan-at-startup.service)

##### Cloud Infrastructure Layer (Middle)
- Inside each region, show:
- AMI deployment
- EC2 instances (multiple instances per region)
- Local scanning processes

##### Execution Layer (Bottom)
- Scanning components:
- masscan execution
- nmap processes
- Data collection flow

Use the following visual elements:

- Blue: Control components
- Orange: AWS infrastructure
- Green: Scanning processes
- Gray: Support services

Important Relationships to Show:

##### Control Flow
- aws-run-scan.py → AWS Regions → EC2 Instances → run_scan.py

##### Data Flow
- Scan Results → transform-ip2asn.py → Processed Data

##### Startup Process
- EC2 Instance → run-scan-at-startup.service → run_scan.py

Additional Considerations:

##### Scaling capabilities
- Instance replication
- Multi-region deployment
- Parallel scanning operations

Level of Detail:
- Configuration points like AMI IDs and region selection

## Diagram (Mermaid)

```mermaid
graph TB
    %% Define styles
    classDef control fill:#3498db,stroke:#2980b9,color:white
    classDef aws fill:#f39c12,stroke:#d35400,color:white
    classDef process fill:#2ecc71,stroke:#27ae60,color:white
    classDef service fill:#95a5a6,stroke:#7f8c8d,color:white

    %% Main Controller
    MC["Main Controller<br/>(aws-run-scan.py)"]:::control
    click MC "https://github.com/aleibl/cloudscanner4internet/blob/main/aws-run-scan.py"

    %% AWS Regions
    subgraph Region1["AWS Region (us-east-1)"]
        AMI1["Custom AMI<br/>ami-xxxxx"]:::aws
        EC1["EC2 Instance 1"]:::aws
        EC2["EC2 Instance 2"]:::aws
    end

    subgraph Region2["AWS Region (us-west-1)"]
        AMI2["Custom AMI<br/>ami-yyyyy"]:::aws
        EC3["EC2 Instance 1"]:::aws
        EC4["EC2 Instance 2"]:::aws
    end

    subgraph Region3["AWS Region (eu-west-1)"]
        AMI3["Custom AMI<br/>ami-zzzzz"]:::aws
        EC5["EC2 Instance 1"]:::aws
        EC6["EC2 Instance 2"]:::aws
    end

    %% Execution Components
    SE["Scan Executor<br/>(run_scan.py)"]:::process
    click SE "https://github.com/aleibl/cloudscanner4internet/blob/main/run_scan.py"
    
    SS["Startup Service<br/>(run-scan-at-startup.service)"]:::service
    click SS "https://github.com/aleibl/cloudscanner4internet/blob/main/run-scan-at-startup.service"
    
    DT["Data Transformer<br/>(transform-ip2asn.py)"]:::process
    click DT "https://github.com/aleibl/cloudscanner4internet/blob/main/transform-ip2asn.py"

    %% Scanning Components
    MS["masscan<br/>Process"]:::process
    NM["nmap<br/>Process"]:::process
    DR[("Scan<br/>Results")]:::process

    %% Relationships
    MC --> Region1
    MC --> Region2
    MC --> Region3

    AMI1 --> EC1
    AMI1 --> EC2
    AMI2 --> EC3
    AMI2 --> EC4
    AMI3 --> EC5
    AMI3 --> EC6

    EC1 & EC2 & EC3 & EC4 & EC5 & EC6 --> SS
    SS --> SE
    SE --> MS
    SE --> NM
    MS & NM --> DR
    DR --> DT

    %% Legend
    subgraph Legend
        L1["Control Component"]:::control
        L2["AWS Component"]:::aws
        L3["Process Component"]:::process
        L4["Service Component"]:::service
    end
```
