Introduction to qbee-connect¶
qbee-connect is a desktop application available for Linux, Mac OS X and Windows. After a user has authorized the application connects to qbee.io. Through the qbee.io infrastructure qbee-connect acts as a secure termination end-point for any port or any service on any of the remote devices in the system. qbee-connect maps remote ports to a defined port on localhost (127.0.0.1) on the local system. This way users can get access to remote devices independent if this is a ssh shell connection, a web server, VNC or any other application. This works across firewalls, NATs, mobile networks and complex network infrastructures because it uses the secure qbee VPN.
qbee maps remote end-point ports and services to localhost
qbee-connect maps remote ports and servcies (that do not need to be accessible from the outside) to a specified port on localhost.
This way a user can access the remote device across complex network topologies within his browser on with the specified port (e.g. localhost:65234).
This works with any application no matter if this is ssh, http, https or any other protocol.
It is possible to maintain many parallel connections at the same time.
Not all users have remote access enabled!
Remote access can be granted by any administrator for any user of qbee. This is defined in the user setting. If a user has remote access any remote access attempts will be logged thus giving an effective overview over who has been on different devices.
Please download and install qbee-connect from within your web app. The packages are available under "qbee packages".
The qbee-connect desktop application¶
After installation the user credentials have to be entered into qbee-connect. Then it securely connects to qbee.io and represents the same tree structure that is created in qbee.
Any device can be selected in the tree on the left. On the right hand side different ports can be selected that will be made available locally. In the displayed example this is ssh with port 22 and a custom port on 1880 ( This is a node-red server running on the local device).
When the connect button is pressed the connection is established. qbee-connect will map the remote ports to random ports on localhost as displayed in this image below:
For ssh the complete command can be copied. Then only the user name needs to be replaced in a terminal and then ssh can be used in a regular local terminal.
For other applications such as web applications running on a http or https server these can be called in a browser with calling localhost and the respective port such as localhost:65446 or 127.0.0.1:65446. In the example below we are connecting to a remote Node-Red instance on port 57412. This gives us full local Node-Red functionality in our browser.
Just copy the assigned port number (see copy button behind respective line) and start a web browser. Then localhost:port_numer will give you the remote web server in your local browser with full functionality
Here is another example connecting through RealVNC on port 5900 to get full bi-directional VNC access to a remote device across a firewall with the possibility to control the device with mouse and even upload files. For more information please visit the VNC use case.
qbee-connect is capable of handling a large number of concurrent connections at the same time. So it is possible to get information and access to many different web servers on many different devices. The second tab in the qbee-connect tool shows all active connections and which ports are mapped to which local port. Just connect any end-point you want to access remotely.
Each device can be separately disconnected and new device can be included from the first tab.
For security reasons we encourage you to log out of the qbee-connect application each time before you close it. Otherwise it will automatically be able to connect to your qbee instance on the next start.