Purpose
This article outlines how to create a collection schedule on a collector client which will ensure continuous data collection. BHE administrators should use it during the deployment of a new client or when adding an additional schedule to an existing client.
Generally, Azure and Active Directory Structure do not change significantly enough to warrant more than daily collection. Local Groups and Sessions can be scheduled to collect every 7 hours to ensure a good sampling of round-the-clock activity.
Prerequisites
- Having deployed a BloodHound Enterprise Tenant, see BloodHound Enterprise Tenant
- Creation of one SharpHound client, see Create a SharpHound Enterprise collector client
- Logged in as a user role which is authorized to modify clients, see Administering users and roles
Process
- In the top right, click settings ⚙️ → Administration
- In the top left side, click Manage Clients
- On a client, click the burger menu and select Edit Client
- In the Edit SharpHound Client window, under the heading Collection Schedule, click the + icon to add a new schedule.
- In the Schedule window, configure the settings of the schedule.
- Start Date: The time on which the first collection should run
- Frequency: The frequency of the schedule
- Data: The type of data the schedule collects, see SharpHound Enterprise Data Collection and Permissions
- Advanced Options: See the Collection Scheduling section in the article SharpHound Enterprise Tenant Configuration
- Save the schedule by clicking SAVE
- Save the collector client by clicking SAVE
- (Optional) Verify collection is successful after the next schedule in the Finished Jobs Log. Where Status should report Complete and a success is found in Status Message.
Outcome
The client is now configured for continuous data collection with one schedule. You can add multiple schedules to a single client for more granular control.
After the next schedule, see the job's status in the Finished Jobs Log by clicking ⚙️ → Administration, and in the top left side, click Finished Jobs Log.
A brief of a client's schedule is shown in the client table's column Collection Schedule.