Tagging Criteria

Tagging Criteria are used to automatically apply Tags to Assets that match the specified criteria. As new Asset or scan information is received, that data is constantly evaluated against the Tagging Criteria to determine which Tags to assign to each Asset.

  1. While creating or editing a Tag, make sure that This tag will be applied to assets Automatically using these criteria is selected.
  2. Enter values for the first selection criterion.

    3. Things to note about relationship selectors:

    • Equals: The value for the criterion must exactly match the specified value.
    • Contains: The value for the criterion must contain the entire specified value.
    • Matches: The value for the criterion must match the specified regular expression.

  3. To add another criterion, use the + character to the right of the first criterion. The relationship between criteria and groups is controlled using the selection dropdown in the upper-right corner.

    4. To add another group of criteria, click ADD GROUP. Groups are evaluated from the inside out, so make sure you add the group in the correct place. The relationship between criteria in a group is controlled using the selection dropdown in the group's upper-right corner.

  4. When you are finished, click Save.

This example shows how to create a PDX_Windows_Server Tag that is applied to Assets with a specific IP range and one of two Windows Server operating systems.

  1. Navigate to Environment > Tags and select NEW > New Tag.
  2. Enter a Name of PDX_Windows_Server and an optional Description for the new Tag.
  3. Under Tagging Criteria, first specify the IP range for the target Assets.

  4. Next select ADD GROUP to add the OS selection criteria.
  5. In the new group, fill out the first OS selection criterion, then select + to add another criterion and populate it too.

  6. Finally, because you want to apply the Tag to Assets with either OS, change the relationship between the criteria to OR using the group's dropdown selector.

The completed Tag should look like this:

You can also use Tagging Criteria to apply Tags when other combinations of Tags and criteria are applied to an Asset. For example, you could apply a new PDX_High_Priority Tag to Assets with the Portland Tag whenever they have a vulnerability with a high CVSS score.

  1. In the Tagging Criteria section, select Tag Name from the Combined Tag section (at the very bottom of the list).

  2. Select a relationship in the second criterion field, and then select a Tag (in this case, Location:Portland) from the third field.
  3. Click + to the right and enter another criterion (in this case, a CVSSv3 score higher than 5).

  4. Click Save.