Skip to content

patrick-projectdiscovery/hth2026-workshop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

From Recon to Remediation with ProjectDiscovery

HTH 2026: Spaceballs — The Hacker Conference

"Combing the galaxy for security vulnerabilities"

A 2-hour hands-on workshop where you'll run the full ProjectDiscovery recon-to-vulnerability pipeline, write your own Nuclei detection template, see it all scale through the cloud platform, and watch an AI pentesting agent find bugs no scanner can catch.

All skill levels welcome. If you can open a terminal, you can do this.


⚡ Quick Start

Before the workshop, clone this repo and get your tools installed.

git clone https://github.com/patrick-projectdiscovery/hth2026-workshop
cd hth2026-workshop

Run all workshop commands from inside this directory — the wordlist and templates are referenced by relative path.

Verify your setup

chmod +x scripts/verify-setup.sh && ./scripts/verify-setup.sh

Install tools (pick one):

Option A: PDTM (Recommended)

ProjectDiscovery Tool Manager — installs everything in one shot.

go install -v github.com/projectdiscovery/pdtm/cmd/pdtm@latest
pdtm -install-all

Requires Go 1.21+. Install Go if you don't have it.

Option B: Docker

If you don't want to install Go or the tools natively:

docker pull projectdiscovery/nuclei
docker pull projectdiscovery/subfinder
docker pull projectdiscovery/dnsx
docker pull projectdiscovery/httpx
docker pull projectdiscovery/naabu
docker pull projectdiscovery/katana

Option C: Individual Install

go install -v github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
go install -v github.com/projectdiscovery/dnsx/cmd/dnsx@latest
go install -v github.com/projectdiscovery/httpx/cmd/httpx@latest
go install -v github.com/projectdiscovery/naabu/v2/cmd/naabu@latest
go install -v github.com/projectdiscovery/katana/cmd/katana@latest
go install -v github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest

Sign up for PDCP (free tier)

You'll need a ProjectDiscovery Cloud Platform account for Part 2 of the workshop. Sign up now so you're ready:

👉 cloud.projectdiscovery.io

Verify your install

./scripts/verify-setup.sh

If all required tools show [✓], you're good to go.


🎯 Workshop Target

Spaceballs Galactic Defense Corp — a deliberately vulnerable web application built for this workshop.

Service URL
Corporate Site https://spaceballscorp.com
Employee Portal https://portal.spaceballscorp.com
Admin Panel https://admin.spaceballscorp.com
REST API https://api.spaceballscorp.com
API Docs https://docs.spaceballscorp.com
Staging https://staging.spaceballscorp.com

⚠️ This is a deliberately vulnerable application. Only interact with it during the workshop or with explicit permission. Do not attack infrastructure outside of the target scope.

Your Account

Username Password Role
lone_starr 12345 Employee

More accounts exist. Finding them is part of the exercise.


📋 Workshop Outline

Time Section What You'll Do
0:00–0:20 Recon Pipeline Subdomain discovery, DNS resolution, HTTP probing
0:20–0:40 Vulnerability Scanning Run Nuclei against the target, find 10+ findings
0:40–1:10 Write a Nuclei Template Write a template for an endpoint you found during recon
1:10–1:15 Neo Token Challenge Found all 10 scanner-detectable vulns with the open source pipeline? Show your nuclei output to a facilitator for free Neo tokens.
1:15–1:30 PD Cloud Platform Same target at enterprise scale — add it to your own dashboard
1:30–1:55 Neo AI Pentesting Watch an AI agent find business logic bugs live
1:55–2:00 Wrap-Up Resources, Q&A

📂 What's in This Repo

├── README.md              ← You are here
├── CHEATSHEET.md          ← Pipeline commands & Nuclei template syntax (print this)
├── NEO.md                 ← Suggested prompts for the Neo AI segment
├── TARGETS.md             ← Alternative targets to practice on after the workshop
├── subs-wordlist.txt      ← Subdomain wordlist for active brute forcing
├── templates/
│   └── starter.yaml       ← Skeleton template for the hands-on exercise
└── scripts/
    └── verify-setup.sh    ← Checks your tool installation

🔗 Resources

Resource Link
ProjectDiscovery Docs https://docs.projectdiscovery.io
Nuclei Templates Repo https://github.com/projectdiscovery/nuclei-templates
PDCP (Cloud Platform) https://cloud.projectdiscovery.io
Neo (AI Pentesting) https://neo.projectdiscovery.io
PD Community Discord https://discord.gg/projectdiscovery
Template Writing Guide https://docs.projectdiscovery.io/templates/introduction

🛠️ Troubleshooting

"command not found" after installing: Make sure $GOPATH/bin is in your PATH:

export PATH=$PATH:$(go env GOPATH)/bin

Add this to your .bashrc or .zshrc to make it permanent.

Nuclei templates not found: Update templates:

nuclei -update-templates

naabu requires root/sudo for SYN scans: Run with sudo, or use connect scan mode:

sudo naabu -host target.com
# or
naabu -host target.com -scan-type c

Can't reach the target: Check that DNS resolves:

dig portal.spaceballscorp.com

If you're on conference WiFi and it's not resolving, try switching to 8.8.8.8 or 1.1.1.1 for DNS.


Workshop by Patrick Gleason & Avery Neims — HTH 2026 Patrick Gleason — Solutions Engineer, ProjectDiscovery Avery Neims — Account Executive, ProjectDiscovery

"We are all hackers. Always learning, but with something to share."

About

HTH 2026 Workshop — From Recon to Remediation with ProjectDiscovery

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages