# Establish a new connection

## Overview

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FLfBJPH0C0W8cdurJv006%2FDocs_Verbindungen%20-%20Verbindungen%20Kafka%200.png?alt=media&#x26;token=c089239e-3cea-4e78-a61e-de3b6682faf7" alt=""><figcaption></figcaption></figure></div>

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FsCR3MQXFTbhLRbe1JNJ2%2FDocs_Verbindungen%20-%20Verbindungen%20Kafka%201.png?alt=media&#x26;token=8652a4ea-fa2f-47ae-93fe-a5be597dfea3" alt=""><figcaption></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="57.600006103515625">Symbol</th><th width="234.199951171875">Description</th><th>Details</th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Menu "Connections"</td><td>Click to open the "Connections" menu</td></tr><tr><td><strong>[B]</strong></td><td>Tab</td><td>Access to the respective interfaces</td></tr><tr><td><strong>[C]</strong></td><td>Workspace</td><td>Shows a list of the existing connections (if any)</td></tr><tr><td><strong>[D]</strong></td><td>Connections</td><td>Existing connections</td></tr><tr><td><strong>[E]</strong></td><td>Pause/resume connection</td><td>Click to pause or resume a connection</td></tr><tr><td><strong>[F]</strong></td><td>Status of the connection</td><td>Shows the current status of the connection</td></tr><tr><td><strong>[G]</strong></td><td>Name</td><td>Name of the connection</td></tr><tr><td><strong>[H]</strong></td><td>Client ID</td><td>Shows the client ID</td></tr><tr><td><strong>[I]</strong></td><td>Consumer Group</td><td>Shows the consumer group</td></tr><tr><td><strong>[J]</strong></td><td>Seeds</td><td>Shows the seed</td></tr><tr><td><strong>[K]</strong></td><td>Create new connection</td><td>Click to create a new connection</td></tr><tr><td><strong>[L]</strong></td><td>Delete connection</td><td>Deletes the respective connection. ⚠ Caution: If the connection is also used in other tenants, it will also be deleted there.</td></tr><tr><td><strong>[M]</strong></td><td>Connection details</td><td>Click to open the details of the connection</td></tr></tbody></table>

## Create a new connection

Proceed as follows to establish a new connection to a broker or to edit an already existing connection.

1. In the sidebar, click on **Connection \[A]**

   ▷ The "Connections" window opens
2. Select the **Kafka \[B]** tab
3. In the workspace, a list of all already existing connections is displayed **\[C]**

   ◈ If you do not see any entries, no connections have been created yet

   ◈ Connections that have been created in other tenants are also displayed
4. Click on **\[K]** to establish a new connection

   ▷ The [↗ "Connection Details"](https://docs.buildings.ability.abb/collection/mandatory-base/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-opc-ua/connection-details) open

## Edit connection

1. In the sidebar, click on **Connection \[A]**

   ▷ The "Connections" window opens
2. Select the **MQTT \[B]** tab
3. In the workspace, a list of all already connected brokers is displayed **\[C]**

   ◈ Connections that have been configured in other tenants are also displayed
4. Click on **\[M]** to open an existing connection

   ▷ The [↗ "Connection Details"](https://docs.buildings.ability.abb/collection/mandatory-base/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-mqtt/configure-client) open