Error processing

SDK can return error codes in response result, send ErrorOccured/StateChanged events and throw SdkException.

ResponseResult

Result of the request processing by the UnifiedSDK service.

Success codes:

• None - no result, default value that never should come from the service.

• Ok - request processed successfully.

• Unlimited - current user traffic limit is unlimited.

Client side error codes:

• ConnectionTimeout - cannot connect to the service during timeout.

• Timeout - SDK service did not respond within the specified timeout interval (3 minutes).

• TransportError - transport error between client and server.

• TransportNotAuthorized - the client pipe is not authorized to connect.

Service side error codes:

• ServiceNotInitialized - service is not initialized.

• NotResponding - VPN node server is not responding.

• Error - request processing failed by any reason.

• TooManyRequests - SDK service cannot process the command because the same process is in progress or already done. From service this error occurs only for StartVpn/StartVpnSession and StopVpn requests.

• NoInternetConnection - request processing failed because it detected broken internet connection through the primary network adapter.

• InvalidUri - URI parameter has invalid format.

• BadRequest - Request contains invalid data.

Backend server error codes:

• NotAuthorized - the client passed has an invalid Auth token.

• DevicesExceed - device limit exceed.

• NotFound - backend server returned 404 error.

• Invalid - invalid data.

• Forbidden - backend server returned 403 error.

• ServerUnavailable - backend server is unavailable.

• SessionsExceed - session limit exceed.

• TrafficExceed - account traffic limit exceed.

• UnAuthorized - unauthorized response.

• InternalServerError - backend server returned 500 error.

• InvalidPurchase - something went wrong with purchase.

• UserSuspended - user activity suspended.

• BadRequest - backend server returned 400 error.

• OauthError - open authenticator error.

• InvalidResponse - invalid response from server (i. e. html instead of json).

• RequestTimeout - backend server did not respond within the specified timeout interval.

• RequestLimitExceed - backend request limit exceed.

• CarrierDisabled - carried disabled on backend.

• AuthFailed - backend authentication failed.

• InvalidDeviceId - invalid device identifier.

• FeatureNotFound - feature not found.

• UnsupportedVersion - unsupported version.

• SessionTrafficExceed - session traffic exceed.

• SessionNotFound - session not found.

• ServerNotAnswering - cannot connect to the backend server.

OperationalError

Service sends operational error codes in ErrorOccured and StateChanged events.

Success codes:

• None = 0 - no error. Occurs when service reset the last error on tunnel start.

Сommon errors:

• Broken = 181 - tunnel broken. Occurs when connected tunnel unexpectedly broked by unknown reason.

• Connect = 182 - tunnel connection failed.

• DcnBlockedBw = 191 - tunnel was broken by the server-side because traffic limit exceeded.

• StartVpnFailed = 8192 - tunnel connection failed. Details can be found in the error message.

• DisconnectedBeforeConnected = 8193 - tunnel connection failed because tunnel unexpectedly disconnected during connection without any errors.

• ConnectionTimeout = 8194 - tunnel stucked into Connecting state and aborted by timeout.

• DisconnectedAfterStart = 8195 - tunnel was connected successfully but unexpectedly disconnected during 10 sec after start without any errors.

• StoppedAfterStart = 8196 - tunnel client reported Connected but service cannot find active network adapter. Usually occurs when tunnel client crashes right after a successfully connection.

• TunnelExited = 8197 - tunnel client was unexpectedly terminated.

• PrimaryNetworkInterfaceChanged = 8198 - primary network interface changed but SDK doesn't support hot-switch between networks. We recommend to reconnect tunnel with the same credentials when this error occured.

• TrafficLeak = 8199 - traffic is leaking outside the tunnel. Occurs when routing table was changed by the third-side.

• TunnelBroken = 8200 - occurs when tunnel is connected but traffic is not going through the tunnel during 30 seconds. That means that all health check requests through the tunnel were failed with error.

• TunnelProcessStartFailed = 8201 - service cannot start tunnel client process by any reason.

• InvalidConfiguration = 8202 - error occurs when StartVpnRequest validation failed.

• InvalidTunnelNetworkIndefaceIndex = 8203 - tunnel successfully connected but SDK service cannot determine the tunnel network adapter.

• StopVpnFailed = 8204 - service cannot stop a tunnel by any reason.

• WfpSessionCreationFailed = 8205 - error occurs when SDK service cannot create Windows Filtering Platform session for tunnel traffic protection.

• ConnectionCanceled = 8206 - connection process was successfully canceled by client application request.

• NoInternetConnection = 8208 - tunnel error occurred and internet connection check failed for the primary network adapter.

• PlatformNotSupported = 8209 - selected VPN protocol is not supported for the current platform.

• ReconnectionCredentialsNotCached = 8210 - error occurs when session reconnection is initiated but credentials for it were not cached by SDK. Reconnection is supported only for usage with StartVpnSession request.

Hydra protocol errors:

• Config = 180 - Occurs when Hydra configuration is invalid.

• Internal = 183 - internal Hydra protocol error.

• ServerAuth = 184 - vpn node server reported authentication error.

• CannotSend = 185 - internal Hydra client communication issue. Occurs when traffic accumulates into the socket buffer but doesn't go out.

• TimeSkew = 186 - internal Hydra client communication issue. Can happens only when infrastructure problems occurs .

• DcnSrvSwitch = 190 - tunnel was broken by the server side reason. Can happens only when infrastructure problems occurs .

• DcnBlockedAbuse = 192 - tunnel was broken by the server side because abuse traffic detected.

• DcnBlockedMalware = 193 - tunnel was broken by the server side because malicious traffic is detected.

• DcnBlockedMisc = 194 - tunnel was broken by the server side with unknown reason.

• DcnReqByCliapp = 195 - tunnel was broken by the server side.

• DcnBlockedAuth = 196 - tunnel was broken by the server side with authentication error.

• DcnSrvFull = 197 - Hydra tunnel was stopped on the server-side when vpn node server is full.

• InvalidState = 4097 - Hydra cliend error when client cannot process tunnel state correctly.

• AccessDenied = 4098 - Hydra client permissions error.

• ComException = 4099 - Hydra client internal error.

• ComInvalidCastException = 4100 - Hydra client internal error. Occurs when internal COM calls failed by any reason.

• InvalidFireshieldConfiguration = 8207 - Hydra fireshield configuration is invalid.

Wireguard personal bridge errors:

• PersonalBridgeUnknownError = 9000 - Personal bridge intermediate server returned unknown error.

• PersonalBridgeBadRequest = 9001 - Personal bridge intermediate server returned BAD_REQUEST error.

• PersonalBridgeForbidden = 9002 - Personal bridge intermediate server returned FORBIDDEN error.

• PersonalBridgeInternalServerError = 9003 - Personal bridge intermediate server returned INTERNAL_SERVER_ERROR error.

• PersonalBridgeNextHopUnavailable = 9004 - Personal bridge intermediate server is unavailable.

• PersonalBridgeNotAnExitNode = 9005 - Personal bridge intermediate server returned NOT_AN_EXIT_NODE error.

• PersonalBridgeTooManyHops = 9006 - Personal bridge intermediate server returned TOO_MANY_HOPS error.

• PersonalBridgeHopNotAllowed = 9007 - Personal bridge intermediate server returned HOP_NOT_ALLOWED error.

• PersonalBridgeSessionNotFound = 9008 - Personal bridge intermediate server returned SESSION_NOT_FOUND error.

Exceptions

• SdkException - SDK service returned general error or transport error occured.