# BuildingPro Suites Broker

## **BuildingPro Suites Broker – Function and Configuration**

The **BuildingPro Suites MQTT Broker** serves as the central interface for secure communication between IoT devices and the BuildingPro Suites platform. It enables the reliable exchange of messages via the MQTT protocol and offers functions for authentication and encryption.

To ensure the security of the communication, **SSL certificates** can be stored. These ensure an encrypted connection and prevent unauthorized access to the data traffic. In addition, **user accounts** can be created to provide specific clients with access data.

***

## Open BuildingPro Suites Broker

<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%2Fhh0p7DL7PBNzfGZIcgCO%2FMQTT%20broker.png?alt=media&#x26;token=821624d5-345d-4e2c-ba47-55b6a3251922" alt=""><figcaption></figcaption></figure></div>

To manage the MQTT connections, navigate to the connection settings and select the BuildingPro Suites Broker.

1. Click on **\[A] Connection** in the main menu.

   ▷ The overview of the available connections opens.
2. Select the **\[B] MQTT** tab.

   ▷ The list of all configured MQTT connections is displayed.
3. Click on **\[C] BuildingPro Suites Broker** to open the configuration of the BuildingPro Suites MQTT connection.

   ▷ The details for the connection are displayed, and you can make settings or add new connections.

***

## Configure MQTT Broker

<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%2FwUFhPCPcQuVQyMkFjUtd%2FMQTT%20broker%20(2).png?alt=media&#x26;token=68f1287a-8a0b-40c8-a721-60f9fe96f229" alt=""><figcaption></figcaption></figure></div>

After opening the BuildingPro Suites Broker, you can customize the MQTT connection by adding SSL certificates or user accounts.

1. **Store SSL certificate**
   * Click on **\[D]**.

     ▷ An input field appears, in which you can insert the SSL certificates and the private key.
   * Insert the **certificate** and the **key** in **\[E]**.
   * Confirm the entry.
2. **Add users**
   * Click on **\[F] +Account** to create a new user with a **username and password**.
   * The new user is then displayed in the **Account list \[G]**.
   * Here, existing users can be deleted or edited.