UFT Developer launchAut method not workin

  • KM03636484
  • 27-Apr-2020
  • 27-Apr-2020

This document has not been formally reviewed for accuracy and is provided "as is" for your convenience.


How to launch a desktop application using launchAUT using different parameter combinations. To used this capability, you must create an application whitelist file


When using the lauchAut method to Run an application with UFT developer 
IAut mfc = Desktop.LaunchAut("C:\\Windows\\System32\\calc.exe");
Without the proper configuration the use of this method will result in the following error message
 Test method UFT_dev_test.UftDeveloperTest.TestMethod1 threw exception: 
    HP.LFT.SDK.GeneralLeanFtException: AUT launch is not allowed. Verify that the AUT is configured in autConfig.json. fileName=C:\Windows\System32\calc.exe, args=[undefined], workingDirectory=undefined



You can write test code to launch a desktop application using the launchAut() method. This method is available in all UFT Developer SDKs (.NET, Java, and JavaScript).

But for security reasons, in order to launch an application using this method, you must add the application and the format in which you are running it to a whitelist file.
If this is your first time using the launchAut() method, you need to create the whitelist file. If you have already created the file, add the new applications to the file. In either case.
▪ Note: You must restart


Create a file called autConfig.json in the following location:
File Format
Platform File localtion
Windows %localappdata%\LeanFT\config\
Mac ~/Library/Application Support/LeanFT/config
Linux ~/.leanft/config

The file is in JSON format and its supported objects are 

Includes the applications that you want to launch using the launchAut() method.
If you want to launch the same application in different ways, make sure to add an entry for each way.
The application name. You can specify the name
only, with or without the extension, the relative path or
the full path.
An array of arguments. For example, command line
The current working directory of the application.
The following is an example of an autConfig.json file. It demonstrates different ways for
specifying a desktop application.
     "allowedAuts": [
              "fileName": "C:\\Windows\\System32\\calc.exe"
              "fileName": "mspaint.exe"
              "fileName": "mspaint",
              "args": ["C:\\devTools\\img\\2.png"]
              "fileName": "mspaint",
              "args": ["1.png"],
              "workingDirectory": "C:\\devTools\\img"
This file corresponds to the following launchAut() implementations:
Aut calc = Desktop.launchAut("C:\\Windows\\System32\\calc.exe");
Aut mspaint1 = Desktop.launchAut("mspaint.exe");
Aut mspaint2 = Desktop.launchAut("mspaint", "C:\\devTools\\img\\2.png");
Aut mspaint3 = Desktop.launchAut("mspaint", new String[] {"1.png"},
Aditional Information
You can find launchAut() code samples here:
• .NET: Launch AUT code samples
• Java: Launch AUT code samples
• JavaScript: Launch AUT code samples