1. Откройте веб-интерфейс KSMG и авторизуйтесь с учетной записью администратора.

2. Перейдите в раздел Учетные записи и роли и выберите вкладку Роли.

3. Нажмите Создать.

4. Укажите название роли и установите флажки:
   • Просматривать правила.
   • Создавать/изменять правила.

5. Нажмите Создать.

6. Выберите вкладку Учетные записи и нажмите Создать.

7. Создайте новую учетную запись:
   • Тип: выберите любой при наличии соответствующей интеграции.
   • Укажите имя учетной записи и задайте пароль.
   • В раскрывающемся списке выберите роль, созданную на шаге 5.

8. Нажмите Создать.

9. Перейдите в раздел Правила и нажмите Создать.

10. Настройте новое правило:
    • Включите правило.
    • Введите уникальное название для правила.
    • Выберите режим Отклонять без проверки.

11. Откройте раздел Отправители и получатели.

12. В блоке Отправитель нажмите Добавить.

13. Укажите заведомо вредоносный или несуществующий адрес отправителя.

14. В блоке Получатель нажмите Добавить.

15. Укажите *, чтобы выбрать всех получателей и нажмите Сохранить.

16. Нажмите на название созданного правила и скопируйте значение ID правила.

1. Скачайте и распакуйте архив с утилитой для интеграции.

2. Откройте веб-интерфейс KUMA и перейдите в раздел Ресурсы → Активные сервисы.

3. Установите флажок напротив сервиса с типом Коррелятор и нажмите → Копировать идентификатор.

4. Разместите утилиту ksmg-rule-update на сервере коррелятора KUMA в директорию:
   /opt/kaspersky/kuma/correlator/<идентификатор коррелятора>/scripts/

5. Подключитесь с помощью SSH к серверу коррелятора KUMA, на котором вы разместили файл, и перейдите в директорию:
   cd /opt/kaspersky/kuma/correlator/<идентификатор коррелятора>/scripts/

6. Создайте в директории файл конфигурации ksmg.conf.

7. Задайте владельцем файла утилиты и файла конфигурации пользователя kuma:kuma с помощью команды:
   chown kuma:kuma ksmg-rule-update ksmg.conf

8. Задайте права с уровнем 600 для файла ksmg.conf с помощью команды:
   chmod 600 ksmg.conf

9. Заполните файл конфигурации ksmg.conf:
   1. [ksmg]:
      • host: укажите IP-адрес или FQDN KSMG (обязательно для учетной записи с типом NTLM или Kerberos);
      • auth_type: укажите local, ntlm или kerberos.
   2. [local] (заполняется при соответствующем auth_type = local):
      • username: имя учетной записи;
      • password: пароль учетной записи.

      Пример заполнения файла конфигурации с [local]

      [ksmg]
      host = ksmg.abc.lab
      auth_type = local
      
      [local]
      username = api-user
      password = secret

   3. [ntlm] (заполняется только при соответствующем auth_type = ntlm):
      • username: имя учетной записи;
      • password: пароль учетной записи.

      Пример заполнения файла конфигурации с [ntlm]

      [ksmg]
      host = ksmg.abc.lab
      auth_type = ntlm
      
      [ntlm]
      username = ABC\api-user
      password = secret

   4. [kerberos] (заполняется только при соответствующем auth_type = kerberos):
      • keytab: полный путь к keytab-файлу пользователя;
      • principal: уникальный идентификатор участника в домене Kerberos.
      Примечания по работе с Kerberos:
      

      • Пользователь kuma должен обладать правом на чтение keytab-файла.
      • Допускается размещение Keytab-файла в той же директории, где расположены утилита и файл конфигурации.
      • Файл /etc/krb5.conf должен содержать соответствующие реалмы (realms) и домены.

      Пример заполнения файла конфигурации с [kerberos]

      [ksmg]
      host = ksmg.abc.lab
      auth_type = kerberos
      
      [kerberos]
      principal = HTTP/web.abc.lab@ABC.LAB
      keytab = /opt/kaspersky/kuma/correlator/<id>/scripts/api-user.keytab

      Пример заполнения файла /etc/krb5.conf

      [libdefaults]
      default_realm = ABC.LAB
      
      [realms]
      ABC.LAB = {
      kdc = dc-01.abc.lab
      admin_server = dc-01.abc.lab
      }
      
      [domain_realm]
      .abc.lab = ABC.LAB
      abc.lab = ABC.LAB

10. Проверьте работу утилиты с помощью команды:
    ./ksmg-rule-update --id <идентификатор правила KSMG> --action add --email test@from.shell --config /opt/kaspersky/kuma/correlator/<идентификатор коррелятора KUMA>/scripts/ksmg.conf

    В случае успешного запуска утилиты вы увидите строку: {"data":"success"}.

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

1. Откройте веб-интерфейс KUMA и перейдите в раздел Ресурсы → Правила реагирования.

2. Нажмите Создать.

3. Настройте новое правило реагирования:
   1. Укажите название правила: KSMG Rule Update.
   2. В раскрывающемся списке выберите тенант.
   3. В раскрывающемся списке выберите тип: Запуск скрипта.
   4. Укажите название скрипта: ksmg-rule-update.
   5. Укажите аргументы скрипта:
      --id <идентификатор правила KSMG> --action add --email {{.DestinationUserName}} --config /opt/kaspersky/kuma/correlator/<идентификатор коррелятора KUMA>/scripts/ksmg.conf
   6. 

4. Перейдите к блоку Параметры фильтра и нажмите Код.

5. Укажите значение фильтра:
   Name = 'KSMG_TEST_RESPONSE'

6. Нажмите Создать.

7. Перейдите в раздел Ресурсы → Активные сервисы.

8. Нажмите на название сервиса коррелятора для перехода в режим редактирования.

9. Откройте раздел Реагирование и нажмите Добавить правило реагирования.

10. В раскрывающемся списке выберите созданное правило реагирования и нажмите Сохранить.

11. Установите флажок напротив сервиса коррелятора и нажмите Обновить параметры.