This commit is contained in:
davidalvarezp
2026-03-23 13:27:21 +01:00
parent d7a9d64e43
commit 9c72c58a88
32 changed files with 2483 additions and 1 deletions
+175
View File
@@ -0,0 +1,175 @@
---
title: WebSec-Audit
description: Professional Web Security Audit Framework — modular, extensible, Bash-native.
hide:
- navigation
- toc
---
<div class="ws-hero">
<h1>🔐 WebSec-Audit</h1>
<p class="ws-tagline">Professional Web Security Audit Framework — modular, extensible, Bash-native</p>
</div>
<div style="text-align:center;margin-bottom:2.5rem">
[![Version](https://img.shields.io/badge/version-1.0.1-blue?style=flat-square)](https://github.com/davidalvarezp/websec-audit/releases)
[![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](https://github.com/davidalvarezp/websec-audit/blob/main/LICENSE)
[![Bash](https://img.shields.io/badge/bash-5.0%2B-orange?style=flat-square)](https://www.gnu.org/software/bash/)
[![Platform](https://img.shields.io/badge/platform-Debian%20%7C%20Ubuntu%20%7C%20Kali-lightgrey?style=flat-square)](https://github.com/davidalvarezp/websec-audit)
[![CI](https://img.shields.io/github/actions/workflow/status/davidalvarezp/websec-audit/ci.yml?label=CI&style=flat-square)](https://github.com/davidalvarezp/websec-audit/actions)
</div>
!!! danger "Legal Notice"
This tool is intended **exclusively for authorised security assessments**.
Only run it against systems you own or have **explicit written permission** to test.
Unauthorised use is illegal. The author assumes no liability for misuse.
---
## What is websec-audit?
**websec-audit** is a Bash framework that automates comprehensive web application security audits.
It integrates **15+ independent modules** — from passive reconnaissance to active exploitation —
and produces professional findings reports in three formats.
Designed to run on **Debian, Ubuntu and Kali Linux** with zero mandatory dependencies beyond
`curl` and `nmap`.
---
## Feature highlights
<div class="grid cards" markdown>
- :material-puzzle: **Modular architecture**
Enable or disable any of the 15+ modules with a single `--skip-<module>` flag.
- :material-speedometer: **Three scan modes**
Normal, Aggressive and Stealth — adapt the scan depth to each engagement.
- :material-file-chart: **Rich reports**
Interactive HTML dashboard, structured JSON and plain-text log — generated automatically.
- :material-shield-search: **Broad coverage**
Recon · Port scan · SSL/TLS · Headers · SQLi · XSS · SSRF · CORS · CMS · Takeover · Nuclei
- :material-bug-play: **Proxy support**
Route all traffic through Burp Suite or any HTTP proxy with `--proxy`.
- :material-tools: **Tool-agnostic**
Graceful fallback when optional tools are absent. Core scan works with only `curl` + `nmap`.
</div>
---
## Modules at a glance
<div class="module-grid">
<a class="module-card" href="modules/recon/">
<div class="mc-num">Module 01</div>
<div class="mc-name">Reconnaissance</div>
<div class="mc-desc">WHOIS · DNS · AXFR · Subdomains · SPF/DMARC · Dorks</div>
</a>
<a class="module-card" href="modules/portscan/">
<div class="mc-num">Module 02</div>
<div class="mc-name">Port Scanning</div>
<div class="mc-desc">nmap · service detection · risk analysis</div>
</a>
<a class="module-card" href="modules/fingerprint/">
<div class="mc-num">Module 03</div>
<div class="mc-name">Fingerprinting</div>
<div class="mc-desc">WhatWeb · WAF detection · version leakage</div>
</a>
<a class="module-card" href="modules/ssl/">
<div class="mc-num">Module 04</div>
<div class="mc-name">SSL/TLS</div>
<div class="mc-desc">testssl.sh · ciphers · cert expiry · HSTS</div>
</a>
<a class="module-card" href="modules/headers/">
<div class="mc-num">Module 05</div>
<div class="mc-name">HTTP Headers</div>
<div class="mc-desc">CSP · cookies · clickjacking · redirects</div>
</a>
<a class="module-card" href="modules/dirbrute/">
<div class="mc-num">Module 06</div>
<div class="mc-name">Dir & File Enum</div>
<div class="mc-desc">gobuster · ffuf · 40+ sensitive paths</div>
</a>
<a class="module-card" href="modules/nikto/">
<div class="mc-num">Module 07</div>
<div class="mc-name">Nikto</div>
<div class="mc-desc">Web server CVEs · misconfigurations</div>
</a>
<a class="module-card" href="modules/sqli/">
<div class="mc-num">Module 08</div>
<div class="mc-name">SQL Injection</div>
<div class="mc-desc">sqlmap · auto + aggressive mode</div>
</a>
<a class="module-card" href="modules/xss/">
<div class="mc-num">Module 09</div>
<div class="mc-name">XSS</div>
<div class="mc-desc">dalfox · reflected · DOM-based</div>
</a>
<a class="module-card" href="modules/cms/">
<div class="mc-num">Module 10</div>
<div class="mc-name">CMS Scanning</div>
<div class="mc-desc">WordPress · Drupal · Joomla · Magento</div>
</a>
<a class="module-card" href="modules/cors/">
<div class="mc-num">Module 11</div>
<div class="mc-name">CORS</div>
<div class="mc-desc">wildcard · reflected origin · null origin</div>
</a>
<a class="module-card" href="modules/redirect/">
<div class="mc-num">Module 12</div>
<div class="mc-name">Open Redirect</div>
<div class="mc-desc">20 params × 10 payloads</div>
</a>
<a class="module-card" href="modules/ssrf/">
<div class="mc-num">Module 13</div>
<div class="mc-name">SSRF</div>
<div class="mc-desc">AWS · GCP · Azure IMDS · internal IPs</div>
</a>
<a class="module-card" href="modules/subtakeover/">
<div class="mc-num">Module 14</div>
<div class="mc-name">Subdomain Takeover</div>
<div class="mc-desc">subjack · nuclei · 20+ services</div>
</a>
<a class="module-card" href="modules/nuclei/">
<div class="mc-num">Module 15</div>
<div class="mc-name">Nuclei</div>
<div class="mc-desc">CVE templates · misconfiguration scan</div>
</a>
</div>
---
## Quick start
```bash
git clone https://github.com/davidalvarezp/websec-audit.git
cd websec-audit
chmod +x install.sh websec-audit.sh
sudo ./install.sh
./websec-audit.sh -t https://target.com
```
:material-arrow-right: See [Installation](installation.md) and [Quick Start](quickstart.md) for details.
---
## Author
Built by **[davidalvarezp](https://davidalvarezp.com)**.
:material-github: [github.com/davidalvarezp](https://github.com/davidalvarezp) ·
:material-linkedin: [linkedin.com/in/davidalvarezp](https://www.linkedin.com/in/davidalvarezp)