Configure device using Web Interface

IoT Connector supports sending data via webswocket connection. The reader in this case acts as a Web Socket server and accepts client connection. Please note the following points about the Web Socket connection to reader.

  1. The Websocket connection should be made on the URL wss://<reader_ip>/ws or ws://<reader_ip>/ws depending on whether a security is enabled or not.

  2. Reader accepts only one WebSocket connection. So it is not possible to send data to two websocket connections at the same time.

  3. Supports both Secure and Non Secure Web Socket connections.

  4. Since the same apache server is used to serve both Web Console and the Web Socket endpoints, the Web Server Settings should match the desired Web Socket setting.

    Ex: If a Secure Web Socket connection to the reader is desired, then HTTP Server Setting in the Communications-> Services page in reader web console should also be set to HTTPS and vice versa.

  5. The Reader Server Certificate is used for Web Socket connections.

Certificates(For Secure Web Socket only)

For Secure Web Socket connections the reader will by default use the self signed certificate that is generated at startup. If the User desires to use a different certificate, then the desired certificate must be imported into the reader using one of the two methods outlined below.

Using Web UI

  • Create PFX file from certificate generated and import into the reader. For information on how to import the certificates to reader, refer to Certificate Management Section.

    Important

    While installing a certificate to be used for Web Socket communication, make sure to use the server as cert type.

Add Web Socket Endpoint

  1. Open a web browser to connect to the reader using the host name or IP address.

  2. Click Communication > Zebra IoT Connector > Configuration.

  3. Click on Add Endpoint button to add new endpoint.

    ZIOTC Add Endpoint

  4. Select Web Socket for Endpoint Type.

  5. Configure Endpoint Name and Endpoint Description fields.

  6. Under the Connection tab, checking the Secure box will add a secure Web Socket endpoint.

  7. Under the Connection tab, checking the Verify Server Certificate box will enable certificate validation on an incoming WebSocket connection. In other words only those connections that are using a certificate signed by a CA that is known to the reader will be allowed.

    ../../_images/WSConnection.png

  8. Click on Add.

  9. Once added the endpoint will be seen under Endpoint Configurations.

    ../../_images/WS_connection_added.png

  10. Open a web browser to connect to the reader using the host name or IP address.

  11. Click Communication > Zebra IoT Connector > Configuration.

  12. Select WEb Socket endpoint for Tag Data Interface1. Choose the desired endpoint for Management Interface , Control Interface and Managementevent Interface if required.

    ../../_images/ws_endpoint_mapping.png

  13. Click on Update button to update interface configuration.

Start ZIoTC Service

  1. Open a web browser to connect to the reader using the host name or IP address.

  2. Click Communication > Zebra IoT Connector > Connection.

  3. Click on Connect button.

  4. Once connected the current connection status of the interfaces will be displayed under Connection Status section.

    ../../_images/WS_connection_status.png

Note

The connection status for Web Sockets will be shown as connected only after a client establishes a connection to the reader