succ
is a simple command line tool that queries Microsoft for a list of domains associated with an Office 365 tenant. Specifically, it queries an Autodiscover endpoint using a specially crafted XML payload. The response contains a list of domains that are associated with the tenant.
This tool is a simple continuation of tools already on the market such as:
- bbot
- letItGo
- AADInternals
- etc.
The aim of this utility is to greatly simplify this enumeration process without having to install a full tool suite or run a Python script.
Now, as a tester or bug bounty hunter, you can simply run succ
and get a list of domains associated with the tenant without a ton of cruft surrounding it. This makes it easy to pipe your results to other tools for further enumeration.
Installation is very simple. Once you have Go installed, simply run:
go install github.com/puzzlepeaches/succ@latest
The help menu for succ
is as follows:
succ up domains from MS
Usage:
succ [domain] [flags]
succ [command]
Available Commands:
help Help about any command
version Print the version number of generated code example
Flags:
-e, --exclude-subs Exclude subdomains from the results.
-h, --help help for succ
-j, --json Output to json.
-o, --output string Output file.
-p, --proxy string SOCKS5 proxy to use.
Use "succ [command] --help" for more information about a command.
The only additional option outside of the domain argument is output. This allows you to specify a file to write the results to. If you do not specify an output file, the results will be written to stdout.
Insert corny bugbounty Tesla example below
$ succ tesla.com
tesla.com
tesla.com
teslamotors.com
perbix.com
tesla.services
service.tesla.com
c.tesla.com
mta.tesla.com
m.tesla.com
Example with JSON output and socks5 proxy:
$ succ tesla.com -j -p 127.0.0.1:8888 | jq
{
"domains": [
"service.tesla.com",
"teslaalerts.com",
"c.tesla.com",
"teslagrohmannautomation.de",
"solarcity.com",
"t.tesla.com",
"m.tesla.com",
"tesla.com",
"siilion.com",
"mta.tesla.com",
"tesla.services",
"teslamotors.com",
"perbix.com"
],
"source": "tesla.com"
}
- Add support for multiple domains
- Add support for reading domains from a file
- Add support for filtering out domains that do not resolve