Integrations
What are Integrations?
Integrations manage incoming connections from external systems and sources into your Heisenware account. This includes, for example, Agents connecting to our MQTT broker, or custom applications connecting via MQTT or VRPC.
You can establish these connections in two primary ways: by manually creating credentials within Heisenware and configuring your external client, or through Smart Onboarding, where an external client initiates a request that you then approve.
Each integration uses a unique username and password (credentials) for authentication. Only connections with valid credentials are granted access.
To manage integrations, log in to your Heisenware account and navigate to the Integrations panel in the left sidebar. Here, you can:
View and manage credentials (usernames, passwords).
Monitor connection types, online statuses, and last login details.
Create, delete, and toggle activation of integrations.
Manual Credential Creation
This method is ideal if you want to pre-configure the external client with specific access credentials.
To authorize an incoming connection manually:
Open the Integrations panel.
Select the type of integration: MQTT or VRPC.
(Optional) Change the randomly generated username and password by clicking into the respective fields and modifying them.
Take these generated credentials (username and password) and configure them within your external client's settings to connect to your Heisenware account.
Smart Onboarding
This method is ideal if you don't want to manually configure an external client with credentials. Smart Onboarding, when activated, listens for incoming connection requests and allows you to approve them directly. For more details on how to perform smart onboarding, refer to the Smart Onboarding in App Builder article.
Integration Types
Heisenware currently supports incoming connections from the following types:
Heisenware Agent (formerly Edge Connector): A proprietary Heisenware technology for integrating systems (files, protocols, databases) from private networks with the cloud. When a Heisenware Agent is created, its integration entry is automatically generated. Agents technically integrate via MQTT. Refer to the Agents article for detailed instructions on creation and deployment.
MQTT: External MQTT clients can connect to Heisenware's MQTT broker using either manual credential creation or through Smart Onboarding initiated from the App Builder. This is suitable for general IoT device integration, or other external clients pushing data.
VRPC: An innovative open-source protocol by Heisenware for easy integration of custom code and proprietary software libraries. External VRPC clients can connect using either manual credential creation or through Smart Onboarding initiated from the App Builder. This is ideal for scenarios like calling custom code or integrating specialized software. Contact us for assistance with custom code and library integration or visit the VRPC website.
Last updated