AdvanNet Rest Service

Introduction

With AdanNet Rest Service you can configure two features: the security protocol and the authentication method for using AdvanNet's REST API and UI. These two features can be configured with the AdvanNetRestService configuration.

AdvanNet Rest service is available in the Services tab.

Using HTTP and HTTPS

“Use HTTPS” will allow you to enter the device via HTTP (as usual) or HTTPS.

Configuring an Authentication method

AdvanNet allows you to set a user and password to connect the device. For this is needed to active Authentication Method to “basic” and fill in the username and password. It is possible to combine this option with both HTTP or HTTPS.

This configuration affects the HTTP server that backs AdvanNet this means this configuration affects both the UI and the REST API.

After rebooting , next time you access the device a log in will be be required with the credentials you have configured.

Disable User/pass authentication

Select None as the authentication method.

Save the settings and reboot the unit.

In case the old AdvanNet UI is used.

Apply & save, and then reboot the unit

How to reenable the UI?

Disabled by accident the UI? We've got you covered. Because the UI is just a front-end to the REST API this guide will use the relevant API calls to guide you to getting back the UI online. You can expand the information on our AdvanNet REST API here. 

Bootloader way

Please follow the instructions here with this file.

No bootloader? The second shortest way: a factory reset.

The reader will revert to factory defaults, which include having the UI online with user admin and password admin.

Just open an internet browser to http://yourDeviceIP/system/os/FactoryReset

The not so short way, by applying default config.

This way will set the UI back online with user admin and password admin but will leave all other settings unchanged.

Just send an HTTP PUT to http://yourDeviceIP/system/services/byId/AdvanNetRestService with payload:

<data>

   <enabled>true</enabled>

   <useHttps>false</useHttps>

   <serveStatic>true</serveStatic>

   <authMethod>digest</authMethod>

   <authUser>admin</authUser>

   <authPassword>admin</authPassword>

</data>

Then send an HTTP GET to http://yourDeviceIP/device/confAllSave to persist the changes.

Reboot the unit to apply the changes.

The proper way

This way only changes the setting that (dis/en)ables the UI.

As with most configuration changes done using the REST API the process is GETting the current configuration, changing to fit our needs and PUTting it back to the reader.

1. GET the information from http://yourDeviceIP/system/services/byId/AdvanNetRestService

2. Keep only the <data> node from the resulting xml

3. Change <serveStatic>false</serveStatic> to true

4. PUT back the payload to the reader

5. HTTP GET http://yourDeviceIP/device/confAllSave to persist the changes.

6. Reboot the unit to apply the changes.