#!/usr/bin/env python3 """Поиск секретов с маскированием найденных значений.""" from __future__ import annotations import argparse import json import os import re from pathlib import Path PATTERNS = ( ("private-key", re.compile(r"-----BEGIN (?:RSA |EC |OPENSSH |DSA |ENCRYPTED )?PRIVATE KEY-----")), ("aws-access-key", re.compile(r"\bAKIA[0-9A-Z]{16}\b")), ("github-token", re.compile(r"\bgh[pousr]_[A-Za-z0-9]{20,}\b")), ("slack-token", re.compile(r"\bxox[abprs]-[A-Za-z0-9-]{10,}\b")), ("jwt", re.compile(r"\beyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\b")), ("password", re.compile(r"(?i)\b(password|passwd|pwd|secret|token|api[_-]?key)\b\s*[:=]\s*['\"]?([^\s'\"]{6,})")), ("long-hex", re.compile(r"\b[0-9a-fA-F]{40,}\b")), ) SKIP_DIRS = {".git", "node_modules", "__pycache__", ".venv", "venv"} def mask(value: str) -> str: value = value.strip() if len(value) <= 8: return "*" * len(value) return value[:2] + "*" * max(4, len(value) - 4) + value[-2:] def iter_files(root: Path): for dirpath, dirnames, filenames in os.walk(root, followlinks=False): dirnames[:] = sorted(d for d in dirnames if d not in SKIP_DIRS) for name in sorted(filenames): path = Path(dirpath) / name if path.is_file() and not path.is_symlink(): yield path def main() -> int: parser = argparse.ArgumentParser(description="Поиск секретов в текстовых файлах") parser.add_argument("--path", type=Path, default=Path("."), help="Каталог для поиска") parser.add_argument("--max-size", type=int, default=2_000_000, help="Пропускать файлы больше N байт") parser.add_argument("--limit", type=int, default=100, help="Максимум находок") parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON") parser.add_argument("--fail", action="store_true", help="Вернуть код 1 при находках") args = parser.parse_args() root = args.path.expanduser().resolve() if not root.is_dir(): parser.error(f"Каталог не найден: {root}") findings = [] scanned = 0 seen: set[tuple[str, int, str]] = set() for path in iter_files(root): try: info = path.stat() if info.st_size > args.max_size: continue data = path.read_bytes() except OSError: continue if b"\x00" in data[:4096]: continue scanned += 1 text = data.decode("utf-8", errors="replace") relative = path.relative_to(root).as_posix() for lineno, line in enumerate(text.splitlines(), start=1): for name, regex in PATTERNS: match = regex.search(line) if not match: continue key = (relative, lineno, name) if key in seen: continue seen.add(key) if name == "password": sample = "[PASSWORD VALUE]" elif name == "private-key": sample = "[PRIVATE KEY HEADER]" else: sample = mask(match.group(0)) findings.append( { "file": relative, "line": lineno, "type": name, "sample": sample, } ) if len(findings) >= args.limit: break if len(findings) >= args.limit: break if len(findings) >= args.limit: break print(f"Каталог: {root}") print(f"Просмотрено текстовых файлов: {scanned}") print(f"Найдено совпадений: {len(findings)}") if findings: print() for item in findings: print(f" {item['file']}:{item['line']} [{item['type']}] {item['sample']}") print() print("Значения замаскированы. Проверьте, не попали ли секреты в репозиторий или резервные копии.") if args.json: payload = {"root": str(root), "scanned": scanned, "findings": findings} args.json.write_text(json.dumps(payload, ensure_ascii=False, indent=2) + "\n", encoding="utf-8") print(f"JSON сохранён: {args.json}") if args.fail and findings: return 1 return 0 if __name__ == "__main__": raise SystemExit(main())