Перейти к основному содержимому

Экспорт отчетов и импорт задач

На странице задачи в меню Параметры () доступны два разных типа выгрузки:

  • отчёт по результатам задачи (PDF / CSV / HTML) — для передачи результатов;
  • конфигурация задачи (архив с зависимостями / JSON) — для переноса или копирования сценария между стендами.

Автоматизация запуска через Python описана отдельно в разделе Автоматизация.

Экспорт отчётов

Отчёты по задаче доступны из меню действий задачи ():

Действие в UIФорматНазначение
Экспортировать отчет в виде PDFPDFПечатная версия: подгружаются панели Grafana, затем вызывается печать браузера
Экспортировать отчет в виде CSVCSVТабличный отчёт system-trace-task-<ID>-report-<дата>.csv (задача, плагины, scope метрик, CP/Access)
Экспортировать отчет в виде HTMLHTMLHTML-файл с встроенными iframe-дашбордами для просмотра без UI

Рис. 24 — Экспорт отчёта PDF/CSV/HTML

Рис. 24 — Пункты экспорта отчёта в меню задачи

При экспорте PDF интерфейс показывает прогресс («Готовлю печатную версию…», «Загружаю графики N из M»). Если панели не загрузились, появится сообщение «PDF-отчет не сформирован». Под графиками на вкладке Метрики также может быть кнопка экспорта текущего дашборда в PDF — используйте её для среза одного дашборда; полное меню даёт PDF/CSV/HTML по задаче целиком.

Чтение графиков и перечень дашбордов — в разделе Метрики и дашборды.

Экспорт и импорт задач

Задачу можно выгрузить для переноса на другой стенд или для копии на том же стенде. Формат выбирается на странице задачи: Параметры → нужный вариант экспорта.

Меню экспорта задачи в Пересвет-СТ

Меню параметров задачи с вариантами экспорта

ВариантЧто скачиваетсяКогда использовать
Экспорт задачи с зависимостямиЗашифрованный архив .pa-task-export с конфигурацией задачи и переносимыми объектами библиотекПеренос задачи на другой стенд вместе с сетями, MAC-объектами, сертификатами, туннелями, CVE-сигнатурами, динамическими приложениями и описанием используемых файлов
Экспортировать задачу в JSONОдин JSON-файл с конфигурацией задачиБыстрое копирование на стенд, где уже есть нужные сети, файлы, приложения и другие объекты библиотеки
Экспортировать задачу в PythonZIP с конфигурацией и Python-клиентом REST APIАвтоматизация запуска — см. Автоматизация

Экспорт задачи с зависимостями

Формат .pa-task-export предназначен для переноса задачи между стендами. Перед скачиванием контроллер собирает план экспорта и показывает, какие зависимости найдены в задаче:

  • сети и их параметры, включая MAC-политику и ручные MAC-исключения;
  • MAC-адреса из библиотеки;
  • сертификаты и закрытые ключи;
  • туннели;
  • CVE-сигнатуры, если задача использует CVE Replay или связанные файлы;
  • динамические приложения;
  • сведения о файлах PCAP, HAR, пользовательских файлах и malware-файлах;
  • описания агентов, которые использовались в задаче.

Архив шифруется и сохраняется с именем вида peresvet-st-task-<ID>.pa-task-export. Внутри архива находятся конфигурация задачи, манифест экспорта и JSON-описания переносимых объектов. Пользователю не нужно вручную распаковывать или изменять архив.

В окне экспорта отображаются счетчики зависимостей: сети, MAC, сертификаты, туннели, CVE, приложения, файлы и агенты. Если часть зависимостей требует внимания, Пересвет-СТ показывает предупреждение до скачивания архива.

Окно экспорта задачи с зависимостями

Окно экспорта переносимого архива .pa-task-export

Файловые payload по умолчанию не вкладываются в архив. Это защищает пользователя от случайного скачивания очень крупных наборов данных: например, задач с большими PCAP/HAR или большим количеством malware-файлов. Если нужно перенести сами файлы, включите опцию «Включить файловые payload». Malware payload включается отдельной опцией и подходит только для небольших переносимых наборов. Если payload не включён, файлы останутся внешней зависимостью: на целевом стенде их нужно заранее загрузить или выбрать из локальной библиотеки.

Агенты и PCI interfaces не переносятся физически. Их идентификаторы зависят от конкретного стенда, поэтому в архив попадает только описание исходных агентов и интерфейсов. При проверке архива на другом стенде такие ресурсы должны быть сопоставлены с локальными агентами и портами.

Проверка архива перед импортом

Архив .pa-task-export можно выбрать в окне импорта задач: откройте Задачи, нажмите меню создания задачи и выберите «Импортировать задачи». В область загрузки можно перетащить один или несколько файлов .json или .pa-task-export.

Проверка .pa-task-export архива перед импортом

Проверка переносимого архива перед импортом задачи

Для .pa-task-export контроллер сначала выполняет безопасную проверку без изменений в базе данных. На этом этапе Пересвет-СТ читает архив, сверяет зависимости с локальными библиотеками и показывает таблицу статусов:

СтатусЧто означаетДействие пользователя
НайденоНа целевом стенде уже есть объект с тем же отпечатком или идентичным содержимымПовторно создавать объект не нужно
Будет созданоТакого объекта на стенде нет, но в архиве достаточно данных для его созданияПроверьте название и состав объекта перед импортом
Нужен выборОбъект зависит от стенда: например, исходный агент или PCI interface нельзя перенести автоматическиВыберите локального агента или интерфейс из списка
Нет payloadВ архиве есть ссылка на файл, но сам файловый payload не вложен и совпадающий файл не найден локальноЗагрузите файл на целевой стенд или повторите экспорт с включением payload
КонфликтНа стенде найден объект с тем же пользовательским идентификатором, но другим содержимымПроверьте локальный объект и решите, какой вариант должен использоваться

Если выбрано несколько архивов, каждый файл проверяется отдельным блоком. Это удобно для массового переноса: пользователь видит состав каждой задачи, общие зависимости и ресурсы, которые требуют выбора. Одинаковые объекты не нужно переносить вручную несколько раз — при проверке они сопоставляются с локальной библиотекой по содержимому, имени, идентификатору или отпечатку в зависимости от типа объекта.

На текущем этапе .pa-task-export используется для переносимого экспорта и проверки зависимостей перед импортом. Если на конкретной версии стенда кнопка создания задачи из .pa-task-export недоступна, используйте проверку архива как список необходимых действий: загрузите отсутствующие файлы, создайте или сопоставьте стендовые ресурсы, затем используйте JSON-экспорт или Python-архив для создания задачи.

Экспорт задачи в JSON

JSON-экспорт сохраняет только конфигурацию задачи. Такой файл подходит для быстрых копий на том же стенде или между стендами с одинаково подготовленными библиотеками. В JSON не попадают сетевые объекты, сертификаты, файлы, динамические приложения, CVE-сигнатуры, агенты и PCI interfaces как самостоятельные объекты библиотеки.

При импорте JSON-файла Пересвет-СТ создаёт новую задачу с конфигурацией из файла. Если в конфигурации есть ссылки на объекты, которых нет на целевом стенде, задачу нужно дополнительно проверить и отредактировать перед запуском.