Huntress
Overview
The Huntress integration lets Bumblebee workflows access incident reports, organization data, and agent information from your Huntress account. It is useful for automating security monitoring, incident triage, and endpoint visibility across managed environments.
Prerequisites & Setup
Before setting up the Huntress integration, you need:
- A Huntress account with Admin access
- API credentials (API Key and API Secret Key)
API Key Types
Huntress offers two types of API keys:
| Account-level API Key | User API Key | |
|---|---|---|
| Access | Read-only | Mirrors user permissions (read & write) |
| Limit | One per account | Multiple per user |
| Best for | Integrations that only read data | Integrations that need write access |
For Bumblebee, an Account-level API Key is sufficient since the integration only requires read access. If your workflows need write access, create a User API Key instead.
Generate an Account-level API Key
- Log in to your Huntress dashboard
- Click the hamburger menu in the upper-right corner
- Under Account, click API Credentials
- Click the Setup API Credentials button
- Copy both the API Key and API Secret Key immediately
Important: The API Secret Key is only visible on the generation page. Once you navigate away, it cannot be retrieved. If lost, you must regenerate your credentials.
Generate a User API Key
- Log in to the Huntress dashboard as a user with Admin privileges
- Click the hamburger menu in the upper-right corner
- Under Profile, click Preferences
- In the User API Credentials section, click Add
- Copy the generated API Key and API Secret Key
Configure in Bumblebee
- Go to the Integrations page in Bumblebee
- Select Huntress
- Enter:
- API Key
- API Secret Key
- Click Save to store the credentials
- Use the Validation section to test the connection