Обязательные настройки конфигурации приложения

При развертывании в ОС LINUX обязательные настройки добавляются автоматически в файл конфигурации appsettings.Production.json.

• Настройки аутентификации Authentication
• Хостинг приложений ASP.NET Core Kestrel
• Библиотека для логирования в приложениях .NET Serilog
• Настройки СУБД SqlClient
• Настройки пути для реверс прокси ServiceSettings
• Настройки SQL кэша SqlCache
• Настройки NoSQL кэша NoSqlCache
• Настройки SessionStorage для кэша SessionStorage

Настройки аутентификации Authentication

С версии 24.2.254.521 добавилась обязательная настройка Authentication. Подробнее с настройкой можно ознакомиться в статье «Обязательная конфигурация аутентификации в appsettings.Production.json».

appsettings.Production.json

  "Authentication": {
    "AuthenticationMethod": "1",
    "BuiltInJwtBearer":{
      "SecurityKey": ""
    }
  },

Наименование	Описание
AuthenticationMethod	Метод аутентификации: • 0 - DBMS (по старому); • 1 - BuiltInJwtBearer; • 2 - SingleUserJwtBearer; • 3 - OpenIdConnect.
BuiltInJwtBearer	Настройки встроенного генератора JWT. SecurityKey - Ключ для симметричного алгоритма.

Хостинг приложений ASP.NET Core Kestrel

appsettings.Production.json

  "Kestrel": {
    "EndPoints": {
      "Http": {
        "Url": "http://0.0.0.0:<порт_приложения>"
      }
    },
    "MaxRequestBodySize": {
      "MaxRequestBodySize": 104857600
    }
  },

Наименование	Описание
Url	0.0.0.0 - приложение будет доступно на всех сетевых интерфейсах машины; <порт_приложения> - замените значение на порт вашего программного комплекса.
MaxRequestBodySize	Максимальный размер тела запроса, принимаемый сервером (в байтах). Полезно для предотвращения перегрузки сервера слищком большими запросами.

Библиотека для логирования в приложениях .NET Serilog

Конфигурация настраивает минимальный уровень логирования и указывает, куда записывать логи.

appsettings.Production.json

  "Serilog": {
    "MinimumLevel": {
      "Default": "Warning",
      "Override": {
        "Microsoft": "Warning",
        "Microsoft.Hosting.Lifetime": "Warning",
        "Microsoft.EntityFrameworkCore.Database.Command": "Warning"
      }
    },
    "WriteTo": [
      {
        "Name": "File",
        "Args": {
          "path": "./logs/log-.txt",
          "rollingInterval": "Day"
        }
      }
    ]
  },

Наименование	Описание
Default	Определяет уровень логирования по умолчанию для всех логов. Warning - записываются сообщения уровня WARN и выше (WARN, ERROR, FATAL).
Override	Настройка уровня логирования для отдельных компонентов приожения. • Microsoft - уровень логирования для всех логов, относящихся к Microsoft; • Microsoft.Hosting.Lifetime - логирование жизненного цикла хостинга Microsoft; • Microsoft.EntityFrameworkCore.Database.Command - регистрация инструкций SQL.
WriteTo	Определяет, куда будут записаны логи приложения. Name - имя объекта, указывающее на тип записи. В примере запись будет происходить в файловую систему. Args - аргументы настройки записи логов: • path - путь к файлу лога (- будет заменён на дату, например log-2025-10-12.txt) • rollingInterval - интервал для ротации файлов логов. Day - каждый день создаётся новый файл лога.

Настройки СУБД SqlClient

appsettings.Production.json

  "SqlClient": {
    "DataSourceType": "",
    "Server": "",
    "DataBase": ""
  },

Наименование	Описание
DataSourceType	Тип источника СУБД. • 0 - MSSQL; • 3 - PostgreSQL.
Server	Имя сервера.
DataBase	Имя базы данных.

Настройки пути для реверс прокси ServiceSettings

appsettings.Production.json

  "ServiceSettings": {
    "PathBase": ""
  },

Наименование	Описание
PathBase	Виртуальный каталог веб-приложения.

Настройки SQL кэша SqlCache

appsettings.Production.json

  "SystemSettings": {
    "SqlCache": "Data Source Type=SQLite; Data Source=/var/www/html/wsks_@kestrel_port@/temp/db/wrk.db3", 
    ...
  }

Наименование	Описание
Data Source Type	Тип источника данных.
Data Source	Источник данных.

Настройки NoSQL кэша NoSqlCache

appsettings.Production.json

  "SystemSettings": {
    "NoSqlCache": "memory", 
  }

Настройки SessionStorage для кэша SessionStorage

appsettings.Production.json

  "SystemSettings": {
    "SessionStorage": "sql", 
    ...
  }