Back in July, we announced TheHive 4.0, the foundation for future releases of your favorite Open Source SIRP.
Today, we are pleased to deliver one of the biggest patch releases we’ve done so far, in terms of number of fixed issues: TheHive 4.0.1! Not only did we squash lots of bugs, we also included some cool improvements we didn’t want to hold until the next version.
As for TheHive 3 and Cortex unveiled few days ago, we fixed the vulnerabilities reported by Play framework in October as well.
A huge work has been accomplished to fix a backlog of bugs (thanks to the community) in several parts of the product:
- Multi Factor authentication;
- Active Directory authentication;
- Export to MISP.
You can find details of the 80+ issues included in this milestone: Changelog file.
Wait, there is also new stuff:
- Cases and Alerts similarity fine tuning;
- Similar cases in Alert preview panel refined;
- Filtering capabilities improvements;
- New UI settings & options;
- Custom fields in Case and Alert lists;
- Statistics panel improvements;
- API key in user settings page;
- More migration tool options.
Cases and Alerts similarity fine tuning
In TheHive, correlation between Alerts and Cases, and between Cases themselves, is computed throughout their respective Observables:
- A Case is considered similar to an Alert, if they have at least one common observable;
- A Case is considered related to another Case, if they have at least one common observable.
In some situations, those relationships are undesirable when based on useless/meaningless observables.
Starting with TheHive 4.0.1, Observables are enriched with a new attribute called
ignoreSimilarity, set to
false by default. Now, when this attribute is set to
true, an observable is simply not taken into account in the relationship between two cases, and is not involved in the similarity calculation, for Cases and Alerts.
This attribute is displayed alongside with the IOC and Sighted flags, in the Observables list – which has been tweaked for the occasion – as well as in the detailed view.
And you can also edit this for a set of selected observables.
Long story short, if you want to break a correlation, you just need to set the linking Observable‘s
ignoreSimilarity flag to
Alerts and similar Cases
The attribute mentioned earlier is taken into account when correlating Alerts with existing Cases : the Similar Cases view in the Alert preview dialog.
Observables with ignoreSimilarity set to true will be ignored when fetching cases similar to the current Alert, whether it is in the Alert or the Case side.
A forthcoming update of thehive4py library will allow to set this attribute in Alerts, along with many other new things.
The Similar Cases view has been thoroughly enhanced to provide more highlights facilitating alert triage and the merging of alerts into existing cases. First, a column named “Matched” has been added. It contains the list of observable dataTypes and the number of occurrences matching the Alert : this should be very useful to identify quickly what type of data has matched the alert content. A filter on this column has also been added.
And there are more refining capabilities in this view:
- Sorting and Filtering on Title of Similar Cases;
- Specifying a minimum observables rate that matches the Alert;
- Specifying a minimum IOCs rate that matches the Alert.
… And, above all, columns can now be sorted. With all these new capabilities, triage and merge Alerts in Cases should be easier.
Filtering capabilities improvement
In TheHive 4, filter forms have the same structure all over the product. Any improvement in the area, benefits to all the listing pages.
For example, in the alert similar cases tab, a new filter form has been included. You can quickly select the type of Cases you want to display, but also use the advanced rules and search criterias.
In this release, the filter component has new capabilities:
- Date filter: now allows setting dynamic ranges instead of setting
tofixed date values. Possible values are:
- Last 7 days;
- Last 30 days;
- Last 3 months;
- Last 6 months;
- Last year;
- Custom: allowing the old-fashioned way of setting date ranges.
- Tag filter: Autocomplete is now enabled.
In TheHive 4.0.1, there is one more place that welcomed a filter form: the list of Alert observables in the preview dialog.
New Org level UI settings
UI configuration page is the place where TheHive adds new options to customise the behavior of the UI, for a given organisation. This is an area that will be expanded over time.
For this milestone, two new options have been introduced:
- Allow merging Alerts in resolved cases;
- Default filter of Alert similar cases.
The first one is self-explanatory and will hide the `Merge into case` button in the Alert similar cases section
The second one allows an administrator define, for an organisation, the default filter to apply to Alert similar cases view. For example: “show only potential similar cases created in the last 7 days and are still open”.
If during the triage, the filter has been updated by an analyst, the default filter cas be retrieved through Default filter option of the Quick Filters.
Custom fields in Case and Alert lists
“Damn, why I’m not able to see my custom fields in my cases list”, “It’s a shame I cannot filter my alerts with my custom defined properties”… We are pretty sure you said it, at least once.
Well, you dreamt of it, and here we go, we did it for Cases and Alerts
- You will be able to see all the custom fields you defined in your Case Templates and propagated to your Cases;
- Custom fields with undefined values are not displayed;
- Custom fields are shown with respect of the order you define;
- Clicking on a custom field, filters your lists using the selected value;
- You can enable displaying the custom fields using the toggle button on the toolbar located on top of the filter form;
- All those capabilities are available in Cases and Alerts views.
New statistics view in Cases and Observables lists
The Stats view has been revamped to represent the statistics using both tables and shiny colourful donuts (not only for managers).
This improvement has been made in Cases, Observables and Alerts views.
This feature has been initially introduced in Cortex and was missing in TheHive. All users can now access their API key, copy or update it, as long as an administrator created it first. No more API keys sent over emails or chat applications.
The migration assistant program has been updated with a few bug fixes and new filtering options. When migrating, you can now specify:
- If you want to include or exclude Alerts generated from specific Sources or by their Type;
- If you want to include Audit trails regarding specific objectType (case, case_task, case_observable …);
- If you want to filter out Audit trails with specific actions (Update, Creation, Delete).
/opt/thehive/bin/migrate --help [..] --include-alert-types ,... migrate only alerts with this types --exclude-alert-types ,... don't migrate alerts with this types --include-alert-sources ,... migrate only alerts with this sources --exclude-alert-sources ,... don't migrate alerts with this sources [..] --include-audit-actions migration only audits with this action (Update, Creation, Delete) --exclude-audit-actions don't migration audits with this action (Update, Creation, Delete) --include-audit-objectTypes migration only audits with this objectType (case, case_artifact, case_task, ...) --exclude-audit-objectTypes don't migration audits with this objectType (case, case_artifact, case_task, ...)
So, you can migrate your data directly to TheHive 4.0.1.
However, please note that the migration tool does not support data from TheHive 3.5.0 yet. In short, you can only consider migrating you data from TheHive 3.4.0, 3.4.1, 3.4.2 or 3.4.4 to TheHive 4.0 or TheHive 4.0.1 for the time being.
How to install/update ?
Our installation guides are up-to-date.
If you are updating an existing instance of TheHive 4.0.0, ensure to read the installation guide. Since our recent release of TheHive 3.5.0, we updated our repositories. The codename of repositories containing all new released packages is now named
release, instead of
stable. So update your apt or yum repository file.
Have you got a minute to let us know how you use TheHive ?
We would love to hear from you (10 questions < 1minute) : https://t.co/l5osjvQ1k7
Many thanks for taking the time 🙏
How to report issues
Please open an issue on GitHub with the dedicated template for TheHive 4. We will monitor them closely and respond accordingly.