shaha

أداة لبناء قواعد بيانات التجزئة والبحث العكسي. SHA + آها!

قم ببناء قواعد بيانات تجزئة محسوبة مسبقًا من قوائم الكلمات، ثم استعلم عنها للعثور على الصور السابقة.

التثبيت

cargo install shaha

أو البناء من المصدر:

git clone https://github.com/oritwoen/shaha
cd shaha
cargo build --release

الاستخدام

بناء قاعدة بيانات تجزئة

# Single algorithm (default: sha256)
shaha build words.txt

# Multiple algorithms
shaha build words.txt -a md5 -a sha256 -a keccak256

# Custom output file
shaha build words.txt -o mydb.parquet

# With source metadata
shaha build rockyou.txt -a hash160 -s rockyou

الاستعلام عن الصورة السابقة

# Find preimage by hash
shaha query 5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8

# Prefix search
shaha query 5e8848

# Filter by algorithm
shaha query 5e8848 -a sha256

# Output formats
shaha query 5e8848 --format plain   # default
shaha query 5e8848 --format json
shaha query 5e8848 --format table

معلومات قاعدة البيانات

shaha info hashes.parquet

الإخراج:

Database: "hashes.parquet"
Records:  1000000
Size:     45.32 MB
Algorithms: sha256, md5, keccak256
Sources:  rockyou

الخوارزميات

تنسيق التخزين

تُخزَّن قواعد البيانات كملفات Apache Parquet مع ضغط ZSTD.

المخطط:

• hash (Binary) - بايتات التجزئة
• preimage (Utf8) - بيانات الإدخال الأصلية
• algorithm (Utf8) - اسم الخوارزمية
• sources (List) - مصادر قوائم الكلمات

يمكن الاستعلام عن ملفات Parquet باستخدام DuckDB أو Polars أو Spark أو Cloudflare R2 SQL.

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

• البحث الأمني - بحث عكسي عن التجزئات
• تحديات CTF - كسر سريع للتجزئة
• التحليل الجنائي - تحديد كلمات المرور المعروفة
• تحليل البلوكشين - بحث في عناوين بيتكوين/إيثيريوم

الإعدادات

يتم تحميل الإعدادات من (حسب الأولوية):

1. خيارات سطر الأوامر
2. متغيرات البيئة
3. .shaha.toml في الدليل الحالي
4. ~/.config/shaha/config.toml

مثال على ملف الإعدادات

[storage.r2]
endpoint = "https://account-id.r2.cloudflarestorage.com"
bucket = "my-bucket"
access_key_id = "your-access-key"
secret_access_key = "your-secret-key"
region = "auto"
path = "hashes.parquet"

[defaults]
algorithms = ["sha256", "md5"]
output = "hashes.parquet"

تخزين R2/S3

قم بالبناء والاستعلام مباشرة من Cloudflare R2 أو التخزين المتوافق مع S3:

# Build to R2
shaha build words.txt --r2

# Query from R2
shaha query 5e8848 --r2

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

• SHAHA_R2_ENDPOINT - عنوان نقطة نهاية S3/R2
• SHAHA_R2_BUCKET - اسم الحاوية
• SHAHA_R2_ACCESS_KEY_ID أو AWS_ACCESS_KEY_ID
• SHAHA_R2_SECRET_ACCESS_KEY أو AWS_SECRET_ACCESS_KEY
• SHAHA_R2_PATH - المسار داخل الحاوية
• SHAHA_R2_REGION - المنطقة (الافتراضي: "auto")

خارطة الطريق

• R2 Data Catalog - تكامل Apache Iceberg لاستعلامات أسرع

الترخيص

MIT