Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/x1mdev/reconpi
ReconPi - A lightweight recon tool that performs extensive scanning with the latest tools.
https://github.com/x1mdev/reconpi
docker hacking hacking-tool hacktoberfest nuclei raspberry-pi recon recon-pi shell
Last synced: 5 days ago
JSON representation
ReconPi - A lightweight recon tool that performs extensive scanning with the latest tools.
- Host: GitHub
- URL: https://github.com/x1mdev/reconpi
- Owner: x1mdev
- License: mit
- Created: 2018-05-14T23:00:02.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-05-06T17:05:34.000Z (over 2 years ago)
- Last Synced: 2024-12-21T05:07:30.381Z (5 days ago)
- Topics: docker, hacking, hacking-tool, hacktoberfest, nuclei, raspberry-pi, recon, recon-pi, shell
- Language: Shell
- Homepage: https://x1m.nl/posts/recon-pi/
- Size: 29.3 MB
- Stars: 716
- Watchers: 28
- Forks: 112
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Recon Pi
```
__________ __________.__
\______ \ ____ ____ ____ ____\______ \__|
| _// __ \_/ ___\/ _ \ / \| ___/ |
| | \ ___/\ \__( <_> ) | \ | | |
|____|_ /\___ >\___ >____/|___| /____| |__|
\/ \/ \/ \/
v2.2 - @x1m_martijn
```
ReconPi - A lightweight recon tool that performs extensive reconnaissance with the latest tools using a Raspberry Pi.
Start using that Raspberry Pi -- I know you all have one laying around somewhere ;)
> Since version 2.1 ReconPi is usable on your VPS, thanks to [Sachin Grover](https://github.com/mavericknerd) for putting in a lot of work.
The latest [HypriotOS](https://blog.hypriot.com/downloads/) image works perfect for Raspberry Pi's!
### Easy installation
Connect to your ReconPi or VPS with SSH:
`ssh [email protected] [Edit IP address if needed]`
Curl the `install.sh` script and run it:
`curl -L https://raw.githubusercontent.com/x1mdev/ReconPi/master/install.sh | bash`
### Manual installation
Connect to your system with SSH:
`$ ssh [email protected] [Edit IP address if needed]`
Now we can set up everything, it's quite simple:
- `git clone https://github.com/x1mdev/ReconPi.git`
- `cd ReconPi`
- `./install.sh`
Grab a cup of coffee since this will take a while.
## Usage
After installing all of the dependencies for the ReconPi you can finally start doing some recon!
```
$ recon
```
`recon.sh` will first gather resolvers for the given target, followed by subdomain enumeration and checking those assets for potential subdomain takeover. When this is done the IP addresses of the target are enumerated. Open ports will be discovered accompanied by a service scan provided by Nmap.
[Nuclei](https://github) and its templates have been implemented in the routine!
Finally the live targets will be screenshotted and evaluated to discover endpoints.
Results will be stored on the Recon Pi and can be viewed by running `python -m SimpleHTTPServer 1337" in your results directory. Your results will be accessible from any system with a browser that exists in the same network.
Make sure to add your SLACK token to the tokens.txt file if you want to get slack notification after the completion of recon process.
## Sample Token.txt ($HOME/ReconPi/configs/tokens.txt)
```
github_subdomains_token=""
SLACK_WEBHOOK_URL="https://hooks.slack.com/services/xxx/xxx/xxx"
findomain_spyse_token=""
findomain_virustotal_token=""
findomain_securitytrails_token=""
CHAOS_KEY=""
hackerhandle="reconpi"
```
## Config Files (Note: config file for amass, subfinder and naabu are stored inside ReconPi/configs/ folder, provide your api keys in these files)
**Input your API keys in these files to get better results**
Subfinder Config file path : $HOME/ReconPi/configs/config.yaml
Amass Config file path : $HOME/ReconPi/configs/config.ini
We have added a `$hackerhandle` which is used in the nuclei scans. An additional `x-bug-bounty: reconpi` header will be added, please update this with your own handle :)
## Scripts
- Script folder contains a script named **daily** which can be used as a cronjob to run subdomain enumeration automatically.
- Methodology is to take already enumerated subdomains as input and use amass on top of them, then track their last 2 result, and alert new subdomains on slack.
## Tools
Tools that will be installed:
- [Go](https://github.com/golang)
- [Subfinder](https://github.com/projectdiscovery/subfinder/cmd/subfinder)
- [Subjack](https://github.com/haccer/subjack)
- [Aquatone](https://github.com/michenriksen/aquatone)
- [httprobe](https://github.com/tomnomnom/httprobe)
- [assetfinder](https://github.com/tomnomnom/assetfinder)
- [meg](https://github.com/tomnomnom/meg)
- [tojson](https://github.com/tomnomnom/hacks/tojson)
- [unfurl](https://github.com/tomnomnom/unfurl)
- [gf](https://github.com/tomnomnom/gf)
- [anew](https://github.com/tomnomnom/anew)
- [qsreplace](https://github.com/tomnomnom/qsreplace)
- [ffuf](https://github.com/ffuf/ffuf)
- [gobuster](https://github.com/OJ/gobuster)
- [amass](https://github.com/OWASP/Amass)
- [getJS](https://github.com/003random/getJS)
- [gau](https://github.com/lc/gau)
- [shuffledns](https://github.com/projectdiscovery/shuffledns/cmd/shuffledns)
- [dnsprobe](https://github.com/projectdiscovery/dnsprobe)
- [naabu](https://github.com/projectdiscovery/naabu/cmd/naabu)
- [nuclei](https://github.com/projectdiscovery/nuclei/cmd/nuclei)
- [nuclei-template](https://github.com/projectdiscovery/nuclei-templates)
- [cf-check](https://github.com/dwisiswant0/cf-check)
- [massdns](https://github.com/blechschmidt/massdns)
- [jq](https://stedolan.github.io/jq/)
- [masscan](https://github.com/robertdavidgraham/masscan)
- [Corsy](https://github.com/s0md3v/Corsy)
- [Arjun](https://github.com/s0md3v/Arjun)
- [Diggy](https://github.com/s0md3v/Diggy)
- [Dnsgen](https://github.com/ProjectAnte/dnsgen)
- [Sublert](https://github.com/yassineaboukir/sublert)
- [Findomain](https://github.com/Edu4rdSHL/findomain)
- [github-subdomain](https://raw.githubusercontent.com/gwen001/github-search/master/github-subdomains.py)
- [linkfinder](https://github.com/GerbenJavado/LinkFinder)
- [bass](https://github.com/Abss0x7tbh/bass)
- [interlace](https://github.com/codingo/Interlace)
- [nmap](https://nmap.org)
- [Seclist](https://github.com/danielmiessler/SecList)
- [Dirsearch](https://github.com/maurosoria/dirsearch)
- [Dalfox](https://github.com/hahwul/dalfox)
- [Hakrawler](https://github.com/hakluke/hakrawler)
- [Naabu](https://github.com/projectdiscovery/naabu)
- [chaos](https://github.com/projectdiscovery/chaos-client)
- [httpx](https://github.com/projectdiscovery/httpx)
- [altdns](https://github.com/infosec-au/altdns)
## Methodology
- gatherResolvers
- gatherSubdomains
- checkTakeovers
- getCNAME
- gatherIPs
- gatherScreenshots
- startMeg
- fetchArchive
- fetchEndpoints
- runNuclei
- portScan
- notifySlack
**Subdomain Enumeration:**
- Sublert
- Subfinder
- assetfinder
- amass
- findomain (Add findomain sources token to get better result)
- chaos dataset
- github-subdomains
- dns.bufferover.run
- Mutate above Subdomains using commonspeak subdomain list
- Combine and Sort above result -> Use shuffledns to resolve -> dnsgen(to mutate) -> httprobe (to get alive hosts)
- Check takeover using subjack and nuclei
- Get CNAME to check manually for takeovers
- Use dnsprobe to gather IP, ignore if they fall in cloudflare ip range
- Do masscan and then nmap scan on them, also use http-title and vulners script.
- Take Screenshot for visual recon
- Use gau to to get archive urls, get paramlist, jsurls, phpurls, aspxurls, and jspurls in there own files.
- Get Endpoints using Linkfinder
- Run Nuclei Scripts on alive hosts
- Notify on Slack channel if token is specified.
- Directory Buteforcing (Not enabled, as it takes long time, it is better to do manually)
More tools will be added in the future, feel free to make a pull request!
## Contributors
- [Sachin Grover](https://github.com/mavericknerd) (Twitter: @mavericknerd)
- [Damian Ebelties](https://github.com/ebelties)