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

# Add Plan

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Plan** in the upper-right corner of the [plan overview](/docs/manual/english/platform-usage/hosts/advanced-persistent-threats/plans.md#plans-overview) to create a new plan. The **Hosts** → **Advanced Persistent Threats** → **Plans** → **Add** view opens.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FQbiusiJ3L0LY8rJF1G9m%2Fenginsight-screenshot-hosts-apt-plans-add%20plan.jpg?alt=media&amp;token=12b963a4-45d1-4fe9-b4d9-b750d072eabc" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Add Plan** after you configured all settings to save and create the new plan.

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Back** to return to the overview.

{% hint style="danger" %}
**Please note**: If you leave this view without clicking **Add Plan**, all configured settings will be permanently lost.
{% endhint %}

***

## General Settings

Here you can configure various basic settings.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FAulswEil2XgcaOtrfbWF%2Fenginsight-screenshot-hosts-apt-plans-add%20plan-general%20settings.jpg?alt=media&amp;token=f0774c4c-2d5d-4044-be88-49052c0ec161" alt="" width="429"><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="199.8828125">Option</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Enter a meaningful name for the plan.</td></tr><tr><td>Description</td><td><p>Provide a more detailed description for the plan.</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></tbody></table>

***

## Assigned Hosts

Here you can define the hosts or groups of hosts to which the configured settings should apply.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FYR7UyXLPL5lH4nfJExPa%2FEnginsight-EN-Assigned%20References.jpg?alt=media&amp;token=cebf4535-0c6c-4404-a071-76821b8fc228" alt=""><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="199.625">Option</th><th>Description</th></tr></thead><tbody><tr><td>Hosts</td><td><p>Define the hosts to which the configured settings should apply.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Hosts</strong> field to expand a list of all available hosts, then select one or more hosts. Alternatively, use the free-text search to find hosts in the list more quickly.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Remove</strong> icon <i class="fa-circle-xmark">:circle-xmark:</i> next to an added host to remove it from the <strong>Hosts</strong> field.</p></td></tr><tr><td>Tag Logic</td><td><p>Define how many tags an assigned host must have for the settings to apply to it.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default tag logic is <strong>All Tags are Present in the Reference</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Tag Logic</strong> field to expand a list of all available options.<br><br>The following options are available:</p><ul><li><strong>All Tags are Present in the Reference:</strong> An assigned host must have all specified tags for the settings to apply to it.</li><li><strong>At Least One of the Specified Tags is Present:</strong> An assigned host must have at least one of the specified tags for the settings to apply to it.</li></ul></td></tr><tr><td>Tags</td><td><p>Define tags for groups of hosts to which the configured settings should apply.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Tags</strong> field to expand a list of all available tags, then select one or more tags. Alternatively, use the free-text search to find tags in the list more quickly.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Remove</strong> icon <i class="fa-circle-xmark">:circle-xmark:</i> next to an added tag to remove it from the <strong>Tags</strong> field.</p></td></tr></tbody></table>

### Excluded Hosts

Here you can define which hosts or groups of hosts should be explicitly excluded from the configured settings.

{% hint style="info" %}
Defining excluded hosts is optional.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Define Exceptions** next to **Assigned Hosts** to show the options for **Excluded Hosts**.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FOwkoC0RXeV3yJg6fqoh0%2FEnginsight-EN-Excluded%20References.jpg?alt=media&amp;token=25189e42-a39b-4936-a80a-3780807e258f" alt=""><figcaption></figcaption></figure></div>

<i class="fa-gear">:gear:</i> Configure all settings as described for an assigned host.

***

## Assigned Rules

Here you can select specific rules or a group of rules that should be assigned to the plan.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FKzf6xbP7p6CZU1IjEgzM%2Fenginsight-screenshot-hosts-apt-plans-add%20plan-assigned%20rules.jpg?alt=media&amp;token=5362ddaf-8cc9-4eb9-999b-c32cc1bb3ccf" alt="" width="563"><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="199.80859375">Option</th><th>Description</th></tr></thead><tbody><tr><td>Rules</td><td><p>Define rules that should be assigned to the plan.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click in the <strong>Rules</strong> field to expand a list of all available rules and select one or more rules. Alternatively, use the free-text input to find rules in the list more quickly.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Remove</strong> icon <i class="fa-circle-xmark">:circle-xmark:</i> next to an added rule to remove it from the <strong>Rules</strong> field.<br><br>Leave the <strong>Rules</strong> field empty if you want to add a group of rules using tags.</p></td></tr><tr><td>Tag Logic</td><td><p>Define which tags an assigned rule must contain for the setting to apply to it.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default tag logic is <strong>All Tags are Present in the Reference</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click in the <strong>Tag Logic</strong> field to expand a list of all available options.<br><br>The following options are available:</p><ul><li><strong>All Tags Are Present in the Reference</strong>: An assigned rule must contain all specified tags for the setting to apply to it.</li><li><strong>At Least one of the Specified Tags Is Present</strong>: An assigned rule must contain at least one of the specified tags for the setting to apply to it.</li></ul></td></tr><tr><td>Tags</td><td><p>Define tags for groups of rules that should be assigned to the plan.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Please note</strong>: The default tag is <strong>Managed</strong>. This means that all of the more than 7,000 managed rules are used by default to scan for APTs.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click in the <strong>Tags</strong> field to expand a list of all available tags and select one or more tags. Alternatively, use the free-text input to find tags in the list more quickly.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Remove</strong> icon <i class="fa-circle-xmark">:circle-xmark:</i> next to an added tag to remove it from the <strong>Tags</strong> field.<br><br>Leave the <strong>Tags</strong> field empty if you want to select one or more specific rules by name.</p></td></tr></tbody></table>

### Excluded Rules

Here you can define which rules or groups of rules should be explicitly excluded from a plan.

{% hint style="info" %}
Specifying excluded rules is optional.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Define Exceptions** next to **Assigned Rules** to show the options for **Excluded Rules**.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FaAfzQXq6MR8TLtro2sIg%2Fenginsight-screenshot-hosts-apt-plans-add%20plan-excluded%20rules.jpg?alt=media&amp;token=9eef0b4a-f558-4c56-a272-8da0332b3296" alt="" width="563"><figcaption></figcaption></figure></div>

<i class="fa-gear">:gear:</i> Configure all settings in the same way as when defining an [assigned rule](#assigned-rules).

***

## File Paths

Define file paths that should be scanned on an assigned host.

{% hint style="info" %}
Specifying file paths is optional.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Field** to add a field for defining a file path.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FVfKedGZTeTbhO3hgJb52%2Fenginsight-screenshot-hosts-apt-plans-add%20plan-filepaths.jpg?alt=media&amp;token=b9af5de8-0961-4832-ba98-c0324309d8ef" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="199.8125">Option</th><th>Description</th></tr></thead><tbody><tr><td>File Path</td><td><p>Enter a file path.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>You can use wildcards (*) here.</p></div></td></tr><tr><td>Delete</td><td><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Delete</strong> icon <i class="fa-trash">:trash:</i> next to an added file path to remove the respective path from the rule.</td></tr><tr><td>Add Field</td><td><i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> <strong>Add Field</strong> to add the file path to the rule and show another field for defining an additional file path.</td></tr></tbody></table>

### File Path Exceptions

Define file paths that should be explicitly excluded from a scan.

{% hint style="info" %}
Specifying file path exceptions is optional.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Field** to add a field for defining a file path.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FhzTmyL0Km4cxsG39hbP3%2Fenginsight-screenshot-hosts-apt-plans-add%20plan-filepath%20exceptions.jpg?alt=media&amp;token=a947dae4-f54b-4769-877f-28938cb08114" alt=""><figcaption></figcaption></figure>

<i class="fa-gear">:gear:</i> Configure all settings in the same way as when [defining a file path that should be scanned](#file-paths).

***

## Scheduled Execution

<i class="fa-computer-mouse">:computer-mouse:</i> Click in the **Advanced Settings** field to define more detailed settings for running an APT scan assigned to the plan.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FluRftCgHjmBYmEKEndpZ%2Fenginsight-screenshot-hosts-apt-plans-add%20plan-scheduled%20execution.jpg?alt=media&amp;token=9d4bf393-72aa-4311-bba8-cca29da7d19d" alt=""><figcaption></figcaption></figure>

The following options are available:

<table><thead><tr><th width="199.53125">Option</th><th>Description</th></tr></thead><tbody><tr><td>System Capacity Utilization</td><td><p>Define the system load that a scan assigned to the plan should consume. This determines how highly the scan is prioritized on a system.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default selected system capacity utilization is <strong>Balanced</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click in the <strong>System Capacity Utilization</strong> field to show a list of all available options.</p><p><br>The following options are available:</p><ul><li><strong>Minimum</strong>: The scan should consume only a minimum amount of system performance (max. 1 thread on 1 CPU). This means that it is assigned very low priority on highly loaded systems.</li><li><strong>Balanced</strong>: The scan should consume a medium amount of system performance (approx. 25% load). This means that it is performed with medium priority on highly loaded systems.</li><li><strong>Moderate</strong>: The scan should consume slightly more system performance (approx. 50% load). This means that it is assigned a higher priority even on highly loaded systems.</li><li><strong>Maximum</strong>: The scan should consume the maximum amount of system performance (100% load, all available CPUs). This means that it is assigned the highest priority even on highly loaded systems.</li></ul></td></tr><tr><td>Maximum File Size (in MB)</td><td><p>Define the maximum size of a file in megabytes (MB) to scan.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default file size is <strong>1024</strong>.</p></div></td></tr><tr><td>Scheduled Execution</td><td><p>Define whether the plan should be executed automatically on a regular basis.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Please note</strong>: Since APT scans generate high system load, we recommend that you perform a scan of all files on the hard drive no more than once per week.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Select the checkbox <i class="fa-square">:square:</i> next to <strong>Scheduled Execution</strong> to define a custom schedule for execution using the <a href="#time-interval-selection">time interval selection</a>, or deselect the checkbox <i class="fa-square-check">:square-check:</i> to disable scheduled execution.</p></td></tr></tbody></table>

### Time Interval Selection

With the time interval selection, you can configure a custom time interval in which the plan is executed automatically on a regular basis.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FRsieOenWTuTSSsvDverr%2FEnginsight-EN-SIEM-Time%20Interval%20Selection.jpg?alt=media&amp;token=12622f35-614f-484b-b6c7-68e059b43e9d" alt="" width="527"><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="199.9140625">Option</th><th>Description</th></tr></thead><tbody><tr><td>Time Zone</td><td><p>Define the time zone that you want to use for the selected time interval.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Time Zone</strong> field to expand a list of all available time zones, and select a time zone.</p></td></tr><tr><td>Cron Expression (Vixie/Unix)</td><td>Shows the defined interval as a cron expression. The cron expression is updated automatically whenever you configure a time interval manually.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Cron Expression</strong> field to <a href="/docs/manual/english/appendix/angabe-von-cron-ausdruecken.md">edit the cron expression manually</a>.</td></tr><tr><td>Next Execution (Local Time Zone)</td><td>Shows the exact date and time of the next execution in your <em>browser’s local time zone</em>.</td></tr><tr><td>Description</td><td>Shows the defined interval for recurring execution as a plain-language description.</td></tr><tr><td>Time Interval Selection</td><td><p>Define a custom execution interval.</p><p><br>Select the relevant minutes, hours, days of the month, months, or days of the week.</p></td></tr></tbody></table>

***
