ADDITIONAL RESOURCES

Tunnels

3min

Relicx executes tests from cloud locations. However, if the applications being tested are not accessible over the public internet, Relicx provides support for firewall protected apps. To enable this feature, customers can install a dockerized AI QA Assistant agent (based on the Open Source Chisel project) within their network. This creates a secure outbound connection to the Relicx cloud endpoint (proxy.relicx.ai). The connection is established through a TCP tunnel that is transported over HTTPS and runs a socks proxy server, which is locally exposed via a reverse port forward. Each agent/location has a unique set of credentials generated for authentication purposes, which allows the Relicx test execution service in the cloud to access the private location securely. The agent is automatically disconnected when the private location is deleted.

Creating and installing a Tunnel

To create a private location, click on โ€œTunnelsโ€ on the navigation bar and the โ€œCreate Tunnelโ€ button on the top of the Tunnels page.

Document image
๏ปฟ

Enter the name of the Tunnel and click on save

๏ปฟ

Document image
๏ปฟ

Once the Tunnel is saved, you will be prompted to copy the docker command or download it as a script.

๏ปฟ

Document image
๏ปฟ

Copy this command and execute it on a Terminal window to initiate the container. Docker will download the image from the repository and run this container. Make sure to run this command on a machine that can communicate to the internet ( i.e. Relicx Cloud) and is also not shutdown frequently. The connection will be lost once container is shutdown or it is no longer running.

Document image
๏ปฟ

Once the container is running, you can refresh the Tunnels page and see the green status icon next to it.

Document image
๏ปฟ

Watch a video demo of Tunnels

๏ปฟ

๏ปฟ

Updated 12 Nov 2024
Doc contributor
Did this page help you?