# suraj16s/ultimacon architecture

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

- Interactive diagram: https://gitdiagram.com/suraj16s/ultimacon
- Repository: https://github.com/suraj16s/ultimacon

## Overview

Ultimate Reconnaissance Tool is a modular security-reconnaissance framework. Its principal scan path validates authorization and safety before reconnaissance; the documented module framework gathers and aggregates findings for reports, while a separately wired OSINT dashboard presents results. Capabilities include passive and active recon, OSINT and breach intelligence, certificate analysis, cloud-bucket checks, and takeover detection. The excerpts do not establish that `ultimate_recon.py` invokes `core_manager.py`, so they are shown as separate entry points; several module internals and their exact dispatch paths were not sampled.

Main entry points: [`core_manager.py`](https://github.com/suraj16s/ultimacon/blob/main/core_manager.py) (Module Manager), [`ultimate_recon.py`](https://github.com/suraj16s/ultimacon/blob/main/ultimate_recon.py) (Recon Runner), [`safety_check.py`](https://github.com/suraj16s/ultimacon/blob/main/safety_check.py) (Scope Safety), [`modules/osint_dashboard.py`](https://github.com/suraj16s/ultimacon/blob/main/modules/osint_dashboard.py) (OSINT Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Scan Entry"]
  node_runner["Recon Runner<br/>[ultimate_recon.py]"]
  node_safety["Scope Safety<br/>[safety_check.py]"]
  node_manager["Module Manager<br/>[core_manager.py]"]
end

subgraph group_recon["Recon Modules"]
  node_passive["Passive Recon<br/>[passive_recon.py]"]
  node_active["Active Recon<br/>[active_recon.py]"]
  node_osint["OSINT Collection<br/>[osint.py]"]
  node_breach["Breach Intelligence"]
end

subgraph group_analysis["Analysis Modules"]
  node_certs["Certificate Analysis"]
  node_buckets["Cloud Bucket Checks"]
  node_takeover["Takeover Detection"]
  node_fallback["Fallback Queries"]
end

subgraph group_results["Results &amp; View"]
  node_reports["Scan Reports<br/>[core_manager.py]"]
  node_dashboard["OSINT Dashboard<br/>[osint_dashboard.py]"]
end

node_user(("Operator"))

node_user -.->|"initiates scan"| node_runner
node_runner -->|"checks authorization"| node_safety
node_manager -->|"saves results"| node_reports
node_manager -->|"wires dashboard"| node_dashboard

click node_runner "https://github.com/suraj16s/ultimacon/blob/main/ultimate_recon.py"
click node_safety "https://github.com/suraj16s/ultimacon/blob/main/safety_check.py"
click node_manager "https://github.com/suraj16s/ultimacon/blob/main/core_manager.py"
click node_passive "https://github.com/suraj16s/ultimacon/blob/main/modules/passive_recon.py"
click node_active "https://github.com/suraj16s/ultimacon/blob/main/modules/active_recon.py"
click node_osint "https://github.com/suraj16s/ultimacon/blob/main/modules/osint.py"
click node_breach "https://github.com/suraj16s/ultimacon/blob/main/modules/breach_intelligence.py"
click node_certs "https://github.com/suraj16s/ultimacon/blob/main/modules/certificate_analysis.py"
click node_buckets "https://github.com/suraj16s/ultimacon/blob/main/modules/cloud_bucket_enum.py"
click node_takeover "https://github.com/suraj16s/ultimacon/blob/main/modules/subdomain_takeover.py"
click node_fallback "https://github.com/suraj16s/ultimacon/blob/main/modules/fallback_manager.py"
click node_reports "https://github.com/suraj16s/ultimacon/blob/main/core_manager.py"
click node_dashboard "https://github.com/suraj16s/ultimacon/blob/main/modules/osint_dashboard.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runner,node_safety,node_manager toneBlue
class node_passive,node_active,node_osint,node_breach toneAmber
class node_certs,node_buckets,node_takeover,node_fallback toneMint
class node_reports,node_dashboard toneRose
class node_user toneIndigo
```

## Components

### Scan Entry

- [Recon Runner](https://github.com/suraj16s/ultimacon/blob/main/ultimate_recon.py): `ultimate_recon.py`
- [Scope Safety](https://github.com/suraj16s/ultimacon/blob/main/safety_check.py): `safety_check.py`
- [Module Manager](https://github.com/suraj16s/ultimacon/blob/main/core_manager.py): `core_manager.py`

### Recon Modules

- [Passive Recon](https://github.com/suraj16s/ultimacon/blob/main/modules/passive_recon.py): `modules/passive_recon.py`
- [Active Recon](https://github.com/suraj16s/ultimacon/blob/main/modules/active_recon.py): `modules/active_recon.py`
- [OSINT Collection](https://github.com/suraj16s/ultimacon/blob/main/modules/osint.py): `modules/osint.py`
- [Breach Intelligence](https://github.com/suraj16s/ultimacon/blob/main/modules/breach_intelligence.py): `modules/breach_intelligence.py`

### Analysis Modules

- [Certificate Analysis](https://github.com/suraj16s/ultimacon/blob/main/modules/certificate_analysis.py): `modules/certificate_analysis.py`
- [Cloud Bucket Checks](https://github.com/suraj16s/ultimacon/blob/main/modules/cloud_bucket_enum.py): `modules/cloud_bucket_enum.py`
- [Takeover Detection](https://github.com/suraj16s/ultimacon/blob/main/modules/subdomain_takeover.py): `modules/subdomain_takeover.py`
- [Fallback Queries](https://github.com/suraj16s/ultimacon/blob/main/modules/fallback_manager.py): `modules/fallback_manager.py`

### Results & View

- [Scan Reports](https://github.com/suraj16s/ultimacon/blob/main/core_manager.py): `core_manager.py`
- [OSINT Dashboard](https://github.com/suraj16s/ultimacon/blob/main/modules/osint_dashboard.py): `modules/osint_dashboard.py`

### Other components

- **Operator**

## Connections

- Operator → Recon Runner: initiates scan
- Recon Runner → Scope Safety: checks authorization (evidence: `ultimate_recon.py`)
- Module Manager → Scan Reports: saves results (evidence: `core_manager.py`)
- Module Manager → OSINT Dashboard: wires dashboard (evidence: `core_manager.py`)