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

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

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

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

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

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

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

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

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

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

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

    Используется логин того же пользователя, который был добавлен в Active Directory на этапе ее настройки.

    Для этого:

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

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

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

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

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

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

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

      • Тип — String.

      • Значение переменной — логин пользователя Active Directory, добавленного на этапе ее настройки.

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

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

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

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

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

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

  7. Введите название интеграции. Название может быть произвольным.

  8. Введите адрес LDAP-сервера, на котором запущена служба Active Directory.

  9. В поле Логин выберите переменную с логином пользователя Active Directory, добавленную на шаге 2.

  10. В поле Пароль выберите переменную с паролем пользователя Active Directory, добавленную на шаге 3.

  11. Если требуется использовать защищенное соединение с LDAP-сервером, установите переключатель Проверка SSL-сертификата в активное положение.

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

    Если переключатель установлен в активное положение, соединение с LDAP-сервером будет осуществляться по порту 636, иначе — по порту 389.

  12. В поле Base DN введите базовое отличительное имя (Distinguished Name) домена, активы из которого необходимо импортировать. Например: DC=company,DC=domain.

    Должен использоваться тот же домен, в котором был создан пользователь Active Directory.

  13. Установите переключатели напротив тех типов сущностей, которые необходимо импортировать:

    • Оборудование;

    • Группы пользователей;

    • Персонал;

    • Учетные записи;

    • Подразделения.

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

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

  15. В следующих полях вы можете указать LDAP-фильтры, по которым будут отобраны списки сущностей, импортируемые в R-Vision VM:

    • Фильтр по оборудованию;

    • Фильтр по группам пользователей;

    • Фильтр по персоналу;

    • Фильтр по учетным записям;

    • Фильтр по подразделениям.

    Примеры LDAP-фильтров

    Простой фильтр устройств:

    (name=win10x64ru)

    Составной фильтр пользователей:

    (!(|(userPrincipalName="admin@company.local")(userPrincipalName="manager@company.local")))

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

  17. В поле Группа воркеров укажите active_directory_worker_group.

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

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

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

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

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

  21. В поле Выгружаемый объем сущностей оставьте значение по умолчанию.

  22. При необходимости добавьте в таблицу Список полей для исключения из объекта идентификаторы полей Active Directory, которые не требуется импортировать. Каждое поле следует добавлять в отдельную строку таблицы. Например:

    • dNSHost

    • displayName

    • sAMAccountName

  23. В таблицах Правила нормализации и Правила связывания оставьте содержимое по умолчанию.

  24. Чтобы настроить расписание запуска интеграции, установите переключатель Запуск по расписанию в активное положение и выполните действия ниже.

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

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

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

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

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

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

  28. Если была выбрана опция Расписание, выполните следующие шаги:

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

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

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

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

      • Каждый час;

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

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

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

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

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

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

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

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

  29. Нажмите на кнопку Добавить. Система создаст интеграцию и отобразит соответствующее уведомление. Новая интеграция отобразится в списке раздела.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • Успешно;

    • Ошибка;

    • В процессе;

    • Отменена.

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

    • Адрес сервера — адрес LDAP-сервера, на котором запущена служба Active Directory.

    • Логин — имя переменной, которая хранит логин пользователя Active Directory.

    • Пароль — имя переменной, которая хранит пароль пользователя Active Directory.

    • Проверка SSL-сертификата — поле, которое показывает, используется ли защищенное соединение с LDAP-сервером.

    • Base DN — базовое отличительное имя (Distinguished Name) домена, активы из которого необходимо импортировать.

  • Секция Параметры импорта:

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

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

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

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

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

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

    • Фильтр по оборудованию — LDAP-фильтр списка оборудования.

    • Фильтр по группам пользователей — LDAP-фильтр списка групп пользователей.

    • Фильтр по персоналу — LDAP-фильтр списка персонала.

    • Фильтр по учетным записям — LDAP-фильтр списка учетных записей.

    • Фильтр по подразделениям — LDAP-фильтр списка подразделений.

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

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

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

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

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

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

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

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

    • Запускать — режим запуска интеграции. Доступные значения:

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

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

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

      • Каждый час;

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

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

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

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

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

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

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

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

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

  • Выгружаемый объем сущностей — максимальное количество объектов Active Directory, выгружаемых за один запрос.

  • Список полей для исключения из объекта — идентификаторы полей Active Directory, которые не требуется импортировать.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

+7 (499) 755 55 70 sales@rvision.ru

О компании Пользовательское соглашение Политика cookies

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