Аудит переменных среды
Показывает переменные среды, маскирует секреты и проверяет дубликаты в PATH.
Что делает скрипт
Скрипт перечисляет переменные окружения, скрывает значения с признаками токенов, паролей и ключей, считает элементы PATH и ищет повторы. Результат можно выгрузить в JSON или CSV. Значения секретов не выводятся даже при экспорте.
- Значения переменных среды могут содержать чувствительные пути. Проверьте отчёт перед отправкой.
Быстрый старт
python environment_audit.py
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python environment_audit.pypython environment_audit.py --json reports/env.jsonpython environment_audit.py --csv reports/env.csv
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
environment_audit.py
#!/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)
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.