Testing Firewall Protected Apps

Relicx executes tests from cloud locations. However, if the applications being tested are not accessible over the public internet, Relicx provides support for private locations. To enable this feature, customers can install a dockerized Relicx 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.

To create a private location, click on “Tunnels” on the navigation bar and the “Create Tunnel” button on the top of the Tunnels page.

Enter the name of the Tunnel and click on save

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

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.

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