Modifying the encrypted Add-on Service configuration file

During installation of the Add-on 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 encryption tool included with the Add-ons feature, while logged in as a properly authorized user.

Procedure

  1. Sign in to the machine on which you installed the Add-on 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. Reencrypt the file by running the following .NET Core command:
    dotnet AppSettingsProtector.dll protect -f appsettings.json