Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

There's no limit on the number of templates you can create and upload, or on the number of reports you can make available on your projects.

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

CLI tool

Generate reports programmatically from the command line

Library package

Import ReportGen into your own code and scripts to generate reports programmatically

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.

Important: for an up-to-date reference of reporting tags, we recommend using the $help function. See ReportGen issue #18.

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

Pentest Report

Red Team Report

Exec Summary PowerPoint-Style Slide Deck

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.

Last updated