---

## حالات الاستخدام

### اختبار الاختراق
- التحقق من صحة بيانات الاعتماد المكتشفة عبر خدمات متعددة أثناء التقييمات الداخلية
- اختبار أنماط إعادة استخدام كلمات المرور عبر خدمات قواعد البيانات ومشاركة الملفات
- تحديد بيانات الاعتماد الافتراضية على البنية التحتية المنشورة حديثًا

### عمليات الفريق الأحمر
- التحقق السريع من صحة بيانات الاعتماد بعد تفريغ كلمات المرور أو حملات التصيد
- اختبار فرص الحركة الجانبية عبر خدمات الشبكة
- التحقق من صحة بيانات الاعتماد المخترقة عبر بيئات غير متجانسة

### رش المفاتيح الخاصة

هل وجدت مفتاحًا خاصًا على نظام مخترق؟ قم برشه عبر الشبكة لتعرف أين يمنح وصولًا أيضًا:```bash
# Discover SSH services and spray a found private key
naabu -host 10.0.0.0/24 -p 22 -silent | \
  nerva --json | \
  brutus creds -u root,admin,ubuntu,deploy -k /path/to/found_key --json

### التحقق الأمني
- اختبار بيانات الاعتماد الافتراضية على الخدمات المنشورة حديثًا
- التحقق من تطبيق سياسة كلمة المرور عبر المنصات
- إنشاء سجلات تدقيق لتقييم الامتثال والأمان

---

## التثبيت

### الملفات الثنائية الجاهزة (موصى بها)

تنزيل من [GitHub Releases](https://github.com/praetorian-inc/brutus/releases):```bash
# Linux (amd64)
curl -L https://github.com/praetorian-inc/brutus/releases/latest/download/brutus-linux-amd64.tar.gz | tar xz
sudo mv brutus /usr/local/bin/

# macOS (Apple Silicon)
curl -L https://github.com/praetorian-inc/brutus/releases/latest/download/brutus-darwin-arm64.tar.gz | tar xz
sudo mv brutus /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/praetorian-inc/brutus/releases/latest/download/brutus-darwin-amd64.tar.gz | tar xz
sudo mv brutus /usr/local/bin/

### تثبيت Go```bash
go install github.com/praetorian-inc/brutus/cmd/brutus@latest

كل أمر فرعي له أسماء مستعارة لسهولة الاكتشاف:

| الأمر الفرعي | الأسماء المستعارة |
|------------|---------|
| `creds` | `services`, `defaults`, `credentials` |
| `web` | `http`, `panels` |
| `snmp` | `community` |
| `badkeys` | `keys`, `ssh-keys`, `badkey` |
| `logon` | `stickykeys`, `sticky-keys`, `utilman`, `sethc`, `winlogon`, `accessibility` |
| `enum` | *(لا يوجد)* |```bash
# Test SSH credentials
brutus creds --target 192.168.1.100:22 --protocol ssh -u root -p toor

# Test HTTP web panel with AI credential detection
brutus web --target 192.168.1.1:80 --experimental-ai

# Test HTTP web panel with manual credentials
brutus web --target 192.168.1.1:80 -c "admin:admin,root:toor"

# Test SNMP community strings
brutus snmp --target 192.168.1.1:161 --mode aggressive

# Detect Windows logon-screen backdoors
brutus logon --target 10.0.0.50:3389

# Pipeline mode: creds skips HTTP/SNMP, web skips non-HTTP, snmp skips non-SNMP
naabu -host 10.0.0.0/24 -silent | nerva --json | brutus creds -P passwords.txt
naabu -host 10.0.0.0/24 -p 80,443,8080 -silent | nerva --json | brutus web --experimental-ai
naabu -host 10.0.0.0/24 -p 161 -silent | nerva --json | brutus snmp --mode aggressive

### مثال الإخراج```
$ brutus creds --target 192.168.1.100:22 --protocol ssh -u root,admin -p toor,password,admin
[+] VALID: ssh root:toor @ 192.168.1.100:22 (1.23s)

مخرجات JSON لتكامل خط الأنابيب (يقوم بإخراج بيانات الاعتماد الناجحة فقط):```
$ brutus creds --target 192.168.1.100:22 --protocol ssh -u root -p toor --json
{"protocol":"ssh","target":"192.168.1.100:22","username":"root","password":"toor","duration":"1.234567ms","banner":"SSH-2.0-OpenSSH_8.9p1"}

#### السيناريو 2: استطلاع برنامج مكافآت الثغرات على نطاق مستهدف```bash
# Full pipeline against a single target
naabu -host target.example.com -top-ports 1000 -silent | \
  nerva --json | \
  brutus creds

# Or scan a list of subdomains
cat subdomains.txt | naabu -silent | nerva --json | brutus creds

#### السيناريو 4: اختبار مفتاح SSH عبر البنية التحتية```bash
# Test embedded bad keys (Vagrant, F5 BIG-IP, ExaGrid, etc.) across a range
naabu -host 10.0.0.0/8 -p 22 -rate 1000 -silent | \
  nerva --json | \
  brutus badkeys --json -o ssh-key-findings.json

# Find systems using compromised SSH keys (key field is true)
cat ssh-key-findings.json | jq 'select(.key == true)'

### استيراد أدوات المسح (Nmap & Masscan)

يمكن لـ Brutus استيراد الأهداف مباشرة من ملفات مخرجات المسح لـ **nmap** و **masscan**، مما يلغي الحاجة إلى تحويل التنسيق أو استخدام أدوات وسيطة.

#### استيراد XML من Nmap (`--nmap-file`)

استيراد الأهداف من مخرجات XML الخاصة بـ nmap (`-oX`). يوفر Nmap بصمة الخدمة، لذلك يقوم Brutus تلقائيًا بتعيين الخدمات المكتشفة إلى البروتوكول الصحيح:```bash
# Run an nmap service scan
nmap -sV -oX scan.xml 10.0.0.0/24 -p 22,3306,5432,6379,445,3389

# Feed nmap results directly to Brutus
brutus creds --nmap-file scan.xml -P passwords.txt

# Test web services from nmap scan
brutus web --nmap-file scan.xml -c "admin:admin,root:password"

# Test SNMP from nmap scan
brutus snmp --nmap-file scan.xml --mode aggressive

# JSON output for scripting
brutus creds --nmap-file scan.xml --json -o results.json

#### الجمع بين سير العمل الأخرى

تعمل العلامات `--nmap-file` و `--masscan-file` مع جميع الأوامر الفرعية وتستبعد بعضها البعض مع `--target` و `--targets-file` والإدخال القياسي:```bash
# Scan for RDP backdoors from nmap results
brutus logon --nmap-file scan.xml

# Test SSH bad keys from nmap results
brutus badkeys --nmap-file scan.xml

# Override protocol for all masscan targets
brutus creds --masscan-file scan.json --protocol redis -p "redis,password"

**Nerva URI** (إخراج Nerva الافتراضي، لا حاجة إلى `--json`):```bash
# Nerva outputs URI-scheme lines by default
$ echo "github.com:22" | nerva
ssh://github.com:22 (20.205.243.166)

# Pipe directly to Brutus — protocol is extracted from the URI scheme
echo "10.0.0.1:22" | nerva | brutus creds
echo "10.0.0.0/24:3306" | naabu -silent | nerva | brutus creds

Brutus يقوم تلقائيًا بـ:
- تحليل صيغ JSON، URI، والتنسيقات المستهدفة العارية
- ربط الخدمات بالبروتوكولات
- اختبار بيانات الاعتماد الافتراضية المناسبة
- إخراج النتائج بصيغة JSON مطابقة

### تنسيق مخرجات الأنابيب

يقوم Brutus بإخراج بيانات الاعتماد الناجحة فقط بصيغة JSONL (كائن JSON واحد لكل سطر):```bash
# Brutus JSON output (with --json flag) - only successful authentications
{"protocol":"ssh","target":"192.168.1.100:22","username":"root","password":"toor","duration":"1.234567ms","banner":"SSH-2.0-OpenSSH_8.9p1"}
{"protocol":"mysql","target":"192.168.1.101:3306","username":"root","password":"","duration":"890.123µs"}
{"protocol":"ssh","target":"192.168.1.103:22","username":"vagrant","key":true,"duration":"2.345678ms","banner":"SSH-2.0-OpenSSH_9.6"}

### مجموعة المفاتيح المدمجة

| المنتج | CVE | المستخدم الافتراضي | الوصف |
|---------|-----|--------------|-------------|
| Vagrant | - | vagrant, root | مفتاح غير آمن من HashiCorp Vagrant |
| F5 BIG-IP | CVE-2012-1493 | root | مفتاح مضيف SSH ثابت |
| ExaGrid | CVE-2016-1561 | root | باب خلفي لجهاز النسخ الاحتياطي |
| Monroe DASDEC | CVE-2013-0137 | root | أنظمة التنبيه في حالات الطوارئ |
| Barracuda | CVE-2014-8428 | cluster | جهاز موازن التحميل الافتراضي |
| Ceragon FibeAir | CVE-2015-0936 | mateidu | وصلة لاسلكية خلفية |
| Array Networks | - | sync | أجهزة vAPV/vxAG |
| Quantum DXi | - | root | أجهزة إزالة التكرار |
| Loadbalancer.org | - | root | موازنات التحميل للمؤسسات |

---

## أوضاع العدوانية

يُتحكم في مستوى العدوانية عبر جميع الأوامر الفرعية باستخدام العلامة العامة `--mode` (`-m`). وهي تُحدد إعدادات مسبقة لضبط الأداء تحقق التوازن بين التغطية والأمان:

| الوضع | عدد الخيوط | مهلة الانتظار | حد المعدل | التشتت | إعادة المحاولة | حالة الاستخدام |
|------|---------|---------|------------|--------|---------|----------|
| `cautious` | 5 | 15ث | 2 طلب/ث | 500مللي ث | 1 | بيئات الإنتاج، تجنب الحظر |
| `default` | 10 | 10ث | غير محدود | لا شيء | 2 | الاختبار القياسي |
| `aggressive` | 20 | 10ث | غير محدود | لا شيء | 3 | بيئات المختبر/CTF، أقصى تغطية |

يتم تطبيق الإعدادات المسبقة للوضع أولاً، ثم تقوم أي علامات CLI صريحة بتجاوزها:```bash
# Safe mode for production Active Directory (low concurrency, rate-limited)
brutus creds --target dc.corp.local:445 --protocol smb -m cautious -U users.txt -P passwords.txt

# Maximum coverage for a CTF
brutus creds --target 10.10.10.100:22 --protocol ssh -m aggressive -U users.txt -P rockyou.txt

# Cautious mode but override threads
brutus creds --target 192.168.1.100:22 --protocol ssh -m cautious --threads 20

الأنماط المدعومة:
- `socks5://` — وكيل SOCKS5 قياسي (حل DNS من جانب العميل)
- `socks5h://` — SOCKS5 مع حل DNS عن بُعد (مفيد عند استهداف أسماء المضيفين الداخلية)

---

## اختبار سلسلة مجتمع SNMP

يوثق الأمر الفرعي `snmp` اختبار سلسلة مجتمع SNMP v1/v2c المخصص مع قوائم كلمات متدرجة يتم التحكم فيها بواسطة العلامة العامة `--mode`:

| الوضع | السلاسل | التغطية |
|------|---------|----------|
| `cautious` | ~25 | سلاسل شائعة (public, private, community، إلخ.) |
| `default` | ~25 | مثل الوضع الحذر |
| `aggressive` | 200+ | شاملة (خاصة بالموردين، SCADA، كاميرات IP، تخزين، إلخ.) |```bash
# Test with default community strings (~25)
brutus snmp --target 192.168.1.1:161

# Aggressive mode for comprehensive testing (200+)
brutus snmp --target 10.0.0.1:161 --mode aggressive

# Custom community strings
brutus snmp --target 192.168.1.1:161 -c "mycommunity,secretstring"

# Custom community string file
brutus snmp --target 192.168.1.1:161 -C community-strings.txt

# Pipeline mode
naabu -host 10.0.0.0/24 -p 161 -silent | nerva --json | brutus snmp --mode aggressive

INPUT:```go
package main

import (
    "fmt"
    "time"

    "github.com/praetorian-inc/brutus/pkg/brutus"
    _ "github.com/praetorian-inc/brutus/pkg/builtins" // registers all protocols and analyzers
)

func main() {
    config := &brutus.Config{
        Target:        "192.168.1.100:22",
        Protocol:      "ssh",
        Usernames:     []string{"root", "admin"},
        Passwords:     []string{"password", "admin", "toor"},
        Timeout:       5 * time.Second,
        Threads:       10,
    }

    results, err := brutus.Brute(config)
    if err != nil {
        panic(err)
    }

    for _, r := range results {
        if r.Success {
            fmt.Printf("[+] Valid: %s:%s\n", r.Username, r.Password)
        }
    }
}

**كيف يعمل:**

1. **الكشف** — يقوم Brutus بمسح أهداف HTTP لاكتشاف نوع المصادقة (المصادقة الأساسية مقابل المصادقة النموذجية)
2. **تحديد الجهاز** — يقوم Claude Vision بتحليل لقطات الشاشة لتحديد الجهاز/التطبيق
3. **اقتراح بيانات الاعتماد** — يقترح Claude بيانات الاعتماد الافتراضية من بيانات تدريبه
4. **بحث ويب اختياري** — يقوم Perplexity (في حال تكوينه) بالبحث عن بيانات اعتماد إضافية على الإنترنت
5. **الاختبار** — يقوم باختبار بيانات الاعتماد المكتشفة ضد الهدف

**لأهداف المصادقة الأساسية HTTP:**
- يقوم بمسح `/` لالتقاط رؤوس HTTP
- يحدد الجهاز من رأس الخادم، عالم مصادقة WWW-Authenticate، إلخ.
- يقترح Claude بيانات الاعتماد الافتراضية المحتملة
- يختبر أزواج بيانات الاعتماد تلقائياً

**لأهداف المصادقة النموذجية HTTP:**
- يستخدم Chrome بدون واجهة رسومية لعرض صفحة الويب والتقاط لقطة شاشة
- يحدد Claude Vision نموذج تسجيل الدخول ونوع الجهاز ويقترح بيانات الاعتماد
- يقوم Perplexity (اختياري) بالبحث عن بيانات اعتماد افتراضية إضافية
- تقوم أتمتة المتصفح بملء النموذج وإرساله

**المتطلبات:**
- `ANTHROPIC_API_KEY` — **مطلوب** لـ Claude Vision (تحديد الجهاز + اقتراحات بيانات الاعتماد)
- `PERPLEXITY_API_KEY` — *اختياري* لإجراء أبحاث ويب إضافية
- تثبيت Chrome/Chromium (للمصادقة النموذجية فقط)

**بروتوكولات غير HTTP (SSH, MySQL, إلخ.) لا تتأثر بـ `--experimental-ai`** — فهي تستمر في استخدام اختبار بيانات الاعتماد القياسي.

---

## RDP: كشف واستغلال باب خلفي لمفاتيح الـ Sticky Keys

يتضمن Brutus كشفًا تلقائيًا لـ **باب خلفي لمفاتيح الـ Sticky Keys** (MITRE ATT&CK [T1546.008](https://attack.mitre.org/techniques/T1546/008/)) على أهداف RDP. يتم تشغيل هذا الفحص قبل المصادقة على أهداف RDP غير NLA — بدون الحاجة إلى بيانات اعتماد.

**كيف يعمل:**

1. يتصل بهدف RDP ويتفاوض على جلسة غير NLA
2. يلتقط صورة شاشة شاشة تسجيل الدخول كخط أساس
3. يرسل 5 ضغطات على مفتاح Shift (مشغل الـ sticky keys)
4. يلتقط صورة الشاشة للاستجابة
5. يحلل الاستدلالي ما إذا ظهرت نافذة طرفية (cmd.exe, PowerShell, إلخ.)
6. يؤكد اختياريًا عبر Claude Vision API (عند تعيين `ANTHROPIC_API_KEY`)```bash
# Detection only — no brute force
brutus logon --target 10.0.0.50:3389

# Detection + Vision API confirmation
brutus logon --target 10.0.0.50:3389 --experimental-ai

**مخرجات الكشف:**```
[CRITICAL] Sticky keys backdoor CONFIRMED (confidence: 85%)
sethc.exe has been replaced with cmd.exe or similar.
SYSTEM-level unauthenticated access available via 5x Shift.

يقوم هذا بالاتصال، وتفعيل الباب الخلفي، وكتابة الأمر، والضغط على Enter، وانتظار الإخراج، وحفظ لقطة شاشة PNG للنتيجة.

### الوحدة الطرفية التفاعلية عبر الويب (`--web`)

إطلاق عارض RDP قائم على المتصفح للتفاعل المباشر مع موجه أوامر الباب الخلفي:```bash
# Start interactive web terminal
brutus logon --target 10.0.0.50:3389 --web

**التنفيذ التقني:** يستخدم دعم بروتوكول RDP [IronRDP](https://github.com/Devolutions/IronRDP) (Rust) المترجم إلى WebAssembly والمنفذ عبر [wazero](https://github.com/tetratelabs/wazero)، مع الحفاظ على تصميم Brutus الخالي من CGO والثنائي الفردي.

---

## تعداد الحسابات

يقوم الأمر الفرعي `enum` بتعداد أوراكلات وجود الحسابات التي تعمل لمؤسسة ما (ويقوم بتعداد رسائل البريد الإلكتروني مقابلها) أو تعداد مستخدمي Active Directory، كل ذلك دون إرسال كلمات المرور.

### تعداد أوراكل وجود الحسابات

تحديد أوراكلات وجود الحسابات غير المصادق عليها (microsoft365, google, github, بالإضافة إلى أوراكل Microsoft Teams) التي تعمل لمؤسسة ما، والتحقق من صحتها مقابل مستخدم معروف الصلاحية، ثم تعداد رسائل البريد الإلكتروني المرشحة مقابل الأوراكلات العاملة. يكشف استطلاع DNS TXT عن الأوراكلات المرشحة؛ التحقق مقابل `--known-valid` هو العنوان الرئيسي. `--known-valid` مطلوب، ويتم التعداد فقط مقابل الأوراكلات التي تؤكده:```bash
# Discover candidate oracles via DNS and report which ones work
brutus enum active oracles --domain example.com --known-valid [email protected]

# Enumerate specific emails against the working oracles
brutus enum active oracles --domain example.com -e [email protected],[email protected] --known-valid [email protected]

# Enumerate emails from file
brutus enum active oracles --domain example.com -E emails.txt --known-valid [email protected]

# Generate emails from embedded name lists and enumerate against working oracles
brutus enum active oracles --domain example.com --generate --format flast --known-valid [email protected]

# Discover working oracles with a known-valid email before large-scale enumeration
brutus enum active oracles discover --domain example.com --known-valid [email protected]

### توليد البريد الإلكتروني/اسم المستخدم

توليد عناوين البريد الإلكتروني أو أسماء المستخدمين من قوائم الكلمات المضمنة للأسماء الأولى/الأخيرة:```bash
# Generate emails: [email protected]
brutus enum generate --domain example.com --format flast

# Generate usernames only (no domain): jsmith
brutus enum generate --format flast

# Available formats: first.last, flast, firstl, f.last, lastf, last.first, lastfirst, first
brutus enum generate --domain example.com --format first.last

---

### مصادقة Microsoft Teams / Entra ID

احصل على رمز وصول OAuth2، ورمز التحديث، ورمز الهوية من Microsoft Entra ID (Azure AD) باستخدام [تدفق رمز الجهاز](https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-device-code) (RFC 8628). يمكن استخدام الرموز الناتجة لإجراء استدعاءات Microsoft Graph API، وتعداد Teams، والتدقيق عبر أدوات مثل [ROADtools](https://github.com/dirkjanm/ROADtools) أو استعلامات Graph المخصصة.```bash
# Authenticate against the common endpoint (any Microsoft tenant)
brutus enum active teams auth

# Authenticate against a specific tenant by domain or GUID
brutus enum active teams auth --tenant contoso.com
brutus enum active teams auth --tenant 00000000-0000-0000-0000-000000000000

# Request a different resource scope (space-separated). The default targets the
# Skype/Teams resource (api.spaces.skype.com); the Teams client is NOT
# authorized for Microsoft Graph (Graph yields AADSTS65002).
brutus enum active teams auth --scope "offline_access https://api.spaces.skype.com/.default"

# Use a custom app registration (your own Azure app client ID)
brutus enum active teams auth --client-id 00000000-0000-0000-0000-000000000000

# Capture the full token set as JSONL for piping to other tools
brutus enum active teams auth -o tokens.jsonl
brutus enum active teams auth --json

#### تعداد مستخدمي Teams

بعد المصادقة، قم بتعداد مستخدمي Teams من الشركات عن طريق عنوان البريد الإلكتروني. كل نتيجة هي `exists`, `blocked` (المستأجر يمنع البحث الخارجي لكن المستخدم قد يكون موجودًا), `not found`, أو `unknown` (خطأ في المصادقة/النقل). الحسابات الشخصية/Live غير مدعومة — المستأجرون من الشركات فقط.```bash
# Device-code auth inline, then enumerate a couple of emails
brutus enum active teams users -e [email protected],[email protected]

# Generate candidate emails for a domain and enumerate the most-likely 5000
# (presence and out-of-office are gathered by default; use --no-presence to skip)
brutus enum active teams users --domain target.com --format first.last --limit 5000

# Enumerate emails from a file
brutus enum active teams users -E emails.txt

# Reuse a token captured earlier and route through a SOCKS5 proxy
brutus enum active teams auth -o token.jsonl
brutus enum active teams users -E emails.txt --token-file token.jsonl --proxy socks5://127.0.0.1:1080

# Provide an access token directly
brutus enum active teams users -e [email protected] --access-token "$TOKEN"

`--domain` يعيد استخدام نفس مولد الأسماء الأولى/الأخيرة المرتبة حسب التردد مثل `enum generate`؛ `--format` يختار تخطيط اسم المستخدم و `--limit` يحدد التوليد إلى أول N (الأكثر احتمالاً) من المرشحين. يمكن دمج `--domain` مع `-e`/`-E`.

---

## القيود المعروفة

### الكشف الإرشادي لمفاتيح الالتصاق

- **تبديل السلبيات الكاذبة:** قد يُنتج الكشف الإرشادي فقط (`brutus logon` بدون `--experimental-ai`) سلبيات كاذبة عند الفحص المتكرر ضد نفس الهدف. بعد اكتشاف ناجح، تبقى نافذة cmd.exe مفتوحة على الخادم. ترى الاتصالات اللاحقة cmd.exe في الإطار الأساسي، وبما أن إرسال 5 ضغطات على Shift لا يُنشئ نافذة جديدة، فإن فرق البكسل يكون ضئيلاً — مما يؤدي إلى حكم "نظيف". لا يؤثر هذا على وضع `--experimental-ai` الذي يستخدم تحليل Vision API لإطار الاستجابة مباشرة (ليس فرق الأساس-والاستجابة) ويحدد نافذة الطرفية بشكل موثوق بغض النظر عن الحالة السابقة.
- **الحل البديل:** استخدم `--experimental-ai` مع تعيين `ANTHROPIC_API_KEY` للحصول على كشف ثابت عبر الفحوصات المتكررة، أو اسمح بفترة تهدئة بين الفحوصات لإعادة تعيين جلسة RDP.

### إضافة المتصفح

- يتطلب تثبيت Chrome/Chromium محليًا
- قد لا يعمل وضع الرأسية (Headless) على جميع الأنظمة
- بعض صفحات تسجيل الدخول كثيفة JavaScript قد تتطلب وقت انتظار إضافي