Поиск секретов в файлах
Ищет ключи, токены и пароли в текстовых файлах и маскирует найденное.
Что делает скрипт
Скрипт обходит каталог, пропускает бинарные и слишком большие файлы и применяет набор шаблонов для приватных ключей, токенов облачных сервисов, JWT и присваиваний паролей. В отчёт попадают путь, номер строки, тип находки и замаскированный фрагмент. Полные значения не выводятся.
Быстрый старт
python scan_secrets.py --path ./repo
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python scan_secrets.py --path . --json secrets.jsonpython scan_secrets.py --path ./config --fail
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
scan_secrets.py
#!/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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.