Skip to content

Latest commit

 

History

History
92 lines (60 loc) · 4.44 KB

README.md

File metadata and controls

92 lines (60 loc) · 4.44 KB
Raw

Go Version Docker Image Size

SubSnipe 🚀⚡

SubSnipe is a multi-threaded tool designed to help finding subdomains that are vulnerable to takeover. It can be used in two different ways:

  1. Provide a domain as input and the tool then searches crt.sh to search for known subdomains
  2. Provide the path to a file that already contains subdomains

Next, Subsnipe queries for each subdomain if it has a CNAME record. If so, we try to fingerprint it and check if the top-level domain of the CNAME is known to be vulnerable to subdomain takeover. The fingerprinting logic leverages https://github.com/EdOverflow/can-i-take-over-xyz.

Say we find that test.someapp.com has a CNAME to abcd1234.azurewebsites.net. Since azurewebsites.net domains can potentially be leveraged for subdomain takeover, SubSnipe flags this as a domain that is generally exploitable. Of course, for this to be a vulnerability, you need to be able to register abcd1234.azurewebsites.net, so as a next step, you need to verify if this domain is available to for you to register.

In the last step, SubSnipe tries to do this for you by checking if the CNAME, e.g. abcd1234.azurewebsites.net, can actually be taken over. If it could verify that the domain can very likely be taken over, it tags the domain with Takeover Likely Possible! in the output.md.

Built-in Help 🆘

Help is built-in!

  • subsnipe --help - outputs the help.

How to Use ⚙

SubSnipe identifies potentially take-over-able subdomains

Usage:
  subsnipe [flags]

Examples:
./subsnipe -d test.com
./subsnipe -d test.com --threads 50 --output my_output.md
./subsnipe -s subdomains.txt --skip-update-check --format json --output output.json

Flags:
  -d, --domain string            The domain to query for subdomains
  -f, --format string            Format of the output (md, json) (default "md")
  -h, --help                     help for subsnipe
  -o, --output string            Name of the output file (default "output.md")
  -u, --skip-update-check        Skip update check
  -s, --subdomains-file string   Path to the file containing subdomains to query (subdomains are separated by new lines)
  -t, --threads int              Number of concurrent threads for CNAME checks (default 30)

Setup ✅

  • You can install the tool via go install github.com/dub-flow/subsnipe@latest
  • You can simply run this tool from source via go run .
  • You can build the tool yourself via go build
  • You can also build the docker image yourself via docker build . -t fw10/subsnipe

Run via Docker 🐳 (Only 1 Command!)

  1. Traverse into the directory where you want the output.md to be stored to
  2. Run docker run -it --rm -v "$(pwd):/app/output" fw10/subsnipe [flags]

Note that the docker version of the app is very slow at the moment (which I presume is related to network latency when doing all the DNS lookups).

Run Tests 🧪

  • To run the tests, run go test or go test -v (for more details)

Example Output 📋

### Could Be Exploitable

- CNAME for blablub.test.com is: blablub.cloudapp.azure.com. (found matching fingerprint - vulnerable)
- CNAME for mail.test.com is: mail.azurewebsites.net. (found matching fingerprint - vulnerable)
- CNAME for static.test.com is: static-test.azureedge.net. (found matching fingerprint - 'vulnerable'): `Takeover Likely Possible!`

### Not Exploitable

- CNAME for *.test.com is: test-loadbalancer.us-east-1.elb.amazonaws.com. (found matching fingerprint - safe)

### Exploitability Unknown

- CNAME for map.test.com is: test-map.lync.com.

Releases 🔑

  • The Releases section contains some already compiled binaries for you so that you might not have to build the tool yourself
  • For the Mac releases, your Mac may throw a warning ("cannot be opened because it is from an unidentified developer")

Bug Reports 🐞

If you find a bug, please file an Issue right here in GitHub, and I will try to resolve it in a timely manner.