Skip to content

puzzlepeaches/succ

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

succ

Suck up some domains from MS

Why?

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:

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

Installation is very simple. Once you have Go installed, simply run:

go install github.com/puzzlepeaches/succ@latest

Usage

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.


Example

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"
}

Planned Features

  • Add support for multiple domains
  • Add support for reading domains from a file
  • Add support for filtering out domains that do not resolve

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages