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

Маскирование отчёта

Заменяет почту, IP, токены и пароли в текстовом отчёте перед отправкой.

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

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

Скрипт читает текстовый файл и последовательно маскирует приватные ключи, учётные данные в URL, токены, длинные hex-строки, присваивания паролей, адреса почты и IP. Результат выводится на экран или в новый файл. Исходный файл не перезаписывается, при необходимости используется --force.

Запуск

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

python mask_report.py --path report.txt

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

Примеры

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

  • python mask_report.py --path report.txt --output report_clean.txt
  • python mask_report.py --path access.log --output clean.log --force
Зависимости

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

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

mask_report.py

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

import argparse
import re
import sys
from pathlib import Path

PRIVATE_KEY = re.compile(r"-----BEGIN [^-]+-----.*?-----END [^-]+-----", re.S)
URL_CREDENTIALS = re.compile(r"(https?://)([^/@\s]+)@")
TOKENS = re.compile(
    r"\b(?:AKIA[0-9A-Z]{16}|gh[pousr]_[A-Za-z0-9]{20,}|xox[abprs]-[A-Za-z0-9-]{10,}|eyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,})\b"
)
LONG_HEX = re.compile(r"\b[0-9a-fA-F]{32,}\b")
PASSWORDS = re.compile(r"(?i)\b(password|passwd|pwd|secret|token|api[_-]?key)(\s*[:=]\s*)(['\"]?)([^\s'\"]{3,})")
EMAILS = re.compile(r"\b([A-Za-z0-9._%+-])[A-Za-z0-9._%+-]*(@[A-Za-z0-9.-]+\.[A-Za-z]{2,})\b")
IPV4 = re.compile(r"\b(?:\d{1,3}\.){3}\d{1,3}\b")
IPV6 = re.compile(r"\b(?:[0-9A-Fa-f]{1,4}:){3,}[0-9A-Fa-f]{0,4}\b")


def main() -> int:
    parser = argparse.ArgumentParser(description="Маскирование отчёта")
    parser.add_argument("--path", type=Path, required=True, help="Исходный текстовый файл")
    parser.add_argument("--output", type=Path, help="Куда записать результат")
    parser.add_argument("--force", action="store_true", help="Перезаписать существующий output")
    args = parser.parse_args()

    source = args.path.expanduser().resolve()
    if not source.is_file():
        parser.error(f"Файл не найден: {source}")
    target = None
    if args.output:
        target = args.output.expanduser().resolve()
        if target == source:
            parser.error("Результат не может совпадать с исходным файлом. Выберите другой путь.")
        if target.exists() and not args.force:
            parser.error(f"Файл уже существует: {target}. Используйте --force")
    try:
        data = source.read_bytes()
    except OSError as error:
        print(f"Не удалось прочитать файл: {error}")
        return 2
    if b"\x00" in data[:4096]:
        print("Похоже, это бинарный файл. Маскирование отменено.")
        return 2

    text = data.decode("utf-8", errors="replace")
    stats = {
        "private_keys": len(PRIVATE_KEY.findall(text)),
        "url_credentials": len(URL_CREDENTIALS.findall(text)),
        "tokens": len(TOKENS.findall(text)),
        "long_hex": len(LONG_HEX.findall(text)),
        "passwords": len(PASSWORDS.findall(text)),
        "emails": len(EMAILS.findall(text)),
        "ipv4": len(IPV4.findall(text)),
        "ipv6": len(IPV6.findall(text)),
    }

    text = PRIVATE_KEY.sub("[PRIVATE KEY BLOCK]", text)
    text = URL_CREDENTIALS.sub(r"\1[userinfo]@", text)
    text = TOKENS.sub("[TOKEN]", text)
    text = LONG_HEX.sub("[HEX]", text)
    text = PASSWORDS.sub(r"\1\2\3***", text)
    text = EMAILS.sub(r"\1***\2", text)
    text = IPV4.sub("[IP]", text)
    text = IPV6.sub("[IPv6]", text)

    summary = ", ".join(f"{name}: {count}" for name, count in stats.items() if count)
    print(f"Маскирование: {summary or 'совпадений не найдено'}", file=sys.stderr)

    if target:
        target.write_text(text, encoding="utf-8")
        print(f"Результат записан: {target}", file=sys.stderr)
    else:
        sys.stdout.write(text)
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

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

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