SharpHound Community Edition has several optional flags that let you control scan scope, performance, output, and other behaviors.
CollectionMethods or 'c'
This tells SharpHound what kind of data you want to collect. These are the most common options you’ll likely use:
- Default: You can specify default collection, or don’t use the CollectionMethods option and this is what SharpHound will do. Default collection includes Active Directory security group membership, domain trusts, abusable permissions on AD objects, OU tree structure, Group Policy links, the most relevant AD object properties, local groups from domain-joined Windows systems, and user sessions.
- All: Performs all collection methods except for GPOLocalGroup.
- DCOnly: Collects data ONLY from the domain controller, will not touch other domain-joined Windows systems. Collects AD security group memberships, domain trusts, abusable permissions on AD objects, OU tree structure, Group Policy links, the most relevant AD object properties, and will attempt to correlate Group Policy-enforced local groups to affected computers.
- ComputerOnly: Collects user sessions (Session) and local groups (LocalGroup) from domain-joined Windows systems. Will NOT collect the data collected with the DCOnly collection method.
- Session: Just does user session collection. You will likely couple this with the `--Loop` option. See SharpHound examples below for more info on that.
- LoggedOn: Does session collection using the privileged collection method. Use this if you are running as a user with local admin rights on lots of systems for the best user session data.
Here are the less common CollectionMethods and what they do:
- Group: Just collect security group memberships from Active Directory
- ACL: Just collect abusable permissions on objects in Active Directory
- GPOLocalGroup: Just attempt GPO to computer correlation to determine members of the relevant local groups on each computer in the domain. Doesn’t actually touch domain-joined systems, just gets info from domain controllers
- Trusts: Just collect domain trusts
- Container: Just collect the OU tree structure and Group Policy links
- LocalGroup: Just collect the members of all interesting local groups on each domain-joined computer. Equivalent for LocalAdmin + RDP + DCOM + PSRemote
- LocalAdmin: Just collect the members of the local Administrators group on each domain-joined computer
- RDP: Just collect the members of the Remote Desktop Users group on each domain-joined computer
- DCOM: Just collect the members of the Distributed COM Users group on each domain-joined computer
- PSRemote: Just collect the members of the Remote Management group on each domain-joined computer
- ObjectProps - Performs Object Properties collection for properties such as LastLogon or PwdLastSet
For example, to collect sessions:
C:\> SharpHound.exe --CollectionMethods session
Collection methods visualization:
Image credit: https://twitter.com/SadProcessor
Domain or 'd'
Tell SharpHound which Active Directory domain you want to gather information from. Importantly, you must be able to resolve DNS in that domain for SharpHound to work correctly. For example, to collect data from the `contoso.local` domain:
C:\> SharpHound.exe --Domain contoso.local
SearchForest or 's'
This flag would instruct SharpHound to automatically collect data from all domains in your current forest.
Perform “stealth” data collection. This switch modifies your data collection method. For example, if you want to perform user session collection, but only touch systems that are the most likely to have user session data:
C:\> SharpHound.exe --CollectionMethods Session --Stealth
Load a list of computer names or IP addresses for SharpHound to collect information from. The file should be line-separated.
Base DistinguishedName to start search at. Use this to limit your search. Equivalent to the old `--OU` and '--SearchBase' option.
C:\> SharpHound.exe --DistinguishedName "OU=New York,DC=Contoso,DC=Local"
LDAPFilter or 'f'
Instruct SharpHound to only collect information from principals that match a given LDAP filter. For example, to only gather abusable ACEs on a user with a certain display name, run this:
C:\> SharpHound.exe --LDAPFilter "(displayName=John Smith)"
Instruct SharpHound to not touch domain controllers. By not touching domain controllers, you will not be able to collect anything specified in the `DCOnly` collection method, but you will also likely avoid detection by e.g., Microsoft ATA/ATP.
C:\> SharpHound.exe -d contoso.local --ExcludeDCs
In some networks, DNS is not controlled by Active Directory, or is otherwise not synchronized to Active Directory. This causes issues when a computer joined to AD has an AD FQDN of COMPUTER.CONTOSO.LOCAL, but also has a DNS FQDN of, for example, COMPUTER.COMPANY.COM. You can help SharpHound find systems in DNS by providing the latter DNS suffix, like this:
C:\> SharpHound.exe --RealDNSName COMPANY.COM
When running SharpHound from a `runas /netonly`-spawned command shell, you may need to let SharpHound know what username you are authenticating to other systems as.
Collect every LDAP property where the value is a string from each enumerated Active Directory object.
By default, SharpHound will output zipped JSON files to the directory SharpHound was launched from. You can specify a different folder for SharpHound to write files to. For example, to instruct SharpHound to write output to C:temp:
C:\> SharpHound.exe --OutputDirectory C:\temp\
Add a prefix to your JSON and ZIP files. For example, to have the JSON and ZIP file names start with “Financial Audit”:
C:\> SharpHound.exe --OutputPrefix "Financial Audit"
Instruct SharpHound to not zip the JSON files when collection finishes
Specify the password to be used for encrypting zip file, by default the zip file is not encrypted
Specify the name of the zip file
Randomize output file names
Outputs JSON with indentation on multiple lines to improve readability. Tradeoff is increased file size.
Adds a CSV tracking requests to computers by dumping error codes from attempted connections to computers
Loop or 'l'
Instruct SharpHound to loop computer-based collection methods. For example, attempt to collect local group memberships across all systems in a loop:
C:\> SharpHound.exe --CollectionMethods LocalGroup --Loop
By default, SharpHound will loop for 2 hours. You can specify whatever duration you like using the HH:MM:SS format. For example, to loop session collection for 12 hours, 30 minutes and 12 seconds:
C:\> SharpHound.exe --CollectionMethods Session --Loop --LoopDuration 12:30:12
How long to pause for between loops, also given in HH:MM:SS format. For example, to loop session collection for 12 hours, 30 minutes and 12 seconds, with a 15 minute interval between loops:
C:\> SharpHound.exe --CollectionMethods Session --Loop --Loopduration 12:30:12 --LoopInterval 00:15:00
Target a specific domain controller by its IP address or name for LDAP collection
Specify an alternate port for LDAP if necessary
Connect to the domain controller using LDAPS (secure LDAP) vs plain text LDAP. This will use port 636 instead of 389. Recommended.
Use with the LdapPassword parameter to provide alternate credentials to the domain controller when performing LDAP collection.
Use with the LdapUsername parameter to provide alternate credentials to the domain controller when performing LDAP collection.
Disables Kerberos Signing/Sealing. Not recommended.
Disables certificate verification when using LDAPS. Not recommended.
Override the username to filter for NetSessionEnum
When SharpHound is scanning a remote system to collect user sessions and local group memberships, it first checks to see if port 445 is open on that system. This helps speed up SharpHound collection by not attempting unnecessary function calls when systems aren’t even online. By default, SharpHound will wait 2000 milliseconds (2 seconds) to get a response when scanning 445 on the remote system. You can decrease this if you’re on a fast LAN, or increase it if you need to. For example, to tell SharpHound to wait just 1000 milliseconds (1 second) before skipping to the next host:
C:\> SharpHound.exe --PortScanTimeout 1000
Instruct SharpHound to not perform the port 445 check before attempting to enumerate information from a remote host. This can result in significantly slower collection periods.
Skip check for PwdLastSet when enumerating computers.
Skip registry session enumeration
Adds a delay after each request to a computer. Value is in milliseconds (Default: 0)
Adds a percentage jitter to throttle. (Default: 0)
Number of threads to run enumeration with
SharpHound will create a local cache file to dramatically speed up data collection. It does this primarily by storing a map of principal names to SIDs and IPs to computer names. By default, SharpHound will auto-generate a name for the file, but you can use this flag to control what that name will be. For example, to name the cache file `Accounting.bin`:
C:\> SharpHound.exe --CacheName Accounting.bin
This will instruct SharpHound to NOT create the local cache file. Future enumeration will be slower than they would be with a cache file, but this will prevent SharpHound from putting the cache file on disk, which can help with AV and EDR evasion.
Invalidate the cache file and build a new cache
Interval in which to display status in milliseconds
Verbosity or 'v'
Enable verbose output