*App connectivity settings

Open

How To Article | HTA-20231017-TS-01 VDG Sense | Web & Mobile Client | App connectivity settings Open

Please follow instructions below to setup Sense correctly for usage with iOS or Android mobile app. These settings apply to Sense 2.6.x and higher.

The HTTP Server plugin is the gateway for the VDG Sense Webpage, iOS/Android apps and third-party systems which integrate VDG Sense. It is also responsible to handle all HTTP calls to the SensePluginManager.

Configuration

The HTTP Server plugin can be found in the ‘Plugins’ tab. Because it is an essential part of the VDG Sense system it cannot be deactivated.

General

The ‘General’ tab holds the main settings of the HTTP Server.

• Bind Address

  • Defaults to 127.0.0.1 (localhost), which means it only accepts connections from localhost and not from any external source. Set to 0.0.0.0 to accept remote connections.

• Port

  • TCP Port to access the HTTP Server (and VDG Sense webpage and iOS/Android app). Default = port 80. If you need to change this please follow instructions in this article: *How to change HTTP-API port in VDG Sense

Advanced Tab

Enable cookie only sessionkey

Enabled by default and prevents the use of the sessionkey as parameter in API commands. Due to security reasons it is recommend to enable this.

Enable digest authentication

Disabled by default for API connectivity. You must enable it for usage with iOS and Android app. It is preferred to use HTTPS access if possible.

Please note that iOS app only accepts trusted SSL certificates. So if you want to use HTTPS icw iOS app you must install trusted certificate in Sense. Installation is described in this article: How to install SSL Certificate

IMPORTANT: Changing setting requires SensePluginManager service to be restarted

Now you can go to your browser and type in the server IP address and port number. If you get the login screen of Sense the settings are done right and you should be able to use iOS or Android app.

Is the browser working and the app gives a error look to your router settings and port forwarding.