Creating Box Response Action Rules

Role Availability Read-Only Investigator Analyst Manager

You can create orchestration rules in USM Anywhere that automatically trigger a Box response action when alarms Alarms provide notification of an event or sequence of events that require attention or investigation. match the criteria that you specify. For example, you can create a rule where USM Anywhere automatically disables the user when authentication to Box from a known malicious host occurs.

Warning: Be careful when automating the disabling of users because an error in the logic could result in all of your users, including administrators, being locked out. The only way to recover would be to contact Box support.

After you create a rule, new alarms that match the rule conditions will trigger the Box response action. The rule does not trigger for existing alarms.

You can create a new rule in one of two ways:

  • From an Applied Response Action: You can create a rule using the response action that you apply to an existing alarm. This makes it easy to set the matching conditions for the rule based on the existing item and use the same settings that you applied to that item.

    In the confirmation dialog box, click Create rule for similar alarms.

  • From the Rules page: The Rules page provides access to all of your orchestration rules. The Orchestration Rules list includes suppression rules, alarm rules, event rules, filtering rules, notification rules, and response action rules. You can create new rules using the specific matching conditions that you define, as well as edit, delete, and enable or disable rules. See Orchestration Rules for more information about managing orchestration rules.

    In the left navigation menu, go to Settings > Rules > Orchestration Rules. Then click Create Orchestration Rule > Response Action Rule to define the new rule.

    Create a new response action rule

To define a new Box response action rule

  1. Enter a name for the rule.
  2. In the Action Type list, select Box.
  3. In the App Action list, select the action you want to use.

    Additional fields will be populated based on the action you've selected. Fill out the necessary fields for the app action.

  4. Fill out the required fields.

  5. At the bottom of the dialog box, set the rule condition parameters to specify the criteria for a matching alarm or event to trigger the rule.

    Set the matching conditions for triggering the rule

    • This section provides suggested property/value pairs from the selected alarm or event that you can use as conditions for the rule. Click the icon to delete the items that you do not want to include in the matching conditions. You can also add other conditions that are not suggested.
    • If you create the rule from the Rules page, you must use the Add Condition and Add Group functions to define the property/value pairs that you want to use as conditions for the rule.
    • At the bottom of the dialog box, click More to display the optional multiple occurrence and window-length parameters.
  6. Click Save Rule.
  7. In the confirmation dialog box, click OK.