FinDomain- Fastest And Cross-platform Subdomain Enumerator.
Comparison
It comparison gives you a idea why you should use findomain instead of another enumerators. The domain used for the test was Microsoft.com in the following BlackArch virtual machine:
Host: KVM/QEMU (Standard PC (i440FX + PIIX, 1996) pc-i440fx-3.1)
Kernel: 5.2.6-arch1-1-ARCH
CPU: Intel (Skylake, IBRS) (4) @ 2.904GHz
Memory: 139MiB / 3943MiB
Find-Domain used to calculate the time, is the time command in Linux.
You can see all the details of the tests in it link.
I can’t wait to the amass test for finish, looks like it will never ends and additionally the resources usage is very high.
Note: The benchmark was made the 10/08/2019, since it point other software’s can improve things and you will got different results.
Features
- Discover sub-domains without brute-force, it uses Certificate Transparency Logs.
- Discover sub-domains with or without IP address according to user arguments.
- Read target from user argument (-t).
- Read a list of targets from file and discover their sub-domains with or without IP and also write to output files per-domain if specified by the user, recursively.
- Write output to TXT file.
- Write output to CSV file.
- Write output to JSON file.
- Cross platform support: Any platform.
- Optional multiple API support.
- Proxy support.
Note: the proxy support is just to proxify APIs requests, the actual implementation to discover IP address of sub-domains doesn’t support proxyfing and it’s made using the host network still if you use the -p option.
How it works?
It tool doesn’t use the common methods for sub(domains) discover, the tool uses Certificate Transparency logs to find sub-domains and it method make it tool the most faster and reliable. The tool make use of multiple public available APIs to perform the search. If you want to know more about Certificate Transparency logs, read https://www.certificate-transparency.org/
APIs that are using at the moment:
- Certspotter: https://api.certspotter.com/
- Crt.sh : https://crt.sh
- Virustotal: https://www.virustotal.com/ui/domains/
- Sublit3r: https://api.sublist3r.com/
- Facebook: https://developers.facebook.com/docs/certificate-transparency
If you know other that should be added, open an issue.
Supported platforms in our binary releases
All supported platforms in the binarys that we give are 64 bits only and we don’t have plans to add support for 32 bits binary releases, if you want to have support for 32 bits follow the documentation.
- Linux
- Windows
- MacOS
- ARM
- Arch64 (Raspberry Pi)
Build for 32 bits or another platform
If you want to build the tool for your 32 bits system or another platform, follow it steps:
Note: You need to have rust, make and perl installed in your system first.
Using the crate:
- cargo install findomain
- Execute the tool from $HOME/.cargo/bin.
Using the Github source code:
- Clone the repository or download the release source code.
- Extract the release source code (only needed if you downloaded the compressed file).
- Go to the folder where the source code is.
- Execute cargo build –release
- Now your binary is in target/release/findomain and you can use it.
Installation Android (Termux)
Install the Termux package, open it and follow it commands:
$ pkg install rust make perl
$ cargo install findomain
$ cd $HOME/.cargo/bin
$ ./findomain
Installation in Linux using source code
If you want to install it, you can do that manually compiling the source or using the precompiled binary.
Manually: You need to have rust, make and perl installed in your system first.
$ git clone https://github.com/Edu4rdSHL/findomain.git
$ cd findomain
$ cargo build –release
$ sudo cp target/release/findomain /usr/bin/
$ findomain
Installation in Linux using compiled artifacts
$ wget https://github.com/Edu4rdSHL/findomain/releases/latest/download/findomain-linux
$ chmod +x findomain-linux
$ ./findomain-linux
If you are using the BlackArch Linux distribution, you just need to use:
$ sudo pacman -S findomain
Installation ARM
$ wget https://github.com/Edu4rdSHL/findomain/releases/latest/download/findomain-arm
$ chmod +x findomain-arm
$ ./findomain-arm
Installation Aarch64 (Raspberry Pi)
$ wget https://github.com/Edu4rdSHL/findomain/releases/latest/download/findomain-aarch64
$ chmod +x findomain-aarch64
$ ./findomain-aarch64
Installation Windows
Download the binary from
https://github.com/Edu4rdSHL/findomain/releases/latest/download/findomain-windows.exe
Open a CMD shell and go to the dir where findomain-windows.exe was downloaded.
Exec: findomain-windows in the CMD shell.
Installation MacOS
$ wget https://github.com/Edu4rdSHL/findomain/releases/latest/download/findomain-osx
$ chmod +x findomain-osx.dms
$ ./findomain-osx.dms
Usage
You can use the tool in two ways, only discovering the domain name or discovering the domain + the IP address.
findomain 0.2.0
Eduard Tolosa [email protected]>
A tool that use Certificates Transparency logs to find subdomains.
USAGE:
findomain [FLAGS] [OPTIONS]
FLAGS:
-a, –all-apis Use all the available APIs to perform the search. It take more time but you will have a lot of
more results.
-h, –help Prints help information
-i, –get-ip Return the subdomain list with IP address if resolved.
-V, –version Prints version information
OPTIONS:
-f, –file
-o, –output
-p, –proxy
-t, –target
Examples
Make a simple search of subdomains and print the info in the screen:
findomain -t example.com
Make a simple search of subdomains using all the APIs and print the info in the screen:
findomain -t example.com -a
Make a search of subdomains and export the data to a CSV file:
findomain -t example.com -o csv
Make a search of subdomains using all the APIs and export the data to a CSV file:
findomain -t example.com -a -o csv
Make a search of subdomains and resolve the IP address of subdomains (if possible):
findomain -t example.com -i
Make a search of subdomains with all the APIs and resolve the IP address of subdomains (if possible):
findomain -t example.com -i -a
Make a search of subdomains with all the APIs and resolve the IP address of subdomains (if possible), exporting the data to a CSV file:
findomain -t example.com -i -a -o csv
Make a search of subdomains using a proxy (http://127.0.0.1:8080 in it case, the rest of aguments continue working in the same way, you just need to add the -p flag to the before commands):
findomain -t example.com -p http://127.0.0.1:8080
