The La 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 heredel dispositivo NextGen puede utilizarse para la integración con una aplicación web. Aquí se puede probar un ejemplo sencillo construido con HTML + JavaScript:
https://www.stepoverinfo.net/NG_DEMO/index.html
The source code can be found hereEl código fuente puede consultarse aquí:
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.
...
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.
...
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 domainDebe introducir la IP o el nombre de host de su dispositivo. El dispositivo debe ser accesible sólo por el cliente, porque el navegador local estará en contacto con el dispositivo y no con el servidor web externo. Esto tiene la gran ventaja de que el servidor web y el dispositivo no necesitan estar dentro de la misma red. El servidor web puede estar en la nube y el la Tableta de firmas NextGen se puede utilizar sin el Ethernet-Kit como dispositivo local.
...
Otra opción podría ser que el servidor se conecte por sí mismo con el dispositivo sin utilizar el navegador como estación de retransmisión, pero esto sólo funciona cuando el dispositivo se utiliza con el kit de red y está junto con el servidor dentro de la misma red.
...
.Debido al Intercambio de recursos entre orígenes (CORS) cruzado (CORS)e existen algunos requisitos.
Se requiere el uso de HTTPS, en el servidor web y en el dispositivo. Por lo tanto, no puedes simplemente abrir el archivo HTML con tu navegador local, necesitas ejecutarlo dentro de un entorno HTTP. La conexión con el dispositivo también debe utilizarse con HTTPs (activado por defecto en el dispositivo).
El navegador local necesita confiar en el certificado HTTPs autofirmado del dispositivo, por lo que necesita tener nuestro RootCertificate instalado en el sistema cliente. Puede encontrar más información sobre la instalación aquí.
Necesita ampliar la configuración de origen cruzado en el dispositivo con tus propios dominios, porque hemos restringido el acceso del dispositivo externo a los dominios StepOver. Por el momento solo puede añadir otros dominios mediante swagger, pero la opción WEBGUI ya está prevista.
Para añadir tu dominio externo, tienes que abrir la página Swagger. Primero tienes que crear una nueva sesión. A continuación, puede comprobar los dominios actuales con la función GET /config. Para cambiar los dominios necesitas usar PUT /config, donde encontrarás un ejemplo "Set CORS Origins". A continuación es necesario serializar la nueva configuración a la memoria, de lo contrario los cambios se pierden después del reinicio que se requiere.
...
Con el uso de * se puede establecer un comodín para cada dominio, se recomienda utilizar esto sólo para las pruebas internas y el desarrollo, ya que este comodín significa que el dispositivo permitirá el acceso desde todos los dominios externos.
...