Heisenware Docs
Go to websiteGet a demo
  • 👋Welcome
  • Getting started
  • Release Notes
    • v84 - Get in the flow
    • v83 - Beauty treatment
    • v82 — Fully distributed
    • v81 — Removing old cruft
    • v80 — Chicks on fire
    • v79 — Nothing is forever
    • v78 — Keep moving
    • v77 — More intelligence
    • v76 — Well cooked
  • Build & Deploy Apps
    • Overview
    • Flow Builder
      • Nodes (Functions)
        • Inputs
        • Trigger
        • Output
      • Function Extensions
        • Modifier
        • Filter
        • Error handler
        • Memorizer
      • Objects & Instances
      • Utilities
        • Basic Functions
        • PDF functions
        • Circular buffer
        • Timer
        • Counter
    • Integrations
      • Protocol Connectors
        • GraphQL
        • HTTP/REST
        • MQTT
        • OPC UA
          • Heidenhain PLCs with OPC UA
        • RS-232/485
        • Siemens S7
      • Data Connectors
        • File
        • Relational Database
        • Time Series Database (WIP)
      • API Connectors
        • OGC SensorThings API
        • Operating System
        • Zebra RFID IoT Connector
      • Agent / (Edge Connector)
      • Calling Custom Code
    • UI Builder
      • Input Widgets
        • Form
        • File Upload
        • Photo
        • Signature
        • Barcode / QR-Code (WIP)
        • Document Scan (WIP)
      • Display Widgets
        • Chart
        • Chat
        • Circular Gauge
        • Data Grid
        • Linear Gauge
        • Map
        • Media View
        • Progress Bar
        • Sparkline
        • Status Lamp
        • Toast
        • Value Box
        • Kanban Board
        • Data Tiles
        • Pie Chart
        • Sankey
      • Buttons
      • Text Box
      • Images
      • Icons
    • Communication Interfaces
      • Email Notifications
      • OPC UA Server
    • Data & File Storage
      • Internal InfluxDB
      • Internal PostgreSQL
      • File Server
    • App Appearance
      • Pages
      • In-App Navigation
      • Screens & Devices
      • Theming
    • Simulation & Testing
      • Simulating Events
      • Simulating Data
    • PDF Templates
    • RAG-based Chatbot
    • Deployment
  • Manage Apps
    • Overview
    • Manage Apps
      • General Settings
      • Users and Access
      • Distribution & Versioning
    • Manage Integrations
    • Manage Account
      • Account Structure
      • Members
      • Workspaces
  • TUTORIALS
    • Build Your First Heisenware App
  • Connect Heidenhain CNC with OPC UA Support
  • Related links
    • Website
    • Privacy policy
    • Imprint
Powered by GitBook
On this page
  • Establish incoming connections
  • Adding integrations manually
  • Smart client onboarding
  • Integration types
  1. Manage Apps

Manage Integrations

Last updated 8 months ago

Integrations represent incoming connections from clients of different types. An integration always consists of a username and a password (credentials), which are required for the connection with your Heisenware account. Only connections with known and valid credentials will be granted access to your Heisenware account.

To monitor, create, and manage integrations, log in to your Heisenware account and go to the Integrations panel in the left sidebar. In this panel, you can view and manage usernames, passwords, types, online statuses, and last login details. Additionally, you can create and delete integrations, as well as toggle their activation.

Establish incoming connections

There are two ways to add integrations to Heisenware:

Adding integrations manually

Manually creating integrations is useful when you need to connect a client to your Heisenware account that you want to pre-configure with credentials.

To authorize an incoming connection manually:

  1. Click Add Integration in the upper right corner in the Integrations panel.

  2. Select the type of integration you'd like to add: MQTT, OPC UA, HTTP or VRPC.

  1. Optionally change the randomly generated username and password, click into the respective field and modify it.

  1. Add the credentials (username and password) to the respective client you want to integrate with your Heisenware account.

Smart client onboarding

Another way to grant clients access to your Heisenware account is through smart onboarding. Smart onboarding lets you integrate clients without manually exchanging credentials.

Currently, this feature is available in the App Builder, but it will soon be relocated to the Integrations panel.

To onboard a client using smart onboarding:

  1. Initiate a connection request with your client.

  2. Open the App Builder.

  3. Click on the client you like to onboard. Please make sure to only onboard clients you trust.

  4. Click on the onboarding icon again to stop the smart onboarding.

If there is no client appearing when the onboarding is activated, please make sure that the request is correctly initiated by your client.

Integration types

Heisenware supports incoming connections from Edge Connectors, MQTT, HTTP, OPC UA and VRPC.

Edge Connector
MQTT

MQTT clients can connect to Heisenwares MQTT broker using either method: manual credential creation or automatic connection through smart onboarding.

HTTP

HTTP clients can connect to Heisenwares REST API using either method: manual credential creation or automatic connection through smart onboarding.

The REST API is currently under development and expected to be available in Q2/2025.

OPC UA
VRPC

VRPC is an innovative open source protocol made by Heisenware that allows integration of custom code and proprietary software libraries easily. VRPC clients can connect to Heisenware using either method: manual credential creation or automatic connection through smart onboarding. Please reach out to us, if you need help with integrating custom code and libraries.

: In this method, you first generate credentials within the Integrations panel and then provide them to the client you wish to connect to your Heisenware account.

: With smart onboarding, the client initiates a connection request to your Heisenware account. Once you approve the connection, the clients credentials are automatically added to the integrations list.

Click on the start onboarding icon in the functions panel.

The Edge Connector is a proprietary Heisenware technology designed to seamlessly integrate files, protocols, databases and other systems within private networks with the cloud. While creating the Edge Connector, the integration entry is automatically made for you. Please refer to the for detailed instructions on crating and deploying them. Technically, an Edge Connector integrates via MQTT.

OPC UA clients can connect to Heisenwares using either method: manual credential creation or automatic connection through smart onboarding.

article on Edge Connectors
OPC UA server
Manual creation of credentials
Smart client onboarding
Integrations panel
Add Integration
MQTT Integration example