Use the ToolAlias field in SEM rules and filters to capture traffic from a specific device
ToolAlias field is a useful field to know if you have to create filters, rules, and searches that target traffic from a specific device. Every device that sends events to SEM has an
Alias property that you can customize with a device-specific name. Use the
ToolAlias field to examine the
Alias property and find events that match your filter criteria.
You can also use the
DetectionIP event to monitor events from a device that has a specific IP address, for example
Create a filter to capture events from a specific device
- On the SEM Console, click the Live Events tab.
- To create a filter at the group level in the Filter Values pane, move the mouse pointer over a group heading to expose the vertical ellipsis, and then select Add New Filter.
To create a filter at the root level, click the add icon, and then select Add New Filter.
- Enter a descriptive name for your new filter.
In the first column on the left, expand Event Groups and select one of the following:
- To view all traffic from your device, select Any Alert.
- To view all network events from your device, select Network Audit Alerts.
- To view web traffic from your device, select WebTrafficAudit from the Event groups.
- From the second column list, drag ToolAlias into the filter builder.
When you drag a value into the filter builder, the correct drop location is illuminated with a blue line.
- Click the or add it hyperlink.
Enter a filter value to match the alias property of the device that you want to track. Use asterisks (*) as wildcard characters if required.
For example, consider the default Firewall filter. Its condition is
Any Alert.ToolAlias = *firewall*. This assumes that the firewall connector was configured with a Tool Alias that includes "firewall" in the name.
Verify that the correct Alias value is associated with the connector
The following procedure applies to devices configured to send logs to SEM. To verify agent connectors, use this same procedure, but apply it to the agent associated with the connector instead.
- On the SEM Console, navigate to Configure > Manager Connectors.
- Under Configured connectors, select the connector instance you want to verify.
- On the connector toolbar, click Edit.
- Verify the connector name (alias) is correct (change the name, if not), and click Save.
- On the connector toolbar, click Start.