Event List Interactions

Security Requirements and Controls

Event List Interactions allows to actively interact with the data and explore it in deep detail. These interactions are added as options in the Event List, and work as quick workflows triggered directly from the search results.

For example, every time an event includes an IP address, you can:

  • Trigger a look up in an external system directly from the Event List — a kind of "WHOIS" search based on the IP address found in the event.

  • Control the context in which the interaction should be displayed, to only show it in events that actually have the field IP address — because this interaction makes sense only if such specific condition is met.

Event List Interactions are available within a certain scope — that is, they apply to some given Repositories & Views.

These scoped interactions are collected in an overview page from which to create more preset interactions, or where other users in the Organization access to reuse the interactions you have created, see Figure 78, “Interactions Overview”.

Not every user can see, configure or edit these interactions, this depends on the permissions set for them in the given repository.

Once created, these interactions are displayed in the Event List for every search within a repository.

For the steps on how to configure Event List Interactions, see Creating Event List Interactions.

Creating Event List Interactions

To create a new interaction:

  1. From your account profile icon on the top right, select Manage interactions from the menu and the Interactions overview page is displayed:

    Interactions Overview

    Figure 78. Interactions Overview


  2. Click + New interaction and a dialog appears which allows you to configure your new interaction:

    New Interaction

    Figure 79. New Interaction


  3. Enter the Name — the name assigned to the interaction, by default Interaction #1, which you can change e.g., Lookup IP.

  4. Enter the Title template — A template for the text that appears in the interaction menus. Values for fields are entered using a required language syntax, the Template Language. For example, to use the aid field from FDR data, the syntax would be {{ fields.aid }}.

    If you want to provide a more precise label for the interaction, you can add it here: for example, for an element or row where the field IPAddress is set to 172.17.0.30, the title of the interaction in the Event List when clicking on that element or row would be Lookup 172.17.0.30, see Figure 81, “Event List Interaction”.

    If left empty, Name will be used to label the interaction.

  5. Specify the Scope — the repository or view where you want your new interaction to be added.

  6. Specify the Behavior — the destination Type you want your widget to interact with, between:

    • Dashboard Link — lookup for an item in a related dashboard.

      You have the options to whether open the destination dashboard to a new tab, and use the time from the current dashboard or the time from the destination dashboard. See Setting Up a Dashboard Interaction for more information on how to configure this type of interaction.

    • Custom Link — lookup for an item in an external location by linking your widget to the destination URL. See Setting Up a Dashboard Interaction for more information on how to configure this type of interaction.

    • Search Link — allows navigation to the Search page by running a query detected from the dashboard. See Setting Up a Dashboard Interaction for more information on how to configure this type of interaction.

  7. Set the Parameter bindings — use fields from within events and bind them to the parameters in the destination target. The value can be static text and/or variables such as parameters and fields e.g. {{ fields.myField }} — see Template Variable Types.

    You can choose whether to bind the parameter to some defined values or keep it unbound (to retain the default behavior of the target destination when the interaction is triggered). To keep it unbound, leave the input field empty.

    Other parameter options are:

    • Empty list alias.

      In case of Multi-value Parameters, you can also specifically bind the parameter to an empty list of values by selecting the empty list alias in the input field — it is available as an option along with the other input values. This option acts as a parameter binding with no values selected for that parameter, and will serve as an argument to the parameter itself.

    • Unused parameters bindings.

      When creating or editing interactions you may need to change the target query, resulting in some parameter bindings no longer mapping to any parameters in the current query. The interaction panel shows such unused parameter bindings, and gives you the option to remove them via the UI:

      Unused Parameter Bindings

      Figure 80. Unused Parameter Bindings


    Use the Template Language to populate values based on the widget you are interacting with.

  8. Under Conditions, click +Add condition to set when you want the interaction to be shown, given some specified conditions. This allows to show the interaction only when a given field in the Event List is equal to a specified value, e.g. #event_simpleName field equal to NetworkConnectIP4 value.

  9. Click the three-dot menu next to each event in the Event List, you'll see your interaction in the contextual menu (under Inspect and Show in context menu options).

Note

Field names and values with spaces (e.g. field: Alert Name, value: Network Scans Count) must be put without quotes in the Conditions field.

With quotes around them (e.g. "Alert Name") the condition does not work, and the contextual three-dot menu disappears.

In the example below, the interaction looks for a specific IP found in the event:

Event List Interaction

Figure 81. Event List Interaction


Deleting & Duplicating Event List Interactions

You may need to delete or duplicate an existing interaction — from the Interactions overview page, use the context menu available for each interaction:

Interaction Context Menu

Figure 82. Interaction Context Menu