Безопасность и аудит

Аудит архивов

Проверяет zip и tar на path traversal, ссылки, исполняемые файлы и бомбы.

Python Windows macOS Linux Продвинутый
Скачать audit_archives.py
Описание

Что делает скрипт

Скрипт читает центральные каталоги ZIP и заголовки TAR без распаковки. Он ищет абсолютные пути, выход через .., символические ссылки наружу, устройства, исполняемые расширения, шифрование и подозрительно сильное сжатие. Для 7z и RAR выводится отдельное сообщение о неподдерживаемом формате.

Запуск

Быстрый старт

python audit_archives.py --path ./downloads

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python audit_archives.py --path ./archive.zip
  • python audit_archives.py --path . --max-ratio 500 --json archives.json
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

audit_archives.py

#!/usr/bin/env python3
"""Аудит ZIP и TAR архивов без извлечения файлов."""
from __future__ import annotations

import argparse
import json
import re
import stat
import tarfile
import zipfile
from pathlib import Path

ARCHIVE_SUFFIXES = (".zip", ".tar", ".tar.gz", ".tgz", ".tar.bz2", ".tbz2", ".tar.xz", ".txz")
UNSUPPORTED = {".7z", ".rar"}
EXECUTABLE = {".exe", ".scr", ".bat", ".cmd", ".ps1", ".sh", ".js", ".vbs", ".jar", ".msi", ".com", ".pif", ".hta"}
NESTED = {".zip", ".tar", ".tgz", ".gz", ".bz2", ".xz", ".7z", ".rar"}


def name_issues(name: str) -> list[str]:
    issues = []
    normalized = name.replace("\\", "/")
    if normalized.startswith("/") or re.match(r"^[A-Za-z]:", normalized):
        issues.append("абсолютный путь")
    parts = [part for part in normalized.split("/") if part not in ("", ".")]
    if ".." in parts:
        issues.append("выход через ..")
    if "\x00" in name:
        issues.append("NUL в имени")
    return issues


def inspect_zip(path: Path, max_ratio: float, max_total: int, limit: int) -> dict[str, object]:
    issues: list[str] = []
    entries = total = encrypted = links = executables = nested = 0
    try:
        with zipfile.ZipFile(path) as archive:
            for info in archive.infolist():
                entries += 1
                issues.extend(f"{info.filename}: {item}" for item in name_issues(info.filename))
                if info.flag_bits & 0x1:
                    encrypted += 1
                mode = (info.external_attr >> 16) & 0xFFFF
                if mode and stat.S_ISLNK(mode):
                    links += 1
                if info.is_dir():
                    continue
                total += info.file_size
                suffix = Path(info.filename).suffix.lower()
                if suffix in EXECUTABLE:
                    executables += 1
                if suffix in NESTED:
                    nested += 1
                if info.compress_size > 0:
                    ratio = info.file_size / info.compress_size
                    if ratio > max_ratio:
                        issues.append(f"{info.filename}: сжатие {ratio:.0f}:1")
    except (zipfile.BadZipFile, OSError, RuntimeError) as error:
        return {"format": "zip", "error": str(error)}
    if total > max_total:
        issues.append(f"распакованный размер {total} больше лимита {max_total}")
    return {
        "format": "zip",
        "entries": entries,
        "total_size": total,
        "encrypted": encrypted,
        "links": links,
        "executables": executables,
        "nested": nested,
        "issues": issues[:limit],
        "issue_count": len(issues),
    }


def inspect_tar(path: Path, max_total: int, limit: int) -> dict[str, object]:
    issues: list[str] = []
    entries = total = links = executables = devices = nested = 0
    try:
        with tarfile.open(path, "r:*") as archive:
            for member in archive:
                entries += 1
                issues.extend(f"{member.name}: {item}" for item in name_issues(member.name))
                if member.issym() or member.islnk():
                    links += 1
                    target = member.linkname.replace("\\", "/")
                    target_parts = [part for part in target.split("/") if part not in ("", ".")]
                    if target.startswith("/") or ".." in target_parts:
                        issues.append(f"{member.name}: ссылка наружу {member.linkname}")
                if member.isdev():
                    devices += 1
                    issues.append(f"{member.name}: файл устройства")
                if member.isfile():
                    total += member.size
                    suffix = Path(member.name).suffix.lower()
                    if suffix in EXECUTABLE:
                        executables += 1
                    if suffix in NESTED:
                        nested += 1
    except (tarfile.TarError, OSError, EOFError) as error:
        return {"format": "tar", "error": str(error)}
    if total > max_total:
        issues.append(f"распакованный размер {total} больше лимита {max_total}")
    return {
        "format": "tar",
        "entries": entries,
        "total_size": total,
        "links": links,
        "executables": executables,
        "devices": devices,
        "nested": nested,
        "issues": issues[:limit],
        "issue_count": len(issues),
    }


def archive_kind(path: Path) -> str:
    lower = path.name.lower()
    if lower.endswith(".zip"):
        return "zip"
    if lower.endswith(ARCHIVE_SUFFIXES[1:]):
        return "tar"
    suffix = path.suffix.lower()
    if suffix in UNSUPPORTED:
        return "unsupported"
    return ""


def main() -> int:
    parser = argparse.ArgumentParser(description="Аудит архивов")
    parser.add_argument("--path", type=Path, required=True, help="Архив или каталог")
    parser.add_argument("--max-ratio", type=float, default=1000.0, help="Порог коэффициента сжатия")
    parser.add_argument("--max-total-mb", type=int, default=2048, help="Порог распакованного размера, МБ")
    parser.add_argument("--limit", type=int, default=50, help="Максимум проблем на архив")
    parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON")
    args = parser.parse_args()

    source = args.path.expanduser().resolve()
    if not source.exists():
        parser.error(f"Путь не найден: {source}")
    files = [source] if source.is_file() else [item for item in sorted(source.rglob("*")) if item.is_file()]
    max_total = args.max_total_mb * 1024 * 1024
    reports = []
    for path in files:
        kind = archive_kind(path)
        if not kind:
            continue
        if kind == "unsupported":
            reports.append({"file": str(path), "format": "unsupported", "issues": ["формат не поддерживается"]})
            continue
        if kind == "zip":
            report = inspect_zip(path, args.max_ratio, max_total, args.limit)
        else:
            report = inspect_tar(path, max_total, args.limit)
        report["file"] = str(path)
        reports.append(report)

    print(f"Проверено архивов: {len(reports)}")
    for report in reports:
        print()
        print(f"  {report['file']} [{report.get('format', '?')}]")
        if report.get("error"):
            print(f"    ошибка чтения: {report['error']}")
            continue
        if report.get("format") == "unsupported":
            print("    формат не поддерживается, проверьте вручную")
            continue
        print(f"    записей: {report.get('entries', 0)}, распакованный размер: {report.get('total_size', 0)} байт")
        print(f"    исполняемых: {report.get('executables', 0)}, ссылок: {report.get('links', 0)}, вложенных архивов: {report.get('nested', 0)}")
        if report.get("encrypted"):
            print(f"    зашифрованных записей: {report['encrypted']}")
        issue_count = report.get("issue_count", 0)
        print(f"    проблем: {issue_count}")
        for issue in report.get("issues", [])[: args.limit]:
            print(f"      - {issue}")

    if args.json:
        args.json.write_text(json.dumps({"archives": reports}, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
        print(f"JSON сохранён: {args.json}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get security-archive-audit
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Безопасность и аудит

Проверка прав, хеши, сертификаты, подозрительные файлы и базовая защита.

Теги