> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/manual/english/platform-usage/penetration-testing/audits.md).

# Audits

The audit overview provides an overview of all penetration tests performed to date and their results.

{% hint style="success" icon="lightbulb" %}
For more information on how penetration testing with Enginsight works, see our Knowledge Base: [How does a penetration test with Enginsight work?](https://docs.enginsight.com/docs/knowledge-base/english/penetration-tests/how-does-a-penetration-test-with-enginsight-work)
{% endhint %}

***

<i class="fa-compass">:compass:</i> Navigate to **Penetration Testing** → **Audits** to show a list of all audit reports for completed penetration tests. If you have not performed any audits yet, this view is empty.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2F8gZVPBhf2oFcu1XILgBb%2Fenginsight-screenshot-audits.jpg?alt=media&amp;token=c146470a-ab21-4808-a7ff-2624ddc9e086" alt=""><figcaption></figcaption></figure>

The [audit overview](#audits-overview) provides information such as:

* when an audit was performed and how long it took.
* which severity levels were identified.
* which target systems were assessed by the penetration test, based on which audit definition, and using which Hacktor.

You can also [start a penetration testing audit](#start-pentesting-audit).

***

## Navigation

<i class="fa-magnifying-glass">:magnifying-glass:</i> Click the **Text Search** field above the list and enter a search term of your choice to find specific list items more quickly.

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Refresh** icon <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i> above the list to update all list items.

<i class="fa-computer-mouse-scrollwheel">:computer-mouse-scrollwheel:</i> Scroll down the list or adjust the number of results shown per page ![](https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FfjKACCt2SKXcFd3S7Xb5%2FEnginsight-EN-Results%20per%20Page.jpg?alt=media\&token=e1650160-7a41-4965-aaca-6975db758dbe) to view additional entries. Use the page navigation ![](https://content.gitbook.com/content/V7OrHgKXA0t1jankQBYf/blobs/wnxVw06QGoSsYjhwMJRF/Enginsight-Seitennavigation-2.jpg) to switch between pages.&#x20;

### Filtering the List

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Filter** icon <i class="fa-filter">:filter:</i> above the list to filter the list by predefined parameters.

<details>

<summary>Available Filters</summary>

<table><thead><tr><th width="159.63671875">Parameter</th><th width="116.515625">Type</th><th>Description</th></tr></thead><tbody><tr><td>Audit Definition</td><td>String</td><td>Filter by all audits based on a specific audit definition, or exclude them from the results. All available audit definitions are shown.</td></tr><tr><td>Status</td><td>String</td><td>Filter by all audits that were completed with a specific status, or exclude them from the results.All available states are shown.</td></tr><tr><td>Targets</td><td>String</td><td>Filter by all audits that concern a specific target system, or exclude them from the results. All available targets are shown.</td></tr></tbody></table>

</details>

### Sorting List Items

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Sort** icon <i class="fa-sort">:sort:</i> next to a column name in the table header to sort by that column in ascending <i class="fa-angle-up">:angle-up:</i> or descending order <i class="fa-chevron-down">:chevron-down:</i> .

<i class="fa-computer-mouse">:computer-mouse:</i> Click the sort icon <i class="fa-bars-sort">:bars-sort:</i> above the list to adjust the priority of the applied sorting. A menu opens that shows all columns by which the list is currently sorted. Drag and drop the shown items to change the sorting priority.

### Deleting List Items

<i class="fa-computer-mouse">:computer-mouse:</i> Select the checkbox <i class="fa-square">:square:</i> next to a list item to select the corresponding item. Alternatively, select the checkbox in the table header to select all list items.

The number of selected list entries is now displayed next to the search field.

The **Delete** button <i class="fa-trash">:trash:</i> also appears in the upper-right corner. Click it, then confirm the message that appears by clicking **Delete**.

{% hint style="danger" %}
**Please note:** Deleted items cannot be restored.
{% endhint %}

### Further Actions for List Items

The following further actions for list items are available:

<table><thead><tr><th width="200.234375">Action</th><th>Description</th></tr></thead><tbody><tr><td>Pause</td><td><p><i class="fa-eye">:eye:</i> This action is only available while the corresponding audit is running.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Pause</strong> icon <i class="fa-pause">:pause:</i> to pause the audit.</p></td></tr><tr><td>Start</td><td><i class="fa-eye">:eye:</i> This action is only available while the corresponding audit is running.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Start</strong> icon <i class="fa-caret-large-right">:caret-large-right:</i> to resume the audit.</td></tr></tbody></table>

***

## Audits: Overview

The audit overview is structured as a table.&#x20;

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FS3KnaMzIXEkHUOkvAvKe%2Fenginsight-screenshot-audits-overview.jpg?alt=media&amp;token=743e601b-6c71-4e9e-a1a3-a30eaf7ba786" alt=""><figcaption></figcaption></figure>

The following information is shown:

<table><thead><tr><th width="199.73828125">Column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td><p>Shows the automatically assigned name of the audit. The date and time it started and ended, its duration and its status are also shown.</p><p></p><p>The following states can be shown:</p><ul><li><strong>Error</strong>: The penetration test could not be started or an error occurred while it was running.</li><li><strong>Failed</strong>: The penetration test was not completed successfully.</li><li><strong>Finished</strong>: The penetration test was completed successfully.</li><li><strong>Processing</strong>: The penetration test is currently running.</li></ul><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>While a penetration test is running, you can track the audit's progress via a red progress bar and additional information, including the target that is currently being scanned, the check that is currently being performed, the scan progress as a percentage, and the elapsed time.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click an audit name to navigate to the <a href="#audit-detail-view">audit detail view</a>.</p></td></tr><tr><td>Severity Levels</td><td><p>Shows the number of vulnerabilities that were found during the audit, grouped by severity.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The severity levels are <a href="/docs/manual/english/appendix/color-coding-of-severity-levels.md">color-coded according to their criticality</a>. If no results were found for a severity, the corresponding field is grayed out.</p></div><p>The following severity levels are shown:</p><ul><li><strong>Critical:</strong> The vulnerabilities found have a very high criticality.</li><li><strong>High</strong>: The vulnerabilities found have a high criticality.</li><li><strong>Medium</strong>: The vulnerabilities found have a medium criticality.</li><li><strong>Low</strong>: The vulnerabilities found have a low criticality.</li></ul></td></tr><tr><td>Audit Definiton</td><td><p>Shows the custom name of the <a href="/docs/manual/english/platform-usage/penetration-testing/management/audit-definitions.md">audit definition</a> on which the audit was based and an additional description, if available.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of the audit definition to navigate to the respective edit view. Here, you can adjust the <a href="/docs/manual/english/platform-usage/penetration-testing/management/audit-definitions/add-audit-definition.md#general-settings">configured settings</a> and delete the audit definition.</p><p><br>Shows the <a href="/docs/manual/english/platform-usage/penetration-testing/required-services/hacktors.md">Hacktor</a> that was used to perform the penetration test.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of the Hacktor to navigate to the respective edit view. Here, you can adjust the <a href="/docs/manual/english/installation-and-configuration/installation-and-configuration/enginsight-components/hacktor.md#configure-hacktor">configured settings</a> and delete the Hacktor.</p></td></tr><tr><td>Targets</td><td><p>Shows the <a href="/docs/manual/english/platform-usage/penetration-testing/management/target-groups.md">target groups</a> on which the penetration test was performed and an additional description for each target group, if available.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a target group to navigate to the respective edit view. Here, you can adjust the <a href="/docs/manual/english/platform-usage/penetration-testing/management/target-groups/add-target-group.md#general-settings">configured settings</a> and delete the target group.</p></td></tr></tbody></table>

***

## Audit: Detail View

<i class="fa-computer-mouse">:computer-mouse:</i> Click a list item to navigate to the respective [audit detail view](/docs/manual/english/platform-usage/penetration-testing/audits/audit-detail-views.md).

***

## Starting an Audit

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Start Penetration Testing Audit** in the upper-right corner to start an audit directly from the overview.

<i class="fa-computer-mouse">:computer-mouse:</i> After configuring all settings, click **Start Penetration Testing Audit** to start the audit, or click **Close** to return to the audit overview.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FuC6VCk2ilcM1jFPkbaLW%2Fenginsight-screenshot-audits-start%20pentesting%20audit.jpg?alt=media&amp;token=5b07381f-de87-465e-9ee0-a7ac1bb6dcd8" alt="" width="375"><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="250.05078125">Option</th><th>Description</th></tr></thead><tbody><tr><td>Alias</td><td><p>Enter a meaningful display name for the audit report.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This field is optional.</p></div></td></tr><tr><td>Audit Definition</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Audit Definition</strong> field to expand a list of all available audit definitions, and select a definition from the list.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Please note</strong>: Before you can select an audit definition here, you must first create it under <strong>Penetration Testing</strong> → <strong>Management</strong> → <a href="/docs/manual/english/platform-usage/penetration-testing/management/audit-definitions.md">Audit Definitions</a>.</p></div></td></tr><tr><td>I am authorized to perform this scan</td><td><p>Confirm that you are authorized to audit the selected target systems.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note</strong>: For data protection reasons, penetration tests may only be performed by authorized persons. Any violation may have legal consequences. Please also read our <a href="https://enginsight.com/en/terms/">Terms and Conditions</a>.</p></div><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Please note</strong>: This is a required field. The audit can only be started after you confirm that you are authorized to perform the penetration test.</p></div></td></tr></tbody></table>

***

## Further Resources

**Knowledge Base**

* [How does a penetration test with Enginsight work?](https://docs.enginsight.com/docs/knowledge-base/english/penetration-tests/how-does-a-penetration-test-with-enginsight-work)
* [How can I use custom scripts in penetration tests with Enginsight?](https://docs.enginsight.com/docs/knowledge-base/english/penetration-tests/how-can-i-use-custom-scripts-in-penetration-tests-with-enginsight)
* [Where do I find which Enginsight logs?](https://docs.enginsight.com/docs/knowledge-base/english/logging/where-do-i-find-which-enginsight-logs)

***
