Subject-Store Method - Diagnostics Service and Diagnostics Console - Foundation 23.1 - Foundation 23.1 - Ready - OnBase - external

Diagnostics Service and Diagnostics Console

Diagnostics Service and Diagnostics Console
Foundation 23.1

The Subject-Store method requires installing the certificate to the local machine and referencing the name, store, and location in the appsettings.json file. To configure remote access using HTTPS and the Subject-Store method for the SSL Certificate:

  1. Locate the appsettings.json file. In a default installation, this file is located at C:\Program Files (x86)\Hyland\Services\Diagnostics.
  2. Open the configuration file in a plain-text editor, such as Notepad.

    The *.config file should only be edited in a plain-text editor, such as Notepad, or a utility specifically designed to edit XML files. It should not be edited in a binary editor, such as Microsoft Word. Using a binary editor can introduce invalid characters to the file and make it unreadable by the software.

  3. Locate the "Urls" element.
  4. To enable remote access, set the element to ""
  5. On the next line, add the following:
    1. "Certificates": {

      "Subject": "<subject; required>",

      "Store": "<certificate store; required>",

      "Location": "<location; defaults to CurrentUser>",

      "AllowInvalid": "<true or false; defaults to false>"


  6. Replace "<subject; required>" with the subject name of the certificate in quotation marks (").
  7. Replace "<certificate store; required>" with the name of the certificate store contained in quotation marks (").
  8. Replace "<location; defaults to CurrentUser>" with the store location to load the certificate from in quotation marks (").
  9. Replace "<true or false; defaults to false>" with either "true" or "false" as desired. If set to "true", invalid certificates such as self-signed certificates are considered.
  10. Save and close the configuration file.
  11. Restart the Diagnostics Service for the changes to take effect.

Each remote Diagnostics Service you need to collect data from must be enabled for remote access.