tenable/audit-utils repository overview

⁠Docker Image

Package all of the utilities, nasl, and plugins into a docker image that can be used to execute the utilities with only Docker as the depenency.

⁠Use

• Use a mounted file system to mount local directory into the docker image. It is suggested to mount the local audits directory to /audits.
• Use docker run to use the image with the preferred utility.

⁠Utilities

⁠check_audit

A utility that uses the compliance plugins to evaluate an audit file and provide that the plugin can evaluate the audit for proper syntax.

• Put custom audit file into local directory named "audits"
• Execute docker image with "audits" directory mounted.

docker run -it --rm -v $(pwd)/audits:/audits audit-utils:latest check_audit /audits/my_custom_audit.audit

⁠check_service

A web service that provides the same audit checking capability as the check_audit utility. This is the default entrypoint for the container if no other commands are provided.

• Start service and use a web browser to interact with the service.

docker run -it --rm -p 8081:8080 audit-utils:latest check_service

⁠sign_audit

A utility that will sign an audit file with a signing key to provide integrity that the audit has not changed. Required configuration on the Nessus scanners to enforce validation.

• Put custom audit file into local directory named "audits"
• Put private key file into local directory named "audits"
• Execute docker image with "audits" directory mounted.

docker run -it --rm -v $(pwd)/audits:/audits audit-utils:latest sign_audit -k /audits/private.pem /audits/my_custom_audit.audit

⁠audit_to_json

Converts an audit to a JSON structure.

• Put custom audit file into local directory named "audits"
• Execute docker image with "audits" directory mounted to convert audit file to JSON format.

docker run -it --rm -v $(pwd)/audits:/audits audit-utils:latest audit_to_json /audits/my_custom_audit.audit

⁠audit_header_to_json

Converts an audits header information to a JSON structure.

• Put custom audit file into local directory named "audits"
• Execute docker image with "audits" directory mounted to extract audit header as JSON.

docker run -it --rm -v $(pwd)/audits:/audits audit-utils:latest audit_header_to_json /audits/my_custom_audit.audit

⁠json_to_audit

Converts a JSON structure to an audit format.

• Put JSON file into local directory named "audits"
• Execute docker image with "audits" directory mounted to convert JSON back to audit format.

docker run -it --rm -v $(pwd)/audits:/audits audit-utils:latest json_to_audit /audits/my_audit.json

⁠audit_tidy

Cleans up the format of an audit file.

• Put custom audit file into local directory named "audits"
• Execute docker image with "audits" directory mounted to format and tidy audit file.

docker run -it --rm -v $(pwd)/audits:/audits audit-utils:latest audit_tidy /audits/my_custom_audit.audit

⁠Release Notes

⁠v2.0.0 2025/12/05

• Add utilities for working with audit files.

⁠v1.0.0 2021/12/31

• Initial release of docker image.