Skip to content

AhmadHassan-BTed/DeAnonymizer

Repository files navigation

DeAnonymizer

Professional Intelligence & Vulnerability Diagnostic Framework

License: MIT Version Threat Levels Developer Live Demo

Engineered by Ahmad Hassan (B-Ted)


A high-fidelity cybersecurity laboratory designed for diagnostic telemetry, advanced fingerprinting, and browser security boundary research.

Architecture Overview

The toolkit is built on a Zero-Coupling Dynamic Plugin Architecture. The core engine remains entirely agnostic of individual module logic, discovering and loading tools at runtime via a centralized manifest.

graph TD
    A[index.html / debug.html] -->|Bootstrap| B[src/core/engine.js]
    B -->|Fetch Discovery| C[src/config/modules.json]
    C -->|Return Payload Paths| B
    B -->|Dynamic import| D[src/modules/level_X/*.js]
    D -->|Self-Register| B
    B -->|Render Grid| UI[Dynamic Command Center]
Loading

Key Design Principles:

  • 0% Coupling: Core engine logic and security payloads never touch.
  • 100% Cohesion: Each module is a self-contained unit with its own metadata and execution logic.
  • Dynamic Handshake: New tools are added by updating a JSON manifestβ€”no code modification required.

Threat Escalation Hierarchy

Tools are categorized into four distinct levels, reflecting the severity of information exposure.

Level Classification Visual Focus Area
L1 Standard Recon 🟒 Green OS, Browser, and Performance Telemetry
L2 Advanced Profiling 🟑 Yellow Network Topology & Hardware Fingerprinting
L3 Critical Intelligence πŸ”΄ Red PII, Credentials, and Social Identity
L4 High-Fidelity Exploits 🟣 Purple Security Bypasses & Hardware Silicion Tracing

System Workflow & Data Flow

When a module is executed, it follows a strict lifecycle from initialization to exfiltration.

sequenceDiagram
    participant U as UI (Command Center)
    participant E as Engine.js
    participant M as Module.js
    participant API as Browser/External API

    U->>E: User clicks 'EXEC'
    E->>E: Initializing Sequence
    E->>M: run() async
    M->>API: Native Probe / Fetch
    API-->>M: Raw Data
    M-->>E: Structured JSON Payload
    E->>U: Render to Terminal Output
Loading

Repository Structure

Pinpoint-Location-Tracker/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ core/
β”‚   β”‚   β”œβ”€β”€ engine.js         # Framework Orchestrator
β”‚   β”‚   └── transmitter.js    # Data Exfiltration Logic
β”‚   β”œβ”€β”€ config/
β”‚   β”‚   └── modules.json      # Discovery Manifest
β”‚   β”œβ”€β”€ modules/              # Plug-and-Play Tools
β”‚   β”‚   β”œβ”€β”€ level1/           # Standard Recon
β”‚   β”‚   β”œβ”€β”€ level2/           # Fingerprinting
β”‚   β”‚   β”œβ”€β”€ level3/           # Intelligence
β”‚   β”‚   └── level4/           # Bypass Lab
β”‚   └── styles/               # Global Design System
β”œβ”€β”€ debug.html                # Automated Lab Shell
└── index.html                # Stealth Dashboard

Internal Module Structure

Every module must adhere to a strict interface to ensure 100% cohesion within the framework.

View Module Template (JavaScript)
/**
 * Pinpoint Module Template
 */
export default {
    id: 'unique_identifier',
    title: 'Display_Name',
    level: 4, // Level 1-4
    info: "Description of the security exposure.",
    steps: [
        "Phase 1 Recon...",
        "Phase 2 Probe...",
        "Phase 3 Exfiltration..."
    ],
    run: async () => {
        // Implementation logic
        return { data: 'captured_intel' };
    }
};

Development & Contribution

The repository is maintained with a focus on engineering excellence. Contributors are encouraged to expand the toolkit by implementing new diagnostic modules.

  1. Draft: Implement the module using the standard template.
  2. Locate: Place the script in the corresponding src/modules/levelX/ folder.
  3. Register: Add the file path to src/config/modules.json.
  4. Verify: Open debug.html to confirm the tool is automatically rendered and functional.


Developed & Documented by Ahmad Hassan (B-Ted)
Professionally maintained for Cybersecurity Research & Education

About

A professional, high-fidelity de-anonymization and vulnerability diagnostic framework. Features a zero-coupling modular architecture for browser-based intelligence gathering, hardware fingerprinting, and security research.

Topics

Resources

License

Contributing

Security policy

Stars

30 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors