تجزئة SHA-256 بـ Python — دليل hashlib وأمثلة

import hashlib

# تجزئة سلسلة بايتات مباشرةً
digest = hashlib.sha256(b"deployment-v4.2.1").hexdigest()
print(digest)
# a8f5f167f44f4964e6c998dee827110c3f1de4d0280c68cba98cf70b4b5157db

import hashlib

# يجب تشفير النصوص إلى بايتات قبل التجزئة
config_key = "redis://cache.internal:6379/0"
digest = hashlib.sha256(config_key.encode("utf-8")).hexdigest()
print(digest)
# 7d3f8c2a1b9e4f5d6c8a7b3e2f1d9c4a5b8e7f6d3c2a1b9e4f5d6c8a7b3e2f1d

import hashlib

h = hashlib.sha256()
h.update(b"request_id=req_7f3a91bc")
h.update(b"&timestamp=1741614120")
h.update(b"&amount=4999")
print(h.hexdigest())
# يعادل hashlib.sha256(b"request_id=req_7f3a91bc&timestamp=1741614120&amount=4999").hexdigest()

import hmac
import hashlib

# التحقق من توقيع webhook
secret_key = b"whsec_9f3a7b2e1d4c8a5b"
payload = b'{"event":"invoice.paid","invoice_id":"inv_8d2c","amount":14900}'

signature = hmac.new(secret_key, payload, hashlib.sha256).hexdigest()
print(signature)
# ملخص HMAC-SHA256 سداسي من 64 حرفاً

import hmac
import hashlib

def verify_webhook(payload: bytes, received_sig: str, secret: bytes) -> bool:
    """التحقق من توقيع webhook باستخدام المقارنة في وقت ثابت."""
    expected = hmac.new(secret, payload, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, received_sig)

# محاكاة التحقق من webhook بأسلوب Stripe
incoming_payload = b'{"event":"payment.completed","amount":4999}'
incoming_signature = "a1b2c3d4e5f6..."  # من ترويسة X-Signature
webhook_secret = b"whsec_9f3a7b2e1d4c"

if verify_webhook(incoming_payload, incoming_signature, webhook_secret):
    print("التوقيع صالح — معالجة الحدث")
else:
    print("عدم تطابق التوقيع — رفض الطلب")

import hmac
import hashlib
import time

def sign_request(method: str, path: str, body: bytes, secret: bytes) -> str:
    """إنشاء توقيع HMAC-SHA256 لطلب API."""
    timestamp = str(int(time.time()))
    body_hash = hashlib.sha256(body).hexdigest()

    # السلسلة المتعارف عليها: الطريقة + المسار + الطابع الزمني + تجزئة الجسم
    canonical = f"{method}\n{path}\n{timestamp}\n{body_hash}"
    signature = hmac.new(secret, canonical.encode("utf-8"), hashlib.sha256).hexdigest()

    return f"ts={timestamp},sig={signature}"

# الاستخدام
api_secret = b"sk_live_9f3a7b2e1d4c8a5b6e7f"
request_body = b'{"customer_id":"cust_4f2a","plan":"enterprise"}'
auth_header = sign_request("POST", "/api/v2/subscriptions", request_body, api_secret)
print(f"Authorization: HMAC-SHA256 {auth_header}")
# Authorization: HMAC-SHA256 ts=1741614120,sig=7d3f8c2a...

import hmac
import hashlib
import base64

secret = b"webhook_secret_9f3a"
message = b"POST /api/v2/events 1741614120"

# مخرجات سداسية: 64 حرفاً
hex_sig = hmac.new(secret, message, hashlib.sha256).hexdigest()
print(f"Hex:    {hex_sig}")

# مخرجات Base64: 44 حرفاً (أقصر، شائع في ترويسات HTTP)
raw_sig = hmac.new(secret, message, hashlib.sha256).digest()
b64_sig = base64.b64encode(raw_sig).decode("ascii")
print(f"Base64: {b64_sig}")

import hashlib
import uuid
from datetime import datetime, timezone

# datetime — استخدم ISO 8601 مع إزاحة UTC الصريحة للتنقلية
event_time = datetime(2026, 3, 28, 12, 0, 0, tzinfo=timezone.utc)
time_hash = hashlib.sha256(event_time.isoformat().encode("utf-8")).hexdigest()
print(f"datetime hash: {time_hash[:16]}...")

# UUID — جزّئ الصيغة النصية المعيارية (أحرف صغيرة مع شرطات)
record_id = uuid.uuid4()
uuid_hash = hashlib.sha256(str(record_id).encode("utf-8")).hexdigest()
print(f"UUID hash: {uuid_hash[:16]}...")

import hashlib
import json
from dataclasses import dataclass, asdict

@dataclass
class Event:
    id: str
    type: str
    amount: int
    timestamp: str

def hash_event(event: Event) -> str:
    """تجزئة كائن dataclass باستخدام JSON بمفاتيح مرتبة للحتمية."""
    canonical = json.dumps(asdict(event), sort_keys=True, separators=(",", ":"))
    return hashlib.sha256(canonical.encode("utf-8")).hexdigest()

e = Event(id="evt_4f2a", type="payment.completed", amount=4999, timestamp="2026-03-28T12:00:00Z")
print(hash_event(e))  # ثابت عبر التشغيلات والأجهزة

import hashlib

def sha256_checksum(filepath: str, chunk_size: int = 8192) -> str:
    """احسب تجزئة SHA-256 لملف مع القراءة في أجزاء لتوفير الذاكرة."""
    h = hashlib.sha256()
    with open(filepath, "rb") as f:
        for chunk in iter(lambda: f.read(chunk_size), b""):
            h.update(chunk)
    return h.hexdigest()

# تجزئة ملف إصدار
checksum = sha256_checksum("/tmp/release-v4.2.1.tar.gz")
print(f"SHA-256: {checksum}")

import hashlib

with open("/tmp/release-v4.2.1.tar.gz", "rb") as f:
    digest = hashlib.file_digest(f, "sha256")

print(digest.hexdigest())

import hashlib
import hmac as hmac_mod  # لـ compare_digest فقط

def verify_checksum(filepath: str, expected_hex: str) -> bool:
    """التحقق من مجموع SHA-256 الاختباري باستخدام المقارنة في وقت ثابت."""
    h = hashlib.sha256()
    with open(filepath, "rb") as f:
        for chunk in iter(lambda: f.read(8192), b""):
            h.update(chunk)
    return hmac_mod.compare_digest(h.hexdigest(), expected_hex.lower())

# التحقق من ملف إصدار
expected = "a8f5f167f44f4964e6c998dee827110c3f1de4d0280c68cba98cf70b4b5157db"
if verify_checksum("/tmp/release-v4.2.1.tar.gz", expected):
    print("المجموع الاختباري متطابق — الملف سليم")
else:
    print("عدم تطابق المجموع الاختباري — قد يكون الملف تالفاً أو معدّلاً")

import hashlib
import base64

data = b"integrity check payload"

# الصحيح: Base64 للبايتات الخام (32 بايت → 44 حرفاً بـ Base64)
raw_digest = hashlib.sha256(data).digest()
b64_digest = base64.b64encode(raw_digest).decode("ascii")
print(f"sha256-{b64_digest}")
# sha256-<44 حرفاً>

# الخطأ: Base64 للسلسلة السداسية (64 بايت ASCII → 88 حرفاً بـ Base64 — ضعف الحجم)
hex_digest = hashlib.sha256(data).hexdigest()
wrong = base64.b64encode(hex_digest.encode()).decode()
print(f"طول خاطئ: {len(wrong)} حرفاً")  # 88 — ليس ما تتوقعه الـ APIs

from cryptography.hazmat.primitives import hashes
from cryptography.hazmat.backends import default_backend

digest = hashes.Hash(hashes.SHA256(), backend=default_backend())
digest.update(b"deployment-v4.2.1")
result = digest.finalize()  # 32 بايتاً خاماً

print(result.hex())  # سلسلة سداسية من 64 حرفاً
# a8f5f167f44f4964e6c998dee827110c3f1de4d0280c68cba98cf70b4b5157db

import hashlib
import sys

def hash_file_safe(filepath: str) -> str | None:
    """تجزئة ملف مع معالجة صحيحة للأخطاء."""
    try:
        h = hashlib.sha256()
        with open(filepath, "rb") as f:
            for chunk in iter(lambda: f.read(16384), b""):
                h.update(chunk)
        return h.hexdigest()
    except FileNotFoundError:
        print(f"خطأ: {filepath} غير موجود", file=sys.stderr)
        return None
    except PermissionError:
        print(f"خطأ: لا يوجد إذن قراءة لـ {filepath}", file=sys.stderr)
        return None

result = hash_file_safe("/etc/nginx/nginx.conf")
if result:
    print(f"SHA-256: {result}")

import hashlib
import urllib.request
import json

def fetch_and_hash(url: str) -> tuple[dict, str]:
    """جلب JSON من API وإرجاع البيانات مع تجزئة SHA-256 الخاصة بها."""
    try:
        with urllib.request.urlopen(url, timeout=10) as resp:
            body = resp.read()
            content_hash = hashlib.sha256(body).hexdigest()
            data = json.loads(body)
            return data, content_hash
    except urllib.error.URLError as exc:
        raise ConnectionError(f"فشل الجلب من {url}: {exc}") from exc

# مفتاح تخزين مؤقت بناءً على محتوى الاستجابة
data, digest = fetch_and_hash("https://api.exchange.internal/v2/rates")
print(f"تجزئة الاستجابة: {digest[:16]}...")
print(f"EUR/USD: {data.get('rates', {}).get('EUR', 'N/A')}")

# سطر Python واحد
echo -n "deployment-v4.2.1" | python3 -c "import hashlib,sys; print(hashlib.sha256(sys.stdin.buffer.read()).hexdigest())"

# macOS / BSD
echo -n "deployment-v4.2.1" | shasum -a 256

# Linux (coreutils)
echo -n "deployment-v4.2.1" | sha256sum

# OpenSSL (متعدد المنصات)
echo -n "deployment-v4.2.1" | openssl dgst -sha256

# تجزئة ملف إصدار مضغوط
sha256sum release-v4.2.1.tar.gz
# أو
openssl dgst -sha256 release-v4.2.1.tar.gz

# التحقق مقابل مجموع اختباري معروف
echo "a8f5f167f44f4964e6c998dee827110c release-v4.2.1.tar.gz" | sha256sum -c -
# release-v4.2.1.tar.gz: OK

pip install pycryptodome

from Crypto.Hash import SHA256

h = SHA256.new()
h.update(b"deployment-v4.2.1")
print(h.hexdigest())
# a8f5f167f44f4964e6c998dee827110c3f1de4d0280c68cba98cf70b4b5157db

import hashlib
import os
from pathlib import Path
from concurrent.futures import ThreadPoolExecutor

def hash_file(path: Path) -> tuple[str, str]:
    """تجزئة ملف واحد وإرجاع (المسار، الملخص السداسي)."""
    h = hashlib.sha256()
    with open(path, "rb") as f:
        for chunk in iter(lambda: f.read(65536), b""):  # أجزاء 64 كيلوبايت
            h.update(chunk)
    return str(path), h.hexdigest()

def hash_directory(directory: str, pattern: str = "*.tar.gz") -> dict[str, str]:
    """تجزئة جميع الملفات المطابقة بشكل متوازٍ باستخدام الخيوط."""
    files = list(Path(directory).glob(pattern))
    results = {}
    with ThreadPoolExecutor(max_workers=os.cpu_count()) as pool:
        for path, digest in pool.map(hash_file, files):
            results[path] = digest
    return results

# تجزئة جميع ملفات الإصدار بشكل متوازٍ
checksums = hash_directory("/var/releases", "*.tar.gz")
for path, digest in checksums.items():
    print(f"{digest}  {path}")

pip install rich

import hashlib
from pathlib import Path
from rich.console import Console
from rich.table import Table

console = Console()

def hash_and_display(files: list[str], expected: dict[str, str]) -> None:
    """تجزئة الملفات وعرض النتائج مع رمز لوني للتحقق."""
    table = Table(title="التحقق من SHA-256")
    table.add_column("الملف", style="cyan")
    table.add_column("SHA-256", style="dim", max_width=20)
    table.add_column("الحالة")

    for filepath in files:
        h = hashlib.sha256()
        with open(filepath, "rb") as f:
            for chunk in iter(lambda: f.read(8192), b""):
                h.update(chunk)
        digest = h.hexdigest()

        name = Path(filepath).name
        status = "[green]✓ OK[/green]" if expected.get(name) == digest else "[red]✗ MISMATCH[/red]"
        table.add_row(name, f"{digest[:16]}...", status)

    console.print(table)

# الاستخدام
expected_checksums = {
    "api-gateway-v3.1.tar.gz": "a8f5f167f44f4964...",
    "worker-v3.1.tar.gz": "7d3f8c2a1b9e4f5d...",
}
hash_and_display(
    ["/var/releases/api-gateway-v3.1.tar.gz", "/var/releases/worker-v3.1.tar.gz"],
    expected_checksums,
)

import hashlib
import os

def sha256_with_progress(filepath: str) -> str:
    """تجزئة ملف كبير مع تقرير التقدم إلى stderr."""
    file_size = os.path.getsize(filepath)
    h = hashlib.sha256()
    bytes_read = 0

    with open(filepath, "rb") as f:
        while chunk := f.read(1 << 20):  # أجزاء 1 ميجابايت
            h.update(chunk)
            bytes_read += len(chunk)
            pct = (bytes_read / file_size) * 100
            print(f"\r  جارٍ التجزئة: {pct:.1f}% ({bytes_read >> 20} ميجابايت / {file_size >> 20} ميجابايت)",
                  end="", flush=True)

    print()  # سطر جديد بعد شريط التقدم
    return h.hexdigest()

digest = sha256_with_progress("/mnt/backups/db-snapshot-2026-03.sql.gz")
print(f"SHA-256: {digest}")

import hashlib
import json

def hash_ndjson_records(filepath: str) -> dict[str, str]:
    """تجزئة كل سجل JSON في ملف NDJSON لإزالة التكرارات."""
    seen = {}
    with open(filepath, "r", encoding="utf-8") as f:
        for line_num, line in enumerate(f, 1):
            line = line.strip()
            if not line:
                continue
            try:
                record = json.loads(line)
                # توحيد قبل التجزئة: ترتيب المفاتيح للمخرجات الحتمية
                canonical = json.dumps(record, sort_keys=True, separators=(",", ":"))
                digest = hashlib.sha256(canonical.encode("utf-8")).hexdigest()

                if digest in seen:
                    print(f"السطر {line_num}: مكرر من السطر {seen[digest]}")
                else:
                    seen[digest] = line_num
            except json.JSONDecodeError:
                print(f"السطر {line_num}: JSON غير صالح، تم التخطي")

    print(f"تمت معالجة {line_num} سطراً، {len(seen)} سجلاً فريداً")
    return seen

hash_ndjson_records("telemetry-events-2026-03.ndjson")

# التجزئة — أحادية الاتجاه، لا يمكن استرداد الأصل
import hashlib
digest = hashlib.sha256(b"secret-config-value").hexdigest()
# لا طريقة للحصول على "secret-config-value" من الملخص

# التشفير — ثنائي الاتجاه، يمكن فك التشفير بالمفتاح
from cryptography.fernet import Fernet
key = Fernet.generate_key()
cipher = Fernet(key)
encrypted = cipher.encrypt(b"secret-config-value")
decrypted = cipher.decrypt(encrypted)
print(decrypted)  # b"secret-config-value" — استُرد الأصل

import re

def is_sha256_hex(value: str) -> bool:
    """التحقق مما إذا كانت السلسلة تطابق صيغة ملخص SHA-256 السداسي."""
    return bool(re.fullmatch(r"[a-fA-F0-9]{64}", value))

# حالات اختبار
print(is_sha256_hex("e3b0c44298fc1c149afbf4c8996fb924"
                     "27ae41e4649b934ca495991b7852b855"))  # True — SHA-256 للسلسلة الفارغة
print(is_sha256_hex("e3b0c44298fc1c14"))                   # False — قصير جداً
print(is_sha256_hex("zzzz" * 16))                          # False — أحرف سداسية غير صالحة