● PROXY TUNNEL v1.0.0

Proxy Tunnel

Connect your internal network to Testara. Run automated tests against web applications that aren't accessible from the internet.

Download Tunnel Client
Version 1.0.0 · Python 3.8+ · Windows / macOS / Linux
Script Only (.py) Config Template
🔒

Encrypted Connection

All traffic uses WSS (TLS 1.2/1.3). No data is transmitted unencrypted.

🌐

Access Internal Apps

Test internal web apps, staging environments, and localhost services.

⚡

Auto-Reconnect

Automatic reconnection with exponential backoff if connection drops.

🛡

Tenant Isolated

Only serves requests from your organization. Host restrictions configurable.

How It Works
The tunnel creates a secure outbound WebSocket from your network to Testara cloud. Test requests are routed through the tunnel to reach internal apps.
Your Network Testara Cloud +-----------------+ +-------------------+ | Tunnel Client |--- WSS ---->| Tunnel Server | | (Python) | :443 | (WebSocket) | | | | | | | | Internal App | | Selenium Browser | | 192.168.x.x | | (Test Execution) | +-----------------+ +-------------------+
Setup Guide
Get connected in under 2 minutes. Works on any OS with Python.
1

Install Requirements

Python 3.8+ must be installed. Then install the required packages:

pip install websockets requests
⚠ On some systems use pip3 instead of pip and python3 instead of python.
2

Download & Extract

Click the Download Tunnel Client button above. Extract the ZIP:

# Windows (PowerShell)
Expand-Archive testara-tunnel.zip -DestinationPath C:\testara-tunnel
cd C:\testara-tunnel

# macOS / Linux
unzip testara-tunnel.zip -d ~/testara-tunnel
cd ~/testara-tunnel

You'll have two files: testara-tunnel.py and config.ini

3

Configure

Open config.ini in any text editor and enter your Testara credentials:

[server]
url = https://auto.testara.net

# Paste your tunnel token (generate in Settings > Tunnel Token)
token = ttr_paste-your-token-here

[tunnel]
name = dev-network
allowed_hosts = *
request_timeout = 30
⚠ Security Tip: In production, set allowed_hosts to specific IPs instead of * to restrict which internal hosts can be accessed.
4

Run the Tunnel

python testara-tunnel.py

You should see:

========================================================
  Testara Proxy Tunnel Client v1.0.0
========================================================
  Server:  https://auto.testara.net
  Email:   john@acme.com
  Tunnel:  dev-network

[AUTH] Logging in...
[AUTH] Success

[CONNECTING] https://auto.testara.net ...
[CONNECTED] Tunnel 'dev-network' active
[READY] Waiting for requests...
✓ Once connected, go to your Test Runner page in Testara. You'll see Proxy Tunnel: Connected at the top.
5

Run in Background (Optional)

# Linux / macOS
nohup python3 testara-tunnel.py > tunnel.log 2>&1 &

# Windows
start /min python testara-tunnel.py

Troubleshooting

ModuleNotFoundError: No module named 'websockets'

Required packages not installed.

Fix: pip install websockets requests

[ERROR] Cannot connect to https://auto.testara.net

Your machine can't reach the server.

Fix: Check that port 443 outbound is allowed. Try: curl https://auto.testara.net/health

[ERROR] Invalid email or password

Credentials in config.ini are wrong.

Fix: Verify login at auto.testara.net/login with the same email/password. Check for extra spaces.

[ERROR] Account blocked or locked

Too many failed login attempts (15 min lock).

Fix: Wait 15 minutes and try again, or contact your admin.

Tunnel keeps reconnecting

WebSocket dropping due to network instability or proxy.

Fix: Client auto-reconnects. Ensure WebSocket (wss://) is allowed on port 443.

Connection refused on internal app

Target app not running or wrong port.

Fix: Test from the tunnel machine: curl http://192.168.x.x:port

Host 'x.x.x.x' not in allowed_hosts

Tunnel is restricting accessible hosts.

Fix: Add the host to allowed_hosts in config.ini or set to *

Proxy Tunnel shows "Not Connected" in Testara

Client not running or connection dropped.

Fix: Check tunnel console for errors. Ensure it shows [CONNECTED]. Restart if needed.

🔒 Security

  • Encrypted: All traffic uses WSS over TLS 1.2/1.3
  • Authenticated: Requires valid Testara login credentials
  • Tenant-scoped: Only serves requests from your organization
  • Configurable: Restrict accessible hosts via allowed_hosts
  • No inbound ports: Only outbound connections from your network
  • Audit logged: All tunnel connections and requests are recorded
  • Auto-disconnect: Tunnel terminates when the client is stopped
⚠ Your config.ini contains login credentials. Store it securely and set permissions: chmod 600 config.ini