FAQ - fbprogmbh/Audit-Test-Automation GitHub Wiki
Frequently Asked Questions
This section is dedicated to an ever-growing list of frequently asked questions
Table of contents
- When printing html to PDF, color-scheme-formatting is lost
- Can we add specific exclusions to be more compliant?
- When downloading my anti virus scanner detects malicious behavior. What does that mean?
- Why is PowerShell console stating commandlet "Save-ATAPHtmlReport" was not found in the module "ATAPAuditor"?
- How long does it take to create a report from AuditTAP?
- ATAP exits due to PowerShell being configured to "ConstrainedLanguage"
- How to change the default folder for ATAPReports
- How to convert reports to xml instead of HTML
Back to TOC(https://github.com/fbprogmbh/Audit-Test-Automation/blob/master/FAQ/readme.md#table-of-contents)
When printing html to PDF, color-scheme-formatting is lostIt's not a bug, it's a feature of modern browsers to save ink. As per default, the option to print backgrounds is disabled. To enable this, expand the section "more settings" and enable "Print backgrounds" (Firefox) / "Background graphics" (Google Chrome).
The following screenshot shows this for Firefox browser.
Back to TOC(https://github.com/fbprogmbh/Audit-Test-Automation/blob/master/FAQ/readme.md#table-of-contents)
Can we add specific exclusions to be more compliant?The scenario often described is as follows: Customer uses another antimalware tool than Microsoft Defender. So all Defender related rules will be non compliant as Microsoft Defender is not in "active mode". This leads to higher "non compliance value". At this point of time it is not possible to add ecxlusions or rationals. AuditTAP was designed to be easy to handle and create fast, transparent reports. We are thinking about enhancing the product in this direction - but this is not a short term feature change.
When downloading my anti virus scanner detects malicious behavior. What does that mean?
For AuditTAP we are using an open source installer called 'Inno Setup' provided by Jordan Russell. This installer can be detected as a malicious file, which is not the case. This is a common problem which happened to other software providers as well. Here is a link to a stackoverflow question about this topic:
https://stackoverflow.com/questions/68834409/program-installed-with-inno-setup-seen-as-trojan-wacatac-bml
If you don't trust this installer at all, you can of course install our tool via PowerShell Gallery or by importing both modules via PowerShell.
Back to TOC(https://github.com/fbprogmbh/Audit-Test-Automation/blob/master/FAQ/readme.md#table-of-contents)
Why is PowerShell console stating commandlet "Save-ATAPHtmlReport" was not found in the module "ATAPAuditor"?This happens in case PowerShell "Constrained Language Mode" is activated and execution policy is set to "AllSigned". A simple change of execution policy will help here. We recommend to change it only for the single PowerShell session and not permanent for system or user. The following PowerShell will do the trick:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
The following Screenshot shows error and solution:
How long does it take to create a report from AuditTAP?
Depending on the size of the report you want to create, the time it takes to create varies. Here are some measurements:
- ~ 50 seconds (Google Chrome)
- ~ 2 minutes 30 seconds (Microsoft Windows 10) Each Audit-Test takes some time and depending on the amount of tests, the final report needs some time to finalise.
ATAP exits due to PowerShell being configured to "ConstrainedLanguage"
When PowerShell is configured to "ConstrainedLanguage" mode, contact your system administrator for help.
How to change the default folder for ATAPReports?
You can change the default folder for Save-ATAPHtmlReport
, which is Documents\ATAPReports
, by creating and later editing the environment variable ATAPReportPath
.
Environment variables can be set for different scopes - please choose the one that fits your needs. The following samples will set the default path to 'C:\ATAPReports'.
Temporary scope: CurrentSession
$env:ATAPReportPath = 'C:\ATAPReports'
Permanent scope: CurrentUser
[System.Environment]::SetEnvironmentVariable('ATAPReportPath','C:\ATAPReports',[System.EnvironmentVariableTarget]::User)
Permanent scope: Machine
[System.Environment]::SetEnvironmentVariable('ATAPReportPath','C:\ATAPReports',[System.EnvironmentVariableTarget]::Machine)
How to convert reports to xml instead of HTML
For this functionality, it is handy to know the Invoke-ATAPReport command can be used: Just use the following code snippet, and exchange the variables "Reportname" and "FilePath".
$Reportname = "Microsoft Windows 11"
$FilePath = "C://YourPath/YourFileName.xml"
ConvertTo-Xml -InputObject (Invoke-ATAPReport -ReportName $ReportName) -As "String" -Depth 10 | Out-File -FilePath $FilePath