Маскирование отчёта
Заменяет почту, IP, токены и пароли в текстовом отчёте перед отправкой.
Что делает скрипт
Скрипт читает текстовый файл и последовательно маскирует приватные ключи, учётные данные в 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.txtpython mask_report.py --path access.log --output clean.log --force
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.