TheHive-Project / TheHive-Project/Cortex-Analyzers
New Responder: Suspicious_Verdict
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 490
- Forks
- 405
- Avg merge
- 2d 43m
- Merged PRs (30d)
- 8
Description
Feature description
Suspicious_Verdict is a new Responder designed to integrate TheHive with the Suspicious platform developed by THA-CERT. It automates the classification of investigations by fetching a specific verdict tag from a Case or Alert in TheHive and pushing it to the Suspicious API.
Describe the solution you'd like
Once installed and configured with the Suspicious API URL and Token, the responder can be triggered manually with tags or automatically (via TheHive notifications).
It performs the following actions:
- Extracts the
Suspicious Case IDdirectly from the Case/Alert title. - Looks for a specific machine tag from the
suspicioustaxonomy (e.g.,suspicious:verdict="DANGEROUS"). - Pushes the classification (SAFE, SUSPICIOUS, or DANGEROUS) to the Suspicious platform via its API.
- Upon successful API update, the responder appends a new tag
suspicious:status="challenge_reviewed."back to the Case or Alert in TheHive to indicate the operation was completed.
Additional context
The responder handles error management cleanly (e.g., missing ID, multiple contradictory tags, or missing tags) and requires the requests library.
A corresponding taxonomy suspicious/machinetag.json is used to standardize the verdicts. I am currently preparing the PR for this responder.
This responder is designed to be used in conjunction with a TheHive Notification template (to be submitted in the Strangebee Integrations repository) that automatically triggers this responder when a taxonomy tag is added.
A machine-tag taxonomy (suspicious) will also be provided in this PR.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the responder configuration requirements and the proposed suspicious/machinetag.json taxonomy. Verify handling for missing IDs, contradictory or missing verdict tags, API errors, and successful updates; done means the responder sends SAFE, SUSPICIOUS, or DANGEROUS to the Suspicious API and appends the completed status tag in TheHive.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- api, security
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100