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

# Rules

TLS Interception rules allow you to define specific services, processes, and connections on a Linux host that should be decrypted and analyzed for attack patterns.

{% hint style="danger" %}
**Please note**: The following requirements must be met for TLS Interception rules to take effect:

* Rules must be assigned to specific hosts using [mappings](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tls-interception/mappings.md).
* The **Enginsight IDS** and **TLS Interception** options must be enabled in the [settings of the individual hosts](https://docs.enginsight.com/docs/manual/english/platform-usage/host-detail-view/settings.md#advanced-settings).\
  OR\
  The **TLS Interception** option must be enabled under **Hosts** → **Policy Manager** via a [corresponding policy](https://docs.enginsight.com/docs/manual/english/archive/configurations/policies/add-policy.md).
  {% endhint %}

***

<i class="fa-compass">:compass:</i> Navigate to **Hosts** → **TLS Interception** → **Rules** to show a list of all configured rules. If you have not added any rules 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%2FRzGGNufDz2pSkmTPHXKG%2Fenginsight-screenshot-hosts-tls%20interception-rules.jpg?alt=media&amp;token=1c595bde-64a5-470e-859f-e3cf71e5a4d3" alt=""><figcaption></figcaption></figure>

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

* whether advanced settings for experienced users (expert mode) have been configured.
* the services, connections, or processes to which TLS Interception is applied.
* the mappings that apply to the rule.
* whether the rule is enabled or disabled.

You can also [add new rules](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tls-interception/rules/add-rule.md), delete rules, and enable or disable them.

***

## 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>Enabled</td><td>Boolean</td><td><p>Filter by whether a rule is enabled or disabled.<br><br>The following values are available:</p><ul><li><strong>True</strong>: The rule is enabled and actively enforced.</li><li><strong>False</strong>: The rule is disabled.</li></ul></td></tr><tr><td>Tag</td><td>String</td><td>Filter by a specific tag that is assigned to a group of rules, or exclude it from the results. All available rule 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="199.52734375">Action</th><th>Description</th></tr></thead><tbody><tr><td>Delete</td><td><p>Delete all selected rules. Confirm the prompt by clicking <strong>Delete Irretrievably</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 recovered.</p></div></td></tr><tr><td>Enable</td><td><i class="fa-eye">:eye:</i> This action is only available if all selected rules are disabled.<br><br>Enable all selected rules to start TLS Interception based on these rules.</td></tr><tr><td>Disable</td><td><i class="fa-eye">:eye:</i> This action is only available if all selected rules are enabled.<br><br>Disable all selected rules to stop TLS Interception based on these rules.</td></tr></tbody></table>

***

## Rules: Overview

The rule overview is structured as a table.&#x20;

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FuoNrjrc9InvBtYqYn1a0%2Fenginsight-screenshot-hosts-tls%20interception-rules%20overview.jpg?alt=media&amp;token=c71d52e7-e9a2-4744-83dc-61cc4a966503" alt=""><figcaption></figcaption></figure>

The following information is shown:

<table><thead><tr><th width="200.28515625">Column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td><p>Shows the name of the rule 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 rule to navigate to the respective <a href="#rule-edit-view">edit view</a>. Here you can adjust configured settings and delete the rule.</p></td></tr><tr><td>Expert Mode</td><td><p>Shows whether <a href="https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tls-interception/rules/add-rule.md#advanced-settings">advanced settings</a> for experienced users have been configured for the respective rule.</p><p></p><p>If advanced settings have been configured, this is indicated by a green <strong>check</strong> icon <i class="fa-circle-check" style="color:green;">:circle-check:</i>. If no advanced settings have been configured, this is indicated by a red <strong>circle</strong> icon <i class="fa-circle" style="color:red;">:circle:</i>.</p></td></tr><tr><td>Sources</td><td>Shows the services, processes, or connections defined in the respective rule to which TLS interception is applied.</td></tr><tr><td>Mappings</td><td><p>Shows the names of the mappings that include the rule.</p><p><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a mapping to navigate to the respective <a href="https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tls-interception/mappings.md#mapping-edit-view">edit view</a>.</p></td></tr><tr><td>Enabled</td><td>Shows whether the corresponding rule actively enforces TLS interception for all defined sources on all assigned hosts.<br><br>If the rule is enabled, this is indicated by a green <strong>check</strong> icon <i class="fa-circle-check" style="color:green;">:circle-check:</i>. Disabled rules are indicated by a red <strong>circle</strong> icon <i class="fa-circle" style="color:red;">:circle:</i>.</td></tr></tbody></table>

***

## Adding a Rule

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Rule** in the upper-right corner to [create a new rule](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tls-interception/rules/add-rule.md).

***

## Rule: Edit View

<i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a rule to navigate to the respective edit view. Here you can adjust [configured settings](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tls-interception/rules/add-rule.md#basic-settings) and delete the rule.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FEFuUAX2qVzhrIJKEidwM%2Fenginsight-hosts-tls%20interception-rules-edit%20view.jpg?alt=media&amp;token=eafeb90a-87cd-4641-8a2d-acd775acf9ef" alt=""><figcaption></figcaption></figure>

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>

***
