هش SHA-256 در Python — راهنمای hashlib + مثال‌های کد

import hashlib

# هش مستقیم یک رشته بایتی
digest = hashlib.sha256(b"deployment-v4.2.1").hexdigest()
print(digest)
# a8f5f167f44f4964e6c998dee827110c3f1de4d0280c68cba98cf70b4b5157db

import hashlib

# رشته‌ها باید قبل از هش کردن به bytes تبدیل شوند
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 هگز ۶۴ کاراکتری

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"

# خروجی هگز: ۶۴ کاراکتر
hex_sig = hmac.new(secret, message, hashlib.sha256).hexdigest()
print(f"Hex:    {hex_sig}")

# خروجی Base64: ۴۴ کاراکتر (کوتاه‌تر، رایج در هدرهای 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 از bytes خام (۳۲ بایت → ۴۴ کاراکتر Base64)
raw_digest = hashlib.sha256(data).digest()
b64_digest = base64.b64encode(raw_digest).decode("ascii")
print(f"sha256-{b64_digest}")
# sha256-<44 کاراکتر>

# اشتباه: Base64 از رشته هگز (۶۴ بایت ASCII → ۸۸ کاراکتر Base64 — دو برابر اندازه)
hex_digest = hashlib.sha256(data).hexdigest()
wrong = base64.b64encode(hex_digest.encode()).decode()
print(f"طول اشتباه: {len(wrong)} کاراکتر")  # 88 — آنچه API‌ها انتظار دارند نیست

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()  # ۳۲ بایت خام

print(result.hex())  # رشته هگز ۶۴ کاراکتری
# 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 one-liner
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

# هش یک tarball انتشار
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""):  # تکه‌های ۶۴ کیلوبایتی
            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]✓ تأیید شد[/green]" if expected.get(name) == digest else "[red]✗ ناهمخوان[/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):  # تکه‌های ۱ مگابایتی
            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" از digest وجود ندارد

# رمزگذاری — دو طرفه، می‌توان با کلید رمزگشایی کرد
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 — کاراکترهای هگز نامعتبر