Using Iterators in Reports

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

2. 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, vulnerabilities, or ports • Present further details about each in the form of tables and charts

3. 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 }

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

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

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

7. 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

8. 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

9. 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

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

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

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

13. 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

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

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

16. 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... }

17. For Questions Contact Tenable Customer Support Portal