test-suite
2021.10
false
  • Studio installation
    • Installing Studio
  • Robot installation
  • Orchestrator installation
  • Test Manager installation
    • Hardware Requirements
    • Software Requirements and Prerequisites
      • Installation steps
      • Post-installation Steps
      • Test Manager Config File Encryption
      • Test Manager Provisioning Tool
      • Silent Install
      • Test Manager deployment in Azure Marketplace
    • Upgrade
    • Backup and Restore
    • Troubleshooting
Test Suite Installation Guide
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated Jun 7, 2024

Test Manager Config File Encryption

Test Manager runs certificate-based encryption to secure the configuration files. You can manually encrypt and decrypt the config files using testmanager.exe, as part of Test Manager Provisioning Tool. You can find the tool in the default Test Manager installation location, as follows: C:\Program Files (x86)\UiPath\TestManager\Tools\TestManagerProvisioner. Alternatively, you can find it in your custom installation folder.

To start using the Test Manager Provisioning Tool to encrypt your configuration files, download and install the UiPath Test Manager installation package on your machine.

Note:
  • For Test Manager versions older than 20.10.4, you need to decrypt the configuration file using the obfuscator (deprecated) command, before encrypting it through the new method.
  • The commands are case sensitive.
  • Once encrypted, the values cannot be changed by editing the appsettings.production.json file. You need to decrypt and then re-encrypt.

Prerequisites

  • The encryption process overwrites current configurations. Ensure you back up the appsettings.production.json file before proceeding. You can find the file in C:\Program Files (x86)\UiPath\Test Manager\
  • Open the appsettings.production.json file to configure the SigningCredentialSettings. If this section is missing, you need to add it to the file. Make sure that the private key is accessible by the user that runs the Test Manager instance, either through the Application Pool Identity, or the user you have specified during installation.
    "SigningCredentialSettings": {
            "StoreLocation": {
                "Name": "66B6B5A95BD055C8A264E643F9F8B26C7BEAA841",
                "Location": "LocalMachine",
                "NameType": "Thumbprint"
            }
        }"SigningCredentialSettings": {
            "StoreLocation": {
                "Name": "66B6B5A95BD055C8A264E643F9F8B26C7BEAA841",
                "Location": "LocalMachine",
                "NameType": "Thumbprint"
            }
        }
    Name: The Thumbprint of your certificate. Keep an eye on the Name object when pasting the Thumbprint value, as it is similar to NameType and it might create confusion.
We recommend using the default values for Location and NameType.
Save the file after you have pasted the value in the SigningCredentialSettings object.

Securing Test Manager Config File

Encryptor Command Options

Parameter

Description

encrypt

Encrypts the appsettings.production.json file.

decrypt

Decrypts the appsettings.production.json file.

Encryption

To encrypt the configuration files follow this procedure:

  1. Open the Command Prompt.
  2. Open the Test Manager Provisioning Tool folder located in your Test Manager installation location.
  3. Run the following command:

    testmanager.exe encryptor encrypt "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"testmanager.exe encryptor encrypt "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"
The configuration file is now protected and stored in a newly generated file: appsettings.protected.json.

Decryption

  1. Open the Command Prompt.
  2. Open the Test Manager Provisioning Tool folder located in your Test Manager installation location.
  3. Run the following command:

    testmanager.exe encryptor decrypt "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"testmanager.exe encryptor decrypt "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"
The appsettings.protected.json file that stores the protected configuration file now has its values set to null.

Encryption for older Test Manager versions

  1. Open the Command Prompt.
  2. Open the Test Manager Provisioning Tool folder located in your Test Manager installation location.
  3. Run the following command:

    testmanager.exe obfuscator deobfuscate appsettings "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"testmanager.exe obfuscator deobfuscate appsettings "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"
After deobfuscating appsettings.production.json, you can secure Test Manager using encryption.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.