Listen to this Post
One of the most challenging aspects of being a pentester is creating detailed reports with evidence, vulnerability classifications, descriptions, and recommendations. To address this, Joan Moya developed Blackstone, a free tool that automates pentesting report generation for Linux, macOS, and Windows.
Blackstone helps you document vulnerabilities discovered during CTFs or real-world engagements, building your knowledge base and differentiating your value as a pentester.
🔗 Key Links:
- Blackstone GitHub Repository
- Tutorial: How to Create a Report with Blackstone
- Install Blackstone on Linux
- Install Blackstone on Windows & macOS
You Should Know:
1. Installing Blackstone on Linux
Run these commands to set up Blackstone:
git clone https://github.com/microjoan/blackstone.git cd blackstone chmod +x install.sh ./install.sh
#### **2. Generating a Report**
After scanning, use:
python3 blackstone.py --target <IP> --output report.pdf
#### **3. Customizing Findings**
Edit the `vulnerabilities.db` file to add/modify CVEs, descriptions, and remediation steps.
#### **4. Integrating with Nmap**
Automate scans and import results:
nmap -sV -A <target_IP> -oX scan_results.xml python3 blackstone.py --import-nmap scan_results.xml
#### **5. Windows/Mac Setup**
- Ensure Python 3.10+ is installed.
- Run `pip install -r requirements.txt` before execution.
### **What Undercode Say:**
Blackstone streamlines pentesting workflows, but mastering manual reporting remains crucial. Combine it with tools like:
– Metasploit (msfconsole) for exploit verification.
– Burp Suite for web app findings.
– John the Ripper (john --format=nt hash.txt) for password cracks.
– Linux Commands:
– `grep “vulnerable” /var/log/apache2/access.log` (log analysis).
– `chmod 600 sensitive_file.txt` (secure file permissions).
– Windows Commands:
– `netstat -ano` (check open ports).
– `certutil -hashfile report.pdf SHA256` (verify integrity).
Automation saves time, but human expertise ensures accuracy.
### **Expected Output:**
A structured PDF report with:
- Executive summary.
- Vulnerability tables (CVE, severity, proof of concept).
- Remediation steps.
- Appendices (scan logs, screenshots).
Use Blackstone to enhance efficiency, but always validate findings manually. 🚀
References:
Reported By: Activity 7311802923506671616 – Hackers Feeds
Extra Hub: Undercode MoN
Basic Verification: Pass ✅



