<p align="center"><img src="https://i.imgur.com/rLENhCp.jpg"></p>
<p align="center">
<img src="https://img.shields.io/badge/Python-3-brightgreen.svg?style=plastic">
<img src="https://img.shields.io/badge/OSINT-red.svg?style=plastic">
<img src="https://img.shields.io/badge/Web-red.svg?style=plastic">
</p>
<p align="center">
<a href="https://twitter.com/thewhiteh4t"><b>Twitter</b></a>
<span> - </span>
<a href="https://t.me/thewhiteh4t"><b>Telegram</b></a>
<span> - </span>
<a href="https://thewhiteh4t.github.io"><b>thewhiteh4t's Blog</b></a>
</p>
FinalRecon is an **automatic web reconnaissance** tool written in python. Goal of FinalRecon is to provide an **overview** of the target in a **short** amount of time while maintaining the **accuracy** of results. Instead of executing **several tools** one after another it can provide similar results keeping dependencies **small and simple**.
## Available In
<p align="center">
<a href="https://www.kali.org/news/kali-linux-2020-4-release/">
<img width="150px" hspace="10px" src="https://i.imgur.com/yQRrCtC.png" alt="kali linux finalrecon">
</a>
<a href="https://blackarch.org/">
<img width="150px" hspace="10px" src="https://i.imgur.com/YZ5KDL1.png" alt="blackarch finalrecon">
</a>
<a href="https://secbsd.org/">
<img width="150px" hspace="10px" src="https://i.imgur.com/z36xL8c.png" alt="secbsd finalrecon">
</a>
<a href="https://tsurugi-linux.org/">
<img width="150px" hspace="10px" src="https://i.imgur.com/S1ylcp7.jpg" alt="tsurugi linux finalrecon">
</a>
<a href="https://www.tracelabs.org/initiatives/osint-vm">
<img width="150px" hspace="10px" src="https://i.imgur.com/COAbvYr.png" alt="tracelabs finalrecon">
</a>
</p>
## Featured
### Python For OSINT
* Hakin9 April 2020
* https://hakin9.org/product/python-for-osint-tooling/
### NullByte
* https://null-byte.wonderhowto.com/how-to/conduct-recon-web-target-with-python-tools-0198114/
* https://www.youtube.com/watch?v=F9lwzMPGIgo
### Hakin9
* https://hakin9.org/final-recon-osint-tool-for-all-in-one-web-reconnaissance/
## Features
FinalRecon provides detailed information such as :
* Header Information
* Whois
* SSL Certificate Information
* Crawler
* html
* CSS
* Javascripts
* Internal Links
* External Links
* Images
* robots
* sitemaps
* Links inside Javascripts
* Links from Wayback Machine from Last 1 Year
* DNS Enumeration
* A, AAAA, ANY, CNAME, MX, NS, SOA, TXT Records
* DMARC Records
* Subdomain Enumeration
* Data Sources
* BuffOver
* crt.sh
* ThreatCrowd
* AnubisDB
* ThreatMiner
* Facebook Certificate Transparency API
* Auth Token is Required for this source, read Configuration below
* VirusTotal
* API Key is Required
* Shodan
* API Key is Required
* CertSpotter
* Directory Searching
* Support for File Extensions
* Wayback Machine
* URLs from Last 5 Years
* Port Scan
* Fast
* Top 1000 Ports
* Export
* Formats
* txt
* json [Coming Soon]
## Configuration
### API Keys
Some Modules Use API Keys to fetch data from different resources, these are optional, if you are not using an API key, they will be simply skipped.
If you are interested in using these resources you can store your API key in **keys.json** file.
`Path --> $HOME/.config/finalrecon/conf/keys.json`
If you dont want to use a key for a certain data source just set its value to `null`, by default values of all available data sources are null.
#### Facebook Developers API
This data source is used to fetch **Certificate Transparency** data which is used in **Sub Domain Enumeration**
Key Format : `APP-ID|APP-SECRET`
Example :
```
{
"facebook": "9go1kx9icpua5cm|20yhraldrxt6fi6z43r3a6ci2vckkst3"
}
```
Read More : https://developers.facebook.com/docs/facebook-login/access-tokens
#### VirusTotal API
This data source is used to fetch **Sub Domains** which are used in **Sub Domain Enumeration**
Key Format : `KEY`
Example :
```
{
"virustotal": "eu4zc5f0skv15fnw54nkhj4m26zbteh9409aklpxhfpp68s8d4l63pn13rsojt9y"
}
```
#### Shodan API
This data source is used to fetch **Sub Domains** which are used in **Sub Domain Enumeration**
Key Format : `KEY`
Example :
```
{
"shodan": "eu4zc5f0skv15fnw54nkhj"
}
```
## Tested on
* Kali Linux
* BlackArch Linux
> FinalRecon is a tool for **Pentesters** and it's designed for **Linux** based Operating Systems, other platforms like **Windows** and **Termux** are **NOT** supported.
## Installation
### Kali Linux
```
sudo apt install finalrecon
```
### BlackArch Linux
```
sudo pacman -S finalrecon
```
### SecBSD
```bash
doas pkg_add finalrecon
```
### Other Linux
```bash
git clone https://github.com/thewhiteh4t/FinalRecon.git
cd FinalRecon
pip3 install -r requirements.txt
```
### Docker
``` bash
docker pull thewhiteh4t/finalrecon
docker run -it --entrypoint /bin/sh thewhiteh4t/finalrecon
```
Also docker user can use this alias to run the finalrecon as the normal CLI user.
``` bash
alias finalrecon="docker run -it --rm --name finalrecon --entrypoint 'python3' thewhiteh4t/finalrecon finalrecon.py"
```
And then use `finalrecon` to start your scan.
> remark
>
> If you have any api keys you can easily commit that image in your local machine.
>
> This docker usage needs root to run docker command.
## Usage
```bash
usage: finalrecon.py [-h] [--headers] [--sslinfo] [--whois] [--crawl] [--dns] [--sub]
[--dir] [--wayback] [--ps] [--full] [-t T] [-T T] [-w W] [-r] [-s]
[-sp SP] [-d D] [-e E] [-o O]
url
FinalRecon - The Last Web Recon Tool You Will Need | v1.1.4
positional arguments:
url Target URL
options:
-h, --help show this help message and exit
--headers Header Information
--sslinfo SSL Certificate Information
--whois Whois Lookup
--crawl Crawl Target
--dns DNS Enumeration
--sub Sub-Domain Enumeration
--dir Directory Search
--wayback Wayback URLs
--ps Fast Port Scan
--full Full Recon
Extra Options:
-t T Number of Threads [ Default : 30 ]
-T T Request Timeout [ Default : 30.0 ]
-w W Path to Wordlist [ Default : wordlists/dirb_common.txt ]
-r Allow Redirect [ Default : False ]
-s Toggle SSL Verification [ Default : True ]
-sp SP Specify SSL Port [ Default : 443 ]
-d D Custom DNS Servers [ Default : 1.1.1.1 ]
-e E File Extensions [ Example : txt, xml, php ]
-o O Export Output [ Default : txt ]
```
```bash
# Check headers
python3 finalrecon.py --headers <url>
# Check ssl Certificate
python3 finalrecon.py --sslinfo <url>
# Check whois Information
python3 finalrecon.py --whois <url>
# Crawl Target
python3 finalrecon.py --crawl <url>
# Directory Searching
python3 finalrecon.py --dir <url> -e txt,php -w /path/to/wordlist
# full scan
python3 finalrecon.py --full <url>
```
## Demo
[![Youtube](https://i.imgur.com/IQpZ67e.png)](https://www.youtube.com/watch?v=10q_CKnM3x4)