Definitions#
The Admin > Definitions page contains management views for the various user-defined elements and groupings used by the Scrutinizer system.
Autonomous Systems (AS)#
The Admin > Definitions > Autonomous Systems (AS) page lists all defined autonomous systems along with their autonomous system numbers (ASN) and any provided descriptions.
Clicking on an AS name opens an activity summary view with the following visualized information (split into source and destination tabs):
Activity over time
Top applications
Top source hosts
Top destination hosts
Hint
The period of time covered by the summary (default: last 15 minutes) can be adjusted by clicking the time range (calendar) button.
Clicking the graph button/shortcut in the top application or host charts will run the corresponding report type with the appropriate filters applied.
Host Names#
The Definitions > Host Names page can be used to assign static names to non-expiring host IP addresses or create subnet labels for use in reports.
The main view lists the following details for all current name definitions:
Host name
Domain
IP address
Description (if provided)
DNS resolution status (see below)
Clicking on a host name opens the settings tray, where the name, domain, description or DNS status can be edited.
Adding a host name assignment
To add a new host name definition, follow these steps:
Click the add (+) button to open the configuration tray.
Configure the following details:
IP address
Name to assign
Domain
Description (optional)
Select one of the following DNS resolution statuses from the dropdown:
Current: Resolution or resolution attempt completed, and the name will expire as specified by the retention setting under Admin > Settings > DNS
Queued: Ready for resolution; can be set to force DNS resolution again
Never: DNS resolution will never be attempted, and the name will not expire; used for assignments that are manually added and should be permanent
Click Save.
After the definition has been saved, it will be added to the list in the main view and can be further modified at any time.
Note
Host name definitions can also be imported using the scrut_util import command.
Deleting definitions
To delete a host name definition, select one or more items using the checkboxes in the main view, and then use the Delete option in the Bulk Actions menu.
IP Groups#
The Definitions > IP Groups page can be used to create and manage IP group definitions, which can be leveraged when running reports, applying filters, or defining inclusions/exclusions for various functions.
The main view lists the following details for all IP groups currently defined:
Group type/locality (internal or external)
Group name
Child groups
Inclusion rules
Clicking on a group name opens the settings tray, where the group’s name, type, and rules can be edited. If the group is or includes child groups, its hierarchy tree can also be viewed in this tray.
Adding a new IP group
To add/create a new IP group, follow these steps:
Click the add (+) button to open the Add IP Group tray.
Enter a name for the group.
Select whether the group is internal or external from the IP Group Type dropdown.
Click Save.
In the main view, click the newly created IP group to open the configuration tray.
Expand the Rules section of the tray, and then click the (+) button to add a new rule.
In the secondary tray, select the rule type (IP address, subnet, etc.) to add.
Enter the details required for the rule in the additional fields.
Click Add to save the rule.
Repeat steps 6 - 9 to define additional membership rules for the group. Settings for existing IP groups can be further modified at any time.
Note
IP group definitions can also be imported using the scrut_util import command.
If there are overlapping host sets between IP groups, a host will automatically be assigned to the group whose rules define the narrowest range of addresses.
The locality (internal or external) of an IP group has multiple uses, including determining traffic directionality (e.g., internal->internal, external->internal, etc.) for FA detections and defining inclusion and exclusion filters for report data sources. The designation also allows addresses to be quickly identified as being internal or external when viewing host details.
Bulk actions
When one or more IP groups are selected using the checkboxes, the following batch operations become available via the Bulk Actions button:
Adding new rules to all selected IP groups
Deleting all selected IP groups
SNMP Credentials#
The Admin > Definitions > SNMP Credentials page can be used to add/manage sets of SNMP credentials for use with devices/exporters in the Scrutinizer environment.
Once defined/saved, credentials can be assigned to one or more specified exporters from the exporters management view. SNMP v1, v2, and v3 are all supported.
Defining new SNMP credentials#
To add a new set of SNMP credentials, follow these steps:
On the SNMP Credentials page, click the Add button.
Fill in the form with the following information:
A name to identify the credential(s) by
A description of the credential(s)
The SNMP credential type/version (dropdown)
The community string to send
The port to use for communication
The timeout value or number of minutes to wait for a response
The number retries after a failed request
The backoff value or number of minutes to wait between retries
Important
If SNMPv3 is selected as the credential type, the additional fields for the username, context, and authentication details (hash function, password, and encryption) must also be filled in.
Verify that the information entered is accurate, and then click Save.
Saved credentials can also be edited at any time by clicking on their name in the main view table. To delete one or more credential sets, tick their checkboxes and click the Delete button.
Well-Known Ports#
The Definitions > Well-Known Ports page can be used to create and manage well-known port definitions for Scrutinizer.
The main view lists the following details for all current definitions:
Name assigned to the well-known port
Port
IP protocol
Description (if provided)
Clicking on a well-known port name opens the settings tray, where the name or optional description can be edited.
Adding a well-known port
To define a new well-known port, follow these steps:
Click the add (+) button to open the configuration tray.
Configure the following details for the well-known port:
Name
Port
IP protocol
Description (optional)
Click Save to save the definition.
After the well-known port definition has been saved, it will be added to the list in the main view and can be further modified at any time.
Deleting well-known ports
To delete a well-known port definition, select one or more items using the checkboxes in the main view, and then use the Delete option in the Bulk Actions menu.