> 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/intrusion-detection-system/whitelist/add-whitelist-entry.md).

# Add Whitelist Entry

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Create Whitelist Entry** in the upper right corner of the [whitelist overview](/docs/manual/english/platform-usage/hosts/intrusion-detection-system/whitelist.md#whitelists-overview) to add a new whitelist entry. The **Hosts** → **Intrusion Detection System** → **Whitelists** → **Add** view opens.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FvbOSTBMkLtpULoUSIWVD%2Fenginsight-screenshot-hosts-ids-whitelist-add%20whitelist%20entry.jpg?alt=media&amp;token=9c6c100e-009c-4e4c-90cc-1ac9c06f2568" alt=""><figcaption></figcaption></figure>

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

<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 Whitelist**, all configured settings will be permanently lost.
{% endhint %}

***

## General Settings

Her you can configure various basic settings.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2F0WU8SgA29qGI3YJE7gVQ%2Fenginsight-screenshot-hosts-ids-whitelist-add%20whitelist%20entry-general%20settings.jpg?alt=media&amp;token=ff374475-520d-4d58-80a9-ea094d590e6d" alt=""><figcaption></figcaption></figure>

The following options are available:

<table><thead><tr><th width="200.47265625">Option</th><th>Description</th></tr></thead><tbody><tr><td>Description</td><td><p>Provide a more detailed description for the whitelist entry.</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>CIDR</td><td>Enter the subnet whose associated IP addresses should be classified as trusted in <a href="/docs/manual/english/appendix/defining-ip-address-ranges-and-subnets.md">Classless Inter-Domain Routing (CIDR) notation</a>.</td></tr><tr><td>Attack Category</td><td><p>Enter the specific attack categories for which the IP addresses defined by the subnet should be classified as trusted.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>You can use wildcards (*) here. For example, enter only the wildcard character (*) to include all attack categories. However, we recommend that you test the corresponding attack filters beforehand using the filter function in the <a href="/docs/manual/english/platform-usage/hosts/intrusion-detection-system/network-anomalies.md#netzwerkanomalien-overview">network anomalies overview</a>.</p></div><div data-gb-custom-block data-tag="hint" data-style="success" data-icon="lightbulb" class="hint hint-success"><p>For more information on detected attack types, see our Knowledge Base: <a href="https://docs.enginsight.com/docs/knowledge-base/english/intrusion-detection-system-ids/what-types-of-network-attacks-does-the-enginsight-ids-detect">What types of network attacks does the Enginsight IDS detect?</a></p></div></td></tr><tr><td>Extended Filter</td><td><p>Define the whitelist entry more precisely by restricting it to specific <strong>Details</strong> read from the <a href="/docs/manual/english/platform-usage/hosts/intrusion-detection-system/network-anomalies.md#netzwerkanomalien-overview">network anomalies overview</a>. For example, you can specify the payload of the attack here, if available.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This field is optional. You can use wildcards (*) here.</p></div></td></tr></tbody></table>

***

## Assigned References

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 References

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.

***

## Further Resources

**Knowledge Base**

* [What types of network attacks does the Enginsight IDS detect?](https://docs.enginsight.com/docs/knowledge-base/english/intrusion-detection-system-ids/what-types-of-network-attacks-does-the-enginsight-ids-detect)

***
