Настройка веб сервера
Эти свойства управляют поведением Встроенного веб сервера и веб приложений, работающих на нем.
Веб-приложения
Следующие свойства определяют, как встроенный веб-сервер обслуживает веб-приложения.
Включить встроенный веб-сервер
Имя переменной в конфигурационном файле: webServerEnabled
Тип значения: Boolean
Возможные значения: true or false
Значение по умолчанию: true
Определяет, включен ли встроенный веб-сервер SberMobile Server. Если он отключен, все веб-сервисы (Web UI, Web Services, etc.) будут недоступны.
Включить встроенный веб сервер
Имя переменной в конфигурационном файле: webServerEnabled
Тип значения: Boolean
Возможные значения: true или false
Значение по умолчанию: true
Определяет, включен ли интегрированный с SberMobile Server'ом веб сервер. Если нет, то все веб-услуги (Web UI, Web Services и пр.) недоступны.
Использовать кодирование ответа в веб-сервисе
Имя переменной в конфигурационном файле: webServiceUseResponseEncoding
Тип значения: Boolean
Возможные значения: true or false
Значение по умолчанию: true
Если эта опция включена, Web Services будет использовать кодировку URL при ответе на запросы SOAP-клиентов.
Включить веб-сервис (web service)
Имя переменной в конфигурационном файле: webServiceEnabled
Тип значения: Boolean
Возможные значения: true или false
Значение по умолчанию: true
Определяет, доступен ли Web Service SberMobile Server для других приложений.
Включить незащищенный доступ к веб-приложениям
Имя переменной в конфигурационном файле: webNonSecureAccessEnabled
Тип значения: Boolean
Возможные значения: true или false
Значение по умолчанию: true
Определяет, можно ли получить доступ к веб-приложениям SberMobile Server, используя небезопасный протокол HTTP. Обычно эту опцию следует отключать, чтобы доступ осуществлялся только по защищенному HTTPS протоколу (с шифрованием на основе SSL).
Включить клиентский апплет и java web start
Имя переменной в конфигурационном файле: webAppletAndJavaWSEnabled
Тип значения: Boolean
Возможные значения: true или false
Значение по умолчанию: false
Определяет, доступны ли клиентский апплет и Java Web Start для запуска.
Тип соединения
Имя переменной в конфигурационном файле: webConnectionType
Тип значения: Integer
Возможные значения: Не разрешать удаленные соединения, Любые удаленные соединения и Только заранее заданные соединения
Значение по умолчанию: Не разрешать удаленные соединения
Опция включает и контролирует работу в режиме Автономный веб сервер.
Заранее заданные соединения
Имя переменной в конфигурационном файле: webConnectionPreconfigured
Тип значения: Data Table
Эта таблица определяет список заданных соединений, которые может устанавливать Автономный веб сервер c внешними серверами SberMobile. Таблица используется только если Тип соединения установлен на Только заранее заданные соединения.
Выражение пользовательского сообщения об ошибке подключения
Имя переменной в конфигурационном файле: webCustomErrorConnectionMessage
Тип значения: String
Выражение, которое оценивается перед отправкой сообщения об ошибке на страницу входа в систему. Таблица по умолчанию содержит одну запись с тремя полями: сообщение об ошибке (строковое поле "message"), код ошибки (целочисленное поле "code") и имя соединения (строковое поле "connectionName"). Выражение должно возвращать текст сообщения об ошибке. Если выражение не задано или выдает пустую строку, то будет использовано стандартное сообщение об ошибке.
Список алиасов имен хоста сервера, разделенных запятым
Имя переменной в конфигурационном файле: webAppsAliases
Тип значения: String
Возможные значения: Одно ли более имен хостов сети, разделенных запятой
Значение по умолчанию: ""
(пустое)
Определяет имя (имена) хоста, по которым можно получить доступ к веб-приложениям SberMobile 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
Определяет номер порта, по которому можно получить доступ к веб-приложениям SberMobile 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 секунд.