Universal Empirical Vulnerability, Exploit Proof & Automated Hardening Platform
Zero synthetic hallucinations. Zero generic checklists. Every finding backed by verifiable cryptographic proof, raw HTTP telemetry, and line-level SAST evidence.
Architected and engineered by Tanmay Bhardwaj (@tmvoid)
Sentinel AppSec is a modern, deterministic application security audit and exploitability verification platform. Built specifically for developers, DevSecOps practitioners, and security auditors, Sentinel bridges the gap between superficial static scanners and active penetration testing.
Unlike traditional compliance scanners that generate noisy alerts based on string matching or speculative checks, Sentinel operates on a strict empirical verification model: every vulnerability reported includes a reproducible command (curl), raw response headers, cryptographic cracking evidence, extracted script strings, or exact source code lines.
Important
- Why GitHub Pages is a Static UI Showcase (Demo Mode): The deployed GitHub Pages site (
tmvoid.github.io/Sentinel-AppSec) is a purely static frontend build intended as a visual display showcase to demonstrate how the platform looks and operates. Because static hosting runs inside a web browser sandbox without a live Node.js socket server, it does not produce authentic live network audit results on external domains. - Why Authentic Audits Run on Your Own Device (Privacy by Design): Security auditing inherently involves sensitive infrastructure URLs, proprietary source code, internal endpoints, and active JWT session tokens. Because we value strict data privacy, Sentinel AppSec is architected to be installed and executed locally on your own machine (
npm run engine). - 100% On-Device Reports: When you run Sentinel locally, every raw-socket probe is executed directly from your device's operating system network stack, and every audit report and PDF you generate stays exclusively on your deviceβnever transmitted to, logged by, or stored on any external server.
- Strict On-Device Privacy: Zero cloud logging. Every scan, source file, token, and exported PDF report stays strictly on your personal machine.
- Deterministic Verification: No speculative heuristics or unverified risk scoring.
- 100% Private Local Audit Daemon: Run audits directly through your workstation's raw network sockets with zero external cloud dependencies.
- Cross-Platform by Design: Fully compatible across Linux (Fedora, Ubuntu, Arch, Debian), macOS, and Windows (PowerShell, CMD, WSL).
- Dual-Architecture Runtime: Operates seamlessly as a self-contained local fullstack server (
http://localhost:3000), or pairs the static UI showcase with your local daemon via W3C Private Network Access. - Automated Remediation Studio: Generates drop-in server and framework hardening snippets (Express, Nginx, Next.js, Vercel) and provides Before-vs-After delta comparison.
- Executive PDF Generation: Exports client-ready, tamper-evident security audit reports locally in your browser.
Sentinel runs your target through seven purpose-built auditing engines:
βββββββββββββββββββββββββββββββ
β Sentinel Target Scope β
β (URL / Repo / JWT / Files)β
ββββββββββββββββ¬βββββββββββββββ
β
βββββββββββββββββββββ¬ββββββββββββββββββββΌββββββββββββββββββββ¬ββββββββββββββββββββ
β β β β β
βΌ βΌ βΌ βΌ βΌ
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
β 01. HTTP & CORS β β 02. Route Probe β β 03. JS Harvesterβ β 04. JWT Cracker β β 05. Protocol β
β Headers, TLS, β β SPA 404 Filter, β β Hidden Endpointsβ β HS256 Dictionaryβ β GraphQL Schema, β
β Clickjacking, β β /.env, /.git, β β Leaked Secrets, β β alg:none, forgedβ β HTTP Verbs, β
β Origin Mirror β β .js.map files β β Client Sourcemapβ β Admin Signature β β Open Redirects β
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
β
βββββββββββββββββββββββββββββββββ
βΌ βΌ
βββββββββββββββββββββββββββββββ βββββββββββββββββββββββββββββββ
β 06. OSV.dev Supply-Chain β β 07. Deterministic Code SAST β
β Live Upstream CVE / GHSA β β Regex Sinks, Dangerous Keys,β
β Manifest Dependency Audit β β SQLi & DOM XSS Line Mapping β
βββββββββββββββββββββββββββββββ βββββββββββββββββββββββββββββββ
| Engine | Verification Focus | Exploitability & Proof Provided |
|---|---|---|
| 01. HTTP, CORS & Clickjacking | CSP, HSTS, X-Frame-Options, MIME sniffing, wildcard CORS | Exact response headers, reproduction curl -sI, framing PoC simulation |
| 02. Dotfile & Sourcemap Prober | /.env, /.git/config, app.bundle.js.map |
Adaptive SPA 404 signature comparison, exposed secret payload dumps |
| 03. JS Bundle & Route Harvester | Client JavaScript bundle inspection | Harvests hidden /api/* and /admin/* endpoints and embedded tokens |
| 04. JWT Cryptographic Cracker | Algorithm confusion (alg: none), weak HMAC keys |
High-speed dictionary cracking + forged Admin JWT cryptographic PoC |
| 05. Protocol & Verb Auditor | GraphQL __schema dump, HTTP TRACE/OPTIONS, Open Redirect |
Verifies introspection locks, verb tampering, and unvalidated 3xx redirects |
| 06. OSV.dev Supply-Chain CVE | package.json manifest dependencies |
Direct API batch querying of Open Source Vulnerabilities (OSV) database |
| 07. Deterministic Code SAST | AWS keys, Stripe tokens, SQLi template interpolation, DOM XSS | Line-numbered code citations with before/after secure replacement snippets |
Sentinel AppSec is built to work out of the box on Windows, Linux (Fedora, Ubuntu, Debian, Arch), and macOS.
This method runs both the web UI and the Node.js audit daemon on your personal computer. It requires zero external cloud accounts, keeps all code and tokens strictly on your machine, and provides unrestricted raw socket access to audit any local or external target:
# 1. Clone the repository
git clone https://github.com/tmvoid/Sentinel-AppSec.git
cd Sentinel-AppSec
# 2. Install dependencies (Works across Windows, Linux, Fedora & macOS)
npm install
# Or use the clean cross-platform setup script:
npm run setup
# 3. Start the Sentinel engine
npm run engineOpen your browser to:
http://localhost:3000
Tip: You can also run
npm run devto start Vite with Hot Module Replacement alongside the Express backend.
If you are using the hosted web version at tmvoid.github.io/Sentinel-AppSec:
- Start your local daemon on your machine:
npm run engine
- In the web console, click Engine & Free Cloud Deploy in the navigation bar.
- Select the preset: Local Node.js Dev Engine (
http://localhost:3000). - Sentinel leverages W3C Private Network Access (
Access-Control-Allow-Private-Network: true) to pipe audit requests directly through your workstation's raw socket engine!
| Command | Action | Platform Support |
|---|---|---|
npm run engine |
Boots the fullstack Sentinel server & audit daemon on http://localhost:3000 |
Windows, Linux, macOS |
npm run dev |
Runs the fullstack development server with Vite HMR | Windows, Linux, macOS |
npm run setup |
Clean, peer-dependency safe installation (npm install --legacy-peer-deps) |
Windows, Linux, macOS |
npm run build |
Compiles the production frontend bundle into dist/ |
Windows, Linux, macOS |
npm run start |
Starts the production server hosting dist/ and /api/* |
Windows, Linux, macOS |
npm run lint |
Runs TypeScript type verification (tsc --noEmit) |
Windows, Linux, macOS |
npm run clean |
Cross-platform cleanup of dist/ and server.js using Node.js |
Windows, Linux, macOS |
βββ .github/
β βββ workflows/
β βββ deploy.yml # Automated GitHub Actions CI/CD to GitHub Pages
βββ public/
β βββ logo.png # Canonical Sentinel shield insignia
βββ src/
β βββ components/
β β βββ BackendConnectionModal.tsx # Engine selector & latency monitor
β β βββ EvidenceDrawer.tsx # Slide-over raw proof & exploit viewer
β β βββ HardeningStudio.tsx # Remediation & config generator
β β βββ ReportExportModal.tsx # Multi-format PDF report generator
β β βββ SpotlightCard.tsx # Micro-interaction container components
β β βββ ThemeToggle.tsx # Obsidian Dark / Alabaster Light toggle
β βββ types/
β β βββ audit.ts # TypeScript domain schemas and interfaces
β βββ utils/
β β βββ assets.ts # Base-aware asset resolution
β β βββ clientAuditEngine.ts # In-browser deterministic fallback scanner
β β βββ pdfExport.ts # Clean vector PDF audit report generator
β βββ App.tsx # Main console orchestration layout
β βββ main.tsx # Application bootstrap
βββ .env.example # Environment variable reference template
βββ .npmrc # Cross-platform peer dependency resolution rule
βββ Dockerfile # Containerization recipe for cloud hosts
βββ LICENSE # Apache 2.0 open-source license
βββ package.json # Dependencies, scripts, and engine entrypoints
βββ render.yaml # Infrastructure-as-Code blueprint for Render
βββ server.ts # Fullstack Node.js server with raw socket audit engines
βββ tsconfig.json # TypeScript compiler configuration
βββ vite.config.ts # Vite build and Tailwind CSS v4 setup
- Zero Telemetry Collection: Sentinel AppSec contains zero third-party analytics, user tracking beacons, or telemetry logging.
- Safe Local Storage: Audit history, theme preferences, and custom backend URLs are stored solely in your browser's private
localStorage. - Private Network Isolation: When connecting from the public web console to your local daemon, all requests are scoped strictly to the
/api/*prefix with strict origin checks.
Sentinel AppSec is engineered and maintained by:
- Tanmay Bhardwaj
- LinkedIn: linkedin.com/in/tanmaysbhardwaj
- GitHub: @tmvoid
This project is licensed under the Apache License 2.0. See the LICENSE file for complete details.
