Безопасность стенда Pilot

Сетевые правила, секреты, права доступа и данные, которые обрабатывают компоненты стенда.

Скачать PDF

1. Кратко

Стек работает внутри сети организации и не требует интернета в работе. Из наших сервисов люди работают в браузере только с веб-админкой PilotProAdmin; веб-интерфейсы GitLab, Grafana и Pilot-myAdmin принадлежат стороннему ПО. Ещё три наших сервиса внутренние и служебные. Остальное это продукты АСКОН и открытое ПО. Паролей в этом документе нет: они находятся в файле .env и в PASSWORDS.md комплекта.

От службы ИБ нужны решения:

№ Что решить Где описано
1 Открыть сетевые доступы, в том числе всем рабочим местам Pilot к сборщику статистики Разделы 4 и 5
2 Согласовать сбор статистики с логином, ФИО и именем компьютера, срок хранения 30 дней уже задан (раздел 7) Раздел 7
3 Выбрать вид токенов разработчиков для реестра пакетов GitLab и их срок действия Раздел 6
4 Принять заявление разработчика о недекларируемых возможностях или назначить свою проверку Раздел 8
5 Принять решение по известным рискам: работа без TLS, доступ runner к Docker, секреты открытым текстом на диске, права Maintainer в GitLab, вход в админку только администратором Pilot Раздел 9

2. Что входит в стек

Наши компоненты

Компонент Где работает Что делает Кто пользуется
Веб-админка pilot-proadmin Сервер Выкладывает автоматизации, отчёты и модули в Pilot через GitLab: ручная выкладка идёт после успешного pipeline, выкладка из CI подтверждается токеном задания и ключом контура. Правит настройки серверов Pilot (раздел «Серверы»). Сравнивает контуры, откатывает версии, запускает миграцию Разработчики, администраторы
Миграция pilot-migration Сервер Копирует данные между контурами. Своего интерфейса нет Только админка
Сборщик report-metrics-collector Сервер Принимает статистику и пишет её в базу pilot_metrics Рабочие места, серверные модули
Сборщики automation-metrics-* Сервер Раз в 5 минут читают лог автоматизаций Pilot и пишут в pilot_metrics Только сервисы
ServerHost Внутри Pilot-Server Загружает и обновляет серверные модули без перезапуска сервера Pilot-Server
Pilot.ClientSdk Клиент Pilot Общие функции клиентских модулей и отправка статистики Все пользователи Pilot
Reports Клиент Pilot Функции отчётов, статистика построения, сохранение отчётов в GitLab Все пользователи; GitLab только у разработчиков отчётов
debug Машина разработчика Запускает серверный модуль под отладчиком на данных контура. Запись на сервер только с подтверждением в консоли Разработчики серверных модулей

Стороннее ПО

Версии сторонних продуктов закреплены в docker-compose.yml тегом и контрольной суммой (digest) и не меняются сами. Исключения: RustFS закреплён только тегом (образ приходит через docker load, у загруженного образа digest нет, целостность проверяет IMAGES.txt; контейнер работает не от root, UID 10001, с no-new-privileges; данные лежат в именованном томе Docker, а не в папке хоста, и права на них настраивать не нужно), а образы наших сервисов (pilot-proadmin, pilot-migration, pilot-report-metrics, pilot-automation-metrics) собираются из исходников и называются :latest. При сборке в них записываются метки org.opencontainers.image.revision и created (коммит и время сборки), идентификатор каждого образа указан в файле IMAGES.txt комплекта. RustFS 1.0.x вышел недавно (лицензия Apache-2.0); его совместимость с Pilot-Server и поддержку вендором Pilot хранилищ, отличных от MinIO, мы не проверяли.

Продукт Версия Назначение
Pilot-Server, Pilot-myAdmin Web (АСКОН) release, по digest Сервер Pilot и его веб-администрирование
PostgreSQL 16.15 Базы Pilot и pilot_metrics
RustFS 1.0.5 Файловый архив Pilot (S3), поставляется в образе комплекта
GitLab CE, GitLab Runner 19.3.0 Исходники, CI, реестр пакетов, вход по OAuth
Grafana, Prometheus, Loki, Promtail 11.2.2, 2.55.1, 3.2.1, 3.2.1 Панели, метрики, логи
node-exporter, cAdvisor 1.8.2, 0.49.1 Нагрузка машин и контейнеров
nginx 1.27.5 Мост к сервисам на других машинах, только при разнесённой установке

3. Доступ в интернет

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

Компонент Обращения в интернет Что нужно сделать
PilotProAdmin, сервер Нет. Обращается только к Pilot, GitLab и миграции по адресам из настроек. Запросы к GitLab идут с тайм-аутом 15 с и без переходов на другой хост. До первой настройки серверов на странице входа можно указать адрес Pilot вручную, после настройки поле убрано Ничего
PilotProAdmin, браузер пользователя Нет. CodeMirror 5.65.16 лежит в самой админке (папка wwwroot/vendor/codemirror, лицензия MIT рядом), с внешних адресов скрипты и стили не загружаются. Политика CSP разрешает скрипты только с самой админки Ничего. Редактор работает без интернета, с подсветкой синтаксиса
Миграция, сборщики статистики Нет Ничего
Клиентские и серверные модули Нет. Только сборщик статистики и, у разработчиков отчётов, GitLab Ничего
Grafana, Loki По умолчанию отправляют статистику использования и проверяют обновления. В комплекте и в автономных compose-файлах репозитория это отключено, в Grafana отключён и Gravatar Ничего
GitLab Параметрами compose отключены отправка статистики и Gravatar, но они действуют для новой базы: в базе, восстановленной из копии, значения берутся из копии. Проверку версий, а после восстановления и эти параметры нужно проверить вручную в Admin / Settings См. «GitLab без интернета»
Установка Docker скачивает образы с registry.ascon.ru, Docker Hub, gcr.io и registry.gitlab.com Комплект без интернета содержит все образы: его готовит поставщик, тип комплекта указан во второй строке IMAGES.txt
CI и разработчики Образы заданий и пакеты NuGet берутся из интернета Без интернета образы лежат на runner, пакеты в реестре GitLab. Проверки автоматизаций и отчётов (ci-checks) без интернета работают только с собственным образом CHECKS_IMAGE, в котором есть python3 и git: по умолчанию задание ставит git командой apk add из интернета
Pilot-Server и другие сторонние продукты Поведение определяет производитель Закрыть исходящий доступ на межсетевом экране

Настройки сервисов не заменяют сетевой контроль. Надёжнее запретить исходящий доступ машин стека на межсетевом экране: стек продолжит работать.

GitLab без интернета

GitLab CE и Runner могут работать в закрытой сети при двух условиях: образы и пакеты принесены заранее, а для проверок ci-checks задан собственный образ CHECKS_IMAGE с python3 и git. Образы приносятся один раз в комплекте. Пакеты NuGet и библиотеки DLL загружает ответственный сотрудник в реестр пакетов GitLab, а разработчики и CI получают их только оттуда. Это даёт ещё и контроль: в закрытый контур попадает только то, что загрузил ответственный. Порядок действий описан в документе «GitLab без интернета».

4. Кому какой доступ

Кто Что делает Куда нужен доступ Чем входит
Пользователь Pilot Работает в Pilot Pilot prod 5546, сборщик 5310 Учётка Pilot
Тестировщик Проверяет изменения То же и Pilot test 5547, stage 5549 Учётка Pilot
Разработчик модулей, автоматизаций, отчётов Пишет код и отправляет на проверку GitLab 8080 и 2224, админка 5300, Pilot test и stage Учётка GitLab; в админку входит учёткой администратора сервера Pilot; токен read_api для пакетов
Выпускающий Выводит изменения на stage и prod То же и Pilot prod 5546 Учётка GitLab (роль не ниже Developer в группе, для слияния в main и release/* Maintainer) и учётка администратора сервера Pilot
Администратор Pilot Управляет пользователями и правами Pilot myAdmin 5601-5603 Учётка администратора Pilot
Администратор стека Устанавливает и обслуживает сервисы SSH или RDP на машины, служебные порты с самой машины Учётка ОС; .env и PASSWORDS.md с правами 600 на Linux и ограниченным доступом на Windows, права DATA_ROOT на Windows закрывает администратор
Руководители, аналитики Смотрят статистику Grafana 3000 Учётка Grafana
Служба ИБ Контроль и журналы Grafana 3000, журналы в Loki: логи контейнеров, в том числе входы в админку и GitLab; журнал входов в ОС только на Linux, категория auth определяется по тексту строк и не заменяет журнал ОС Учётка Grafana

Вход в админку. Админка принимает только учётную запись администратора сервера Pilot: логин и пароль проверяются на серверах из настроек (адрес сервера на странице входа выбрать нельзя, ручной ввод остаётся только при первом запуске, пока серверы не заданы, и требует ключ установки ADMIN_SETUP_KEY; без ключа такой вход закрыт), затем нужен вход в GitLab. Любой, кто работает в админке, имеет на сервере Pilot права администратора. Для автоматизаций админка работает от имени вошедшего администратора сервера, для отчётов и модулей от имени учётки, введённой на странице раздела, а при выкладке из CI под служебной учёткой Pilot контура.

Права внутри админки. Сохранение общих настроек, весь раздел «Миграция» (запуск, расписания, подключения, проверка подключений с сохранением) и сохранение «Серверов» доступны только сессии, вошедшей администратором Pilot контура prod (если прод не задан, администратором любого настроенного сервера, до первой настройки любым). Остальные сессии видят эти страницы только для чтения, секреты замаскированы, запись даёт ошибку 403. Любое изменение в GitLab и выкладка на серверы (в том числе все операции серверных модулей) требуют роли не ниже Developer в группе и разрешены только при подключённом GitLab и заданной группе: при ошибке GitLab или ошибке определения роли действие запрещено.

Выкладка из CI. Анонимные маршруты /api/ci/modules/deploy и /api/ci/server-modules/deploy требуют два доказательства: заголовок X-Job-Token (токен задания $CI_JOB_TOKEN, который админка проверяет в GitLab запросом GET /api/v4/job) и заголовок X-Deploy-Key (ключ контура, выведенного из проверенной ветки: dev это test, release/* stage, main и master prod). Ветка, коммит, pipeline, проект и автор берутся из ответа GitLab, а не из полей запроса: несовпавшие поля дают 400, проект вне группы модулей этого вида 403, неверный токен 401. Ключи раздельные: MODULES_DEPLOY_KEY_TEST, _STAGE, _PROD. В GitLab ключи STAGE и PROD имеют флаги Masked и Protected, поэтому их получают только задания защищённых веток main и release/*. Старый общий ключ принимается только для test и только если ключ test не задан. Проверки библиотек (check_libraries) требуют только токен задания с той же проверкой проекта и группы.

Остаточные риски выкладки. Защита опирается на защиту веток в GitLab и на состав Maintainer. Ветка release/* принимает push от Maintainer (админка коммитит в неё версию и CHANGELOG.md), поэтому Maintainer может выложить код на стейдж, а слить в main (прод) может любой Maintainer. Ключ test защищён только флагом Masked: его видит любое задание группы. Владелец группы и администратор GitLab могут менять переменные и правила защиты. После выкладки код модуля выполняется в процессе Pilot-Server или клиента Pilot. Проекты, которые создаёт админка, получают настройку Pipelines must succeed, а репозиторий автоматизации или отчёта со своим .gitlab-ci.yml без подключения общих проверок при первой публикации получает общий ci_config_path (предупреждение пишется в журнал).

Защита от перебора и журнал. После 10 неудачных попыток (вход, ввод учёток контуров, неверные ключи и токены CI) с одного адреса за 5 минут админка отвечает 429 на 5 минут. Адрес клиента виден, если админка не за обратным прокси или включено ADMIN_TRUST_PROXY=true (включайте, только если порт админки недоступен в обход прокси). Админка пишет в журнал контейнера pilot-proadmin, который читает Promtail и который виден в Loki: входы в Pilot и GitLab, неудачные входы (без паролей), смены общих настроек (имена полей, не значения), отказы 403 и разрешённые изменения в защищённых разделах, неверные ключи и токены CI. Журнал операций (список, страница операции и её состояние) видит администратор прода, а остальные только свои операции: запущенные под их логином Pilot или их пользователем GitLab (выкладка из CI записывается на пользователя GitLab, запустившего job). Чужая операция отвечает 404. В журнале могут быть сообщения об ошибках и хвост лога задания GitLab; сам журнал хранится в data/jobs.json без шифрования.

Заголовки и cookie. Страницы админки отдаются с Content-Security-Policy (скрипты только свои с одноразовым nonce, без unsafe-inline; редактор CodeMirror отдаётся самой админкой), X-Content-Type-Options: nosniff, Referrer-Policy и X-Frame-Options. Обработчики событий вынесены из страниц, файлы /downloads отдаются только после входа. Cookie входа получает флаг Secure, когда запрос пришёл по HTTPS; за обратным прокси это работает при ADMIN_TRUST_PROXY=true или https-адресе в ADMIN_PUBLIC_URL. Допустимые значения заголовка Host по умолчанию не ограничены (AllowedHosts=*): сузить их можно переменной ADMIN_ALLOWED_HOSTS, перечислив через «;» все имена, по которым открывают админку, и host.docker.internal (по нему обращается CI модулей); запрос с другим Host получает 400.

5. Сетевые правила

По умолчанию весь трафик идёт по HTTP без TLS, см. раздел 9. Для админки и Grafana HTTPS включается необязательно: сертификат и ключ кладутся в папку certs установочной папки, установка включает HTTPS на тех же портах (HTTP на них перестаёт работать). Сертификат и ключ копируются в DATA_ROOT/tls с правами 600 для пользователя контейнера (на Windows доступ ограничен текущим пользователем, SYSTEM и администраторами). Порты указаны по умолчанию и меняются в .env.

Вход от людей и рабочих мест

№ Откуда Куда, порт TCP Зачем
1 Рабочие места Pilot Pilot-Server prod, 5546 Работа в Pilot
2 Рабочие места Pilot Сборщик, 5310: POST /api/module-events, /api/report-events Статистика модулей и отчётов
3 Разработчики, тестировщики Pilot-Server test 5547, stage 5549 Проверка изменений
4 Разработчики, администраторы Админка, 5300 Выкладка, сравнение, откат, миграция
5 Разработчики; клиент Pilot разработчиков отчётов GitLab, 8080 и 2224 Исходники, CI, пакеты, вход
6 Администраторы Pilot myAdmin, 5601, 5602, 5603 Администрирование Pilot
7 Руководители, аналитики, ИБ Grafana, 3000 Панели и журналы

Служебные порты

PostgreSQL 5433-5435, RustFS 9000-9001, 9010-9011 и 9020-9021, миграция 5320, Prometheus 9090, Loki 3100, node-exporter 9100, cAdvisor 9101. При установке на одну машину они слушают только 127.0.0.1 и снаружи недоступны. Автономные compose-файлы репозитория ведут себя так же: порт миграции публикуется только на 127.0.0.1 (`MIGRATION_BIND`), Prometheus на `INTERNAL_BIND` или 127.0.0.1. Внутри машины сервисы общаются через сети Docker: у каждого контура своя сеть.

На Linux правила ufw и firewalld не закрывают опубликованные порты Docker. Docker добавляет свои правила раньше них. Запреты нужно задавать в цепочке DOCKER-USER или на внешнем межсетевом экране и проверять подключением с другой машины. Пример находится в документе по установке, раздел 2.

Дополнительно при установке на разные машины

Файл правил брандмауэра. Без него служебные порты при INTERNAL_BIND доступны всей сети, а у Prometheus, Loki и экспортёров нет пароля. Поэтому при заданном INTERNAL_BIND установка сама пишет в установочную папку готовый файл правил: firewall-linux.sh для Linux, firewall-windows.ps1 для Windows. Файл разрешает эти порты только адресам машин стенда из .env (PROD_HOST, TEST_HOST, STAGE_HOST, METRICS_HOST, ADMIN_HOST, GITLAB_HOST_IP) и самой машине, остальным закрывает. Порты админки, Grafana, Pilot и GitLab файл не затрагивает. Установка файл только создаёт и печатает путь к нему, сама ничего не применяет: правила применяет администратор после просмотра (проверка без применения: sh firewall-linux.sh --test, снятие: --remove). На Linux правила стоят в цепочке DOCKER-USER; их работа проверена на настоящем iptables (трафик через подмену адреса, как у опубликованных портов Docker). Файл для Windows проверен только по синтаксису PowerShell, на живой машине его действие не проверялось. В правила входят только IPv4-адреса, имена хостов пропускаются с предупреждением.

Параметр INTERNAL_BIND открывает служебные порты на IP машины. Они слушают сеть без аутентификации: откройте их только для перечисленных источников. В конце установки скрипт печатает список служебных портов машины:

Откуда Куда, порт TCP Зачем
Машина admin Контуры: Pilot 5546, 5547, 5549 Работа админки и миграции
Машина admin Контуры: PostgreSQL 5433-5435, RustFS 9000, 9010, 9020 Копирование данных миграцией
Машина admin Контуры: SMB 445 или NFS 2049 Чтение настроек контуров. Миграция прод только читает, но раздел «Серверы» сохраняет настройки и прода, поэтому для него нужна запись
Машина admin GitLab, 8080 Ветки, merge request, pipeline, вход; проверка токена задания при выкладке из CI
GitLab Runner Админка, 5300 Выкладка модулей из CI: ключ контура и токен задания
Машины test, stage, metrics Прод: PostgreSQL, 5433 База статистики pilot_metrics
Машина metrics Все машины: 9100, 9101 Сбор нагрузки
Все машины Машина metrics: Loki, 3100 Отправка логов
Контуры Машина metrics: сборщик, 5310 Статистика серверных модулей

6. Учётные записи и секреты

Как входят в сервисы

Сервис Вход
Админка Логин и пароль администратора сервера Pilot, затем GitLab через OAuth. Запасной вариант: Personal Access Token. Своих учётных записей нет. Токены хранятся в сессии на сервере, cookie зашифрованы (ключи шифрования лежат в данных админки файлами без дополнительной защиты)
Pilot-Server, myAdmin Учётные записи Pilot
GitLab Учётные записи GitLab
Grafana Свои учётные записи, саморегистрация отключена
RustFS Root-учётка контура для обслуживания (в .env её ключи по-старому называются MINIO_USER и MINIO_PASSWORD). Pilot должен работать под учёткой pilot с доступом только к своему бакету: такую учётку нужно создать после установки
Миграция Ключ MIGRATION_API_KEY, один на админку и сервис, сравнивается по хешам. После 10 неверных ключей с одного адреса за 5 минут ответ 429 на 5 минут. Защищайте его как ключ к проду: в сервисе хранятся учётные данные всех контуров
Сборщик статистики Ключ COLLECTOR_API_KEY. Если он задан, нужен и для приёма событий, и для сводок GET /api/report-events/summary и /api/module-events/summary (/health открыт). При первой установке на одну машину ключ создаётся, в остальных случаях он пуст и запросы принимаются без ключа, см. раздел 9. Размер тела запроса ограничен 10 МБ (больше отклоняется), параметр hours сводок не больше 8784
Prometheus, Loki Без аутентификации, порты открыты только сервисам. Управление Prometheus по HTTP (--web.enable-lifecycle) выключено

OAuth-приложения GitLab

Веб-админка Reports
Кто входит Пользователь админки в браузере Разработчик отчётов из клиента Pilot
Тип Confidential: секрет хранится на сервере Public без секрета, PKCE
Redirect URI http://<админка>:5300/GitLab/Callback: адрес берётся из GITLAB_OAUTH_REDIRECT_URI, иначе из ADMIN_PUBLIC_URL, иначе из адреса запроса http://127.0.0.1:7890/callback, адрес рабочего места
Scope api api
Хранение токена Сессия на сервере Рабочее место, DPAPI: %AppData%\ASCON\Reports\gitlab

Scope api нужен, потому что приложения создают ветки, коммиты и merge request от имени пользователя.

Токены для реестра пакетов

Вариант Права Плюсы и минусы
Личный токен разработчика (рекомендуется) read_api Персональный, отзывается при увольнении, срок задаётся
Deploy Token группы read_package_registry Проще, только чтение пакетов, но один общий секрет и нужна ротация

Пароль токена на рабочем месте шифруется через DPAPI. Загружать пакеты должен один ответственный, в CI для чтения используется токен задания. Шаблон CI передаёт его только источникам NuGet, хост которых равен `CI_SERVER_HOST`, и записывает открытым текстом в конфигурацию NuGet внутри одноразового контейнера задания. Пакет Pilot.ClientSdk публикуют задания `nuget_*` проекта под токеном задания.

Где какие секреты

Секрет Для чего Где хранится
Администратор Pilot-Server Вход в Pilot, миграция .env; config.json миграции (DATA_ROOT/services/migration) открытым текстом
postgres, pilotuser Базы Pilot .env, строка подключения в settings.xml
metrics_writer, metrics_reader База pilot_metrics: запись (сборщики статистики) и только чтение (Grafana) .env (METRICS_WRITER_PASSWORD, METRICS_READER_PASSWORD)
RustFS root, pilot Файловый архив .env; ключ в settings.xml зашифрован средствами Pilot
MIGRATION_API_KEY Админка / миграция .env
MODULES_DEPLOY_KEY_TEST, _STAGE, _PROD, служебные учётки выкладки CI / админка / Pilot .env машины admin; переменные группы GitLab DEPLOY_KEY_TEST, _STAGE (Masked) и _PROD (Masked и Protected)
COLLECTOR_API_KEY Клиенты / сборщик .env, файлы настроек модулей
OAuth Client ID и Secret Вход в админку .env
GitLab root, gitlab-secrets.json GitLab Данные GitLab
Администратор Grafana Grafana .env (начальный), база Grafana
Ключи Data Protection Шифрование cookie входа, токенов форм и паролей Pilot в памяти сессий админки Данные админки (services/proadmin/keys), файлы ключей без шифрования. У каждой установки свои: в комплект с data ключи не попадают, при установке из data создаются заново; из бэкапа своей машины возвращаются. На Linux папка закрыта правами 700

Комплект с папкой data содержит данные стенда и все пароли открытым текстом, в том числе файл PASSWORDS.md. Передавайте его как секрет, доступ к .env и DATA_ROOT оставьте только администратору стека. Установка ограничивает права: .env и PASSWORDS.md получают права 600 на Linux (на Windows доступ у пользователя, SYSTEM и администраторов), на Linux закрываются каталоги секретов в DATA_ROOT; права DATA_ROOT на Windows установка не меняет. При первой установке на одну машину пароли-заглушки из .env.example заменяются случайными, на нескольких машинах установка останавливается, пока заглушки не заменены. Открытым текстом лежат пароли администраторов Pilot и ключи S3 в config.json миграции (права 600 действуют только в Linux-контейнере) и пароль PostgreSQL в settings.xml (ключ S3 там зашифрован средствами Pilot); защищайте резервные копии и сетевые папки.

7. Сбор статистики и персональные данные

Статистику отправляет клиент Pilot на рабочем месте, поэтому всем нужен доступ к сборщику. Без него Pilot работает как обычно, но статистика с этого места теряется.

Источник Как собирается Куда пишется
Клиентские модули События копятся в памяти и отправляются пачкой раз в 15 секунд, на диск не пишутся metrics.module_events
Отчёты Событие на каждое построение metrics.report_events
Серверные модули События загрузки и действий, пачкой раз в 15 секунд metrics.module_events
Автоматизации Лог сервера Pilot читается раз в 5 минут, только на test и stage. Повторное чтение того же лога дубли не создаёт, исключение: события, записанные прежней версией сборщика metrics.automation_events

Что отправляется: модуль и его версия, действие, результат, длительность, число объектов, тип и текст ошибки, а также логин, ФИО, имя компьютера, адрес сервера Pilot и версия клиента. Данные объектов, атрибуты и содержимое документов клиентские и серверные модули не отправляют. Текст ошибки может содержать имена объектов, если их включил автор модуля; он усекается: в Reports это текст корневого исключения до 1000 символов, в Pilot.ClientSdk до 2000, в серверных модулях до 1000. Исключение составляет сборщик автоматизаций: в metrics.automation_events он пишет значения expected и was из сообщений об ошибках и до 200 символов тела ошибки, поэтому туда могут попасть значения атрибутов объектов. Адрес сборщика в модулях задаёт администратор: в поставляемом Reports.config.json адреса пусты, пока statsUrl пуст, статистика выключена; выпущенные ранее версии модуля собраны с адресами исходной машины.

Логин, ФИО и имя компьютера относятся к персональным данным работников. Нужно решение ИБ: достаточно ли внутреннего уведомления. Срок хранения владелец стека определил: 30 дней. Сборщики сами удаляют события старше срока из metrics.report_events, metrics.module_events и metrics.automation_events при старте и затем не реже раза в час (сборщик автоматизаций проверяет при каждом запуске, раз в 5 минут), пачками по 5000 строк. Срок задаётся переменной STATS_RETENTION_DAYS в .env (по умолчанию 30); значение 0 отключает удаление, и сборщики пишут об этом предупреждение в журнал. Ошибка удаления попадает в журнал и работу сборщика не останавливает. Резервные копии базы pilot_metrics, сделанные до удаления, хранят старые строки до собственной ротации. Журналы Loki хранятся 720 часов (30 дней, retention_period в конфигурации Loki).

8. Недекларируемые возможности

Что означает этот раздел

Недекларируемые возможности (НДВ) это функции ПО, не описанные в документации, в результате использования которых могут быть нарушены конфиденциальность, доступность или целостность данных. Формальный контроль отсутствия НДВ проводит аккредитованная лаборатория.

Сертификата или заключения лаборатории на компоненты нет. Этот раздел содержит заявление разработчика, полный перечень функций и результаты самопроверки. Он не заменяет сертификацию. Если система подпадает под обязательные требования, например как значимый объект КИИ или ГИС, нужна проверка по этим требованиям.

Что умеют наши компоненты

Здесь перечислены функции, чувствительные с точки зрения безопасности. Других таких функций при самопроверке не найдено.

Компонент Что может делать Чем ограничено
PilotProAdmin Записывает автоматизации, отчёты, типы и модули в Pilot. Создаёт ветки, коммиты, merge request, теги и Release в GitLab и защищает ветку dev. Правит файл настроек сервера Pilot server-settings.conf всех контуров, включая прод (каталоги смонтированы на запись). Распаковывает zip модулей: запись до 256 МБ, архив до 1 ГБ Права вошедшего пользователя в Pilot и GitLab (роль не ниже Developer, при ошибке определения роли действие запрещено), успешный pipeline. Настройки, миграция и серверы только для администратора прода. Docker и перезапуск сервера админке недоступны
PilotProAdmin, выкладка из CI Записывает модуль в Pilot под служебной учёткой контура. Ветка, коммит, pipeline, проект и автор берутся из ответа GitLab Токен задания, проверяемый в GitLab, и ключ контура (MODULES_DEPLOY_KEY_TEST, _STAGE, _PROD), выведенного из проверенной ветки; проект должен лежать в группе модулей этого вида; после 10 неудач 429. Пустой ключ отключает выкладку на контур
Миграция Останавливает и запускает базу приёмника, заменяет её данные, удаляет из архива приёмника файлы, которых нет в источнике, заменяет метаданные и автоматизации, пишет server-settings.conf, перестраивает индекс атрибутов, пишет пробные объекты в архивы, выгружает базы в файлы вместе с хешами паролей пользователей, импортирует присланные базы Ключ API. Запись в прод запрещена проверкой меток контуров: перенос блокируется, если у приёмника тот же адрес Pilot, settings.xml или папка архива, что у прода. Файловые тома прода смонтированы только для чтения. Защита от общей папки данных PostgreSQL работает только при праве на pg_control_*, без него остаётся предупреждение. Учётные данные прода в сервисе есть (открытым текстом в config.json)
Сборщики статистики Читают лог автоматизаций, принимают события, пишут их в pilot_metrics Сборщикам автоматизаций смонтирован только каталог логов контура (чтение), они работают не от root. Сборщик событий при заданном ключе требует его и для сводок, тело запроса до 10 МБ
ServerHost Загружает сборки серверных модулей в процесс Pilot-Server и выполняет их код Модули выкладывает админка: выкладка из CI подтверждается токеном задания и ключом контура, ключи stage и prod доступны только заданиям защищённых веток. Имя модуля проверяется (буквы, цифры, _, -, ., до 100 знаков), архив не больше 512 МБ после распаковки и 5000 файлов (200 МБ в сжатом виде), текст ошибки в статистику до 1000 знаков. Сам код хост не проверяет и выполняет любую сборку, выложенную админкой
Pilot.ClientSdk Отправляет статистику. В окне настроек проверяет доступность сборщика Адрес задаётся настройкой
Reports Отправляет отчёты в GitLab, хранит токен, открывает браузер для входа. Для поиска токена вызывает git credential fill, если токена нет: это чтение сохранённого в Git токена к адресу GitLab Только по действию разработчика отчётов, только адрес GitLab из настроек. Ссылки из ответов GitLab открываются в браузере только по http и https; git.exe ищется только по каталогам PATH, ожидание ответа до 5 с; токен при http-адресе GitLab передаётся открытым текстом, в лог раз за сеанс пишется предупреждение; отчёт отправляется в ветку dev или hotfix/… от main, не в main
debug Подключается к Pilot и запускает модуль на машине разработчика Учётка разработчика. Запись только при apply (в файле настроек или ключом --apply) и после подтверждения в консоли с показом сервера и логина; ключ --yes отключает вопрос, без подтверждения код возврата 1, в неинтерактивной среде без --yes запись не выполняется. Пароля в файле настроек нет, образец поставляется с apply: false
Скрипт запуска Pilot-Server При старте контейнера меняет settings.xml по файлу настроек Только 7 перечисленных параметров и только значения true или false

Что проверено

Самопроверка исходного кода выполнена 5 ноября 2026 года; перечень в этом разделе обновлён 10 ноября 2026 года с учётом внесённых исправлений. Проверялись proadmin, Клиентские модули, Reports, Серверные расширения и сборщики статистики. Проверка выполнена поиском по коду, это не аудит и не полный статический анализ.

Что искали Как Результат
Адреса в интернете Поиск URL в исходниках и конфигурации cdnjs.cloudflare.com в редакторе больше не используется: CodeMirror лежит в самой админке, см. раздел 3
Сетевые клиенты Поиск HttpClient, WebRequest, TcpClient Обращения только к Pilot, GitLab, миграции и сборщику; запросы админки к GitLab идут с тайм-аутом 15 с и без переходов на другой хост
Посторонняя телеметрия Поиск telemetry, analytics, sentry, applicationinsights, просмотр зависимостей Внешней телеметрии нет. Собственная статистика идёт только в свой сборщик
Встроенные учётные записи и пароли Поиск строковых значений password, secret, token, apikey в коде В рабочем коде не найдено. Пароли-заглушки были в .env.example, compose и скриптах: при первой установке на одну машину установка заменяет их случайными, на нескольких машинах останавливается, пока они не заменены; подстановки minioadmin для S3 миграции убраны. В compose остаются запасные значения служебных переменных, поэтому проверяйте .env после установки. Тесты не проверялись
Запуск сторонних программ Поиск Process.Start Только открытие браузера и git credential fill в Reports
Доступ без входа в админке Поиск AllowAnonymous /health, /Login, /Error, /Process (справка), выход. Маршруты /api/ci/* проверяют токен задания в GitLab и ключ контура. Файлы /downloads только после входа

Что можно проверить самостоятельно

  1. Сеть. Запретите исходящий доступ машин стека и журналируйте попытки соединений. Стек должен работать, а попытки покажут всё, что идёт наружу.

  2. Исходный код. Код лежит в репозитории проекта (монорепозиторий). Образы собираются из Dockerfile его папок, поэтому их можно собрать заново и сравнить поведение. Для сборки нужен доступ к mcr.microsoft.com, nuget.org и PyPI (в образе сборщика автоматизаций закреплён psycopg2-binary==2.9.10).

  3. Статический анализ. Проведите его своим инструментом, ориентир для процесса: ГОСТ Р 71207-2024.

  4. Зависимости. Постройте перечень компонентов и проверьте его по базе уязвимостей: dotnet list package --include-transitive и сканер образов.

  5. Сторонние продукты. Сведения о сертификации и поведении Pilot запрашивайте у АСКОН, об остальных продуктах у их производителей. Наша проверка их не охватывает.

Заявление разработчика

Заполняется и подписывается ответственным лицом разработчика после своей проверки.

Разработчик заявляет, что в компонентах стека, перечисленных в разделе 2, версии от _______________, на момент передачи: функции, чувствительные с точки зрения безопасности, описаны в настоящем разделе; разработчиком намеренно не внесены скрытые учётные записи, средства удалённого управления и функции передачи данных за пределы сети организации. Заявление не является сертификатом соответствия и не распространяется на стороннее ПО.

Организация Должность, ФИО Подпись, дата

9. Известные риски

Риск Почему важно Что можно сделать
Нет TLS Пароли Pilot, токены GitLab и статистика идут по сети открытым текстом; токен GitLab в Reports при http-адресе тоже. Cookie входа получает флаг Secure только при HTTPS Включить HTTPS для админки и Grafana (сертификат и ключ в папке certs, установка включает его сама); для GitLab настроить external_url с https и сертификат; порядок настройки HTTPS у Pilot-Server описан у поставщика, до этого поставить перед ним обратный прокси с HTTPS и сегментировать сеть
Runner имеет доступ к docker.sock Равносильно root на машине GitLab: код из pipeline может влиять на все контейнеры этой машины Вынести runner на отдельную машину, защитить ветки (main, release/*), ограничить, кто может менять CI
Promtail, cAdvisor и node-exporter с широким доступом Читают логи и данные машины, cAdvisor работает в режиме privileged Закрыть их порты от всех, кроме metrics, или отключить
Сборщик принимает данные без ключа Любой в сети может записать ложную статистику и, пока ключ пуст, читать сводки Задать COLLECTOR_API_KEY и прописать его в настройках модулей. При первой установке на одну машину ключ создаётся, при установке с данными и на нескольких машинах его нужно задать самому; при пустом ключе сборщик пишет предупреждение при старте. Тело запроса ограничено 10 МБ
Группа docker на Linux Участие в группе равносильно правам root на машине Включать в неё только администратора стека
Один .env на всех машинах При разнесённой установке компрометация машины test раскрывает пароли прода На каждой машине оставить только нужные пароли
Роли PostgreSQL для статистики Сборщики пишут под ролью metrics_writer (владелец базы pilot_metrics), Grafana читает под metrics_reader (только SELECT, источник помечен только для чтения). У обеих ролей нет прав на базы Pilot, у pilotuser нет прав на pilot_metrics. Роли ходят в PostgreSQL по сети без TLS. База Pilot, созданная после запуска установки, остаётся доступной для захода (без прав на данные) до следующего запуска установки Закрыть порт PostgreSQL брандмауэром, оставить доступ только машинам стека (готовый файл правил установка пишет при INTERNAL_BIND); пароли ролей менять через shared/rotate-contour-secrets
Сетевые папки контуров В settings.xml есть пароль PostgreSQL. Папки доступны машине admin, раздел «Серверы» пишет server-settings и прода Открыть только машине admin, отдельная учётка; прод только для чтения, если настройки прода не правятся из раздела «Серверы»
Мост без шифрования Контейнеры link-* пересылают трафик между машинами как есть Выделенная сеть между серверами или шифрованный туннель
Выгрузки и бэкапы Папки export, бэкапы и data содержат данные и секреты Ограничить доступ, хранить отдельно, удалять ненужное
Секреты открытым текстом Пароли администраторов Pilot и ключи S3 в config.json миграции (права 600 только в Linux-контейнере), пароль PostgreSQL в settings.xml, .env, PASSWORDS.md, ключи шифрования админки в файлах без защиты; всё это попадает в резервные копии Закрыть доступ к DATA_ROOT и ./data средствами ОС (на Windows права DATA_ROOT установка не меняет), шифровать копии и ограничивать доступ к ним
Права Maintainer в GitLab Maintainer сливает в main (прод) и пишет в release/* (стейдж), ему доступны Protected-ключи STAGE и PROD. Ключ test защищён только флагом Masked. «Pipelines must succeed» оценивается по .gitlab-ci.yml ветки merge request, который меняет автор Ограничить число Maintainer и владельцев групп, включить ревью merge request, следить за переменными групп
Вход в админку администратором Pilot Каждый, кто работает в админке, входит учёткой администратора сервера Pilot; администратор прода к тому же меняет общие настройки, миграцию и серверы Ограничить круг таких учёток, следить за журналом контейнера админки: входы, неудачные входы, смены настроек
Миграция хранит учётные данные прода Ключ MIGRATION_API_KEY равносилен доступу к учёткам всех контуров. Запрет записи в прод держится на метках контуров и сверке адресов; защита от общей папки данных PostgreSQL работает только при праве на pg_control_* Хранить ключ только на машине admin, закрыть порт 5320 брандмауэром, выдать подключению прода отдельную учётку с минимальными правами
Версии .NET в стеке Образы админки, миграции и сборщика метрик собраны на .NET 10, его поддержка действует до ноября 2028 года (дату проверьте на сайте Microsoft). Серверные расширения (ServerHost, Debug) собираются под .NET 8 и работают внутри Pilot-Server: их среда зависит от образа Pilot-Server, а его выбирает АСКОН. Поддержка .NET 8 закончилась 10 ноября 2026 года, обновлений безопасности для неё не будет Пересобирать образы сервисов при выходе исправлений безопасности .NET. Версию .NET в образе Pilot-Server уточнить у АСКОН и запросить образ на поддерживаемой версии
Скрипты отчётов получают доступ к Pilot Модуль Reports передаёт скриптам отчётов (из GitLab и Pilot) сервисы клиентского SDK: IObjectsRepository, ISearchService, IObjectModifier, IFileProvider, диалоги. Скрипт отчёта может читать и менять объекты и файлы в Pilot с правами пользователя, открывшего отчёт Доверять только отчётам из проверенных репозиториев GitLab (защита веток, ревью merge request), ограничить права пользователей Pilot по принципу минимальных прав