Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • <installdir>/appsettings.json

  • <installdir>/Configuration/appsettings.json

  • <installdir>/Configuration/Custom/appsettings.json

  • Environment variables

  • Command line arguments

  • <installdir>/Configuration/Custom/protectedsettings.json

Default configuration is stored in <installdir>/appsettings.json file and it is not recommended to change. Any change should be specified in <installdir>/Configuration/appsettings.json or other layers.

...

Code Block
.\AltiKare.Workflow.Agent.exe DBConnStr="Host=myserver;Database=emakin;Username=emakin;Password=mypassword;"

Encrypting Configuration Settings

By default all configuration parameters are stored in plain text json files but sensitive settings like database connection string can be encrypted if needed. Encrypted settings are stored in this path and overwrites the previous layers.

  • <installdir>/Configuration/Custom/protectedsettings.json

Note

Encrypted configuration settings can be only written and cannot be read back. If you lost this file all values are cannot be retrieved.

For example database connection string can be set with;

Code Block
.\AltiKare.Workflow.Agent.exe setconfig DbConnStr DBConnStr 'Host=myserver;Database=emakin;Username=emakin;Password=mypassword;'

After this command is executed a new protectedsettings.json file is created in ‘Configuration/Custom’ directory and stores the encrypted connection string.

Code Block
{
  "DbConnStr": "CfDJ8L..........6PT0Kw="
}

Any configuration value from <installdir>/appsettings.json file can be set with setconfig parameter and child sections can be specified with “:” qualifier.

Code Block
dotnet AltiKare.Workflow.Agent.dll setconfig Section:SubSection:Key Value