> 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/plans.md).

# Plans

Plans allow you to define when and how scans for Advanced Persistent Threats (APT) are performed.

{% hint style="warning" %}
**Please note**: Since APT scans generate high system load, we recommend that you run a full scan of all files on the hard drive no more than once per week.
{% endhint %}

***

<i class="fa-compass">:compass:</i> Navigate to **Hosts** → **Advanced Persistent Threats** → **Plans** to show a list of all plans. If you have not added a plan 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%2FkhhQvyCCl9yiasFiB7WQ%2Fenginsight-screenshot-hosts-apt-plans.jpg?alt=media&amp;token=efaeed31-f8ac-4d63-88e0-289a9e6d2265" alt=""><figcaption></figcaption></figure>

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

* which hosts and, optionally, which file paths are scanned and when.
* which rules are used as the basis for the scan.

You can also start a scan directly and add a new [plan](/docs/manual/english/platform-usage/hosts/advanced-persistent-threats/plans/add-plan.md).

***

## 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

<details>

<summary>Available Filters</summary>

<table><thead><tr><th width="206.60546875">Parameter</th><th width="116.515625">Type</th><th>Description</th></tr></thead><tbody><tr><td>File Path</td><td>String</td><td>Filter by a specific file path that should be scanned on a host or exclude it from the results. All available file paths are shown.</td></tr><tr><td>Scheduled Execution</td><td>Boolean value</td><td><p>Filter by whether a plan includes a time interval for regularly running a scan or not.</p><p></p><p>The following values are available:</p><ul><li><strong>True</strong>: The plan includes a time interval.</li><li><strong>False</strong>: The plan does not include a time interval.</li></ul></td></tr><tr><td>Host</td><td>String</td><td>Filter by a specific host on which a scan should be performed 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 that is assigned to the hosts on which a scan should be performed or exclude these hosts from the results. All available tags are shown.</td></tr><tr><td>Rule</td><td>String</td><td>Filter by a specific rule that is assigned to a plan or exclude it from the results. All available rules are shown.</td></tr><tr><td>Rule Tag</td><td>String</td><td>Filter by a specific tag that is assigned to the rules that further define a scan or exclude these rules 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.

### 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 %}

***

## Plans: Overview

The plan 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%2FoOSez19GQNIEUBeq0Q8y%2Fenginsight-screenshot-hosts-apt-plans%20overview.jpg?alt=media&amp;token=35258c6d-f2d7-40d2-ba28-a69c81bc1a82" alt=""><figcaption></figcaption></figure>

The following information is shown:

<table><thead><tr><th width="199.8515625">Column</th><th>Description</th></tr></thead><tbody><tr><td>Plan</td><td><p>Shows the name of the plan as well as 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 plan to navigate to the respective <a href="#plan-edit-view">edit view</a>. Here you can adjust configured settings and delete the plan.</p></td></tr><tr><td>File Paths</td><td>Shows the file paths that should be scanned on the assigned hosts according to the plan.</td></tr><tr><td>Assigned Hosts</td><td><p>Shows the names of the hosts that should be scanned according to the plan or excluded from it, as well as the tags that refer to the corresponding host groups.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Whether host names, tags, or both are shown depends on the <a href="/docs/manual/english/platform-usage/hosts/advanced-persistent-threats/plans/add-plan.md#assigned-hosts">settings of the assigned hosts</a> that you configured for the respective plan.</p></div><p><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>.</p></td></tr><tr><td>Assigned Rule</td><td><p>Shows the names of the <a href="/docs/manual/english/platform-usage/hosts/advanced-persistent-threats/rules.md">rules</a> that are assigned to the plan or excluded from it, as well as the tags that refer to the corresponding rule groups.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Whether rule names, tags, or both are shown depends on the <a href="/docs/manual/english/platform-usage/hosts/advanced-persistent-threats/plans/add-plan.md#zugeordnete-regelwerke">settings of the assigned rules</a> that you configured for the respective plan.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a rule to navigate to the respective <a href="/docs/manual/english/platform-usage/hosts/advanced-persistent-threats/rules.md#rule-edit-view">edit view</a>. Here you can adjust configured settings and delete the rule.</p></td></tr><tr><td>Actions</td><td><p>Shows the action that you can perform for the respective plan.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-circle-play">:circle-play:</i> <strong>Start Scan</strong> to directly run the scan defined by the respective plan. Confirm the prompt by clicking <strong>Start Scan</strong>.</p></td></tr></tbody></table>

***

## Adding a Plan

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

***

## Plan: Edit View

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

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>

***
