نظرة عامة

التثبيت
- mql
- cnspec
فحص النظام الأساسي المستهدف
معلومات الحزمة
Kubernetes

الحالة

حاويات Docker:
Homebrew:
Install.sh:
Install.ps1:
macOS Pkg:
Arch Linux:

التثبيت

أسهل طريقة لتثبيت mql و cnspec هي استخدام نصوص التثبيت.

عبر Shell Script (لينكس و macOS)

https://install.mondoo.com/sh```bash bash -c "$(curl -sSL https://install.mondoo.com/sh)"

### عبر PowerShell (Windows)

[`https://install.mondoo.com/ps1`](https://install.mondoo.com/ps1)```powershell
Set-ExecutionPolicy Unrestricted -Scope Process -Force;
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;
iex ((New-Object System.Net.WebClient).DownloadString('https://install.mondoo.com/ps1'));
Install-Mondoo;

خلف وكيل HTTP

مرّر الوكيل إلى سكربت التثبيت باستخدام -x (لينكس و macOS) أو -Proxy (ويندوز). يوجّه السكربت تنزيلاته الخاصة، وتثبيت الحزمة، وcnspec login والمحدّث التلقائي عبره. يحدث التنزيل الأولي للسكربت قبل قراءة العَلم، لذا وجّه ذلك إلى الوكيل أيضًا:```bash export https_proxy='http://proxy.example.com:3128' curl -sSL --proxy "$https_proxy" https://install.mondoo.com/sh | bash -s -- -x "$https_proxy"

## الميزات الرئيسية

- **اكتشاف تلقائي**: يكتشف تلقائيًا جميع نقاط النهاية (endpoints) المتاحة من مواصفات OpenAPI
- **توليد ذكي للحمولات (Payloads)**: ينشئ حمولات اختبار واقعية بناءً على مخططات API
- **اختبار أمني شامل**: يختبر نقاط الضعف الشائعة في API بما في ذلك:
  - حقن SQL (SQL Injection)
  - البرمجة النصية عبر المواقع (XSS)
  - تجاوز المصادقة (Authentication Bypass)
  - الوصول غير المصرح به (IDOR)
  - حقن الأوامر (Command Injection)
  - اجتياز المسار (Path Traversal)
  - وحقن NoSQL
- **تقارير مفصلة**: ينشئ تقارير شاملة بتنسيقات متعددة (JSON، HTML، Markdown)
- **دعم المصادقة**: يدعم طرق المصادقة المتعددة (Bearer Token، API Key، Basic Auth)
- **تكوين مرن**: خيارات تكوين شاملة عبر ملفات التكوين أو متغيرات البيئة
- **جاهز لـ CI/CD**: يتكامل بسهولة مع خطوط أنابيب CI/CD

## التثبيت

### من المصدر

```bash
git clone https://github.com/yourusername/api-fuzzer.git
cd api-fuzzer
pip install -r requirements.txt

باستخدام pip

pip install api-fuzzer

باستخدام Docker

docker build -t api-fuzzer .
docker run -v $(pwd)/reports:/app/reports api-fuzzer -s https://api.example.com/openapi.json

الاستخدام

الاستخدام الأساسي

python api_fuzzer.py -s https://api.example.com/openapi.json

خيارات متقدمة

python api_fuzzer.py \
  -s https://api.example.com/openapi.json \
  -o reports \
  -f json html markdown \
  -t 20 \
  --timeout 15 \
  --auth-type bearer \
  --auth-token YOUR_TOKEN \
  -v

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

الخيار	الوصف	الافتراضي
`-s, --spec`	مسار أو URL لمواصفات OpenAPI	مطلوب
`-o, --output`	دليل الإخراج للتقارير	`reports`
`-f, --format`	تنسيقات التقرير (json، html، markdown)	`json`
`-t, --threads`	عدد الخيوط المتزامنة	`10`
`--timeout`	مهلة الطلب بالثواني	`10`
`--auth-type`	نوع المصادقة (bearer، api_key، basic)	`none`
`--auth-token`	رمز المصادقة أو مفتاح API	`none`
`--config`	مسار ملف التكوين	`none`
`-v, --verbose`	تمكين الإخراج المفصل	`false`

التكوين

ملف التكوين

أنشئ ملف config.yaml:

target:
  spec_url: "https://api.example.com/openapi.json"
  base_url: "https://api.example.com"
  timeout: 10

authentication:
  type: "bearer"
  token: "your_token_here"

fuzzing:
  threads: 10
  delay: 0.1
  max_requests_per_endpoint: 50

payloads:
  sql_injection: true
  xss: true
  command_injection: true
  path_traversal: true
  nosql_injection: true

reporting:
  formats:
    - json
    - html
    - markdown
  output_dir: "reports"
  include_poc: true

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

export API_FUZZER_SPEC_URL="https://api.example.com/openapi.json"
export API_FUZZER_AUTH_TOKEN="your_token_here"
export API_FUZZER_THREADS=20

أمثلة

اختبار API بسيط

python api_fuzzer.py -s https://petstore.swagger.io/v2/swagger.json -o reports

اختبار API مع مصادقة

python api_fuzzer.py \
  -s https://api.example.com/openapi.json \
  --auth-type bearer \
  --auth-token "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -f json html

استخدام ملف التكوين

python api_fuzzer.py --config config.yaml

بنية المشروع

api-fuzzer/
├── api_fuzzer.py          # نقطة الدخول الرئيسية
├── requirements.txt       # تبعيات Python
├── config.yaml           # مثال على ملف التكوين
├── Dockerfile            # تكوين Docker
├── README.md             # هذا الملف
├── modules/
│   ├── __init__.py
│   ├── parser.py         # محلل مواصفات OpenAPI
│   ├── fuzzer.py         # محرك الاختبار
│   ├── payloads.py       # مولّد الحمولات
│   ├── auth.py           # معالجة المصادقة
│   └── reporter.py       # توليد التقارير
└── tests/
    ├── __init__.py
    └── test_fuzzer.py    # اختبارات الوحدة

المساهمة

نرحب بالمساهمات! يرجى اتباع الخطوات التالية:

قم بعمل Fork للمستودع
أنشئ فرعًا للميزة (git checkout -b feature/amazing-feature)
قم بعمل Commit لتغييراتك (git commit -m 'Add amazing feature')
ادفع إلى الفرع (git push origin feature/amazing-feature)
افتح طلب سحب (Pull Request)

الترخيص

هذا المشروع مرخص بموجب ترخيص MIT - راجع ملف LICENSE للحصول على التفاصيل.

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

للاستخدام التعليمي والاختبار الأمني المصرح به فقط.

هذه الأداة مخصصة لاختبار الاختراق الأخلاقي واختبار الأمان. يجب عليك:

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

المطورون غير مسؤولين عن أي سوء استخدام أو أضرار ناتجة عن هذه الأداة.

الدعم

المشكلات: GitHub Issues
المناقشات: GitHub Discussions
البريد الإلكتروني: [email protected]

شكر وتقدير

مستوحى من أدوات اختبار API مفتوحة المصدر المختلفة
شكر خاص لجميع المساهمين

تذكر: اختبر بمسؤولية! 🔒```powershell Set-ExecutionPolicy Unrestricted -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; $wc = New-Object System.Net.WebClient; $wc.Proxy = New-Object System.Net.WebProxy('http://proxy.example.com:3128'); iex ($wc.DownloadString('https://install.mondoo.com/ps1')); Install-Mondoo -Proxy 'http://proxy.example.com:3128';

على Linux وmacOS يتم التقاط `https_proxy` أو `http_proxy` الموروث تلقائيًا
عندما لا يتم تمرير `-x`. في كلتا الحالتين يتم تصدير كلا الصيغتين، بحيث
يتم الوصول إلى مستودعات التوزيعة نفسها — وهي HTTP عادي على Debian وUbuntu
— عبر الوكيل أيضًا. أي `no_proxy` قمت بتعيينه يتم تمريره
دون تغيير، بما في ذلك عبر `sudo`.

يجب أن يكون عنوان URL للوكيل عنوان URL عاديًا: إذا كان يحمل بيانات اعتماد،
فقم بترميزها بنسبة مئوية (`!` كـ `%21`، وهكذا). تتم كتابة القيمة في المهمة المجدولة
للمحدّث التلقائي، لذا يتم رفض الأحرف التي قد تحتاج إلى اقتباس هناك
بدلاً من تهريبها.

## افحص منصة هدفك

افحص [منصة هدفك](https://github.com/mondoohq/cnspec/#supported-targets):```bash
# query system information with incident and inventory query pack
mql scan aws
# scan the platform for security vulnerabilities
cnspec scan aws

سجّل للحصول على حساب Mondoo للوصول إلى المزيد من السياسات وتخزين التقارير. لمعرفة المزيد، اتصل بنا.```bash cnspec login -t 'eyJh...llZ4BW'

mql و cnspec يدعمان الأهداف المحلية والبعيدة، بما في ذلك الخوادم (Linux، Windows، macOS)، والسحابة (AWS، Azure، Google، VMware)، وKubernetes (EKS، GKE، AKS، ذاتية الإدارة)، والحاويات، وسجلات الحاويات، ومنتجات SaaS (Google Workspace، M365، GitHub، GitLab)، والمزيد.

تشغيل فحص:```bash
# scan your local host
cnspec scan local

# scan a cloud environment
cnspec scan aws
cnspec scan gcp
cnspec scan azure

# scan a kubernetes cluster
cnspec scan k8s

# scan a docker image from a remote registry
cnspec scan docker image debian:12

# scan a docker container (get ids from docker ps)
cnspec scan docker container 00fa961d6b6a

# scan a system over ssh
cnspec scan ssh [email protected]

معلومات الحزمة

https://install.mondoo.com/package/cnspec/{platform}/{arch}/{filetype}/{version}/{method}

تدعم الوسائط القيم التالية:

الوسيط	القيم
`platform`	`linux`, `windows`, `darwin`
`arch`	`amd64`, `arm64`, `armv7`, `armv6`, `386`, `ppc64le`
`filetype`	`tar.gz`, `deb`, `rpm`, `zip`, `pkg`, `msi`
`version`	`latest` أو رقم محدد
`method`	`download`, `filename`, `version`, `sha256`

Download the latest version

https://install.mondoo.com/package/cnspec/linux/arm64/rpm/latest/download

## الموارد

- [دليل التثبيت](https://github.com/mondoohq/installer/blob/main/docs/INSTALL.md)
- [دليل المستخدم](https://github.com/mondoohq/installer/blob/main/docs/USER_GUIDE.md)
- [مرجع API](https://github.com/mondoohq/installer/blob/main/docs/API.md)
- [الأسئلة الشائعة](https://github.com/mondoohq/installer/blob/main/docs/FAQ.md)
- [استكشاف الأخطاء وإصلاحها](https://github.com/mondoohq/installer/blob/main/docs/TROUBLESHOOTING.md)

## الترخيص

هذا المشروع مرخّص بموجب ترخيص MIT - راجع ملف [LICENSE](https://github.com/mondoohq/installer/blob/main/LICENSE) للتفاصيل.

## شكر وتقدير

- شكر خاص لجميع المساهمين
- مدعوم من مجتمع الأمن مفتوح المصدر```bash
# Get the filename for the latest cnspec package
https://install.mondoo.com/package/cnspec/linux/arm64/rpm/latest/filename

المكونات الإضافية

المكونات الإضافية الرسمية

مكون Burp Suite الإضافي - ماسح احتياطي مدعوم من Burp.
مكون Chrome الإضافي - مكون Chrome الإضافي لـ Burp.

المكونات الإضافية من طرف ثالث

نظام Kali Linux - أداة مدمجة في Kali Linux.
مكون ZAP الإضافي - مكون ZAP الإضافي لـ Backslash.
مكون Caido الإضافي - مكون Caido الإضافي لـ Backslash.

الأسئلة الشائعة

ما هو Backslash Powered Scanner؟

Backslash Powered Scanner هو ماسح ثغرات مدعوم من Burp Suite يكتشف الثغرات الأمنية في تطبيقات الويب باستخدام تقنيات متقدمة.

كيف يعمل Backslash Powered Scanner؟

يستخدم Backslash Powered Scanner تقنيات متقدمة لاكتشاف الثغرات الأمنية في تطبيقات الويب، بما في ذلك تحليل الاستجابات وتحديد نقاط الحقن.

هل Backslash Powered Scanner مجاني؟

نعم، Backslash Powered Scanner مجاني ومفتوح المصدر.

ما هي متطلبات Backslash Powered Scanner؟

يتطلب Backslash Powered Scanner تثبيت Burp Suite وJava 8 أو أحدث.

كيف أقوم بتثبيت Backslash Powered Scanner؟

يمكن تثبيت Backslash Powered Scanner من خلال مدير المكونات الإضافية في Burp Suite أو عن طريق تنزيل ملف JAR من صفحة الإصدارات.

كيف أستخدم Backslash Powered Scanner؟

لاستخدام Backslash Powered Scanner، قم بتحميل المكون الإضافي في Burp Suite وتكوين الإعدادات حسب الحاجة.

هل يمكنني المساهمة في Backslash Powered Scanner؟

نعم، يمكنك المساهمة في Backslash Powered Scanner من خلال الإبلاغ عن الأخطاء أو تقديم طلبات السحب على GitHub.

أين يمكنني العثور على مزيد من المعلومات حول Backslash Powered Scanner؟

يمكنك العثور على مزيد من المعلومات حول Backslash Powered Scanner في مستودع GitHub الخاص به.

هل Backslash Powered Scanner آمن للاستخدام؟

نعم، Backslash Powered Scanner آمن للاستخدام، لكن يجب عليك دائمًا اختبار تطبيقات الويب الخاصة بك في بيئة خاضعة للرقابة.

هل يمكنني استخدام Backslash Powered Scanner على تطبيقات الويب الخاصة بي؟

نعم، يمكنك استخدام Backslash Powered Scanner على تطبيقات الويب الخاصة بك، لكن يجب عليك دائمًا الحصول على إذن قبل اختبار تطبيقات الويب التي لا تملكها.