Page tree
Skip to end of metadata
Go to start of metadata

Last updated: Dec 09, 2019 15:28

This section describes common error messages and possible solutions.

Perfecto Connect network requirements

The Perfecto Connect executable requires outgoing network access to the following URL. Add them to your system's security whitelist (may require assistance from your IT personnel):

  • vpn.<lab-name>*
  • <lab-name> -


    <lab-name> is the "name" of your Perfecto Lab. For example if you connect to the Perfecto Lab at, then the <lab-name> is mytest and you should add the URLs:  and vpn.mytest* to your network's whitelist.

On this page:

Error messages

Error MessageMeaningWhat to do
Proxy requires authenticationYour machine is behind an authenticated proxy, and Perfecto Connect requires your credentials in order to continue.Proxy credentials can be supplied using the outgoingproxyusername and outgoingproxypassword parameters.
Can't reach Perfecto Connect service at https://<lab_name>.connect.perfectomobile.comThe Perfecto Connect executable was unable to communicate with the Perfecto Connect service.Verify network access to the URL provided. See what to whitelist.
Can't start Perfecto Connection session: Failed to create a new session, authentication failed using ClientAuthentication

Either -

  • The wrong Perfecto Lab URL was supplied
  • The security-token used was rejected.
Verify that the Perfecto Lab URL is correct and/or generate a new security token.
Connectivity test failed to Perfecto node server vpn.demo.perfectomobile.comPerfecto Connect unable to access the described host on port 443.Verify outgoing network access to this host on port 443
Can't start ssh on tunnel to port <port> - <URL>Perfecto Connect utilizes several STunnel servers to connect your client to the service. One of these tunnels is being blocked by your network security.Add the STunnel address to your network's white-list. To see how see below.

Failed to connect to at least one node

Perfecto Connect was unable to initiate any connection to the Perfecto Connect nodes.Please contact Perfecto support.
Failed to execute command wifi.settings set: setWifiSettings command failedPerfecto Connect was unable to prepare the device for the session.Please contact Perfecto support.
tunnelId=<tunnelId> not existsWill appear during the Automation Script execution - the value in the tunnelId capability does not point to a valid STunnel connection.

Verify that the value of the capability corresponds to the tunnel that was opened.

Try reconnecting the client to obtain a new tunnel id and update the capability value appropriately.

Failed to activate tunnel - tunnelId=<tunnelId> not opened for this Perfecto Lab
The tunnel identified by the capability is connected to a different Perfecto Lab from the one identified in the automation driver initialization URL.

Verify that the URL of the automation script is the same as the one used when running the Perfecto Connect client.

Rerun the client on the correct Perfecto Lab and use the new tunnel identifier.

Failed to activate tunnel - tunnel is not connected - please rerun the clientThe client is running but failed to connect to specific regions.

Rerun the client on the Perfecto Lab and use the new tunnel identifier.

If problem persists, contact Perfecto support.

Troubleshoot access to local apps or data

When accessing resources from the user's workstation from an iOS device use the IP address of the workstation, not "localhost" - iOS interprets addresses at localhost to refer to information on the device, rather than on the hosting machine

White-list the STunnel Addresses

Start the Perfecto Connect client in the foreground (with the -f flag set):

macosx:/usr/local/etc/perfecto$ ./perfectoconnect start -c -s eyJhbGciOiJSUz...DxAkAuw82Hao7qrA -f

The client outputs the different process steps to the console, including steps in the following format:

11:11:38.340 launchTunnels ▶ DEBUG 003 Starting up channel on <port> [<address>]

Make sure to add the <address> included in the line to your network's white list.

Note: There may be more than one tunnel to add to the network white-list.