After you’ve completed installing the SmartBear SecureTunnel app, you can launch the application in one of two ways:
- Launch from the CrossBrowserTesting.com website Local Connection dialog (convenience)
- Launch the application directly by finding SmartBear SecureTunnel app in your system applications
Both the application and the website display a similar UI for starting a tunnel. The website dialog is used in the images below.
Start a new tunnel
As you can see from the image, you will choose a connection type and configuration options, described below.
This is the most basic type of tunnel for a local connection. It creates an encrypted tunnel that allows traffic and requests to be routed through the local network of your computer. This allows you to test sites that are only accessible through your local network or behind your firewall.
- Select ‘Internal Websites’ option
- Click Connect
- Run a Live Test to an internally resolved domain name http://my-internal-domain.com
- Run a Live Test using your internal IP Address: http://10.100.1.1
- Run a Live Test using the “local” keyword (“localhost” and “127.0.0.1” are not supported on all devices): http://local:3000
- Run a Screenshot Test using your internal ip address or use the keyword “local”: http://local:3000/home
Local HTML Files
This type of tunnel allows you to test static HTML files saved on your computer without being required to setup a web server.
- Select Local Html Files option
- Enter the full path to the top-level directory on your machine where the HTML files live. For example:
- Click connect
- Run a Live Test to http://local/ to get a full directory listing of your HTML folder and click on each file you want to test
- Run a screenshot to a single file, e.g., http://local/index.html
The final connection type allows you to specify a proxy server to route your traffic through during tests. This is especially useful for testing location-based content.
- Select ‘Proxy Server’ option
- Enter the IP address and Port number for the proxy server
- Click Connect
- Run a Live Test or Screenshot test to the website URL or IP address that needs to route through the proxy
There are two additional options that can be specified when starting a tunnel through the UI (Find more options with the command-line binary.)
Bypass tunnel for public URLs: Clicking this checkbox enables the tunnel to resolve publicly accessible sites without having to route through your machine– it will only attempt to resolve a domain name through your computer if it cannot resolve it publicly. This will generally speed up tests when enabled since many sites call publicly available resources.
Accept All SSL Certificates: Checking this option makes it so that all certificates are considered valid through the tunnel. This is useful for development versions of sites, which may use self-signed or invalid certificates.
Once the tunnel is connected, you will see the follow screen with details and connection status: