Alert Triggers

You can configure an Alert Trigger when you want InsightIDR to initiate a workflow in response to a security incident instead of requiring that you manually take action. The automated and immediate nature of Alert Triggers helps you mitigate and resolve issues in a very small window of time.

To get started with Alert Triggers:

Install and Activate an Orchestrator

If you haven’t already, make sure that you have installed and activated an orchestrator before starting the Alert Trigger configuration process. Alert Triggers are designed to initiate automation workflows, so an active orchestrator must be present at the time of configuration.

If you already have installed and activated an orchestrator in your environment, proceed to the next section.

Configure Alert Types

Alert Triggers rely on investigations that InsightIDR creates in response to user actions on your network. InsightIDR determines whether or not to create these investigations for each action according to the options specified in your alert settings. Before you configure an Alert Trigger, verify that all desired alert types for which you want to run a workflow are set to Alert to ensure that InsightIDR creates an investigation when they occur.

NOTE

Alert types that are set to Notable Behavior or Disabled will not generate an investigation if InsightIDR detects them.

To verify that your alert types are set to Alert:

  1. Sign in to InsightIDR.
  2. On the left menu, select Settings > Alert Settings > User behavior analytics.
  3. Browse through the user action categories listed in the “Alert Type” column. Make sure that all desired alert types are set to Alert in the “Type” column.
  4. If you made any changes, click Save when finished.

Configure Alert Triggers

Now that you’ve verified that your alert types are set to generate investigations, you’re ready to create your first Alert Trigger.

To create an Alert Trigger:

  1. Click the Automation tab on your left menu. The “Automation” screen displays.
  2. Click the Alert Triggers tab. Your “Automation” screen will switch to the Alert Trigger view.
  1. Click Create Alert Trigger in the upper right corner. The “Create Alert Trigger” panel appears.
  2. Select an action category from the dropdown list. This allows you to focus your list of selectable workflows according to the kind of action that you want to take. Click Continue.
    • If you want to select from all available workflows, select All Workflows.
  3. Select a workflow from the dropdown list. A color-coded tag on the right side of the workflow name indicates the object that the workflow accepts as input.
    • Workflows that accept multiple objects appear with gray-colored tags. Hover over this tag to see what objects this workflow accepts as input.
    • If you are configuring a new workflow, make sure you select the template version of the workflow you want to run. Templates are indicated by a small Rapid7 logo next to the workflow name.
  4. After selecting your workflow, InsightIDR will detail the steps that the workflow will move through as it executes. Click Continue when ready.
  5. Select one or more alert types from the dropdown list. Your workflow will trigger when InsightIDR creates an investigation based on any of these selected alert types.
  6. If you are configuring a new workflow from a template, configure any required connections as necessary.
    • If you selected an existing workflow from the dropdown list (one that does not have a Rapid7 logo next to its name), then InsightIDR will automatically use the orchestrators and connections that were specified in the previously existing workflow.
  7. Verify that your configuration options are correct. Click Add Alert Trigger to save your new Alert Trigger.

Your new Alert Trigger will be enabled by default and will now appear in the Alert Triggers table.

Manage Alert Triggers

After you configure one or more Alert Triggers, you can manage them on the Alert Triggers tab of the “Automation” page.

Alert Trigger Status

By default, all newly created Alert Triggers are enabled and active as soon as you save them. If you want to disable an Alert Trigger for any reason, toggle the workflow switch to the Off position in the “Status” column. To enable a disabled Alert Trigger, toggle the switch again to the On position.

Alert Triggers with the “N/A” Status

Short for “Not Applicable”, an Alert Trigger will assume this status if a change to one of its dependencies prevents the workflow from running. Alert Triggers with the “N/A” status will not run and cannot be enabled until the underlying issue is addressed. Reasons for an Alert Trigger assuming the “N/A” status include:

  • Deletion of the workflow that the Alert Trigger is configured to run
  • This is often the result of a custom workflow being deleted from InsightConnect. Alert Triggers with this condition cannot be enabled again, so you must create a new Alert Trigger after you recreate the workflow in InsightConnect.
  • Modification of the Alert Trigger’s alert type to a value other than Alert
  • Alert Triggers can only kick off their attached workflows based on investigations that InsightIDR creates in response to user actions. An Alert Trigger will assume the “N/A” status if the alert type value is changed from Alert to something else. To enable an “N/A” workflow of this type again, verify that your alert type is set properly.