Overview
Overview
ReportGen is AttackForge's custom reporting engine. It creates custom DOCX reports on demand from your templates. A template is a Word document with tags in it. ReportGen fills the tags with a project's data, such as its vulnerabilities, scope and test cases, and keeps the formatting you applied in Word.
Run it in AttackForge, build and debug templates in the browser tool, or generate reports in your own code with the CLI or Library.
You can make any kind of report. For example:
Pentest reports
Retesting reports
Executive reports
Testing summary reports
Application and Infrastructure reports
Mobile testing reports
Red Team and Purple Team reports
Configuration Audit reports
Compliance reports
Why it matters
Your brand, your format. Reports look exactly how you design them in Word.
One template, every project. Build a template once, and every project can use it.
A report for every audience. Executive, technical, retest and compliance reports can all come from the same project data.
Always up to date. Reports are built from live project data each time they're generated, so there's no copying and pasting.
Who uses it
Who
To
Report template authors
Build and test templates in ReportGen, then upload them
Administrators
Upload templates, and control who can see and use them
Testers and Project Coordinators
Generate reports for their projects
Clients and stakeholders
Download the reports made available to them
Developers and integration teams
Generate reports programmatically with the ReportGen CLI or Library
Generate a report
Any user can generate custom reports on demand, from the project dashboard or the reporting section of their projects. Each person only sees the reports that have been made available to them.



Manage report templates
Upload a template
Click Add Template to upload a new template.

Control who can use a template
Each template can have access controls, so only the right people can see and use it. You can give access to roles, groups and users. For example, keep an internal QA report for your testers, or a compliance report for auditors. See Concepts and Access.

Create a report for one or more projects
To create a report for one or more projects at once, click Create Report on the template you want.

Build templates with ReportGen
Guidance, help, examples and tips for building templates are on the ReportGen GitHub support site. There's also a tutorial video for first-time users.
ReportGen comes in three forms:
Tool
Use it to
Get it
Offline browser tool
Build and debug templates, then upload them to AttackForge and use them straight away
Download it from AttackForge, or use the online version
Library package
Import ReportGen into your own code and scripts to generate reports programmatically
@attackforge/reportgen-node on npm
Offline browser tool
Use the browser tool to build and debug your templates. When a template is ready, upload it to AttackForge and use it immediately. Its home page links to templates you can download and change, and to help on filters, functions, styles, tables, charts, options and examples.

CLI tool
The ReportGen CLI generates reports programmatically, from a template and a project's JSON export. For example:

Library package
The ReportGen Library lets you import ReportGen into your own code and scripts, to generate reports as part of your own automation.

What a template looks like
This template loops through every unique vulnerability, and prints each one's title on a new line:
ReportGen keeps the formatting you apply to tags in Word. To make each title bold, make the {title} tag bold. See the ReportGen GitHub support site for more.
For example, {$help[Label][scope]} prints all the data available at that point in your template to the ReportGen browser console. Put it inside a loop, such as {#vulnerabilities}, to see the data for each item.
Example report templates
To get started quickly, download one of these templates and change it to suit you. Each comes with an example report, so you can see the result, and test data, so you can try the template in ReportGen.
Template
Template file
Example report
Test data
More templates, help, examples and tips are on the ReportGen GitHub support site.
Tips
Start simple. Get used to how tags and loops work before adding logic, styles, charts and tables.
Start from an existing template. Download one from ReportGen and change it to suit you.
Use the help function to see the data available at any point in your template, in the browser console.
Make one template for each audience, such as executive, technical and retest reports.
Use template access controls so each person only sees the reports meant for them.
Automate with the CLI or Library when reports need to be generated as part of a pipeline.
Start from an example template, such as the Pentest Report, and try it with its test data before you change it.
FAQ
What format are reports in? DOCX.
How many templates can I have? As many as you like. There's no limit on templates, or on the reports you make available on your projects.
Who can generate reports? Any user, from the project dashboard or the reporting section of their projects. They only see the reports made available to them.
Can I stop some people seeing a template? Yes. Each template can have access controls for roles, groups and users.
Can I create a report for several projects at once? Yes. Click Create Report on the template you want.
Where can I learn to build templates? On the ReportGen GitHub support site, which has guidance, examples, tips and a tutorial video.
Can I generate reports outside AttackForge? Yes, with the ReportGen CLI or Library, using a template and a project's JSON export.
Related pages
Last updated