Using Iterators in Reports A “How To” Guide for SecurityCenter

What Is an Iterator? Use an iterator in a SecurityCenter report to define a group of items and step through the items in the group, presenting details on each Like a for-next or while loop in a program Step through a group of IP addresses, vulnera- bilities, ports, event users, or event types Present further details about each in the form of tables and charts

Iterator Example An example “Vulnerabilities Per Host” Report Use an iterator to step through all detected hosts Show host information per host Show a pie chart of the count of active vulnerabilities at each severity level per host Show a table of the top most severe active vulnerabilities per host for (all hosts) { display info display pie chart display table }

Iterator Example Edit Iterator dialog Use plugin 19506 to enumerate hosts, and iterate over the first 10 IP addresses… …displaying, for each IP address, host information…

Iterator Example Edit Pie Chart dialog …and, for each IP address, a pie chart of active vulnerabilities at each severity level…

Iterator Example Edit Table dialog …and, for each IP address, a table of the top 10 most severe active vulnerabilities

Iterator Example Example page of the resulting Vulnerabilities Per Host Report Shows the host information, pie chart, and top vulnerabilities table for an IP address

Iterator Notes Iterators are only available in reports The filter for the iterator defines the set of objects to iterate over; this entire set will be iterated over in the report The report elements within the iterator will be repeated for each object in the iterated set The filters for the report elements within the iterator can further refine what information is displayed for each object in the iterated set

Iterator Notes Iterators can be placed within section and group report elements A section element cannot be placed within an iterator Do not place a group element within an iterator; any elements inside a group that is within an iterator will not display in the report

Iterator Uses Use iterator to show Users per Host Iterate over IPs Display users Example from Daily Host Alerts Report: Users Accessing Hosts

Iterator Uses Use iterator to show Software per Host Iterate over IPs Display OS info Display software info Example from Windows Software Summary

Iterator Uses Use iterator to show Plugin output per Host Iterate over IPs Use iterator to show Plugin output per Host Display vuln info Example from Insider Threat Report

Display vuln info with list of IPs Iterator Uses Iterate over vulns Use iterator to show Hosts per Vulnerability Display vuln info with list of IPs Example from Remediation Instructions Report by Vulnerability

Iterator Uses Use iterator to show Hosts per Vulnerability Iterate over vulns Use iterator to show Hosts per Vulnerability Display IPs Example from PVS Detections Report

Iterator Uses Use iterator to show Hosts per Port Iterate over ports Display IPs Example from TCP Port Report

Iterator Uses Use iterator to show Hosts per User Iterate over users Display IPs Example from Daily Host Alerts Report: Hosts Accessed by Users

Iterators Use an iterator in a SecurityCenter report to define a group of items and step through the items in the group, presenting details on each for (all items) { display details... }

Tenable Customer Support Portal For Questions Contact Tenable Customer Support Portal