Skip to content

About

Local-first application security auditing & exploitability verification platform. 100% private, on-device scans, zero synthetic hallucinations, verifiable cryptographic proofs, and executive PDF reports.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Sentinel AppSec Logo

Sentinel AppSec

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.

Static UI Showcase Node Version TypeScript React 19 Tailwind CSS v4 License

Architected and engineered by Tanmay Bhardwaj (@tmvoid)


πŸ›‘οΈ Overview

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

πŸ”’ Local-First Privacy Architecture & Static Preview Notice

  • 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.

🌟 Why Sentinel AppSec?

  • 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.

⚑ The 7 Deterministic Verification Engines

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

πŸš€ Getting Started

Sentinel AppSec is built to work out of the box on Windows, Linux (Fedora, Ubuntu, Debian, Arch), and macOS.

Method A: 100% Private Local Engine (Recommended)

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 engine

Open your browser to:

http://localhost:3000

Tip: You can also run npm run dev to start Vite with Hot Module Replacement alongside the Express backend.


Method B: Static Web Console + Local Daemon (Hybrid)

If you are using the hosted web version at tmvoid.github.io/Sentinel-AppSec:

  1. Start your local daemon on your machine:
    npm run engine
  2. In the web console, click Engine & Free Cloud Deploy in the navigation bar.
  3. Select the preset: Local Node.js Dev Engine (http://localhost:3000).
  4. Sentinel leverages W3C Private Network Access (Access-Control-Allow-Private-Network: true) to pipe audit requests directly through your workstation's raw socket engine!

πŸ› οΈ Available Scripts

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

πŸ“Š Project Structure

β”œβ”€β”€ .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

πŸ”’ Security & Privacy Posture

  • 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.

πŸ‘¨β€πŸ’» Author & Attribution

Sentinel AppSec is engineered and maintained by:


πŸ“„ License

This project is licensed under the Apache License 2.0. See the LICENSE file for complete details.

About

Local-first application security auditing & exploitability verification platform. 100% private, on-device scans, zero synthetic hallucinations, verifiable cryptographic proofs, and executive PDF reports.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages