Modifying the encrypted Add-ons Service configuration file

To modify the appsettings.json file you must first decrypt it. The installed Add-ons Service feature provides a tool for this.

About this task

During installation of the Add-ons Service, the installer encrypted its configuration file, appsettings.json. To change the file, you must decrypt it, modify it, and encrypt it again. To decrypt and encrypt the file, use the provided encryption tool while logged in as a properly authorized user.

Procedure

  1. Sign in to the machine on which you installed the Add-ons Service as one of the following users:
    • If your machine runs Linux, sign in as the user who originally ran the start.sh script.
    • If your machine runs Windows and you started the service using the start.ps1 script, sign in as the user who originally ran the script.
    • If your machine runs Windows and you installed the service using the installService.ps1 script, sign in as the Windows Local System account.
  2. From a command prompt, go to the bin\ subfolder of the folder in which the Add-on Service was installed. On a Windows machine, this location defaults to c:\Program Files\SDL\Tridion\Add-on Service\bin\.
  3. Decrypt the configuration file by running the following .NET Core command:
    dotnet AppSettingsProtector.dll unprotect -f appsettings.json
  4. Open the file for editing, and modify it as needed.
  5. Re-encrypt the file by running the following .NET Core command:
    dotnet AppSettingsProtector.dll protect -f appsettings.json