> 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/tls-interception/rules/add-rule.md).

# Add Rule

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Rule** in the upper-right corner of the [rule overview](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tls-interception/rules.md#rules-overview) to create a new rule. The **Hosts** → **TLS Interception** → **Rules** → **Add** view opens.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FJ1ZOP2bvrkT6NPS82eXq%2Fenginsight-screenshot-hosts-tls%20interception-rules-add%20rule.jpg?alt=media&amp;token=ff01c946-2010-4e2f-8d66-1f33e93cf897" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> After configuring all settings, click **Add Rule** to save and create the new rule.

<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 Rule**, all configured settings will be lost and cannot be recovered.
{% endhint %}

***

## General Settings

Here 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%2FuW9lSJCQYRr1QE4zBXY9%2Fenginsight-screenshot-hosts-tls%20interception-rules-add%20rule-general%20settings.jpg?alt=media&amp;token=14b957a9-034a-4f91-8b04-70ec19d7ec08" alt=""><figcaption></figcaption></figure>

The following options are available:

<table><thead><tr><th width="200.46875">Option</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Enter a meaningful name for the rule.</td></tr><tr><td>Description</td><td><p>Provide a more detailed description for the rule.</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>Tags</td><td><p>Define the tags that should be assigned to the rule.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This field is optional.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Tags</strong> field to expand a list of all existing rule tags, and select one or more tags. Alternatively, enter a new custom tag and confirm with <strong>Enter</strong>.</p><p></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><tr><td>Enabled</td><td><p>Enable the rule so that the services, processes, or connections defined in it can be decrypted and analyzed on the assigned hosts.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This option is enabled by default.</p></div><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note</strong>: TLS interception can have a significant impact on the target application. We therefore strongly recommend that you <strong>always test TLS interception in a controlled environment</strong> with the intended application before using it in production.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Select or deselect the checkbox <i class="fa-square">:square:</i> next to <strong>Enabled</strong> to enable or disable the rule.</p></td></tr></tbody></table>

***

## Service for TLS Interception

Here you can select one of the predefined supported services to which TLS interception should be applied.

{% hint style="info" %}
This option is required if you do not want to configure custom [advanced settings](#advanced-settings) for experienced users.
{% endhint %}

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FNxfpELbfP8JEwIaIBZf2%2Fenginsight-screenshot-hosts-tls%20interception-rules-add%20rule-service%20for%20tls%20interception.jpg?alt=media&amp;token=96c204ee-37db-4758-b65b-3a30aafc7210" alt="" width="563"><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Service** field to expand a list of all supported services, and select a service.

The following services are available:

* Nginx
* Apache
* lighttpd
* Squid
* HAProxy
* exim4
* ProFTPD
* InspIRCd

***

## Advanced Settings

Here you can add custom services, processes, and connections to the rule to which TLS Interception should be applied.

{% hint style="warning" %}
**Please note**: We recommend these settings for experienced users only.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Advanced Settings** field to expand additional input fields.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2F6aaA0vxPE3WCQ5iBEkzQ%2Fenginsight-screenshot-hosts-tls%20interception-rules-add%20rule-advanced%20settings.jpg?alt=media&amp;token=8e5d3aa8-eafa-453d-bebc-1440acad6b52" alt=""><figcaption></figcaption></figure>

<i class="fa-split">:split:</i> Under **Custom Connections, Processes, or Services for TLS Interception**, select one of the following options: [Service](#service), [Process](#process), or [Connection](#connection).

{% hint style="warning" %}
**Please note**: The application to be analyzed using TLS Interception must use **OpenSSL** or **GnuTLS**. However, outside the predefined services supported by Enginsight, we cannot guarantee that TLS interception will work with every application that uses OpenSSL or GnuTLS.
{% endhint %}

The available input options depend on the selected option:

{% tabs %}
{% tab title="Service" %} <i class="fa-eye">:eye:</i> This option is only visible if you select **Service** under **Custom Connections, Processes, or Services for TLS Interception**.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2F2d4NO6punZHAGrfqMcGs%2Fenginsight-screenshot-hosts-tls%20interception-rules-add%20rule-advanced%20settings-service.jpg?alt=media&amp;token=b439cc2c-f72e-4677-9bc8-702588cbfe01" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> Click the respective input field and enter the name of the service to which TLS interception should be applied, for example, *nginx* or *nginx.service*.

{% hint style="warning" %}
**Please note**: Wildcards (\*) are not supported.
{% endhint %}
{% endtab %}

{% tab title="Process" %} <i class="fa-eye">:eye:</i> This option is only visible if you select **Process** under **Custom Connections, Processes, or Services for TLS Interception**.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FciX461eC1etR0Bn6p82v%2Fenginsight-screenshot-hosts-tls%20interception-rules-add%20rule-advanced%20settings-process.jpg?alt=media&amp;token=46b90d6f-ea04-49d8-bb63-d6d3470693e1" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> Click the respective input field and enter the full path to the process to which TLS interception should be applied, for example, */usr/sbin/nginx*.

{% hint style="warning" %}
**Please note**: Wildcards (\*) are not supported.
{% endhint %}
{% endtab %}

{% tab title="Connection" %} <i class="fa-eye">:eye:</i> This option is only visible if you select **Connection** under **Custom Connections, Processes, or Services for TLS Interception**.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FSszhTiZQMkFso5m9Y18J%2Fenginsight-screenshot-hosts-tls%20interception-rules-add%20rule-advanced%20settings-connection.jpg?alt=media&amp;token=643afd4a-5552-4f20-a7bd-7299695cab90" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> Click the respective input field and enter the port number used by the connection to which TLS interception should be applied, for example, *443*.

{% hint style="warning" %}
**Please note**: Wildcards (\*) are not supported.
{% endhint %}
{% endtab %}
{% endtabs %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Add Another Field** to define additional custom services, processes, or connections.

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Discard Changes** to close all additional input fields and discard the settings.

***
