Skip to content

Repository files navigation

Spectra Banner

Spectra | Enterprise Attack Surface Management

A state-aware, collaborative reconnaissance and ASM platform.

Docker ProjectDiscovery License


Overview

Spectra is a self-hosted, collaborative Attack Surface Management (ASM) ecosystem designed for red teams, bug bounty hunters, and security researchers. It goes beyond simple wrapper scripts by introducing State-Aware Diffing Logic—meaning it tracks the exact lifecycle of your assets, identifying what is newly discovered, what ports have been closed, and instantly flagging regressions in fixed vulnerabilities.

Key Features

  • Continuous Reconnaissance (Diff-Logic): Intelligently tracks active vs. dead assets (Subdomains, IPs, Ports, HTTP Services, Findings) across multiple scans.
  • Project-Scoped RBAC: Granular Role-Based Access Control. Isolate your work into projects, invite team members securely with codes/passwords, and assign roles (Captain, Admin, Member).
  • Real-Time Scan Telemetry: Watch your attack surface unfold live via a Socket.IO-powered dashboard.
  • Enterprise UI/UX: A highly polished, data-dense interface built with Tailwind CSS, featuring dark mode (Void/Carbon) aesthetics and Intel Gold accents.
  • Containerized by Default: Ready to deploy in seconds with persistent PostgreSQL and Redis volumes.

Visual Tour

Real-Time Pipeline

Watch assets and vulnerabilities populate live as the engine runs.
Real-time scan feed

Dashboard & Analytics

Get a high-level overview of exposed ports, active hosts, and critical CVEs.
Spectra Dashboard

Asset Inventory & Findings

Filter, search, and export your entire infrastructure state.
Asset Inventory


Quick Start (Docker)

Spectra is fully containerized. You only need Docker and Docker Compose installed on your machine. All data (PostgreSQL, Redis) is strictly persistent out of the box, surviving reboots and container rebuilds safely.

1. Clone the Repository

git clone https://github.com/MoMhaidat05/Spectra.git
cd Spectra

2. Configure Environment

Create a .env file in the root directory. You must define your own secure keys:

cp .env.example .env

Ensure your .env contains at least:

SPECTRA_DOCKER_SECRET_KEY=your_super_secret_flask_key_here
SPECTRA_DOCKER_POSTGRES_PASSWORD=your_strong_database_password

3. Build & Spin Up

docker compose up --build -d

Note: The first build might take a few minutes as it compiles Go-based ProjectDiscovery tools.

4. Access the Platform

Navigate to http://localhost:8080 in your browser.

  1. Register a new account. (Only a unique username and password are required. Name is optional).
  2. Create a Project. The user who creates a project is automatically assigned the Captain role for that workspace.
  3. Invite your team using the generated Project Code and Password.

Collaboration & RBAC

Spectra does not have global administrators. Every user acts within the scope of a specific Project.

Role Capabilities
Captain (Owner) Absolute control over the project. Can add/modify/remove targets, launch/cancel scans, export data, manage team roles, edit project settings, and delete the project.
Admin Technical powerhouse. Can add/modify/remove targets, run/cancel scans and export data. Cannot manage team members, access project settings or delete the project.
Member (Viewer) Read-only access. Can view the live dashboard, explore the inventory, and read findings. Perfect for clients or junior analysts.

Engine Architecture

Spectra's backend orchestrates the industry's best open-source security tools in a strict, self-healing pipeline:

  1. subfinder: Passive perimeter mapping.
  2. dnsx: Target validation and IP resolution mapping.
  3. naabu: Fast port scanning (tracks dead/stale ports).
  4. httpx: HTTP service fingerprinting and smart cross-linking.
  5. nuclei: Template-based vulnerability scanning (with regression detection).

Results are normalized, hashed, and flushed into PostgreSQL, where the engine's diffing logic updates the live state of the project.


👨‍💻 Backed By

Architected and developed by Mohammad Al Musa, Tech Founder and Offensive Security Researcher.

Connect with me:


"Don't just scan. Understand your spectrum."

About

A state-aware, collaborative Attack Surface Management (ASM) and continuous reconnaissance platform.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages