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, vulnera- bilities, ports, event users, or event types
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. Iterator Example Edit Iterator dialog
Use plugin to enumerate hosts, and iterate over the first 10 IP addresses…
…displaying, for each IP address, host information…

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

6. Iterator Example 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 Use iterator to show Users per Host Iterate over IPs
Display users
Example from Daily Host Alerts Report: Users Accessing Hosts

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

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

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

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

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

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

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

18. Tenable Customer Support Portal
For Questions Contact
Tenable Customer Support Portal