Cygor

نظرة عامة

Cygor هو إطار عمل نمطي لاكتشاف الأصول يجمع بين المسح والتحليل وتعداد الخدمات في سير عمل واحد. فهو يستبدل مجموعة الأدوات المنفصلة بعملية آلية تتولى الاكتشاف والإثراء والتعداد الموجّه بسلاسة — مما يقلل العبء اليدوي ويتيح لك التركيز على النتائج بدلاً من إدارة الأدوات.

توفر واجهة الويب الخاصة بـ Cygor مركز قيادة مرئيًا موحّدًا ينظّم فوضى بيانات المسح الأولية. فبدلاً من البحث في ملفات XML أو JSON أو النصوص المسطحة التي لا نهاية لها، يتم تحليل النتائج وإثراؤها وعرضها تلقائيًا في مساحة واحدة مصممة للفرز السريع واتخاذ القرار.

بفضل FastAPI و Bootstrap 5، تتيح لوحة المعلومات ما يلي بسهولة:

• رؤية الصورة الكاملة في لمحة — تكشف العدّادات والملخصات توزيعات الخدمات واتجاهات أكواد الحالة وبصمات أنظمة التشغيل.
• التعمق فورًا — الانتقال من المقاييس عالية المستوى إلى تفاصيل كل مضيف والمنافذ ونتائج الوحدات بنقرة واحدة.
• تصور مستوى التعرض — إحدى وحدات Cygor وتُسمى Lockon تلتقط لقطات شاشة لخدمات الويب النشطة ويتم تضمين المخرجات مباشرة، مما يوفر سياقًا فوريًا دون مغادرة لوحة المعلومات.
• البقاء منظمًا أثناء الفرز — تحديد النتائج التي تمت مراجعتها مقابل غير المراجعة، وتصفية النتائج وفرزها، والتركيز على الأهداف الأعلى قيمة.

واجهة الويب ليست للعرض فقط — بل تهدف إلى الكفاءة والوضوح. فمن خلال جمع كل البيانات في مساحة عمل تفاعلية واحدة، تقلّل الوقت المستغرق في تحليل الملفات أو مواءمة المخرجات، وتتيح للمختبرين التركيز على ما يهم: فهم البيئة والتفاعل معها.

لماذا سُمي بـ Cygor؟

الكثير من الأدوات والتقنيات والأساليب التي أصنعها مستوحاة من عالم Spawn. إذا لم تكن قد قرأت أي قصة مصورة من Spawn من قبل، فلا بأس؛ سأشارك بعض المعلومات حول سبب اختياري لهذه الشخصية لتصبح اسم هذه الأداة.

اسم Cygor مستوحى من Cy-Gor، وهو بطل مضاد مأساوي في عالم Spawn. كان مايكل كونيتشني — عميل حكومي وصديق مقرب من آل سيمونز — قد حاول كشف الفساد بعد مقتل سيمونز. ومع ذلك، تم القبض عليه وإجباره على المشاركة في مشروع Sim، تجارب الدكتور فريدريك ويلهايم على القرود، حيث تم دمج جسد غوريلا مع عقل كونيتشني عبر التحكم الآلي الاختراقي. وكانت النتيجة الوحش المعروف باسم Cy-Gor — اختصارًا لـ Cybernetic Gorilla.

بعد هروبه من الأسر، شنّ Cy-Gor هجمات عنيفة، حتى أنه اخترق مراكز بيانات حكومية في نوبات من الارتباك والغضب. ورغم أنه طورد وأُعيد أسره عدة مرات، إلا أنه في النهاية قاوم الأنظمة التي سعت للسيطرة عليه — فأزال الغرسات التعقبية وحرر نفسه ليشق طريقه الخاص، ممزقًا بين الآلة والوحش والإنسان.

• المرجع: https://www.spawnworld.com/encyclopedia/cygor.htm

من يستخدم Cygor؟

• فرق الاختراق (Red Teams) ومختبري الاختراق (Pentesters) – أتمتة الاكتشاف، وتبسيط التعداد، والحفاظ على السياق عبر الاختبارات الكبيرة
• الفرق الزرقاء (Blue Teams) ومشرفو الأنظمة – اكتشاف الأصول غير المعروفة، والتحقق من قوائم الجرد، ورصد الأخطاء في التكوين التي توسّع سطح الهجوم.
• باحثو الأمن – تحليل بيانات المسح وتحليلها بسرعة لتحديد الاتجاهات والخدمات المهملة واكتشاف الحالات الشاذة النمطية.
• الطلاب والمعلمون – تعلّم تقنيات الاستطلاع والتعداد الواقعية في بيئة منظمة وقابلة للتكرار.

الأدوات التي يستخدمها Cygor:

• Nmap – كشف موثوق للخدمات والإصدارات؛ يتم تحليل مخرجات XML إلى بيانات مضيف/خدمة منظمة.
• Masscan – فحص منافذ عالي السرعة لاكتشاف سريع عبر الشبكات الكبيرة.
• Naabu – ماسح منافذ TCP بسيط وسريع يكمّل سير عمل Masscan/Nmap.
• Playwright – محرك أتمتة المتصفحات الذي تستخدمه Lockon لالتقاط لقطات شاشة للويب.
• اكتشاف محتوى الويب – يتم تنسيق ffuf و feroxbuster و gobuster و dirsearch بالتوازي بواسطة وحدة webenum (يتم تشغيل الأدوات المثبتة فقط).
• أدوات تعداد الخدمات – تدعم وحدات المستكشف كلاً من rpcclient/polenum (MSRPC) و ldapsearch/ldapdomaindump (LDAP) و snmpwalk/onesixtyone (SNMP) و dig/dnsrecon (DNS) و showmount (NFS)؛ وتتخطى كل وحدة عملها بسلاسة إذا كانت أداتها غير مثبتة.
• مكتبات Python – (requests و colorama و SQLModel وغيرها) للتحليل والإثراء وتنسيق المخرجات والتعامل مع قاعدة البيانات.

تثبيت Cygor

هناك عدة طرق مدعومة لتثبيت Cygor: pip و pipx و uv و docker.

التثبيت باستخدام pipx

بعض التبعيات (مثل gssapi الخاصة بـ Kerberos/WinRM) تُنشئ امتدادات C، لذا قم أولاً بتثبيت مجموعة أدوات البناء وملفات رؤوس Kerberos:

# Debian/Ubuntu/Kali:
sudo apt install -y build-essential python3-dev libkrb5-dev

# Stable version:
pipx install cygor

# Install from source:
git clone https://github.com/tjnull/cygor
cd cygor
pipx install .

نشر Cygor باستخدام Docker

إعداد Docker الخاص بـ Cygor يشمل التطبيق وخدمة قاعدة بيانات PostgreSQL معًا. يتحول النظام تلقائيًا إلى SQLite إذا كانت PostgreSQL غير متوفرة.

بداية سريعة

الإنتاج (موصى به):

# Option 1: Use the wrapper script (automatically handles port conflicts)
./docker-compose-up.sh up --build

# Option 2: Direct docker compose (uses default ports)
docker compose up --build

التطوير (مع تثبيت الكود المصدري):

# Option 1: Use the wrapper script (automatically handles port conflicts)
./docker-compose-up.sh dev up --build

# Option 2: Direct docker compose (uses default ports)
docker compose -f docker-compose-dev.yaml up --build

خدمات Docker Compose

يتضمن إعداد Docker Compose ما يلي:

• خدمة PostgreSQL: قاعدة بيانات مهيأة تلقائيًا (تتحول إلى SQLite إذا كانت غير متوفرة)
• خدمة Cygor: واجهة الويب والتطبيق
• الاكتشاف التلقائي للمنافذ: يتحقق من تعارض المنافذ ويستخدم منافذ بديلة عند الحاجة
• وحدات التخزين الدائمة:
  • results/: مخرجات المسح ونتائج credrecon وملفات قاعدة البيانات
  • cygor-config/: وحدة تخزين التكوين المحلي (تُنشأ تلقائيًا)

إعداد المنافذ

افتراضيًا:

• الإنتاج: PostgreSQL معرّضة على منفذ المضيف 5432 (إذا كان متاحًا)
• التطوير: PostgreSQL معرّضة على منفذ المضيف 5434 (إذا كان متاحًا)
• داخليًا: تستخدم الحاويات دائمًا المنفذ 5432 داخليًا (شبكة Docker)

إذا كانت المنافذ مستخدمة، يمكنك:

1. استخدام السكربت المُغلّف (wrapper) (موصى به - يكتشف المنافذ المتاحة تلقائيًا):

   root@kitploit:~

   ./docker-compose-up.sh up --build
   

2. تعيين المنفذ يدويًا:

   root@kitploit:~

   export POSTGRES_HOST_PORT=5435
   docker compose up --build
   

3. إزالة تعيين المنفذ (إذا لم تكن بحاجة إلى وصول خارجي إلى PostgreSQL): علّق على قسم ports: في ملف docker-compose.yaml

البناء اليدوي لـ Docker

لبناء صورة Docker يدويًا:

docker build -t cygor .

تشغيل حاوية واحدة (بدون خدمة PostgreSQL):

docker run --rm -v ./results:/opt/cygor/results \
  -e CYGOR_RESULTS_DIR=/opt/cygor/results \
  cygor web --host 0.0.0.0 --port 8080 --load-dir /opt/cygor/results

سلوك قاعدة البيانات

• مع Docker Compose: تستخدم خدمة PostgreSQL (تُهيأ تلقائيًا)
• إذا فشلت PostgreSQL: تتحول تلقائيًا إلى SQLite
• حاوية مستقلة: تستخدم SQLite افتراضيًا (ما لم يتم تعيين CYGOR_DB_URL)

متغيرات البيئة

متغيرات البيئة الأساسية لـ Docker:

البيانات ومساحة العمل:

• CYGOR_RESULTS_DIR: دليل النتائج (الافتراضي: /opt/cygor/results)
• CYGOR_WORKSPACE: دليل مساحة العمل (الافتراضي: /opt/cygor/results)
• CYGOR_RESULTS_PATH: مسار المضيف لحجم النتائج (الافتراضي: ./results)
• CYGOR_CONFIG_PATH: مسار المضيف لحجم تكوين المصادقة (الافتراضي: ./cygor-config)

قاعدة البيانات:

• CYGOR_DB_URL: سلسلة اتصال قاعدة البيانات (يتم تعيينها تلقائيًا بواسطة docker-compose)
• CYGOR_DB_USER: مستخدم قاعدة بيانات PostgreSQL (الافتراضي: cygor)
• CYGOR_DB_PASSWORD: كلمة مرور قاعدة بيانات PostgreSQL
• POSTGRES_HOST_PORT: تعيين منفذ مضيف PostgreSQL (لحل تعارض المنافذ)

التصحيح والتفصيل:

• CYGOR_DEBUG: تفعيل وضع التصحيح (اضبطه على 1 للتفعيل)
• CYGOR_VERBOSE: مستوى التفصيل (0=عادي، 1=مفصّل، 2=تصحيح)

التوثيق

توجد الأدلة المفصلة في cygor/wiki/ — التثبيت، وحدات التعداد المدمجة الإحدى عشرة، تطوير الإضافات، إدارة مساحات العمل، والمزيد. يعرض GitHub الدليل كموقع توثيق قابل للتصفح (ابدأ من cygor/wiki/README.md). كما يتم تقديم الصفحات نفسها عبر واجهة الويب في /docs بمجرد تشغيل cygor web start.

تشغيل Cygor

استخدم أمر Cygor الرئيسي للوصول إلى الأدوات المتاحة. لكل أمر فرعي شاشة مساعدة خاصة به (Cygor --help) توثق الخيارات والإجراءات.

tjnull@kali:~$ cygor
Usage:
  cygor <command> [args]

Commands:
  banner      Cygor tool banner (Warning it is large!)
  scan        Automated scanner to discover hosts and services. (Will require root/sudo privileges for scanning).
  parse       Analyze a NMAP scan file (nmap, gnmap, xml) and extract categorized hostlists by common service.
  enum        Loads enumeration modules that are located in the cygor modules directory. 
  workspace   Manage workspaces (init/set-default/show).
  web         Control/launch the Cygor Web UI (start/stop/status) or run directly.

Environment:
  CYGOR_WORKSPACE     Override default workspace just for this run.
  CYGOR_RESULTS_DIR   Used by web and modules if set. (Auto-set from default workspace.)

ماسح Cygor

ستحتاج إلى صلاحيات sudo (root) لتشغيل الماسح في cygor:

    Run host discovery with Masscan only:

    cygor scan -i eth0 -f scope.txt --discover masscan

    Run host discovery with both Masscan and Naabu, then Nmap on merged results:

    cygor scan -i eth0 -f scope.txt --discover masscan naabu --nmap-source merge

    Discovery only (no Nmap), save results in results/discovery/:

    cygor scan -i eth0 -f scope.txt --discover masscan naabu --discover-only

    Reuse saved discovery results for Nmap top ports scan:

    cygor scan --use-discovery results/discovery/merged-discovered.txt --scan-type top-ports

    Run Nmap with custom ports on discovered hosts:

    cygor scan --use-discovery results/discovery/masscan-discovered.txt --ports 80,443,8443

    Run Nmap with 10 parallel processes on full scope (Max is 100):

    \cygor scan -i eth0 -f scope.txt --discover naabu --processes 10 --scan-type fullscan:

    Run Cygor to discover hosts and scan them with Nmap with a provided lists of IP Addresses or CDRs:

    cygor scan -i eth0 --ips 10.10.10.1 10.10.10.5 10.10.20.0/24 --discover naabu --processes 10 --scan-type fullscan

    Exclude specific subnets or hosts from scan:

    cygor scan -i eth0 -f scope.txt --exclusions exclusions.txt --discover masscan

محلل Cygor:

    Parse a directory of Nmap results and print hostlists:

    cygor parse results/nmap

    Parse a single XML and write hostlists to results/parsed-hostlists:

    cygor parse results/nmap/scan1.xml -o results

    Recursively parse .xml/.nmap/.gnmap files and write outputs:

    cygor parse /path/to/scans --out-dir results

وحدات تعداد Cygor

يأتي Cygor مع مجموعة متزايدة من وحدات التعداد الخاصة بالبروتوكولات. كل وحدة تغلّف أدوات مجرّبة، وتحلل المخرجات إلى صفوف مصنفة ("parse-don't-dump")، وتضع النتائج في المخزون (قاعدة البيانات + واجهة الويب) حيث يمكن البحث فيها وربطها بالمضيف. كما يتم تغذية الملاحظات عالية الإشارة تلقائيًا إلى محرك الخطوات التالية، الذي يعرض النتائج ذات الأولوية والأوامر الجاهزة للتنفيذ في واجهة الويب.

    List all available modules:

    cygor enum --list

    Run lockon against an http hostlist:

    cygor enum lockon web -f results/parsed-hostlists/http/http-hostlist.txt -o results/enum/lockon

    Run web content discovery (multi-tool, with screenshots):

    cygor enum webenum -f results/parsed-hostlists/http-https/http-https-hostlist.txt --screenshot

    Run nfsexplorer against NFS targets (exports only):

    cygor enum nfsexplorer -i results/parsed-hostlists/nfs/nfs-hostlist.txt --info

    Run smbexplorer and list files:

    cygor enum smbexplorer -i results/parsed-hostlists/smb/smb-hostlist.txt --list-files

    Enumerate MSRPC (null session) with password policy + RID cycling:

    cygor enum rpcexplorer -i results/parsed-hostlists/smb/smb-hostlist.txt --rid-cycle

    Probe databases for unauthenticated access (point at any DB service hostlist):

    cygor enum dbprobe -i results/parsed-hostlists/mysql/mysql-hostlist.txt

شغّل cygor enum <module> --help للحصول على مرجع الخيارات الكامل لكل وحدة.

إضافات Cygor

Cygor قابل للتوسعة — ضع ملف Python في ~/.cygor/plugins/ وسيظهر ضمن cygor enum --list (وفي واجهة الويب) مثل أي وحدة مدمجة. يمكنك تغليف أدواتك الخاصة، أو توزيع ماسحات داخلية بين فريقك، أو توسعة Cygor لاختبار محدد دون عمل fork.

    Scaffold a new plugin (writes ~/.cygor/plugins/my_scanner.py):

    cygor plugin create "My Scanner"

    Install a plugin from a local file or a git URL:

    cygor plugin install ./my_scanner.py
    cygor plugin install https://github.com/example/cygor-myscanner

    Validate, list, update, remove:

    cygor plugin validate ./my_scanner.py
    cygor plugin list
    cygor plugin update --all
    cygor plugin remove my_scanner

    Run an installed plugin (same as a built-in module):

    cygor enum my_scanner -t 10.10.10.5

توجد ثلاث إضافات مرجعية في docs/examples/modules/: مثال بسيط، وغلاف لأداة خارجية، وقالب كامل مشروح. راجع دليل تطوير الإضافات للتعرف على تنسيق الإضافة الكامل، والخيارات/الأعمدة/العروض، والتعامل مع التبعيات، وتوافق الإصدارات، وقائمة السماح الاختيارية للإضافات.

واجهة الويب الخاصة بـ Cygor

بعد جمع البيانات، يمكنك تحميلها إلى واجهة الويب الخاصة بـ Cygor لتحويل نتائج المسح إلى تصور واضح للمضيفين والخدمات والنتائج الرئيسية الأخرى. سينشئ Cygor ملفًا باسم cygor.db يحتوي على البيانات اللازمة لنمذجتها في واجهة الويب الخاصة بـ Cygor

تشغيل خادم الويب

# Basic usage - start on default host/port (127.0.0.1:8000)
cygor web start

# Start on all interfaces, port 8080
cygor web start -H 0.0.0.0 -p 8080

# Start with custom results directory
cygor web start --load-dir /path/to/results

# Start with verbose output
cygor web start -vv

# Start with all options
cygor web start -H 0.0.0.0 -p 8080 --load-dir ~/scan-results -vv

خيارات سطر الأوامر

شغّل cygor web start --help للحصول على القائمة الكاملة للخيارات.

إدارة خادم الويب

# Check if the web server is running
cygor web status

# Stop a running web server
cygor web stop

خيارات قاعدة البيانات

يكتشف Cygor تلقائيًا ويستخدم PostgreSQL إذا كانت متوفرة، وإلا يتحول إلى SQLite:

• PostgreSQL (موصى بها للإنتاج):

  • تُكتشف تلقائيًا إذا كان psql متاحًا
  • تنشئ قاعدة البيانات والمستخدم عند الحاجة
  • سلسلة الاتصال: postgresql+psycopg_async://user:pass@host/db

• SQLite (الخيار الاحتياطي الافتراضي):

  • لا يتطلب أي إعداد
  • ملف قاعدة البيانات: cygor.db في دليل النتائج
  • مناسب للنشر أحادي المستخدم

إخلاء مسؤولية:

Cygor هو إطار عمل للأبحاث الأمنية والتعليم. صُمم ليُستخدم فقط في البيئات التي لديك فيها إذن صريح ومكتوب — مثل اختبارات الاختراق، وعمليات الفرق الحمراء، والمختبرات التعليمية، أو نطاقات الاختبار الشخصية.

يجب عدم استخدام هذا البرنامج للوصول غير المصرح به، أو الاقتحام، أو تعطيل الأنظمة التي لا تملكها أو لا تتحكم فيها. قد يؤدي القيام بذلك إلى انتهاك القوانين واللوائح في منطقتك، وقد ينتج عنه ملاحقة جنائية أو عقوبات مدنية.

بتحميل Cygor أو تشغيله أو تعديله، فإنك توافق على ما يلي:

• أنت وحدك المسؤول عن كيفية استخدامه.
• ستقتصر استخدامه على السيناريوهات القانونية والأخلاقية.

لا يتحمل مؤلفو Cygor والمساهمون فيه أي مسؤولية عن سوء الاستخدام أو الضرر أو العواقب الناشئة عن استخدام هذا البرنامج.

إذا لم تكن متأكدًا مما إذا كان لديك إذن باستخدام Cygor في بيئة معينة، فلا تقم بتشغيله.