> 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/hosts/advanced-persistent-threats/whitelist.md).

# Whitelist

The Advanced Persistent Threat (APT) whitelist allows you to classify specific files and directories as trusted, preventing them from being incorrectly detected as APTs.

***

<i class="fa-compass">:compass:</i> Navigate to **Hosts** → **Advanced Persistent Threats** → **Whitelist** to view a list of all whitelist entries. If you have not created any whitelist entries 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%2Fhqs9beFT8Odwhcoc6E00%2Fenginsight-screenshot-hosts-apt-whitelist.jpg?alt=media&amp;token=b6dfc7e5-0fb6-422b-a45a-44ca1369d450" alt=""><figcaption></figcaption></figure>

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

* which hosts and rules a whitelist entry applies to.
* which files and directories a whitelist entry applies to.
* whether a whitelist entry is enabled.

You can also [add new whitelist entries](#add-whitelist-entry).

***

## 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="206.60546875">Parameter</th><th width="116.515625">Type</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Active</td><td>Boolean</td><td><p>Filter by whether a whitelist entry is enabled or not.</p><p></p><p>The following values are available:</p><ul><li><strong>True:</strong> The whitelist entry is enabled.</li><li><strong>False:</strong> The whitelist entry is disabled.</li></ul></td></tr><tr><td>File Path</td><td>String</td><td>Filter by a specific file path for which a whitelist entry was created, or exclude it from the results. All available file paths are shown.</td></tr><tr><td>Host</td><td>String</td><td>Filter by a specific host that is assigned to a whitelist entry, or exclude it from the results. All available hosts are shown.</td></tr><tr><td>Host Tag</td><td>String</td><td>Filter by a specific tag for a host group assigned to a whitelist entry, or exclude it from the results. All available tags 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.

### Further Actions for 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 respective item. Alternatively, select the checkbox in the table header to select all list items.

The number of selected list items is now shown next to the search field.

The <i class="fa-slider">:slider:</i> **Actions** menu also appears in the upper-right corner. Click it to expand the respective submenu. The following actions are available:

<table><thead><tr><th width="149.84375">Action</th><th>Description</th></tr></thead><tbody><tr><td>Delete</td><td><p>Delete all selected whitelist entries. Confirm the prompt by clicking <strong>Delete</strong>.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note:</strong> Deleted settings cannot be restored.</p></div></td></tr><tr><td>Enable</td><td>Enable all selected, disabled whitelist entries.</td></tr><tr><td>Disable</td><td>Disable all selected, enabled whitelist entries.</td></tr></tbody></table>

***

## Whitelist Entries: Overview

The whitelist overview is structured as a table.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FbEwZj7jNuD8qENuRJfsn%2Fenginsight-screenshot-hosts-apt-whitelist%20overview.jpg?alt=media&amp;token=a65500bb-5178-4a9b-9d78-e804fe3380d8" alt=""><figcaption></figcaption></figure>

The following information is shown:

<table><thead><tr><th width="200.2890625">Column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td><p>Shows the custom name of the whitelist entry and an additional description, if provided. </p><p></p><p>The date and time of creation and last edit are also shown.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a whitelist entry to navigate to the respective <a href="#whitelist-edit-view">edit view</a>. Here you can adjust configured settings and delete the whitelist entry.</p></td></tr><tr><td>Assigned References</td><td>Shows the names of the hosts to which the respective whitelist entry applies or which are excluded from it, as well as the tags that refer to the corresponding host groups.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a host to navigate to the respective <a href="/docs/manual/english/platform-usage/host-detail-view.md">host detail view</a>.</td></tr><tr><td>Assigned References</td><td>Shows the name of the <a href="/docs/manual/english/platform-usage/hosts/advanced-persistent-threats/rules.md">rule</a> to which the respective whitelist entry applies. If the whitelist entry applies to all rules, this is indicated accordingly.</td></tr><tr><td>Filepaths</td><td>Shows the file paths to which the respective whitelist entry applies or which are excluded from it.</td></tr><tr><td>Enabled</td><td>Shows whether the respective whitelist entry is enabled or not.<br><br>If the whitelist entry is enabled, this is indicated by a green <strong>check</strong> icon <i class="fa-circle-check" style="color:green;">:circle-check:</i>. Inactive whitelist entries are indicated by a red <strong>circle</strong> icon <i class="fa-circle" style="color:red;">:circle:</i>.</td></tr></tbody></table>

***

## Adding a Whitelist Entry

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Whitelist** in the upper-right corner to [create a new whitelist entry](/docs/manual/english/platform-usage/hosts/advanced-persistent-threats/whitelist/add-whitelist-entry.md).

***

## Whitelist: Edit-View

<i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a whitelist entry to navigate to the respective edit view. Here you can adjust [configured settings](/docs/manual/english/platform-usage/hosts/advanced-persistent-threats/whitelist/add-whitelist-entry.md#general-settings) and delete the whitelist entry.

The following actions are available:

<table><thead><tr><th width="200.39453125">Option</th><th>Description</th></tr></thead><tbody><tr><td>Save Changes</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Save Changes</strong> after adjusting any settings.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note:</strong> Unsaved changes cannot be recovered.</p></div></td></tr><tr><td>Back</td><td><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Back</strong> to return to the list overview.</td></tr><tr><td>Remove</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Remove</strong>, then confirm the prompt that appears to delete the object that you are editing.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note:</strong> Deleted objects cannot be recovered.</p></div></td></tr></tbody></table>

***
