You can obtain the current connection status of your VPN Client using the status endpoint. The example below shows you what that request should look like.
curl --request GET \
An example of a possible connection status response is given below. In this example the status is idle.
There is a status WebSocket connection available at
wss://localhost:9250/. The status will be posted to each connected WebSocket client each time it changes. For example, the IXON Cloud uses a WebSocket connection to keep its status synchronized with the VPN Client.
Examples of the status object can be found in the example above. The status object returned by the
/status endpoint and the WebSocket connection are the same, the only difference is that the WebSocket will push a new status object each time it changes (push), whereas the
/status endpoint has to be queried manually (pull).
curl --request GET \
--url 'https://localhost:9250/' \
--header "Connection: Upgrade" \
--header "Upgrade: websocket" \
--header "Sec-WebSocket-Key: GUID" \
--header "Sec-WebSocket-Version: 13"
The status object format is subject to change and still in active development. As such, a complete list of every status code has been omitted as such a list would quickly become out of date. Nonetheless, the status codes can be categorized as follows:
|Operation status unknown
openvpn.connection may have this status when the VPN Client is still retrieving the OpenVPN configuration in the
|Operation is not applicable
stunnel.connection may have this status when Stealth Mode has not been enabled.
|Operation is pending
openvpn.connection may have this status when it is currently setting up a connection
|Operation completed succesfully
ixapi.discovery may have this status after the Discovery has been successfully retrieved.
|Operation is active
openvpn.connection may have this status when the OpenVPN connection is active. 004 is comparable with 003, with the only difference being that 004 is used for scenarios when an operation is successfully active rather than has been successfully completed.
|Operation completed with an unknown error
|Used as a generic error message when a more detailed error is not available.
|IXapi Discovery related errors.
|IXapi Agent Information related errors.
|IXapi VPN Configuration related errors.
|Proxy related errors.
|Stunnel related errors.
|OpenVPN related errors.
|Routes (LAN) related errors.
|Routes (Subnet) related errors.
Updated over 1 year ago