Connected Systems

The section “Connected Systems” contains third party systems that are not part of the niotix core system but can interact with niotix via internal interfaces.

Node-RED

Under the menu item “Node-RED” you will find links to a Node-RED instance if instances have been created for your account or its sub-accounts. This link will take you to the IoT Service Builder. The IoT Service Builder uses Node-RED as a flow-based development tool for visual programming. Node-RED provides a browser-based flow editor that can be used to create JavaScript functions. Elements of applications can be saved or shared for reuse. The runtime environment is based on Node.js. Flows created in Node-RED are stored using JSON. Since its latest release, MQTT nodes can establish properly configured TLS connections.

Node-RED is a powerful visual editor studio that lets you create dashboards and client applications yourself and configure services. This simply involves adding new nodes to its palette.

Embedding your own Node Red instances

You can authenticate and mount your own Node Red instances via niotix if you have the appropriate permissions. The SSL secured NodeRed instance is done using oAuth2. Here’s how to create a new instance:

1. Add an IoT Service Builder URL to the account you want the instance to run through, followed by an instance name: https:///. In this tutorial, we will use the following example:
   https://yourdomain.com/node-red-1

2. Click the “Save” button and add an appropriate service to the Docker Compose file, as in the example below.

3. Copy the “OAUTH settings” that appear into the newly added service. These will only appear if you have the appropriate admin permission.

4. Adjust the timezone:

   node-red-1: image: registry.gitlab.com/digimondo-samples/niotix-node-red/docker-niotix-node-red:oauth
   volumes:

   • ./data/node-red-1:/data
     restart: always
     user: “0”
     environment:
   • TZ=Europe/Berlin
   • VIRTUAL_HOST=yourdomain.com
   • VIRTUAL_PATH=/node-red-1
   • LETSENCRYPT_HOST=yourdomain.com
   • LETSENCRYPT_EMAIL=support@yourdomain.com
   • OAUTH_CLIENT_ID=xxxxxxxx-477c-4b34-yyyy-2ecdca47bb02
   • OAUTH_CLIENT_SECRET=xxxxxxxx-8ef8-451f-yyyy-65feaebc8ee8
   • OAUTH_AUTH_URL= https://api.niota.io/api/v1/oauth2/authorize
   • OAUTH_TOKEN_URL= https://api.niota.io/api/v1/oauth2/token
   • OAUTH_CALLBACK_URL= https://yourdomain.com/node-red-1/auth/strategy/callback

5. Create a folder in data named with your instance name, e.g. “node-red-1”.

6. Copy settings.js there and don’t change it anymore.

LoRaWAN System

When you click on this menu item, the SaaS instance of firefly, the LoRaWAN network server of DIGIMONDO, opens in a new browser window.