Настройки

Обзор

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

Навигация

Меню: Система > Настройки

Макет страницы

Одна карточка с центрированным содержимым (макс. ширина 800px), содержащая:

Кнопка Сохранить все отключена до внесения изменений.

Секции конфигурации

Хранение данных

Управляет длительностью хранения данных в системе.

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

Дни хранения аудита: Записи журнала аудита старше этого периода можно очистить с помощью кнопки Очистка на странице Журнал аудита.

Производительность

Управляет производительностью системы и использованием ресурсов.

Лимит запросов: Защищает API от перегрузки. Клиенты, превышающие этот лимит, получают ошибки HTTP 429 (Too Many Requests). Более высокие значения позволяют большую пропускную способность, но могут нагружать ресурсы сервера.

Параллельность воркера: Более высокие значения обрабатывают больше заданий одновременно, но используют больше CPU и памяти. Устанавливайте на основе мощности сервера и типичной нагрузки.

Интервал автообновления: Как часто UI автоматически обновляется при просмотре активных сканирований или заданий. Меньшие значения обеспечивают более реалтаймовые обновления, но увеличивают нагрузку на API.

Логирование

Управляет поведением логирования приложения.

Варианты уровня логирования:

Макс. размер загрузки: Ограничивает размер загружаемых файлов, таких как SSH-приватные ключи.

Известные проблемы (Known Issues)

Раздел Известные проблемы позволяет исключать определенные правила CIS из расчета оценки соответствия и из скриптов исправления.

Зачем нужны известные проблемы

• False positives: Правила, которые всегда показывают fail из-за особенностей среды
• Неприменимые правила: Правила, которые не актуальны для вашей инфраструктуры
• Принятые риски: Правила, которые намеренно не выполняются по бизнес-причинам
• Временные исключения: Правила, требующие исправления позже

Таблица известных проблем

Добавление известной проблемы

1. Нажмите Добавить известную проблему
2. Заполните поля:
   • ID правила: Точный ID или паттерн с wildcard (например, xccdf_org.ssgproject.*audit*)
   • Описание: Объяснение почему правило исключается
3. Нажмите Добавить

Паттерны с wildcard

Поддерживается символ * для совпадения с частью ID:

Влияние на систему

Когда правило в списке известных проблем:

1. Скорректированная оценка: Оценка соответствия пересчитывается без учета исключенных правил
2. Скрипты исправления: Исключенные правила не включаются в генерируемые Ansible playbook
3. Отображение: В таблице заданий исправления показывается:
   • Правил к исправлению: X (фактическое количество)
   • Исключено (Known Issues): Y

Пример использования

Если правила аудита систематически fail из-за специфики вашей среды:

1. Добавьте паттерн *audit* с описанием “Audit rules not applicable in containerized environment”
2. Включите переключатель
3. Оценка соответствия будет скорректирована
4. Скрипты исправления не будут включать правила аудита

Сохранение настроек

Настройки изменяются локально до явного сохранения:

1. Измените нужные настройки с помощью элементов управления формы
2. Кнопка Сохранить все становится активной
3. Нажмите кнопку Сохранить все
4. Каждая настройка сохраняется на сервер
5. Сообщение об успехе показывает количество сохраненных настроек
6. Настройки вступают в силу немедленно (некоторые могут требовать перезапуска сервиса)

Перезагрузка настроек

Нажмите кнопку Перезагрузить для:

• Отмены несохраненных изменений
• Получения текущих значений с сервера
• Сброса формы к состоянию сервера

Тема и язык

Переключение темы

Переключатель темы доступен в основной навигации:

1. Нажмите иконку темы в панели навигации
2. Переключение между светлым и темным режимами
3. Предпочтение сохраняется в локальном хранилище браузера
4. Сохраняется между сессиями

Выбор языка

1. Нажмите выпадающий список языка (EN/RU) в панели навигации
2. Выберите предпочтительный язык
3. Интерфейс обновляется немедленно
4. Предпочтение сохраняется в локальном хранилище

Лучшие практики

Хранение данных

• Устанавливайте хранение на основе требований комплаенса (PCI-DSS, HIPAA, GDPR)
• Более длительное хранение использует больше хранилища базы данных
• Учитывайте юридические/нормативные требования для вашей отрасли
• Хранение аудита обычно должно быть дольше (90+ дней)

Настройка производительности

Рекомендации:

• Увеличьте параллельность воркера для более быстрой обработки заданий
• Уменьшите если система показывает высокое использование CPU/памяти
• Мониторьте глубину очереди на странице Задания
• Балансируйте пропускную способность vs использование ресурсов

Логирование

• Используйте debug только для устранения конкретных проблем
• Используйте info для нормальной работы в продакшене
• Используйте warn или error для уменьшения объема логов
• Убедитесь, что настроена ротация логов на уровне ОС

Регулярный пересмотр

• Пересматривайте настройки ежеквартально или после изменений инфраструктуры
• Корректируйте на основе наблюдаемых паттернов использования
• Мониторьте метрики производительности системы
• Обновляйте хранение перед аудитами комплаенса

Устранение неполадок

Настройки не сохраняются

1. Проверьте сетевое подключение (инструменты разработчика браузера)
2. Убедитесь, что у пользователя есть права администратора
3. Проверьте консоль браузера на ошибки JavaScript
4. Попробуйте обновить страницу
5. Проверьте доступность API-сервера

Проблемы с лимитом запросов

Если пользователи попадают под лимит (ошибки HTTP 429):

1. Проверьте текущую настройку лимита запросов
2. Временно увеличьте лимит запросов
3. Проверьте поведение клиента на избыточные запросы
4. Проверьте на автоматизированные скрипты или неправильно настроенные инструменты
5. Рассмотрите реализацию троттлинга на стороне клиента

Производительность воркера

Если задания медленные или накапливаются:

1. Проверьте текущую настройку параллельности воркера
2. Увеличьте параллельность если сервер имеет мощность
3. Проверьте ресурсы сервера (CPU, RAM) на узкие места
4. Просмотрите глубину очереди заданий на странице Задания
5. Проверьте неудачные задания, которые могут требовать расследования
6. Проверьте сетевое подключение к управляемым хостам

Проблемы логирования

Если логи слишком подробные или потребляют дисковое пространство:

1. Установите уровень логирования на warn или error
2. Проверьте настроенность ротации логов (logrotate)
3. Мониторьте дисковое пространство
4. Рассмотрите централизованное логирование (syslog, Loki)
5. Архивируйте старые логи перед удалением

Справочник API

Настройками также можно управлять через API:

Получить все настройки:

GET /api/v1/settings

Обновить настройку:

PUT /api/v1/settings/{key}
Content-Type: application/json
{"value": "new_value"}

Известные проблемы:

GET /api/v1/known-issues
POST /api/v1/known-issues
DELETE /api/v1/known-issues/{id}
POST /api/v1/known-issues/{id}/toggle

Связанные страницы

• Журнал аудита - Использует настройку audit_retention_days
• Задания - Использует настройку worker_concurrency
• Сканирование соответствия - Использует настройку auto_refresh_interval

Функции безопасности

Шифрование учетных данных

Все SSH-ключи и пароли в базе данных зашифрованы алгоритмом AES-256-GCM с использованием переменной окружения ENCRYPTION_KEY. Ключ генерируется автоматически при первом запуске.

• Шифрование прозрачное - данные шифруются при сохранении и расшифровываются при использовании
• Существующие данные в формате base64 автоматически мигрируются при запуске API
• Ключ шифрования - 64-символьная hex-строка (32 байта)

Синхронизация ФСТЭК БДУ

Банк данных угроз ФСТЭК синхронизируется автоматически:

• При запуске API - начальная синхронизация
• Каждые 24 часа - периодическая фоновая синхронизация
• Ручной запуск - через API администратора: POST /api/v1/admin/fstec-sync
• Проверка статуса - GET /api/v1/admin/fstec-sync/status

Синхронизация баз CVE

Базы CVE предзагружены в образ ВМ. Движок сканирования уязвимостей проверяет все 8 баз при запуске и синхронизирует отсутствующие автоматически.

Ручная синхронизация доступна через API: POST /api/v1/admin/cve-sync