Управление интеграцией в R-Vision VM

Данный раздел содержит информацию об управлении интеграцией с Nessus в R-Vision VM. Работа осуществляется в разделах Ресурсы → Переменные и Настройки → Интеграции → Интеграции ИБ-активов веб-интерфейса R-Vision VM.

Доступные действия над интеграцией:

Добавление интеграции

Чтобы добавить интеграцию R-Vision VM с Nessus, выполните следующие действия:

  1. Создайте переменные, которые будут хранить учетные данные для подключения к Nessus. Переменные зависят от варианта подключения к Nessus — по HTTP API или SMB:

    • HTTP API

    • SMB

    1. Перейдите в раздел Ресурсы → Переменные веб-интерфейса R-Vision VM.

    2. Добавьте переменную, которая будет хранить ключ access_key пользователя системы Nessus.

      Используется тот же ключ access_key, который был сгенерирован в Nessus на этапе ее настройки.

      Для этого:

      1. Нажмите на кнопку Создать (plus). Отобразится окно создания переменной.

      2. Укажите следующие параметры переменной:

        • ID — произвольный.

        • Название — произвольное.

        • Организация — организация, в рамках которой будет работать интеграция.

        • Описание — произвольное.

        • Секрет — установите переключатель в активное положение.

        • Тип — String.

        • Значение переменной — ключ access_key, сгенерированный в Nessus на этапе ее настройки.

      3. Нажмите на кнопку Создать. Переменная будет создана и добавлена в список в разделе Ресурсы → Переменные. Система отобразит соответствующее уведомление.

    3. Аналогичным образом добавьте переменную, которая будет хранить ключ secret_key пользователя Nessus.

    1. Перейдите в раздел Ресурсы → Переменные веб-интерфейса R-Vision VM.

    2. Добавьте переменную, которая будет хранить логин пользователя системы Nessus.

      Используется логин того же пользователя, от имени которого выполнялась настройка Nessus.

      Для этого:

      1. Нажмите на кнопку Создать (plus). Отобразится окно создания переменной.

      2. Укажите следующие параметры переменной:

        • ID — произвольный.

        • Название — произвольное.

        • Организация — организация, в рамках которой будет работать интеграция.

        • Описание — произвольное.

        • Секрет — установите переключатель в активное положение.

        • Тип — String.

        • Значение переменной — логин пользователя Nessus, от имени которого выполнялась ее настройка.

      3. Нажмите на кнопку Создать. Переменная будет создана и добавлена в список в разделе Ресурсы → Переменные. Система отобразит соответствующее уведомление.

    3. Аналогичным образом добавьте переменную, которая будет хранить пароль пользователя Nessus.

  2. Перейдите в раздел Настройки → Интеграции → Интеграции ИБ-активов веб-интерфейса R-Vision VM.

  3. Нажмите на кнопку plus и выберите из выпадающего списка опцию Интеграция с Nessus. Отобразится окно создания интеграции.

  4. Выберите из выпадающего списка организацию, в которой будет работать интеграция.

    Организация должна совпадать с организацией, в которой созданы переменные для учетных данных Nessus, а также автоматизации для запуска интеграции.
  5. Введите название интеграции. Название может быть произвольным.

  6. Выберите тип подключения к Nessus:

    • SMB;

    • API.

  7. Введите адрес сервера Nessus.

    Адрес сервера следует вводить без порта и протокола: например, nessus.evo.local.
  8. Заполните параметры подключения в зависимости от его типа:

    • HTTP API

    • SMB

    1. Для проверки валидности SSL-сертификата Nessus установите переключатель SSL в активное положение.

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

    2. Выберите протокол подключения:

      • HTTP;

      • HTTPS.

    3. Если порт, по которому выполняются запросы к Nessus, отличается от 8834, укажите его номер в поле Порт.

    4. В поле AccessKey выберите переменную с access_key системы Nessus, добавленную на шаге 1.

    5. В поле SecretKey выберите переменную с secret_key системы Nessus, добавленную на шаге 1.

    1. В поле Сетевая папка укажите адрес сетевой папки, в которую Nessus выгружает отчеты в формате CSV.

    2. Если требуется импортировать отчеты как из указанной папки, так и из вложенных в нее папок, установите переключатель Импортировать из вложенных папок в активное положение.

    3. В поле Имя пользователя выберите переменную с именем пользователя Nessus, добавленную на шаге 1.

    4. В поле Пароль выберите переменную с паролем пользователя Nessus, добавленную на шаге 1.

  9. В поле Тип источника данных оставьте значение по умолчанию.

  10. В поле Группа воркеров укажите nessus_worker_group.

  11. В поле Пагинация введите максимальное количество объектов, выгружаемых системой из NATS и передаваемых в плейбук load за один раз.

    Значение поля Пагинация влияет только на количество объектов, одновременно обрабатываемых внутри системы. На количество объектов, выгружаемых из внешней системы, этот параметр не влияет.

  12. В поле Задержка отправки запросов введите интервал в секундах между повторными запросами к внешней системе, если запрос к ней завершился с ошибкой.

  13. В поле Число повторных попыток отправки данных введите максимальное количество повторных запросов к внешней системе, если запрос к ней завершился с ошибкой.

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

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

    Если установлен переключатель Игнорировать дату последнего запуска, время импорта информации об активах и уязвимостях может значительно увеличиться. Выбор этой опции предполагает импорт из Nessus всей информации независимо от того, когда интеграция запускалась в последний раз. Не рекомендуется использовать эту опцию в штатном режиме работы интеграции.
  16. Чтобы настроить расписание запуска интеграции, установите переключатель Запуск по расписанию в активное положение и выполните действия ниже.

  17. Выберите часовой пояс из выпадающего списка.

  18. Выберите формат расписания, на основании которого будет запускаться интеграция. Доступные форматы:

    • Cron-выражение;

    • Расписание.

  19. Если была выбрана опция Cron-выражение, задайте cron-выражение для запуска интеграции по расписанию.

    Указанное cron-выражение задает расписание для триггера, по которому выполняется интеграция. Вы можете ознакомиться с синтаксисом cron-выражений в разделе Работа с автоматизациями.
  20. Если была выбрана опция Расписание, выполните следующие шаги:

    1. Выберите режим запуска интеграции из выпадающего списка Запускать. Доступные режимы:

      • Каждый месяц;

      • Каждую неделю;

      • Каждый день;

      • Каждый час;

      • Каждую минуту.

    2. Если выбран режим запуска Каждый месяц, укажите следующие параметры:

      1. Интервал между запусками в месяцах.

      2. Дни месяца, в которые будет выполняться запуск, через запятую. Например: 1, 5, 10, 15, 20, 25, 30.

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

    4. Если выбран режим запуска Каждый день, Каждый час или Каждую минуту, укажите интервал между запусками в днях, часах или минутах соответственно.

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

      Доступны интервалы в 15 минут с 00:00 до 23:59.
  21. Нажмите на кнопку Добавить. Система создаст интеграцию и отобразит соответствующее уведомление. Новая интеграция отобразится в списке раздела.

Просмотр интеграции

Чтобы просмотреть настройки интеграции:

  1. Перейдите в раздел Настройки → Интеграции → Интеграции ИБ-активов веб-интерфейса R-Vision VM. Система отобразит список существующих интеграций.

  2. Нажмите на строку интеграции в списке. Система отобразит в правой части экрана карточку этой интеграции с подробной информацией о ней.

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

Карточка интеграции содержит следующие вкладки:

  • Основное — основная информация об интеграции.

  • Расширенные параметры — дополнительные параметры интеграции: правила нормализации и связывания.

  • История — история изменений интеграции.

  • Конфигурация — тип источника данных и группа воркеров интеграции, а также настройки интенсивности обработки импортируемых объектов.

Вкладка Основное

На вкладке Основное отображаются основные сведения об интеграции и элементы управления ей:

  • Кнопка Запустить (play) позволяет запустить интеграцию вручную.

  • Организация — организация, в рамках которой работает интеграция.

  • Название — название интеграции.

  • Статус — статус последнего запуска интеграции:

    • Успешно;

    • Ошибка;

    • В процессе;

    • Отменена.

  • Секция Параметры подключения:

    • Кнопка Проверить подключение (check) — позволяет проверить подключение к Nessus.

    • Статус подключения — статус подключения к Nessus.

    • Детали подключения — детальная информация о результате последней проверки подключения: например, сообщение об ошибке.

    • Тип подключения:

      • SMB;

      • API.

    • Адрес сервера — адрес сервера Nessus.

    • SSL — поле, которое показывает, выполняется ли проверка валидности SSL-сертификата Nessus, при работе через API.

    • Протокол подключения — протокол подключения по API:

      • HTTP;

      • HTTPS.

    • Порт — порт, по которому выполняется подключение к Nessus при работе через API.

    • Сетевая папка — адрес сетевой папки, в которую Nessus выгружает отчеты в формате CSV при работе через SMB.

    • Импортировать из вложенных папок — поле, которое показывает, требуется импортировать отчеты как из папки в поле Сетевая папка, так и из вложенных в нее папок, при работе через SMB.

    • Имя пользователя — имя переменной, которая хранит логин пользователя Nessus, при работе через SMB.

    • Пароль — имя переменной, которая хранит пароль пользователя Nessus, при работе через SMB.

    • AccessKey — имя переменной, которая хранит ключ access_key Nessus, при работе через API.

    • SecretKey — имя переменной, которая хранит ключ secret_key Nessus, при работе через API.

  • Секция Расписание:

    • Игнорировать дату последнего запуска — поле, которое показывает, импортируются ли только данные, изменившиеся с последнего запуска интеграции, или все данные.

    • Запуск по расписанию — определяет, происходят ли запуски интеграции по заданному расписанию.

    • Часовой пояс — часовой пояс для времени запуска интеграции.

    • Формат расписания — формат расписания для запуска интеграции. Доступные форматы:

      • Cron-выражение;

      • Расписание.

    • Cron-выражение — cron-выражение для запуска интеграции по расписанию.

      Данное поле отображается, только если в поле Формат расписания выбрана опция Cron-выражение.
      Указанное cron-выражение задает расписание для триггера, по которому выполняется интеграция. Вы можете ознакомиться с синтаксисом cron-выражений в разделе Работа с автоматизациями.
    • Запускать — режим запуска интеграции. Доступные значения:

      • Каждый месяц;

      • Каждую неделю;

      • Каждый день;

      • Каждый час;

      • Каждую минуту.

      Это и все последующие поля отображаются, только если в поле Формат расписания выбрана опция Расписание.
    • Интервал повторения — количество единиц времени между последовательными запусками интеграции.

    • Дни повторения (через запятую) — дни месяца, в которые будет выполняться запуск, через запятую. Отображается только для режима запуска Каждый месяц.

    • День недели — день недели, в который будет запускаться интеграция. Отображается только для режима запуска Каждую неделю.

    • Время запуска — время, в которое инициируется выполнение интеграции. Отображается для всех режимов запуска, кроме Каждую минуту.

      Доступны интервалы в 15 минут с 00:00 до 23:59.

Вкладка Расширенные параметры

Вкладка Расширенные параметры содержит дополнительные параметры интеграции:

  • Правила нормализации.

  • Правила связывания.

В текущей версии интеграции значения данных параметров зафиксированы.

Вкладка История

Вкладка История отображает сведения о запусках интеграции, а также об изменениях ее настроек.

Вкладка Конфигурация

Вкладка Конфигурация содержит следующие поля:

  • Тип источника данных — в текущей версии интеграции всегда имеет значение integrationNessus.

  • Группа воркеров — группа воркеров, на которой запускается интеграция — nessus_worker_group.

  • Пагинация — максимальное количество объектов, выгружаемых системой из NATS и передаваемых в плейбук load за один раз.

  • Задержка отправки запросов — интервал в секундах между повторными запросами к внешней системе, если запрос к ней завершился с ошибкой.

  • Число повторных попыток отправки данных — максимальное количество повторных запросов к внешней системе, если запрос к ней завершился с ошибкой.

Проверка подключения к Nessus

Чтобы проверить подключение к Nessus, выполните следующие действия:

  1. Перейдите в раздел Настройки → Интеграции → Интеграции ИБ-активов веб-интерфейса R-Vision VM. Система отобразит список существующих интеграций.

  2. Нажмите на строку интеграции в списке. Система отобразит в правой части экрана карточку этой интеграции с подробной информацией о ней.

  3. Нажмите на кнопку Проверить подключение (check). Система проверит подключение к Nessus и по итогам проверки заполнит следующие поля:

    • Статус подключения — статус подключения к Nessus.

    • Детали подключения — детальная информация о результате последней проверки подключения: например, сообщение об ошибке.

Изменение интеграции

Вы можете изменить интеграцию следующими способами:

Удаление интеграции

Вы можете удалить интеграцию следующими способами:

Была ли полезна эта страница?

Обратная связь