Deployment Process Overview
To collect Active Directory data with SharpHound and ingest it into BloodHound for analysis:- Provision a Server that meets or exceeds the recommended Hardware, Software, and Network requirements below.
- Create a Service Account or gMSA that SharpHound will run as with the Service Account Requirements below.
- Install and Upgrade SharpHound Enterprise
- Create a BloodHound Enterprise collector client
- Run an On Demand Scan or Create a data collection schedule
Server Requirements
Hardware
These recommendations should be considered a baseline and may need to be increased depending on the size and complexity of your environments.
Software
- Windows Server 2019+
- .NET 4.7.2+
Network
- TLS on 443/TCP to your BloodHound Enterprise SaaS tenant URL (proxy is supported)
- LDAP to at least one domain controller in each domain requiring collection.
- By default, SharpHound will attempt LDAP over SSL first, then fall back to LDAP if SSL is unavailable.
- LDAP over SSL on 636/TCP (configurable port)
- LDAP on 389/TCP (configurable port)
- LDAP over SSL is enforceable.
- LDAP channel signing is used for all queries.
- By default, SharpHound will attempt LDAP over SSL first, then fall back to LDAP if SSL is unavailable.
- [Optional] If performing privileged collection (see Why perform privileged collection in SharpHound)
- SMB/RPC on 445/TCP to all in-scope domain-joined Windows systems
- SMB/RPC on 135/TCP to all in-scope domain-joined Windows systems for NTLM relay-based collection
- Approximately 60-100kB network bandwidth per collection to each in-scope domain-joined Windows system
- [Optional] If performing DC Registry and CA Registry collection (see DC Registry and CA Registry details)
- SMB/RPC on 445/TCP to all DCs and domain-joined CAs
Service Account Requirements
Run the SharpHound Enterprise service under a domain-joined account that has the Log on as a service User Rights Assignment on the SharpHound Enterprise server. This account can be a traditional user account or a Group Managed Service Account (gMSA). The service account needs permissions to collect data from your target domains and domain-joined systems as detailed in SharpHound Data Collection and Permissions. We recommend following SharpHound Enterprise Service Hardening.If Active Directory tombstoning is enabled, the service account must also have read permissions on the deleted objects container.
Integrated Windows Authentication (IWA)
If you want to use IWA for SharpHound, the following additional requirements apply:- Active Directory Federation Services (ADFS) server must be accessible in your network environment
Both the system running SharpHound and the BloodHound Enterprise tenant require network connectivity to the ADFS server
- Service account must be configured in ADFS to support Windows authentication for SharpHound
- Client ID property must be registered in ADFS (provided during collector client creation)
- Local SharpHound configuration must include IWA-specific properties in the
settings.jsonfile