YARA-анализатор
YARA-анализатор представляет собой автономный инструмент для статического анализа вредоносного кода с использованием YARA-правил для выявления персональных данных в офисных документах (65 различных форматов).
Также YARA-анализатор поддерживает выявление более 20 типов чувствительной информации, включая персональные идентификаторы, финансовые данные, документы, удостоверяющие личность, и различные виды секретов.
Для повышения покрытия анализа сервис обрабатывает вложенные объекты: если документ является ZIP-контейнером (DOCX, XLSX, PPTX и аналогичные форматы), из него извлекается содержимое, а из PDF-файлов извлекаются все текстовые данные для последующего сигнатурного анализа YARA-правилами.
Функционал YARA-анализатора позволяет настроить предварительную проверку файлов на персональные данные до отправки в СЗИ и использовать ее статус в цепочках для более эффективной организации процесса проверки.
Переменные внешней среды, которые использует YARA-анализатор:
STORAGE_ADDRESS — адрес подключения к ValKey-хранилищу. В режиме host сети нужно указывать IP-адрес или localhost.
STORAGE_USERNAME — имя пользователя для аутентификации в ValKey(analyzer).
STORAGE_PASSWORD — пароль для ValKey. Должен совпадать с паролем в списке ACL (users.acl).
MODE — режим работы сервиса:
- development — разработка (с логированием ошибок),
- always_init — всегда инициализация хранилища при старте,
- production — продакшн (без инициализации и с минимальным логгированием).
PORT — порт http-сервера (8079).
HOST — адрес для привязки сервиса к сетевому интерфейсу (0.0.0.0 — все интерфейсы).
APP_PATH — корневой путь приложения на хосте (/yara_analyzer).
RULES_PATH — путь к папке с правилами YARA внутри контейнера (/yara_analyzer/rules).
DNS_NAMES — доменные имена для генерации самоподписанного сертификата, разделённые запятыми.
IP_ADDRESSES — IP-адрес для генерации самоподписанного сертификата (берётся из переменной MP_IP).
FILE_BUFFER_SIZE — размер буфера для определения типа файла (в КБ, по умолчанию 24).
MAPPING_FILE_PATH — путь к файлу настроек маппинга карт (mapping_settings.json).
API_KEY — ключ для авторизированных запросов к YARA Analyzer. Должен передаваться в заголовке Authorization клиентским сервисом при обращении к YARA. Значение генерируется при первой установке, для перегенерации на новое значение необходимо удалить строку из .env и запустить установку заново.
Конфигурация Volumes в compose:
- [путь до файла сертификата]:/certs/ca.crt
- [путь до файла ключа]:/certs/ca.key
OTLP_EXPORTER_HOST - адрес коллектора метрик(необязательно, с версии 2.2)
OTLP_EXPORTER_PORT - порт коллектора метрик(необязательно, с версии 2.2)
MEMORY_BUDGET - объем памяти, которым сервис может оперировать(с версии 2.2)
Параметры ответа YARA-анализатора:
scan_time - время в нс затраченное на анализ
success - true если анализ завершился удачно (устаревшее)
scan_status - "completed" если все норм, "not_proceeded" - если анализ не производился, например по причине отсутствия правил для типа файла, "failed" - в процессе произошла ошибка
error - ошибка, которая возникла в процессе анализа
max_severity - самый высокий уровень из всех сработок
scan_status - статус сканирования, плохо, если не completed
matches_found - поле отражает, есть ли сработки (устаревшее)
namespaces - список наборов правил, которые использовались при анализе(см. mapping)
meta - блок, который будет если анализатор запущен не в production mode( переменная окружения MODE не установлена)
В разделах ниже приведены инструкции по его установке в виде отдельной системы.
Эта страница была полезна?
Спасибо за отзыв!
Спасибо, мы учтём это для улучшения документации.