DC 5.7 Application configuration

There are 3 levels of configuration for the Importer. This section describes the application level configuration which is in effect for all hotfolder configurations. This configuration is done in the app.config which is named Importer.exe.config when running app mode and ImportService.exe.config when running service mode.

{
  "DAMCenterDetails": {
    "BaseUrl": "https://dam.company.com",
    "SystemUsername": "ImportUser",
    "SystemPassword": "fc5e038d38a57032085441e7fe7010b0"
  },
  "Service": {
    "PollRate": 10,
    "RequestTimeout": 60,
    "RequestDelay": 2,
    "RequestRetry": 3,
    "Name": "ImportService"
  },
  "Logging": {
    "LogLevel": "Information",
    "Overrides": {
      "Microsoft.EntityFrameworkCore": "Warning"
    },
    "LogDirectory": "Logs",
    "DaysToKeepLogFiles": 30
  },
  "Jaeger": {
    "Enable": false,
    "AgentHost": "localhost",
    "AgentPort": 6831
  }
}
KeyDescription
BaseUrlThe URL for the DC
UserNameThe username of the user with the right to upload and edit assets. It is a good idea, although not required to create a separate user for this instead of reusing Super Administrator or System.
Password

An MD5 hash of the password corresponding to UserName.

PollRateWhen the Importer is running as a service, this is the interval in seconds between checking if files are present in the hotfolder.
RequestTimeoutTimeout of web request in seconds. Acceptable values range from 1 to 3600. The default is 60. Added in 5.2.2 (backported to 5.1.x).
RequestDelayDelay in seconds between retries of failed web requests. Acceptable values range from 1 to 60. The default is 2. Added in 5.2.2 (backported to 5.1.x).
RequestRetryHow many times a failing web request has retried. Acceptable values range from 1 to 10. The default is 3. Added in 5.2.2 (backported to 5.1.x).

A note on passwords

It has been common practice to copy-paste passwords directly from the database, but that will not work with the new strong encryption type passwords. Here is the proper way to do it:

  1. Create a new user for the Importer purpose or reuse an existing one.
  2. Either way, make a note of the actual password.
  3. Type in that password in any MD5 tool and generate a hash.
  4. Use the MD5 hash for the Importers application config.

Examples of MD5 tools:

  1. SQL:

    How to generate an MD5 hash in SQL
    SELECT CONVERT(NVARCHAR(255), HashBytes('MD5', 'password'), 2)
  2. Notepad++