Инструкция по установке для пилотных проектов
О продукте и пилотном тестировании
Solar LightHouse — решение для построения и поддержки безопасности инфраструктуры. Целью пилотного тестирования является проверка возможности закрытия ваших задач по безопасности инфраструктуры с помощью Solar LightHouse.
Этапы пилотного тестирования:
Установка Solar LightHouse;
Сбор данных с инфраструктуры;
Проверка работы ключевых механизмов;
Оценка выполнения задач инвентаризации;
Проработка фокусного решения специфической задачи
Результаты пилота помогут детальнее понять потребности и определить направление дальнейшего развития продукта.
Подготовительные работы
Определение подхода к внедрению
Рекомендуемым на пилот подходом к внедрению является внедрение нашими силами с поддержкой вашей инженерной команды – для него необходимо проработка вариантов доступа и подписания необходимых документов. Пришлите необходимые пре-реквизиты для организации такого доступа.
Выбор пилотного сетевого сегмента
На данном этапе необходимо определить сегмент сети для установки продукта. Возможно два основных сценария:
Базовый и рекомендованный сценарий: Установка AIO (All in One) - размещение всех компонентов решения в сетевом сегменте, где проводится пилотное тестирование. Такой сценарий рекомендован для сетевого сегмента с количеством ассетов (сетевых активов: сетей, хостов и пр.) до 2000. Для установки выделяется одна виртуальная машина.
Альтернативный сценарий: Размещение основных компонентов решения в отдельном сегменте и размещение коллектора (keeper) в сетевом сегменте, где проводится пилотное тестирование. Такой сценарий рекомендован для сетевого сегмента с количеством ассетов (сетевых активов: сетей, хостов и пр.) более 2000, для повышения производительности решения и для возможности тестирования развитой сетевой инфраструктуры с возможностью установки отдельного кипера для каждой выделенной сетевой зоны. Для установки выделяется минимально две виртуальных машины и более, в зависимости от числа ассетов, сетевых зон. Для сложных сетевых инфраструктур рекомендуется установку производить с участием разработчика.
Пилотная инсталляция
Рекомендуемый способ установки продукта для пилота – это AIO (All in One). Он хорошо подходит для тестов в пилотном сетевом сегменте на количестве ассетов до 2 тысяч.
Такая инсталляция предполагает использование 1 виртуальной машины (далее – ВМ или VM).
Рекомендуемые характеристики для ВМ
Компонент | Процессор | ОЗУ | Диск |
LightHouse VM | 2 ядра | 4 ГБ | 100 ГБ |
Важно! Компоненты программы работают в среде Docker. По умолчанию Docker хранит данные (образы, контейнеры, volumes и др.) в каталоге /var/lib/docker. Мы рекомендуем предусмотреть отдельный раздел на файловой системе в размере не менее 50ГБ, и подмонтировать его в /var/lib/docker до установки Docker и его компонентов. Файловая система: xfs с ftype=1 или ext4.
Если у Вас имеются определенные ограничения в инфраструктуре - директорию /var/lib/docker можно сменить через переменную data-root в конфигурации Docker (подробнее https://docs.docker.com/engine/daemon/#daemon-data-directory)
Требования к ПО и сетевым доступам
Сетевые доступы
По возможности должен быть обеспечен доступ к registry.lighthouse.rt-solar.ru по 443 порту. В данном реджестри находятся образы модулей и самой системы, что позволит избежать ручной загрузки на стенд. Логин и пароль до registry будут выданы при старте пилота.
Должен быть обеспечен доступ к основным внешним системам для интеграций. Ключевые системы для интеграции:
Active Directory
SMTP сервер
Должен быть обеспечен доступ к сетевому сегменту, содержащему репрезентативный набор ассетов (сетевых активов) для тестирования: хосты с разными операционными системами (Windows, Linux) и разным набором установленного программного обеспечения.
Для реализации базовых сценариев необходимо обеспечить следующие сетевые доступы:
source | destination | protocol/port | comment | |||
Group | hostname | ip | hostname | ip | ||
LH VM | AD | tcp/389, 636 | Active Directory Integration | |||
LH VM | SMTP Server | tcp/25, 587, 465 | SMTP Integration | |||
LH VM | iDP | LDAP | Domain Authentication | |||
LH VM | * | * | Another Integration | |||
LH VM | Hosts | * | Access usable to host discovery or host audit | |||
Platform Access | User computer | Service VM | tcp/80 | User access to Web | ||
User computer | Service VM | tcp/443 | User access to Web | |||
Admin access | Admins computer | Service VM | tcp/22 | SSH access for admin | ||
Admins computer | LH VM | tcp/5432 | database access for admins | |||
Требования к ОС и ПО на ВМ
Рекомендуемые версии ОС для установки на ВМ:
Ubuntu 24.04.2 LTS
Astra Linux 1.7, 1.8 SE
RedOS 8.0
При необходимости на стороне компании проведем анализ возможности установки на другие ОС семейства Linux Вашей организации.
На ВМ должны быть установлены:
Docker (Docker Engine и Docker Compose) из состава ОС (в случае сертифицированной версии ОС) или не ниже версии 27 для не сертифицированной версии ОС.
Следующие пакеты:
Python3-pip
Python3
Python3-venv
OpenSSL
Установка Solar Lighthouse (базовый сценарий AIO)
Предварительные шаги
Установить Docker по оф. инструкции (ставится сразу и Docker и Docker Compose v2) https://docs.docker.com/engine/install/ubuntu/
Особенности Astra Linux
Установка Docker https://docs.astralinux.ru/latest/guide/virtual/docker/
Установка Docker Compose v2 https://docs.astralinux.ru/latest/guide/virtual/docker/compose2/
Установить пакет «zstd» (шаг опциональный)
- sudo apt install zstd
Добавить текущего пользователя в группу docker после чего перелогиниться, чтобы изменения вступили в силу
- sudo usermod -aG docker $USER
Дальнейшие шаги выполняются в зависимости от наличия доступа в Интернет с ВМ
Наличие доступа в Интернет
Установите ORAS для получение из registry.lighthouse.rt-solar.ru скрипта установки
Если он у Вас уже установлен - проверьте версию
oras version
Если не установлен - выполните установку с помощью следующих команд
export ARCHIVE=oras_1.3.0_linux_amd64.tar.gzcurl -LO https://github.com/oras-project/oras/releases/download/v1.3.0/$ARCHIVEtar -xzf $ARCHIVEsudo mv oras /usr/local/bin/
Уточните у команды поддержи актуальную версию скрипта
- export version=<версия поставки>
Войдите в registry.lighthouse.rt-solar.ru
oras login registry.lighthouse.rt-solar.ru
Скачайте архив со скриптом
oras pull registry.lighthouse.rt-solar.ru/lighthouse/release:$version
Распакуйте новый архив
tar xf lighthouse_deploy_<version>.tar
Перейдите в распакованный каталог
cd lighthouse_deploy_${version}/output/
Запустите скрипт
./install_lighthouse.sh ../configs/prod-all-in-one.yml
В процессе установки скрипт уточнит следующую информацию
планируется ли использовать remore keeper
если да, то укажите адрес кипера и следуйте инструкции от скрипта
планируется ли использовать внешнюю базу данных
если да, укажите адрес внешней базы (как настроить внешнюю базу данных указано ниже)
Настройка внешней базы данных
CREATE DATABASE am; CREATE DATABASE was_go; CREATE DATABASE river_go; -- Устанавливаем postgres_fdw в базах данных для работы с Asset Manager \c am; CREATE EXTENSION IF NOT EXISTS postgres_fdw; \c was_go; CREATE EXTENSION IF NOT EXISTS postgres_fdw;
Отсутствие доступа в Интернет
Запросите ссылку на архивы с образами и со скриптом установки
lighthouse_deploy_<version>.tarСкачайте указанные архивы с образами и скриптом и поместите их на подготовленную виртуальную машину в закрытом контуре
Разархивируйте файл с образами с помощью утилиты zstd
zstd -d lighthouse_core_images.tar.zst
Загрузите образы в локальный registry
docker load -i lighthouse_core_images.tar
Запустите скрипт со следующими параметрами
SKIP_REGISTRY=true ./install_lighthouse.sh ../configs/pilot-all-in-one.yml
Обновление Solar Lighthouse (базовый сценарий AIO)
В будущем для обновления Вы можете пропусти Предварительные шаги и преступить к шагам скачивания образов и скрипта и его последующего запуска в зависимости от наличия доступа к Интернет с ВМ.
Особенности установки / обновления
В процессе установки / обновления могут возникнуть ситуации, требующие дополнительного пояснения. Ниже предоставляем самые популярные из них.
Если скрипт прервался (некорректное значение, принудительная ручная остановка)
Решение: Повторно запустить скрипт
При выборе ответа на запрос скрипта во время выполнения будет выбран тот, что с заглавной буквы.
Пример: Например, из [Y/n] будет выбран Y по умолчанию, если просто нажать ввод (enter)
Некоторые переменные проставлены по умолчанию в квадратных скобках []
Пример: если вы согласны, просто подтвердите ввод (enter), если нет - подставьте свои значения
В процессе установке нужны логин и пароль для подключения к registry. Они были высланы ранее на почту.
Решение: Если необходимо повторно направить данные - сообщите команде поддержки пилота
Обратите внимание на что список сетей для игнорирования ранее устанавливаемый через скрипт, а именно:
127.,00:00:00:00:00:00;192.168.;172.16.;172.17.;172.18.;172.19.;172.20.;172.21.;172.22.;172.23.;172.24.;172.25.;172.26.;172.27.;172.28.;172.29.;172.30.;172.31.
теперь настраивается в карточке Тенанта.
Решение: Скопируйте списки игнорируемых сетей до установки обновления и проверьте их после обновления в карточке Тенанта
При наличии вопросов - сообщите об этом команде поддержки пилота.
Сценарии пилотного тестирования
По итогу установки / обновление требуется проверить выполнение следующих базовых сценариев выполнения системы.
Сценарии подготовительные
Создание базовой структуры организации
Настройка интеграции с LDAP и настройка RBAC
Добавление доменных пользователей
Сценарии поиска ассетов
Добавление киперов
Настройка и запуск активного сканирования
Настройка и запуск интеграции с AD
Сценарии аудита ассетов
Настройка и аудит хостов Linux
Настройка и аудит хостов Windows
Сценарии обогащения атрибутов ассета
Ручное и автоматическое проставление ответственных за ассеты
Ручное и автоматическое проставление данных по членству в ИТ-системах
Ручное и автоматическое проставление данных критичности ассетов