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

Поиск секретов в файлах

Ищет ключи, токены и пароли в текстовых файлах и маскирует найденное.

Python Windows macOS Linux Средний
Скачать scan_secrets.py
Описание

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

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

Запуск

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

python scan_secrets.py --path ./repo

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

Примеры

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

  • python scan_secrets.py --path . --json secrets.json
  • python scan_secrets.py --path ./config --fail
Зависимости

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

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux 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())

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

CLI 1.0.0

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

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

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

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

Категория

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

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