XW-112™ Wi-Fi Water Detector Users Manual
Web Server
Version
This field specifies the version of the remote services' protocol to use. Version 1 of the protocol sends
the connection string after successfully connecting to the remote server and then periodically per the
connection interval specified. Version 2 of the protocol sends the connection string in addition to the
MAC address, connection interval, model number and then immediately sends the state.xml file of the
device. Version 2 of the protocol requires the remote server to reply to the connection string with a 3
byte packet containing the text “ACK”. If the “ACK” is not received within 10 seconds of sending the
connection string, the XW-112 will close the connection. Version 2 continues to send the connection
string and the state.xml file periodically per the connection interval specified.
Use SSL Certificate
This option enables encryption of the remote services' connection with the remote services' server as
well as authentication of the XW-112 to the server by a client certificate and key. Custom certificates and
keys can be loaded into the XW-112 for this purpose. (See
Remote Services
at the end of this section
for more information.)
By default, the XW-112 does not come with any SSL certificates already installed. The certificates will
need to be installed either manually by uploading the files or automatically with a token. The SSL
certificates must be in the PEM format.
Certificate Request Token
When the XW-112 has a valid Certificate Request Token entered, it will automatically attempt to request
and download its Client Certificate, Key, and CA. Once successful, the token will be erased and the XW-
112 will stop its requests. (See
Remote Services
at the end of this section
for more information.)
Certificate Request Port
The certificate server is a server that has been configured to deliver the Client Certificate, Key, and CA
when requested by the XW-112. For the XW-112 to request a Certificate, Key, and CA from the
certificate server, it must have a previously issued Certificate Request Token. This field specifies what
port the Certificate Server listens on. The server is found at the same host name as the remote services
server. (See
Remote Services
at the end of this section for more information.)
Manual Certificate Upload
Client Certificate
A client certificate is used with custom remote services servers for device authentication. To upload a
custom client certificate to the XW-112, click the
Browse
button, find the PEM formatted certificate file,
and select
Submit
.
Client Key
A client key is used with custom remote services servers for device authentication. The key that is
uploaded must be the correct key associated with the Client Certificate. Care should be taken with
where this client key is stored as it is meant only to be known to the XW-112. To upload a custom client
key to the XW-112, click the
Browse
button, find the PEM formatted file, and select
Submit
.
Client CA
A CA (Certificate Authority) is used by the XW-112 to verify the authenticity of the remote services server
it is connecting to. It is important to note that this CA does not need to be the CA that signed the Client
Certificate used by the XW-112. Rather the CA needs to be the one used to sign the certificate used by
the remote services server. To upload a custom CA to the XW-112, click the
Browse
button, find the PEM
formatted file, and select
Submit
.
Remote Services Notes:
Remote Services initiates an outgoing connection to a server at a remote
location. This can be used in an environment where a web server on the Internet provides a custom web
Xytronix Research & Design, Inc.
Page 15
Summary of Contents for XW-112
Page 1: ......
