yellow~ opinionated web scanning pipeline for pentesters in a hurry |
| git clone https://github.com/djnnvx/yellow.git |
| log | files | refs | archive | README | LICENSE |
~ yellow
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣤⣤⣤⣤⣤⣤⣤⣄⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀ ⠀⠀⠀⠀⠀⠀⠀⠀⠉⠉⠛⠻⠿⢿⣿⣿⣿⣿⣿⣶⣤⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
Y E L L O W ⠀⠀⠀⢀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠙⠻⣿⣿⣿⣿⣿⣿⣶⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣷⣤⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⢿⣿⣿⣿⣿⣿⣿⣦⡀⠀⠀⠀⠀⠀⠀⠀
-------- ⠀⠀⢸⣿⣿⣿⣿⣷⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣀⣀⣀⣀⣙⢿⣿⣿⣿⣿⣿⣿⣦⡀⠀⠀⠀⠀⠀
⠀⠀⠀⠀ ⠀⠀⠀⠀⠀⢿⣿⣿⣿⣿⣿⣿⣿⣿⣶⣶⣶⣶⣿⣿⣿⣿⣿⣿⣿⣿⣿⠀⠻⣿⣿⣿⣿⣿⣿⣿⣄⠀⠀⠀⠀
djnn.sh⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠇⠀⠀⢹⣿⣿⣿⣿⣿⣿⣿⣆⠀⠀⠀
⠀v0.0.8 ⠀⠀⢠⣿⣿⣿⣿⡟⠹⠿⠟⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡏⠀⠀⠀⠀⢿⣿⣿⣿⣿⣿⣿⣿⡆⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⡿⠋⡬⢿⣿⣷⣤⣤⣴⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠟⠀⠀⠀⠀⠀⠸⣿⣿⣿⣿⣿⣿⣿⣿⡀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠰⡇⢸⡇⢸⣿⣿⣿⠟⠁⢀⣬⢽⣿⣿⣿⣿⣿⣿⠋⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣧⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣼⣧⣈⣛⣿⣿⣿⡇⠀⠀⣾⠁⢀⢻⣿⣿⣿⣿⠇⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⡀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢹⣿⣿⣿⣿⣿⣿⣧⣄⣀⠙⠷⢋⣼⣿⣿⣿⡟⠀⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⣿⣿⣿⣿⣿⣿⡇
⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠻⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣿⣿⣿⣿⡟⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⣿⡇
⣿⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠙⠻⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡟⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠁
⣿⣿⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⣿⣿⣿⣿⣦⡀⠀⠀⠀⠀⠀⠀⢀⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⠀
⠸⣿⣿⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢰⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣦⡀⠀⠀⠀⢀⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠃⠀
⠀⢹⣿⣿⣧⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣄⣴⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠏⠀⠀
⠀⠀⠹⣿⣿⣿⣷⣄⠀⠀⠀⠀⠀⠀⠀⠀⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠏⠀⠀⠀
⠀⠀⠀⠙⣿⣿⣿⣿⣿⣶⣤⣀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿s/o jenaye :)~⣿⣿⣿⣿⣿⣿⠋⠀⠀⠀⠀
⠀⠀⠀⠀⠈⠻⣿⣿⣿⣿⣿⣿⣿⣷⣶⣶⣾⣿⣿⣿⣿⣿⣿⣿⣿matro7sh⣿⣿⣿⣿⣿⣿⣿⠟⠁⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠉⠻⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠟⠁⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠈⠛⠿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠿⠋⠅⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠙⠻⠿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⠿⠛⠉⠀⠀⠀⠀⠀⠀⠀⠀⠈⠂⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠉⠉⠛⠛⠛⠛⠛⠛⠛⠋⠉⠉⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
<=[ Pentest companion for scanning, OSINT, and quick wins ]=>
yellow is a tiny golang CLI to quickly set up scanning at the beginning of a pentest. :)~
Based on yelaa: https://github.com/matro7sh/Yelaa.
Disclaimer
This software is provided as-is, at the discretion of professionals. Developpers assume no responsability for your lack of morals or overall stupidity. Please use at your own risk, in a controlled environnement. Thanks<3
Installing
Using go v1.27.
git clone https://evil.djnn.sh/yellow.git
cd yellow/
make # or: make docker
The docker image ships chromium. On the host, katana and httpx download their own (~150MB) on first run if no chrome is installed.
Running
Every tool is a core.Module (see core/module.go), wired in as a library rather
than shelled out. Run any subcommand with --help for its flags.
Directory tree
./yellow -d djnn.sh
Creates extracted/{assets,code,creds}, scans/{infra,nessus,screenshots,ssl} and
www/{exploits,tools} under djnn.sh/.
Passive enumeration
./yellow osint -d djnn.sh
subfinder, assetfinder, dnsx, gau, alterx, dorks, leaker, shodan. Discovered assets
land in scans/domains.txt. Each IP is also mapped to its ASN and BGP prefix
(asn.json) over DNS via Team Cymru, with Shadowserver as a fallback.
That ASN data is informational and never feeds back into scanning. For a cloud-hosted
target the prefix belongs to the provider and can span millions of unrelated addresses,
so those are flagged hosting_provider: true. Treat it as a scope boundary, not a
target list.
Prune dead hosts
osint returns historical domains, plenty of which are gone. Filter to the live ones:
./yellow prune -f djnn.sh/scans/domains.txt -o djnn.sh/scans/web-targets.txt
Active scans
./yellow scan -d djnn.sh/scans/infra --file djnn.sh/scans/web-targets.txt
Default pipeline: sitemap, robots.txt, katana crawl, secret scan, tlsx, wappalyzergo, cvemap, httpx. Opt in to more:
./yellow scan -d djnn.sh --port-scan # TCP + service fingerprinting
./yellow scan -d djnn.sh --gobuster # dir bruteforce, rooted at crawled dirs
./yellow scan -d djnn.sh --nuclei # downloads ~hundreds of MB of templates
Disable the slow defaults with --no-katana and --no-secrets.
Katana drives a real browser, so it picks up endpoints that only appear once JavaScript
has run. Its URLs feed the secret scan, gobuster and nuclei, bounded by
--katana-max-urls.
The secret scan re-fetches each crawled URL and runs the gitleaks rule set over it,
writing secrets.json. That file holds raw secret values. gitleaks is tuned for
source repos, so minified JS throws high-entropy false positives: treat findings as
leads. Rule ID and entropy are recorded so noisy rules are easy to spot.
Port scanning checks every resolved IP against cdncheck first. Hosts behind a WAF are
annotated in portscan.json and skipped, since you would only be scanning the reverse
proxy. CDN and cloud ranges are annotated but still scanned, because cdncheck files
ordinary cloud compute under cdn, and skipping that would drop real origins.
Fingerprint only
Wappalyzer plus CVE lookup, without the rest of the scan:
./yellow fingerprint -d djnn.sh/scans/infra --file djnn.sh/scans/web-targets.txt
Environment
All optional. Modules self-skip when their key is absent.
| variable | unlocks |
|---|---|
NVD_API_KEY |
faster CVE lookups (free key); without one NVD allows 5 requests per 30s and yellow sleeps 7s between queries |
SHODAN_API_KEY |
the shodan module |
LEAKER_PROVIDER_CONFIG |
path to a leaker provider config, e.g. ~/.config/leaker/provider-config.yml containing leakcheck: [your-key] |
HTTP_PROXY |
set for you by -p/--proxy |
Contributing
This software's code is public, but not open to contributions. If something is integrated, I want to be sure I can maintain it afterwards.
Ideas are welcome though: https://djnn.sh/pgp