Integration with an webapplication

Owned by Andy Erd
Last updated: Mar 28, 2024
3 min read

The RESTAPI of the NextGen device can be used for integration with a web application. A simple example which is build with HTML + JavaScript can be tested here:

https://www.stepoverinfo.net/NG_DEMO/index.html

The source code can be found here:

https://www.stepoverinfo.net/NG_DEMO/NG_demo_v3.zip

You need enter the IP or the hostname of your device. The device needs to be reachable only by the client, because the local browser will be in contact with the device and not the external webserver. This has the big advantages that the webserver and the device doesn´t need to be inside the same network. The webserver can be in the cloud and the NextGen Pad can be used without the Ethernet-Kit as local device.

1.png

Another option could be that the server connects it self with the device without using the browser als relay station, but this works only when the device is used with the network-kit and its together with the server inside the same network.

2.png

 

Because of the Cross-Origin Resource Sharing (CORS) there are some requirements.

  • Usage of HTTPS is required, on the webserver and on the device. There for you can not just open the HTML file with your local browser, you need to run it inside a HTTPs environment. The connection to the device needs to be also used with HTTPs (enabled by default on the device)

  • The local browser needs to trust the self signed HTTPs certificate from the device, therefor you need to have our RootCertificate installed on the client system. You can find more information about the installation here.

  • You need to extend the cross origin settings on the device with your own domains, because we restricted the external device access to StepOver Domains. At the moment you can only add other domains by swagger, but WEBGUI option is already planed.

 

For adding your external domain, you have to open the Swagger page. First you need there to create a new Session. Next you can check the current domains with GET /config function. To change the Domains you need to use PUT /config, where you find a example “Set CORS Origins”. Next you need to Serialize the new config to memory, otherwise the changes are lost after the restart which is required.

With using * you can set a wildcard to every domain, we recommend to use this only for internal tests and development, because this wildcard means the device will allow the access from every external domain.