Configure device using Web Interface

To connect the reader to HTTP POST Server, follow the steps below:

Import Certificates

For secure HTTP POST Server with self signed certificate the Root CA certificate of the server need to be imported into the reader. For mutual TLS setups device public certificate and private key generated need to be imported.

Using SCP

  • Copy generated certificates and CA certificate into reader. (copy to desired folder inside /apps/).

Using Web UI

  • Create PFX file from certificate generated.

  • Follow reader’s Integration guide to import certificates into reader.

Add HTTP Post Endpoint

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

  1. Click Communication > Zebra IoT Connector > Configuration.

    ../../_images/HTTP_connection_page.png

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

    ../../_images/HTTP_add_endpoint_page.png

  3. Select HTTP POST for Endpoint Type.

  4. Configure Endpoint Name and Endpoint Description fields.

  5. Configure Connection details with device details of HTTP POST Server.

    ../../_images/HTTP_connection1.png

Note

URL

  • HTTP POST Server URL with path.

Verify Host

  • Option to check Server hostname.

Verify Peer

  • Enable Server certificate verification.

Authentication Type
  • Authentication Type for Server.
    • Basic Server Basic Authentication information.

      • username: username

      • password: password

    • TLS Server TLS Authentication.

  1. configure HTTP Post proxy

    When using a proxy server to handle HTTP POST requests, specific configurations must be made to ensure successful communication. Below are detailed explanations of common proxy server fields.

    Proxy Server Configuration Fields

    1. Proxy Server

      Definition: The proxy server field specifies the hostname or IP address of the proxy server that will handle the requests.

      Usage: This field tells the client application where to send HTTP requests to be forwarded. The proxy server can be located on the local network or on the internet.

      Example: proxy.example.com or 192.168.1.100

    2. Proxy Port

      Definition: The proxy port is the network port that the proxy server listens on for incoming HTTP requests.

      Usage: The client application must use the correct port number to establish a connection with the proxy server. Commonly used ports for HTTP proxies are 8080, 3128, and 8000.

      Example: 8080

    3. Proxy Tunnel (HTTP CONNECT Method)

      Definition: The proxy tunnel field specifies whether the client application should use the HTTP CONNECT method to establish a tunnel through the proxy server.

      Usage: The HTTP CONNECT method is used to establish a secure, end-to-end connection between the client and the destination server. This is commonly used for HTTPS connections.

      Consideration: Proxy tunneling is mainly relevant when dealing with HTTPS requests, as it allows the client to establish a secure connection through an intermediate server.

    4. Authentication:

      Definition: Authentication refers to the process of verifying the identity of the client attempting to use the proxy server. This is often required to access restricted networks or to log traffic for security purposes.

      Types of Authentications:

      Basic Authentication: Involves sending a username and password with each request, encoded in Base64.

      Digest Authentication: A more secure method that uses a challenge-response mechanism to send credentials.

      NTLM/Kerberos: Used in enterprise environments for secure, single sign-on authentication.

      ../../_images/HTTP_POST_Proxy_config.png

  2. Configure Certificates section with the location of certs inside reader. The certificate path, private key path and passphrase need to be provided.

    ../../_images/HTTP_certs.png

  3. Click on Add.

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

    ../../_images/HTTP_app.png

Interface Configuration

  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. Select webhook endpoint for Management Events Interface and Tag Data Interface.

    ../../_images/HTTP_ifc.png

  4. 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.

    ../../_images/HTTP_connection_page.png

  3. Click on Connect button.

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

    ../../_images/HTTP_cs.png