Skip to main content
Version: v23.0

DxConnect-iOS Admin Guide


DxConnect-iOS allows the user to create direct secure connections (tunnels) between a remote mobile client and one or more servers running DxEnterprise or DxOdyssey without the need for a VPN, expensive hardware, or data passing through a vendor portal. DxConnect-iOS transfers encrypted packages across system-assigned UDP ports so there is no need to open a TCP or UDP port to the internet. With DxConnect-iOS, data transfers securely between custom-designed tunnels. DH2i’s DxConnect-iOS uses a highly available proprietary cloud MatchMaking Service to keep connections alive, but no payload data is passed through the matchmaker – all data is directly encrypted between servers.

In DxEnterprise or DxOdyssey create the tunnels and assign a client to the tunnel. Then export the client configuration to a *.dh2i file for use with DxConnect-iOS. For more information on creating tunnels in either DxEnterprise or DxConnect consult the appropriate admin guide.

DH2i Tunneling features

Configuration and Management Simplicity

  • Lightweight Windows or Linux install
  • Simply install and connect
  • No dedicated VPN routers
  • No ACLs, no firewall rules
  • No expensive cloud VPN services

Highest Level Security and Performance

  • Application-level micro-tunneling
  • Discreetly transports TCP payloads via UDP
  • Eliminates lateral network attack surface
  • Highly available, auto self-healing tunnels
  • Invisible to port scanners

Minimum System Requirements

The following sections describe hardware and software requirements for DxConnect-IoT.

Supported Hardware

DxConnect-iOS is hardware-agnostic, and uses minimal system resources. Please follow operating system and application best practices to achieve performance expectations.

Supported Operating Systems

  • Apple iPhone OS version 11.0 and greater

Network Configuration Guidelines

DxConnect-iOS uses a proprietary communications protocol based on TCP and UDP for its gateway group communication.


DxConnect-iOS software requires internet access to register with the DH2i MatchMaking Service.

Installing and Configuring DxConnect-iOS

Using the device’s web browser, go to the DH2i Mobile Downloads page. Choose the DxConnect Download link and download the app for the device.

Client portal to download DxConnect-iOS

The first time DxConnect-iOS is run the following warning is displayed:

Untrusted Enterprise developer warning

Change the settings to trust DH2i.

Apps from developer window

Go to Settings -> General -> Device Management -> DH2i Company

Device management

Click on Trust DH2i Company

Window to select Trust to trust the app

DxConnect-iOS Main Page

DxConnect is laid out with a menu bar and a detail screen. On first login DxConnect will display two icons in the menu bar. The first icon on the left is the DH2i logo – this is the icon the user should click to hide the connect to gateway parameters. The second icon looks like a gear – this is the settings icon.

This initial page shows the user the version of DxConnect and the version of the OS.

DxConnect first page showing version and os

  • Config file - This is the client configuration file that is exported from the Client and Group Manager in either DxEnterprise or DxOdyssey. The config file contains the connection parameters required to negotiate the connection between the local phone and the gateway.

  • Config - Clicking on the Config button will display a file browser to allow the user to select an existing imported file or browse for one on the phone or iCloud. Choosing one of these files will populate the config file field. The name of the config file needs to have a *.dh2i file extension.

    Browse to config file window.

  • Username - The configured client name.

  • Passkey - The passkey assigned to the client.

  • Connect - Attempts to connect to a gateway with the given credentials.

  • Stop - When connected to a gateway, clicking the stop button will disconnect.

After successfully connecting, the main screen will display the connected user and the state of connection. If there are available tunnels, the tunnel information will be displayed as well.

DxConnect connected.

  • Tunnel - The name of the configured tunnel.

  • Listener - The IP address and port that the client uses to connect to the application assigned to that tunnel.

Menu Bar

The menu bar is located in the top section of the page. The icons are monochrome on a white background.

Connect to gateway icon. Connect to Gateway - When on the main page this button displays or hides the connection parameters.

Settings icon. Settings - General settings page.

Home icon. Home - The home icon is available on all pages except the main page. When the home icon is selected it returns to the main page.

General Settings

The General Settings page contains options to configure device wide settings for DxConnect. This page can be accessed in DxConnect by clicking the settings icon.

General settings window.


The first section of the general settings page contains details about the installed version of DxConnect. It also has a link to the DH2i website where visitors can explore other programs and apps offered by DH2i as well as KB articles and detailed documentation.


  • View Logs - View collected logs including gateway connections, failed connections and tunnel state changes as well as any errors encountered while running.
  • Settings File -View the settings file to see what the default config file is and a time stamp of usernames which have successfully connected from the current device.
  • Clear Logs - Clears the logs immediately.
  • Reset App - Immediately clears the logs, the setting file, and gateway connection history. This will essentially reset the app to a state of first use.
  • Heartbeat Interval - This is set to send a keep alive ping as often as every 5 seconds or to wait as long as 360 seconds. The default is 45 seconds and should only be changed if the connection is timing out too quickly or consuming too much resources.


  • Download Latest DxConnect - Click on link to download the latest version from the DH2i Client Portal.

  • Email Support - Click on link to send a message to which contains the log file.