Skip to content

Alerts

This section is under construction.

Introduced in IRIS v2.1.0

Alerts can be feeded directly into IRIS using the Alerts API.
Any source can inject alerts into IRIS, as long as it can send HTTP requests and respects the alert format.

A service account with the alert_read and alert_write permission can be used to send alerts to IRIS.

Warning

This section is only available for users with the alert_read and alert_write permissions.

Viewing alerts

Alerts can then be viewed in the Alerts section of IRIS. Analysts can then triage the alerts and create cases from them.

Alerts

Each alert can be expanded to show more details.

Alerts assignment

Alerts can be assigned to analysts. This can be done directly from the alert view.

To self assign an unassigned alert, click on the hand icon on the left.

Alerts

Clicking again on the hand icon will prompt with a list of analysts to assign the alert to.

The right button Assign when hovering an alert can also be used to assign the alert to an analyst.

Merge / escalation operations

Creating cases from alerts

Alerts can be escalated/merged into a new case. When hovering an alert, a Merge button will appear.

Alerts

Once clicked, a new window appears, requesting additional information. In this window, the analyst can:

  • Set the name of the case
  • Select the case template
  • Select the IOCs to import
  • Select the assets to import
  • Add an escalation note
  • Set the case tags
  • Choose if the alert should be import in the timeline as event

Merge alerts into an existing case

Alerts can also be escalated/merged into an existing case. When hovering an alert, a Merge button will appear.

Once clicked a new window appears, requesting additional information. The button Merge into existing case needs to be clicked.
A new dropdown appears and allows to select the case to merge the alert into.

Similar to the case creation, the analyst can:

  • Select the IOCs to import
  • Select the assets to import
  • Add an escalation note
  • Choose if the alert should be import in the timeline as event

The selections IOCs and assets are then added to the selected case.

Umerge alerts from a case

Alerts can be unmerged from a case.

Info

When unmerging an alert, the alert is not deleted. It is only removed from the case. The alert state is not changed.
The IOC and assets are not removed from the case.

When a case is merged, a new link appears on the alert and mentions the case it was merged into.
Clicking on this link allows to browse the case or to unmerge the alert.

Alerts

Alerts relationships

Each alert have a Relastionships section. This section shows the relationships between the alert and other objects in IRIS. This feature is in preview and might report false relationships.

The relationships are computed using the following logic:

  • Same IOC, based on the IOC type and value
  • Same Asset, based on the asset type and name

By default the view limits the relationships to 100 nodes and looks back 7 days. This can be updated directly in the alert view.

Alerts


Last update: 2023-05-16