hivesecurity/pso-printer-security-offensiveOffensive security tool for printer pentesting
Version 0.4.0 | Changelog
"Nmap for Printers" - Offensive security tool for printer pentesting.
Fast. Focused. No bloat.
PSO includes assessment and exploitation features. Always obtain explicit authorization before use.
--aggressive): PJL file system exploitationUnauthorized network scanning is illegal. Use responsibly.
443,631,5000-6000,9100 efficiently@PJL INFO ID--aggressive) - Tests unauthenticated file system accesspip install -r requirements.txt
Requirements: zeroconf, requests, pyyaml
python pso.py --scan 192.168.1.0/24
# Single port
python pso.py --scan 10.0.0.0/24 --ports 8631
# Multiple ports
python pso.py --scan 10.0.0.0/24 --ports 443,631,9100
# Port ranges (smart!)
python pso.py --scan 10.0.0.0/24 --ports 443,631,5000-6000,9100
python pso.py 192.168.1.50 --check-jobs
Requires authorization. Enables PJL file system checks.
python pso.py 192.168.1.50 --aggressive
Output:
[!] AGGRESSIVE MODE ENABLED
[!] PJL file system checks are EXPLOITATION.
[!] Ensure you have explicit authorization.
[*] 192.168.1.50 (JETDIRECT)...
└─ PJL ID: Canon imageRUNNER ADVANCE
🔥 PJL FS ACCESS CONFIRMED (Exploitable)
Risk: 🔥 CRITICAL (Exploitable)
nmap -p- 10.0.0.0/16 -oX scan.xml
python pso.py --nmap scan.xml --aggressive --output json
python pso.py [target] [options]
Positional:
target IP or CIDR (e.g., 192.168.1.0/24)
Options:
--scan CIDR Scan network range
--ports PORTS Ports: single (631), list (443,631,9100), ranges (5000-6000)
--nmap FILE Parse nmap XML
--check-jobs Check for stored print jobs
--aggressive Enable PJL FS checks (requires authorization)
--output FORMAT table | csv | json (default: table)
--timeout SEC mDNS timeout (default: 5)
--no-probe Skip active probing
Network scan with custom ports:
python pso.py --scan 10.0.0.0/24 --ports 443,631,5000-6000,9100
Comprehensive assessment:
python pso.py 192.168.1.50 --check-jobs --aggressive --output json
Automation workflow:
# 1. Discovery
nmap -sV -p- 10.0.0.0/16 -oX scan.xml
# 2. PSO analysis
python pso.py --nmap scan.xml --aggressive --output json > results.json
# 3. Filter critical findings
cat results.json | jq '.printers[] | select(.risk_score > 80)'
Default ports: 9100, 631, 515, 443 (standard printer ports)
Why custom ports?
Syntax:
--ports 631 # Single
--ports 443,631,9100 # List
--ports 5000-6000 # Range
--ports 443,631,5000-6000,9100 # Mixed
Note: For comprehensive scans, use nmap first to discover all open ports, then parse results with PSO.
--aggressive)What it does:
@PJL FSDIRLIST to PJL-enabled portsImpact: 🔥 CRITICAL
Detection: May trigger IDS/IPS
Legal: Requires explicit authorization
--check-jobs)What it does:
Get-Jobs operationImpact: 🔴 HIGH
Legal: Generally acceptable in authorized pentests
Name IP Port Proto Make/Model Risk Level
---------------------------------------------------------------------------------------------------------
Canon-Office 192.168.1.50 631 IPP Canon imageRUNNER ADVANCE 85 🔥 CRITICAL (Exploitable)
python pso.py --scan 10.0.0.0/24 --output csv > findings.csv
python pso.py --scan 10.0.0.0/24 --output json > results.json
JSON structure:
{
"printers": [
{
"id": "printer_192_168_1_50",
"ip": "192.168.1.50",
"risk_score": 85,
"risk_level": "🔥 CRITICAL (Exploitable)",
"fs_access": true,
"vulnerabilities": [...],
"findings": [...]
}
]
}
PSO checks printers against known vulnerabilities in cve_db/printers.yaml.
Included CVEs:
Add your own:
vendors:
YourVendor:
models:
"Model XYZ":
cves:
CVE-2025-0001:
severity: CRITICAL
cvss: 9.8
description: "Your finding"
remediation: "Fix steps"
Bulk update:
python cve_db_builder.py --export
# 1. Discovery
nmap -sV -p- 10.0.0.0/16 -oX nmap_scan.xml
# 2. Assessment
python pso.py --nmap nmap_scan.xml --check-jobs --output json > assessment.json
# 3. Exploitation (authorized only)
python pso.py <target_ip> --aggressive --output json > exploit.json
# 4. Reporting
python pso.py --nmap nmap_scan.xml --output csv > client_report.csv
ModuleNotFoundError?
python -m pip install -r requirements.txt
No printers found?
--ports 8631,19100Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
MIT - Copyright © 2025 Hivesecurity
WWW: https://hivesecurity.gitlab.io/ REPO: https://gitlab.com/hivesecurity/pso-printer-security-offensive