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

Манифест контрольных сумм

Создаёт и проверяет SHA-256 или SHA-512 манифест каталога.

Python Windows macOS Linux Новичок
Скачать hash_manifest.py
Описание

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

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

Запуск

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

python hash_manifest.py create --path ./etc --manifest manifest.json

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

Примеры

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

  • python hash_manifest.py create --path . --manifest manifest.json --algorithm sha512
  • python hash_manifest.py verify --path . --manifest manifest.json --report diff.json
Зависимости

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

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

hash_manifest.py

#!/usr/bin/env python3
"""Создание и проверка манифеста контрольных сумм."""
from __future__ import annotations

import argparse
import hashlib
import json
import os
import sys
from datetime import datetime, timezone
from pathlib import Path

DEFAULT_EXCLUDES = {".git", "__pycache__", "node_modules", ".venv", "venv"}


def file_hash(path: Path, algorithm: str, chunk_size: int = 1024 * 1024) -> str:
    digest = hashlib.new(algorithm)
    with path.open("rb") as handle:
        while True:
            chunk = handle.read(chunk_size)
            if not chunk:
                break
            digest.update(chunk)
    return digest.hexdigest()


def iter_files(root: Path, excludes: set[str]):
    for dirpath, dirnames, filenames in os.walk(root, followlinks=False):
        dirnames[:] = sorted(d for d in dirnames if d not in excludes)
        for name in sorted(filenames):
            path = Path(dirpath) / name
            if path.is_symlink() or not path.is_file():
                continue
            yield path


def collect(root: Path, algorithm: str, excludes: set[str], manifest: Path) -> dict[str, dict[str, object]]:
    files: dict[str, dict[str, object]] = {}
    for path in iter_files(root, excludes):
        if path.resolve() == manifest.resolve():
            continue
        try:
            info = path.stat()
            relative = path.relative_to(root).as_posix()
            files[relative] = {"hash": file_hash(path, algorithm), "size": info.st_size}
        except OSError as error:
            print(f"Пропуск {path}: {error}", file=sys.stderr)
    return files


def command_create(args: argparse.Namespace) -> int:
    root = args.path.expanduser().resolve()
    manifest = args.manifest.expanduser().resolve()
    if not root.is_dir():
        print(f"Каталог не найден: {root}")
        return 2
    excludes = set(DEFAULT_EXCLUDES) | set(args.exclude)
    files = collect(root, args.algorithm, excludes, manifest)
    payload = {
        "version": 1,
        "algorithm": args.algorithm,
        "root": str(root),
        "created": datetime.now(timezone.utc).isoformat(),
        "exclude": sorted(excludes),
        "files": files,
    }
    manifest.write_text(json.dumps(payload, ensure_ascii=False, indent=2, sort_keys=True) + "\n", encoding="utf-8")
    print(f"Файлов в манифесте: {len(files)}")
    print(f"Алгоритм: {args.algorithm}")
    print(f"Манифест: {manifest}")
    return 0


def command_verify(args: argparse.Namespace) -> int:
    root = args.path.expanduser().resolve()
    manifest = args.manifest.expanduser().resolve()
    if not root.is_dir():
        print(f"Каталог не найден: {root}")
        return 2
    try:
        payload = json.loads(manifest.read_text(encoding="utf-8"))
        recorded = payload["files"]
        algorithm = payload.get("algorithm", "sha256")
    except (OSError, ValueError, KeyError, AttributeError) as error:
        print(f"Не удалось прочитать манифест: {error}")
        return 2

    excludes = set(DEFAULT_EXCLUDES) | set(payload.get("exclude", [])) | set(args.exclude)
    current = collect(root, algorithm, excludes, manifest)
    changed = []
    missing = []
    for relative, item in recorded.items():
        if relative not in current:
            missing.append(relative)
        elif current[relative]["hash"] != item.get("hash"):
            changed.append({"path": relative, "expected": item.get("hash"), "actual": current[relative]["hash"]})
    new = sorted(set(current) - set(recorded))

    print(f"Каталог: {root}")
    print(f"Записей в манифесте: {len(recorded)}")
    print(f"Изменено: {len(changed)}")
    print(f"Удалено: {len(missing)}")
    print(f"Новых: {len(new)}")
    for item in changed[: args.limit]:
        print(f"  изменён: {item['path']}")
    for relative in missing[: args.limit]:
        print(f"  удалён: {relative}")
    for relative in new[: args.limit]:
        print(f"  новый: {relative}")

    if args.report:
        report = {
            "root": str(root),
            "manifest": str(manifest),
            "changed": changed,
            "missing": missing,
            "new": new,
        }
        args.report.write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
        print(f"Отчёт сохранён: {args.report}")

    return 1 if changed or missing or new else 0


def main() -> int:
    parser = argparse.ArgumentParser(description="Манифест контрольных сумм")
    subparsers = parser.add_subparsers(dest="command", required=True)

    for name in ("create", "verify"):
        sub = subparsers.add_parser(name)
        sub.add_argument("--path", type=Path, required=True, help="Каталог для проверки")
        sub.add_argument("--manifest", type=Path, required=True, help="Файл манифеста")
        sub.add_argument("--exclude", action="append", default=[], help="Исключить каталог по имени")
        sub.add_argument("--limit", type=int, default=30, help="Сколько строк показать")
        if name == "create":
            sub.add_argument("--algorithm", choices=("sha256", "sha512"), default="sha256")
        else:
            sub.add_argument("--report", type=Path, help="Сохранить отчёт о расхождениях")

    args = parser.parse_args()
    if args.limit < 1:
        parser.error("--limit должен быть положительным")
    if args.command == "create":
        return command_create(args)
    return command_verify(args)


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

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

CLI 1.0.0

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

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

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

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

Категория

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

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