Настройка веб сервера

Эти свойства управляют поведением Встроенного веб сервера и веб приложений, работающих на нем.

Веб-приложения

Следующие свойства определяют, как встроенный веб-сервер обслуживает веб-приложения.

Включить встроенный веб-сервер

Имя переменной в конфигурационном файле: webServerEnabled

Тип значения: Boolean

Возможные значения: true or false

Значение по умолчанию: true

Определяет, включен ли встроенный веб-сервер AggreGate Server. Если он отключен, все веб-сервисы (Web UI, Web Services, etc.) будут недоступны.

Включить встроенный веб сервер

Имя переменной в конфигурационном файле: webServerEnabled

Тип значения: Boolean

Возможные значения: true или false

Значение по умолчанию: true

Определяет, включен ли интегрированный с  AggreGate Server'ом веб сервер. Если нет, то все веб-услуги (Web UI, Web Services и пр.) недоступны.

Использовать кодирование ответа в веб-сервисе

Имя переменной в конфигурационном файле: webServiceUseResponseEncoding

Тип значения: Boolean

Возможные значения: true or false

Значение по умолчанию: true

Если эта опция включена, Web Services будет использовать кодировку URL при ответе на запросы SOAP-клиентов.

Включить веб-сервис (web service)

Имя переменной в конфигурационном файле: webServiceEnabled

Тип значения: Boolean

Возможные значения: true или false

Значение по умолчанию: true

Определяет, доступен ли Web Service AggreGate Server для других приложений.

Включить незащищенный доступ к веб-приложениям

Имя переменной в конфигурационном файле: webNonSecureAccessEnabled

Тип значения: Boolean

Возможные значения: true или false

Значение по умолчанию: true

Определяет, можно ли получить доступ к веб-приложениям AggreGate Server, используя небезопасный протокол HTTP. Обычно эту опцию следует отключать, чтобы доступ осуществлялся только по защищенному HTTPS протоколу (с шифрованием на основе SSL).

Включить клиентский апплет и java web start

Имя переменной в конфигурационном файле: webAppletAndJavaWSEnabled

Тип значения: Boolean

Возможные значения: true или false

Значение по умолчанию: false

Определяет, доступны ли клиентский апплет и Java Web Start для запуска.

Тип соединения

Имя переменной в конфигурационном файле: webConnectionType

Тип значения: Integer

Возможные значения: Не разрешать удаленные соединения, Любые удаленные соединения и Только заранее заданные соединения

Значение по умолчанию: Не разрешать удаленные соединения

Опция включает и контролирует работу в режиме Автономный веб сервер.

Заранее заданные соединения

Имя переменной в конфигурационном файле: webConnectionPreconfigured

Тип значения: Data Table

Эта таблица определяет список заданных соединений, которые может устанавливать Автономный веб сервер c внешними серверами AggreGate. Таблица используется только если Тип соединения установлен на Только заранее заданные соединения.

Выражение пользовательского сообщения об ошибке подключения

Имя переменной в конфигурационном файле: webCustomErrorConnectionMessage

Тип значения: String

Выражение, которое оценивается перед отправкой сообщения об ошибке на страницу входа в систему. Таблица по умолчанию содержит одну запись с тремя полями: сообщение об ошибке (строковое поле "message"), код ошибки (целочисленное поле "code") и имя соединения (строковое поле "connectionName"). Выражение должно возвращать текст сообщения об ошибке. Если выражение не задано или выдает пустую строку, то будет использовано стандартное сообщение об ошибке.

Список алиасов имен хоста сервера, разделенных запятым

Имя переменной в конфигурационном файле: webAppsAliases

Тип значения: String

Возможные значения: Одно ли более имен хостов сети, разделенных запятой

Значение по умолчанию: "" (пустое)

Определяет имя (имена) хоста, по которым можно получить доступ к веб-приложениям AggreGate Server (Web Admin, Web Service, HTTP Proxy и пр.). Эта опция будет работать, если означенные имена хоста правильно установлены в DNS. Опцию следует настроить дополнительно во время конфигурации вашего сервера DNS.

Номер порта для приема защищенных соединений (HTTPS)

Имя переменной в конфигурационном файле: webAppsSslPort

Тип значения: Integer

Возможные значения: 1-65535

Значение по умолчанию: 8443

Определяет номер порта, по которому будет доступно приложение Web Admin. Вы можете поменять значение этой опции на 443, если нет других веб серверов, прослушивающих этот порт. 443 - это номер порта HTTPS по умолчанию. Не рекомендуется использовать 80 в качестве значения для этой опции, потому что 80 - это номер порта по умолчанию для небезопасного протокола HTTP.

Номер порта для приема незащищенных соединений (HTTP)

Имя переменной в конфигурационном файле: webAppsNonSslPort

Тип значения: Integer

Возможные значения: 1-65535

Значение по умолчанию: 8080

Определяет номер порта, по которому можно получить доступ к веб-приложениям AggreGate Server. Вы можете выставить значение этой опции в 80, если нет других веб серверов, прослушивающих этот порт. 80 - это номер порта HTTP по умолчанию.

Размер буфера чтения

Key name in the configuration file: appReadBufferSize

Тип значения: Long

Возможные значения: 1 или более

Значение по умолчанию: 8192

Каждое соединение, которое открывается веб сервером, связано с байтовым буфером чтения. Этот атрибут управляет размером данного буфера. По умолчанию буфер чтения имеет размер 8192 байта. Для снижения параллелизма вы можете увеличить размер, чтобы буферизировать больше данных. Для большого количества поддерживаемых соединений уменьшите это число или увеличьте размер кучи.

Размер буфера записи

Имя переменной в конфигурационном файле: appWriteBufferSize

Тип значения: Long

Возможные значения: 1 или более

Значение по умолчанию: 8192

Каждое соединение, которое открывается веб сервером, связано с байтовым буфером записи. Этот атрибут управляет размером данного буфера. По умолчанию буфер записи имеет размер 8192 байта. Для снижения параллелизма вы можете увеличить размер, чтобы буферизировать больше данных ответа. Для большого количества поддерживаемых соединений уменьшите этот параметр или увеличьте размер кучи. Значение по умолчанию здесь довольно низкое, вам следует его использовать, если вы не имеете дело с десятками тысяч одновременных подключений.

Максимальное количество потоков

Имя переменной в конфигурационном файле: maxThreads

Тип значения: Integer

Возможные значения: 1  или более

Значение по умолчанию: 200

Ограничивает число потоков, которые могут использоваться встроенным веб-сервером.

Включить ведение журнала доступа

Имя переменной в конфигурационном файле: accessLogEnabled

Тип значения: Boolean

Возможные значения: true or false

Значение по умолчанию: false

Активирует запись файлов журнала доступа для каждого веб-приложения, развернутого на веб-сервере.

Отключить компрессию сообщений веб сокета

Имя переменной в конфигурационном файле: webSocketCompressionDisabled

Тип значения: Boolean

Возможные значения: true or false

Значение по умолчанию: false

Если значение равно true, стандартные расширения сжатия WebSocket на сервере будут отключены.

Путь к хранилищу ключей

Имя переменной в конфигурационном файле: webAppsKeyStoreFile

Тип значения: String

Возможные значения: Любой действительный путь к папке

Значение по умолчанию: Отсутствует

Определяет файл, содержащий SSL сертификаты, которые веб сервер будет пытаться использовать.

Пароль хранилища ключей

Имя переменной в конфигурационном файле: webAppsKeyStorePassword

Тип значения: String

Возможные значения: Любая строка

Значение по умолчанию: Отсутствует

Определяет пароль для открытия файла хранилища ключей.

Пароль ключа

Имя переменной в конфигурационном файле: webAppsKeyPassword

Тип значения: String

Возможные значения: Любая строка

Значение по умолчаниюvalue: Отсутствует

Определяет пароль для открытия ключа SSL.

Режим выполнения виджетов

Имя переменной в конфигурационном файле: webAppsWidgetsMode

Тип значения: Integer

Возможные значения: 0 (виджеты будут запускаться на машине сервера) или 1 (виджеты будут запускаться на машине клиента).

Значение по умолчанию: 0

Определяет, где будут выполняться виджеты при работе с Web UI - на сервере или на устройстве-клиенте .

Настройки безопасности

Следующие свойства настраивают параметры безопасности встроенного веб-сервера.

Время жизни Access Token

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

Имя переменной в конфигурационном файле: tokenExpirationPeriod

Тип значения: Long

Возможные значения: Любой положительный отрезок времени.

Значение по умолчанию: 1 час

Время жизни Refresh Token

Определяет период времени, в течение которого токен обновления может быть использован для получения новых токенов доступа, что повышает безопасность за счет ограничения срока службы токенов обновления.

Имя переменной в конфигурационном файле: refreshTokenExpirationPeriod

Тип значения: Long

Возможные значения: Любой положительный отрезок времени.

Значение по умолчанию: 1 день

Секретный ключ

Представляет собой конфиденциальный криптографический ключ, используемый для обеспечения безопасности связи между клиентом и сервером, защиты от несанкционированного доступа и фальсификации данных.

Имя переменной в конфигурационном файле: secretKey

Тип значения: String

Возможные значения: Любая строка.

Значение по умолчанию: Генерируется случайным образом.

Сгенерировать секретный ключ

Инициирует создание нового секретного ключа, обеспечивая механизм регулярного обновления криптографических ключей и повышая общий уровень безопасности.

Имя переменной в конфигурационном файле: generateSecretKey

Тип значения: Boolean

Возможные значения: True or False.

Значение по умолчанию: True

Разрешенные значения Origin (для проверок CORS)

Указывает список доменов, которым разрешено выполнять кросс-оригинальные запросы, разделяя их запятыми, что предотвращает доступ неавторизованных доменов к конфиденциальным данным и ресурсам через кросс-оригинальный обмен ресурсами (CORS). Символ звезды (*) разрешает запросы любого происхождения.

Имя переменной в конфигурационном файле: allowedOrigins

Тип значения: String

Возможные значения: Список доменов, разделенный запятыми.

Значение по умолчанию: Null

Период проверки продолжительности жизни Access Token

Устанавливает частоту, с которой сервер проверяет статус истечения срока действия маркеров доступа, обеспечивая своевременную идентификацию и отзыв просроченных маркеров для повышения уровня безопасности.

Имя переменной в конфигурационном файле: sessionExpirationCheckPeriod

Тип значения: Long

Возможные значения: Любой положительный отрезок времени.

Значение по умолчанию: 30 секунд.