YARA-анализатор

YARA-анализатор представляет собой автономный инструмент для статического анализа вредоносного кода с использованием YARA-правил для выявления персональных данных в офисных документах (65 различных форматов).
Также YARA-анализатор поддерживает выявление более 20 типов чувствительной информации, включая персональные идентификаторы, финансовые данные, документы, удостоверяющие личность, и различные виды секретов.
Для повышения покрытия анализа сервис обрабатывает вложенные объекты: если документ является ZIP-контейнером (DOCX, XLSX, PPTX и аналогичные форматы), из него извлекается содержимое, а из PDF-файлов извлекаются все текстовые данные для последующего сигнатурного анализа YARA-правилами.

Функционал YARA-анализатора позволяет настроить предварительную проверку файлов на персональные данные до отправки в СЗИ и использовать ее статус в цепочках для более эффективной организации процесса проверки.

Переменные внешней среды, которые использует YARA-анализатор:

  1. STORAGE_ADDRESS — адрес подключения к ValKey-хранилищу. В режиме host сети нужно указывать IP-адрес или localhost.

  2. STORAGE_USERNAME — имя пользователя для аутентификации в ValKey(analyzer).

  3. STORAGE_PASSWORD — пароль для ValKey. Должен совпадать с паролем в списке ACL (users.acl).

  4. MODE — режим работы сервиса:

    1. - development — разработка (с логированием ошибок),

    2. - always_init — всегда инициализация хранилища при старте,

    3. - production — продакшн (без инициализации и с минимальным логгированием).

  5. PORT — порт http-сервера (8079).

  6. HOST — адрес для привязки сервиса к сетевому интерфейсу (0.0.0.0 — все интерфейсы).

  7. APP_PATH — корневой путь приложения на хосте (/yara_analyzer).

  8. RULES_PATH — путь к папке с правилами YARA внутри контейнера (/yara_analyzer/rules).

  9. DNS_NAMES — доменные имена для генерации самоподписанного сертификата, разделённые запятыми.

  10. IP_ADDRESSES — IP-адрес для генерации самоподписанного сертификата (берётся из переменной MP_IP).

  11. FILE_BUFFER_SIZE — размер буфера для определения типа файла (в КБ, по умолчанию 24).

  12. MAPPING_FILE_PATH — путь к файлу настроек маппинга карт (mapping_settings.json).

  13. API_KEY — ключ для авторизированных запросов к YARA Analyzer. Должен передаваться в заголовке Authorization клиентским сервисом при обращении к YARA. Значение генерируется при первой установке, для перегенерации на новое значение необходимо удалить строку из .env и запустить установку заново.

  14. Конфигурация Volumes в compose:

    1. - [путь до файла сертификата]:/certs/ca.crt

    2. - [путь до файла ключа]:/certs/ca.key

  15. OTLP_EXPORTER_HOST - адрес коллектора метрик(необязательно, с версии 2.2)

  16. OTLP_EXPORTER_PORT - порт коллектора метрик(необязательно, с версии 2.2)

  17. MEMORY_BUDGET - объем памяти, которым сервис может оперировать(с версии 2.2)

Параметры ответа YARA-анализатора:

  1. scan_time - время в нс затраченное на анализ

  2. success - true если анализ завершился удачно (устаревшее)

  3. scan_status - "completed" если все норм, "not_proceeded" - если анализ не производился, например по причине отсутствия правил для типа файла, "failed" - в процессе произошла ошибка

  4. error - ошибка, которая возникла в процессе анализа

  5. max_severity - самый высокий уровень из всех сработок

  6. scan_status - статус сканирования, плохо, если не completed

  7. matches_found - поле отражает, есть ли сработки (устаревшее)

  8. namespaces - список наборов правил, которые использовались при анализе(см. mapping)

  9. meta - блок, который будет если анализатор запущен не в production mode( переменная окружения MODE не установлена)

В разделах ниже приведены инструкции по его установке в виде отдельной системы.