Конфигурация модуля Платформа

Все настройки модуля хранятся в конфигурационном файле модуля appsettings.json. Конфигурационный файл может быть изменён в любом текстовом редакторе, например nano.

sudo nano /usr/lib/docsvision/platform/appsettings.json
Фрагмент конфигурационного файла appsettings.json:
{
  "DocsVision": {
    "Platform": {
      "Server": {
        "DefaultBaseName": "alias", (1)
        "LogFile": "/var/log/docsvision/dvappserver.log", (2)
        "WindowsSecurityServerName": "any.domain.com", (3)
        "Databases": {
          "alias": "CONNECTION-STRING"  (4)
        }
      }
    "SettingsService": {
      "ConnectionString": "ConnectAddress=http://settings.service.com:5200/api", (5)
      "ApiKey": "apikey-settingsservice" (6)
    },
    },
      "Workflow": {
        "ApiKey": "api-key" (7)
      }
  },
  "Groups": {
    "DocsVision Administrators": [
      "domain\\account"
    ], (8)
    "DocsVision Security Administrators": [
      "domain\\account"
    ]
  },
  "Ldap": { (9)
    "AuthType": "Basic", (10)
    "Credential": {
      "UserName": "account@domain.com", (11)
      "Password": "password" (12)
    }
  },
  "Domains": [
    "DOMAIN.COM" (13)
  ],
  "DataProtectCertificateThumbprint": "thumbprint", (14)
  "SystemUserAccount": "account@domain.com", (15)
  "SystemUserPassword": "password", (16)
  "Logging": { (17)
    "LogLevel": {
      "Default": "Error"
    }
  }
}
1 DefaultBaseName — псевдоним базы данных. Должен совпадать с псевдонимом подключаемой базы в Консоли настройки. Можно заполнить заранее, или вернуться позже, после создания из Консоли управления.
2 LogFile — путь к файлу журнала сервера. Параметр необязательный, если он не указан, действует системная настройка по умолчанию.
3 WindowsSecurityServerName — необходимо указать имя любого компьютера в текущем домене Active Directory. Используется при получении списка доступных членов домена при настройке дискреционной безопасности в Windows-клиенте, РМА и DVExplorer.
4 alias — псевдоним используемой БД, для которой задаётся строка подключения. CONNECTION-STRING — строка подключения, подробное описание строки подключения см. ниже.
5 ConnectionString — полный адрес Сервиса настроек.
6 ApiKey — API-ключ для подключения к Сервису настроек, можно оставить значение по умолчанию или изменить, главное условие, чтобы значения в конфигурации модулей Сервис настроек и Платформа были одинаковые. Адрес и API-ключ требуется указать, если планируется переходить в Консоль управления Docsvision из карточек Web-клиента и Windows-клиента.
7 ApiKey — используется для подключения серверного расширения Управление процессами. Можно оставить значение по умолчанию или изменить, главное условие, чтобы значения в конфигурации модулей Платформа и Управление процессами были одинаковые.
8 Groups — эквивалент системных групп. Указанные в группах пользователи будут обладать соответствующими правами. Обратите внимание, что в группах массив строк, а не строка.
9 Ldap — имя и пароль учётной записи, под которой процесс обращается к ActiveDirectory.
10 AuthType — тип аутентификации: Basic — аутентификация через LDAP, Oauth — аутентификация через ЕСИА или Azure.
11 UserName — логин пользователя модуля для аутентификации LDAP.
12 Password — пароль учётной записи пользователя для аутентификации LDAP в открытом или в зашифрованном виде, см. подробнее о шифровании в документации по установке системы, раздел "Защита системной учётной записи".
13 Domains — домен сервера Docsvision.
14 DataProtectCertificateThumbprint — Отпечаток закрытого ключа шифрования SHA1.
Указывается без двоеточия, например, D8602179888DC8402B393F11DCA16A3376DDF879, см. подробнее в документации по установке системы, раздел "Защита системной учётной записи".
Если шифровать пароль системной учётной записи не планируется, параметр можно удалить.
15 SystemUserAccount — имя системной учётной записи Docsvision.
Не рекомендуется авторизоваться на клиентских рабочих местах под системными учётными записями, т.к. это может привести к ошибкам в работе системы.
16 SystemUserPassword — пароль системной УЗ рекомендуется хранить в зашифрованном виде, см. подробнее в документации по установке системы, раздел "Защита системной учётной записи".
17 Logging — настройка уровня журналирования.
  • После установки на сервере необходимо настроить группы безопасности. Группы безопасности настраиваются в секции "Groups" конфигурационного файла appsettings.json.

  • Также через конфигурационный файл выполняется настройка клиентской части, см. подробнее Раздел "Настройка клиентской части".

Строка подключения к БД

Microsoft SQL

Initial Catalog=Имя-БД-Docsvision; Data Source=Полное-имя-сервера-СУБД; User ID=Имя-пользователя; Password=Пароль-пользователя;

PostgreSQL

Server=Адрес-сервера-базы-данных; Port=SQL-порт; Database=Название-БД; User ID=Имя-пользователя; Password=Пароль-пользователя;