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

# Mappings

Mappings for TLS interception define which rules are assigned to which hosts. The mappings overview provides an overview of all mappings between rules and hosts.

{% hint style="danger" %}
**Please note**: [TLS interception rules](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tls-interception/rules.md) must always be assigned to specific hosts using mappings before they can take effect.
{% endhint %}

***

<i class="fa-compass">:compass:</i> Navigate to **Hosts** → **TLS Interception** → **Mappings** to show a list of all configured mappings. If you have not created any mappings 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%2FeBTZWFWhUr9RiNZGD5oD%2Fenginsight-screenshot-hosts-tls%20interception-mappings.jpg?alt=media&amp;token=36e0d841-95fa-4c8b-a483-f31e5e21e60e" alt=""><figcaption></figcaption></figure>

The [mappings overview](#mappings-overview) shows which rules are assigned to which hosts.

You can also [add new mappings](#add-mapping).

***

## 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>Host Tags</td><td>String</td><td>Filter by a specific tag that is assigned to a group of hosts, or exclude it from the results. All available host tags are shown.</td></tr><tr><td>Rule Tags</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><tr><td>Assigned Hosts</td><td>String</td><td>Filter by a specific host that is included in a mapping, or exclude it from the results. All available hosts are shown.</td></tr><tr><td>Assigned Rules</td><td>String</td><td>Filter by a specific rule that is included in a mapping, or exclude it from the results. All available rules 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 mappings for TLS interception. Confirm the prompt by clicking <strong>Delete</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 mappings are disabled.<br><br>Enable all selected TLS interception mappings.</td></tr><tr><td>Disable</td><td><i class="fa-eye">:eye:</i> This action is only available if all selected mappings are enabled.<br><br>Disable all selected TLS interception mappings.</td></tr></tbody></table>

***

## Mappings: Overview

The mappings 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%2FkgKiUq8L9LPaTvDef4WA%2Fenginsight-screenshot-hosts-tls%20interception-mappings-overview.jpg?alt=media&amp;token=9df9a029-0eb4-4adf-b4d7-8c3e2d6f721d" alt=""><figcaption></figcaption></figure>

The following information is provided:

<table><thead><tr><th width="254.90625">Column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td><p>Shows the name of the mapping 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 mapping to navigate to the respective <a href="#mapping-edit-view">edit view</a>. Here you can adjust configured settings and delete the mapping.</p></td></tr><tr><td>Rules</td><td><p>Shows the names of the assigned rules or the tags that refer to the corresponding groups of rules.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a rule to navigate to the respective <a href="https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tls-interception/rules.md#rule-edit-view">edit view</a>.</p></td></tr><tr><td>Host</td><td><p>Shows the names of the assigned hosts or the tags that refer to the corresponding groups of hosts.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click a host name to navigate to the respective <a href="https://docs.enginsight.com/docs/manual/english/platform-usage/host-detail-view/dashboard.md">host detail view</a>.</p></td></tr></tbody></table>

***

## Add a Mapping

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

***

## Mapping: Edit View

<i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a mapping 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/mappings/add-mapping.md#basic-settings) and delete the mapping.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FKQU3PivQLvCw9V9SMc8z%2Fenginsight-hosts-tls%20interception-mappings-edit%20view.jpg?alt=media&amp;token=0b3cd42b-72a1-430c-8af8-5337e99573f4" 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>

***
