#!/usr/bin/env python3 """Аудит переменных среды с маскировкой секретов.""" from __future__ import annotations import argparse import csv import json import os import sys from datetime import datetime from pathlib import Path SECRET_MARKERS = ( "TOKEN", "SECRET", "PASSWORD", "PASSWD", "PRIVATE", "CREDENTIAL", "AUTHORIZATION", "APIKEY", "API_KEY", "ACCESS_KEY", "CLIENT_KEY", "CONNECTION", "DATABASE_URL", "DSN", ) def is_secret(name: str) -> bool: upper = name.upper() return any(marker in upper for marker in SECRET_MARKERS) def main() -> int: parser = argparse.ArgumentParser(description="Аудит переменных среды") parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON") parser.add_argument("--csv", type=Path, help="Сохранить отчёт в CSV") args = parser.parse_args() rows = [] for name in sorted(os.environ): value = os.environ[name] secret = is_secret(name) rows.append( { "name": name, "value": "***" if secret else value, "masked": secret, } ) path_value = os.environ.get("PATH", "") path_entries = [item for item in path_value.split(os.pathsep) if item] normalized = [os.path.normcase(item.rstrip(os.sep)) for item in path_entries] duplicates = sorted({item for item in normalized if normalized.count(item) > 1}) masked_count = sum(1 for row in rows if row["masked"]) print(f"Переменных всего: {len(rows)}") print(f"Скрыто значений: {masked_count}") print(f"Элементов PATH: {len(path_entries)}") if duplicates: print("Повторы в PATH:") for item in duplicates: print(f" {item}") print() for row in rows: print(f"{row['name']}={row['value']}") if args.json: args.json.parent.mkdir(parents=True, exist_ok=True) payload = { "generated": datetime.now().isoformat(timespec="seconds"), "total": len(rows), "masked": masked_count, "path_entries": len(path_entries), "path_duplicates": duplicates, "variables": rows, } args.json.write_text(json.dumps(payload, ensure_ascii=False, indent=2) + "\n", encoding="utf-8") print(f"JSON сохранён: {args.json}") if args.csv: args.csv.parent.mkdir(parents=True, exist_ok=True) with args.csv.open("w", encoding="utf-8", newline="") as handle: writer = csv.DictWriter(handle, fieldnames=["name", "value", "masked"]) writer.writeheader() writer.writerows(rows) print(f"CSV сохранён: {args.csv}") return 0 if __name__ == "__main__": try: raise SystemExit(main()) except KeyboardInterrupt: print("Прервано пользователем", file=sys.stderr) raise SystemExit(130)