Включение Kaspersky Scan Engine GUI

В некоторых случаях вам может потребоваться включить Kaspersky Scan Engine GUI, как описано ниже. Например, это может потребоваться в тех случаях, если Kaspersky Scan Engine уже установлен и GUI не включен или если вы собираетесь развернуть Kaspersky Scan Engine с помощью Docker.

Чтобы включить Kaspersky Scan Engine GUI:

1. Убедитесь, что у вас есть права администратора.
2. Выполните одно из следующих действий.
   • Если вы ранее не устанавливали экземпляр Kaspersky Scan Engine GUI или не хотите добавлять новый экземпляр в существующий кластер, выполните действия, описанные в разделе Подготовка к установке Kaspersky Scan Engine GUI.
   • Если у вас уже есть экземпляр Kaspersky Scan Engine GUI и вы хотите добавить новый экземпляр в тот же кластер, перейдите к шагу 4.
3. На компьютере, на котором установлен PostgreSQL, выполните перечисленные ниже действия от имени пользователя, который может создавать новых пользователей и базы данных. Для выполнения этих действий вы можете использовать утилиту psql или pgAdmin.

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

   1. Войдите в интерактивный терминал PostgreSQL:

      sudo -u postgres psql

   2. Создайте нового пользователя PostgreSQL с именем %username%:

      CREATE USER %username%;

   3. Задайте пароль для пользователя %username%:

      ALTER USER %username% WITH PASSWORD '%password%';

      Рекомендации по надежности пароля

      Настоятельно рекомендуется удостовериться, что пароль состоит не менее чем из 8 символов, которые включают:

      • не менее 1 буквы ASCII в нижнем регистре;
      • не менее 1 буквы ASCII в верхнем регистре;
      • не менее 1 цифры;
      • не менее 1 специального символа: !, #, $,%, &, _.
   4. Создайте базу данных под названием kavebase:

      CREATE DATABASE kavebase OWNER %username%;

   5. Выйдите из интерактивного терминала PostgreSQL:

      exit

   6. В базе данных kavebase выполните запросы, описанные в %service_dir%/samples/tables.sql.

      %service_dir% – директория, в которой находятся файлы Kaspersky Scan Engine.

      sudo -u postgres psql -d kavebase -a -f %service_dir%/samples/tables.sql

4. Создайте ключ шифрования следующим образом:

   %service_dir%/tools/openssl rand -out %service_dir%/httpsrv/kl_scanengine_db.key 512

5. Предоставьте право чтения только владельцу:

   chmod 400 %service_dir%/httpsrv/kl_scanengine_db.key

6. Откройте /etc/klScanEngineUI.xml.
7. В элементе <EnableUI> укажите true:

   <EnableUI>true</EnableUI>

8. В элементе <ConnectionString> укажите адрес веб-службы Kaspersky Scan Engine GUI в формате %IP%:%port%.

   Например:

   <ConnectionString>198.51.100.0:443</ConnectionString>

9. Укажите SSL-сертификат для установки в веб-службе Kaspersky Scan Engine GUI.
   • Если у вас уже есть SSL-сертификат, который вы хотите установить в веб-службе Kaspersky Scan Engine GUI, укажите пути к вашему сертификату и вашему закрытому ключу:
     1. В элементе <SSLCertificatePath> укажите путь к вашему сертификату SSL.
     2. В элементе <SSLPrivateKeyPath> укажите путь к вашему закрытому ключу.
   • Если у вас нет SSL-сертификата, который вы хотите установить в веб-службе Kaspersky Scan Engine GUI, сгенерируйте новый. Запустите утилиту %service_dir%/tools/openssl следующим образом:

     /opt/kaspersky/ScanEngine/tools/openssl req -x509 -nodes -days 1825 -subj /C=RU/CN="%ConnectionString%" -newkey rsa:4096 -extensions EXT -config "/opt/kaspersky/ScanEngine/tools/openssl.cnf" -keyout "/opt/kaspersky/ScanEngine/httpsrv/kl_scanengine_private.pem" -out "/opt/kaspersky/ScanEngine/httpsrv/kl_scanengine_cert.pem"

     Здесь %ConnectionString% – это значение, указанное в элементе <ConnectionString>. Рекомендуется использовать значения rsa:4096 или rsa:3072 с параметром -newkey. Минимальное поддерживаемое значение – rsa:2048.

   Обязательно требуется указать <SSLCertificatePath> и <SSLPrivateKeyPath>.

   При настройке этого параметра в таблице со служебными событиями Kaspersky Scan Engine может появиться следующее сообщение: "У вашего закрытого ключа низкий уровень безопасности. Пожалуйста, проверьте права доступа к файлу <path>." В этом случае вам требуется настроить доступ к файлу закрытого ключа и/или к папкам по всему пути к файлу ключа, чтобы только пользователь root и пользователь, на учетной записи которого запущена служба, имели право на его чтение.

10. В элементе DatabaseSettings > ConnectionString укажите адрес новой или существующей базы данных kavebase, к которой вы хотите подключиться, используя формат %IP%:%port%.
11. Сохраните и закройте /etc/klScanEngineUI.xml.
12. Зашифруйте имя пользователя и пароль пользователя, который будет использоваться для доступа к базе данных kavebase:
    • Если вы никогда раньше не устанавливали экземпляр Kaspersky Scan Engine с графическим интерфейсом пользователя или не хотите добавлять новый экземпляр в существующий кластер, зашифруйте имя и пароль пользователя, указанного на шаге 3.
    • Если у вас уже есть экземпляр Kaspersky Scan Engine с графическим интерфейсом пользователя и вы хотите добавить новый экземпляр в тот же кластер, зашифруйте имя и пароль пользователя, который используется для доступа к базе данных kavebase кластера.

    Чтобы зашифровать учетные данные, используйте утилиту kav_encrypt. Эта утилита также автоматически записывает зашифрованные имя пользователя и пароль в /etc/klScanEngineUI.xml. Утилита находится в директории %service_dir%/tools/.

    Запустите утилиту kav_encrypt со следующими параметрами:

    %service_dir%/tools/kav_encrypt -d '%username%:%password%'

13. В /etc/systemd/system/multi-user.target.wants/ создайте символьную ссылку на /opt/kaspersky/ScanEngine/etc/klScanEngineUI.service с помощью следующей команды:

    ln -s /opt/kaspersky/ScanEngine/etc/klScanEngineUI.service /etc/systemd/system/klScanEngineUI.service

14. Зарегистрируйте Kaspersky Scan Engine в системе с помощью следующих команд:

    systemctl daemon-reload

    systemctl enable klScanEngineUI

15. Запустите зарегистрированную службу Kaspersky Scan Engine:

    service klScanEngineUI start