HMAC في Python — دليل hmac.new()‏ SHA-256 + أمثلة كود

import hmac
import hashlib

key = b"webhook_signing_key_2026"
message = b'{"event":"invoice.paid","invoice_id":"inv_8f3a","amount":19900}'

# إنشاء كائن HMAC والحصول على التوقيع السداسي
signature = hmac.new(key, message, hashlib.sha256).hexdigest()
print(signature)
# "b4e74f6c9a1d3e5f8b2a7c0d4e6f1a3b5c7d9e0f2a4b6c8d0e1f3a5b7c9d0e2f"

import hmac
import hashlib

key = b"service_auth_key"
msg = b"GET /api/v2/orders 2026-03-28T14:30:00Z"

h = hmac.new(key, msg, hashlib.sha256)

raw_bytes = h.digest()
print(type(raw_bytes), len(raw_bytes))
# <class 'bytes'> 32

hex_string = h.hexdigest()
print(type(hex_string), len(hex_string))
# <class 'str'> 64

# تمثّلان البيانات ذاتها — السداسية مجرد ترميز نصي للبايتات
assert raw_bytes.hex() == hex_string

import hmac
import hashlib

# مفتاح ورسالة نصيتان — .encode() يحوّلهما إلى بايتات UTF-8
api_key = "sk_live_9f3a2b7c4d8e"
request_body = '{"customer_id":"cust_4421","plan":"enterprise"}'

signature = hmac.new(
    api_key.encode(),
    request_body.encode(),
    hashlib.sha256
).hexdigest()

print(signature)
# "3a9f1b..."  — مخرجات سداسية متسقة

import hmac
import hashlib
import base64

key = b"whsec_MbkP7x9yFqHGn3tRdWz5"
payload = b'{"id":"evt_1Nq","type":"charge.succeeded","data":{"amount":4200}}'

# الملخص الخام → Base64 (شائع لترويسات Authorization وتوقيعات webhooks)
raw_digest = hmac.new(key, payload, hashlib.sha256).digest()
b64_signature = base64.b64encode(raw_digest).decode("ascii")

print(b64_signature)
# "dGhpcyBpcyBhIHNhbXBsZSBzaWduYXR1cmU="

# هذه القيمة تُقارَن بترويسة X-Signature
header_value = f"sha256={b64_signature}"
print(header_value)
# "sha256=dGhpcyBpcyBhIHNhbXBsZSBzaWduYXR1cmU="

import hmac
import hashlib

consumer_secret = b"oauth_consumer_secret_2026"
token_secret = b"oauth_token_secret_2026"

# يستخدم OAuth 1.0a consumer_secret&token_secret كمفتاح التوقيع
signing_key = consumer_secret + b"&" + token_secret
base_string = b"GET&https%3A%2F%2Fapi.service.com%2Fv1%2Forders&oauth_nonce%3D7f3a91bc"

sig = hmac.new(signing_key, base_string, hashlib.sha1).digest()

import base64
oauth_signature = base64.b64encode(sig).decode("ascii")
print(oauth_signature)
# "Tza3R9sE..."  — شفّره بـ URL لترويسة Authorization

import hmac
import hashlib

key = b"high_security_signing_key_64_bytes_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
msg = b'{"transfer_id":"xfr_9c2e","amount":500000,"currency":"EUR"}'

h = hmac.new(key, msg, hashlib.sha512)

print(len(h.digest()))   # 64 بايتاً (512 بتاً)
print(len(h.hexdigest()))  # 128 حرفاً سداسياً
print(h.hexdigest()[:40] + "...")
# "8e3a1f9b2c4d6e7f0a1b3c5d7e9f0a2b4c6d8e0f..."

import hmac
import hashlib

# MD5 مكسورة تشفيرياً — استخدمها فقط للتوافق مع البروتوكولات القديمة
key = b"legacy_api_key"
msg = b"action=charge&amount=1500&merchant=store_42"

sig = hmac.new(key, msg, hashlib.md5).hexdigest()
print(sig)  # سلسلة سداسية من 32 حرفاً
# "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"

import hmac
import hashlib

key = b"batch_signing_key_2026"
messages = [
    b'{"order_id":"ord_001","total":4500}',
    b'{"order_id":"ord_002","total":8900}',
    b'{"order_id":"ord_003","total":2200}',
]

# دفعة واحدة — بدون كائن HMAC وسيط
signatures = [hmac.digest(key, msg, hashlib.sha256) for msg in messages]

# تحويل إلى سداسي للعرض
for msg, sig in zip(messages, signatures):
    print(f"{msg[:30]}... -> {sig.hex()[:24]}...")

import hmac
import hashlib
from flask import Flask, request, abort

app = Flask(__name__)
WEBHOOK_SECRET = b"whsec_MbkP7x9yFqHGn3tRdWz5"

@app.route("/webhooks/payments", methods=["POST"])
def handle_payment_webhook():
    # الجسم الخام — يجب أن يطابق تماماً ما جرى توقيعه
    raw_body = request.get_data()

    # التوقيع من الترويسة
    received_sig = request.headers.get("X-Signature-256", "")

    # إعادة حساب HMAC على الجسم الخام
    expected_sig = hmac.new(WEBHOOK_SECRET, raw_body, hashlib.sha256).hexdigest()

    # مقارنة في وقت ثابت — تمنع هجمات التوقيت
    if not hmac.compare_digest(f"sha256={expected_sig}", received_sig):
        abort(403, "توقيع غير صالح")

    # التوقيع صالح — معالجة الحدث
    event = request.get_json()
    print(f"حدث مُتحقق منه: {event['type']} بمبلغ {event['data']['amount']}")
    return "", 200

import hmac
import hashlib
from flask import Flask, request, abort

app = Flask(__name__)
GITHUB_WEBHOOK_SECRET = b"your_github_webhook_secret"

@app.route("/webhooks/github", methods=["POST"])
def handle_github_webhook():
    # GitHub يُرسل: X-Hub-Signature-256: sha256=<hex_digest>
    sig_header = request.headers.get("X-Hub-Signature-256", "")

    if not sig_header.startswith("sha256="):
        abort(403, "ترويسة التوقيع غائبة أو مشوّهة")

    received_hex = sig_header[len("sha256="):]
    raw_body = request.get_data()  # بايتات خام — لا تُحلّل JSON قبل هذا

    expected_hex = hmac.new(
        GITHUB_WEBHOOK_SECRET, raw_body, hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(expected_hex, received_hex):
        abort(403, "عدم تطابق التوقيع — الحمولة قد تكون عُبث بها")

    event_type = request.headers.get("X-GitHub-Event", "unknown")
    payload = request.get_json()
    print(f"حدث GitHub مُتحقق منه {event_type}: {payload.get('action', '')}")
    return "", 200

import hmac
import hashlib
import time
import json

def sign_request(secret: bytes, method: str, path: str, body: str) -> dict:
    """توليد توقيع HMAC-SHA256 لطلب API."""
    timestamp = str(int(time.time()))

    # بناء سلسلة التوقيع — الطريقة + المسار + الطابع الزمني + الجسم
    signing_string = f"{method}\n{path}\n{timestamp}\n{body}"

    signature = hmac.new(
        secret,
        signing_string.encode(),
        hashlib.sha256
    ).hexdigest()

    return {
        "X-Timestamp": timestamp,
        "X-Signature": signature,
    }

# الاستخدام
api_secret = b"sk_hmac_9f3a2b7c4d8e1a6f"
body = json.dumps({"customer_id": "cust_4421", "action": "suspend_account"})

headers = sign_request(api_secret, "POST", "/api/v2/customers/actions", body)
print(headers)
# {"X-Timestamp": "1711612200", "X-Signature": "a3f1b9c0..."}

import hmac
import hashlib
import time
import json
import requests

API_SECRET = b"sk_hmac_9f3a2b7c4d8e1a6f"
BASE_URL = "https://api.billing-service.internal"

def make_signed_request(method: str, path: str, payload: dict) -> requests.Response:
    body = json.dumps(payload, separators=(",", ":"))  # JSON مضغوط، محدد
    timestamp = str(int(time.time()))

    signing_string = f"{method}\n{path}\n{timestamp}\n{body}"
    signature = hmac.new(API_SECRET, signing_string.encode(), hashlib.sha256).hexdigest()

    headers = {
        "Content-Type": "application/json",
        "X-Timestamp": timestamp,
        "X-Signature": f"hmac-sha256={signature}",
    }

    try:
        return requests.request(method, f"{BASE_URL}{path}", data=body, headers=headers)
    except requests.RequestException as e:
        raise RuntimeError(f"فشل الطلب الموقَّع: {e}") from e

# إرسال طلب POST موقَّع
resp = make_signed_request("POST", "/api/v2/invoices", {
    "customer_id": "cust_4421",
    "line_items": [
        {"description": "Pro plan - March 2026", "amount": 4900},
        {"description": "Extra seats (3)", "amount": 2100},
    ],
})
print(resp.status_code, resp.json())

python3 -c "
import hmac, hashlib
print(hmac.new(b'my_secret', b'message_to_sign', hashlib.sha256).hexdigest())
"
# المخرجات: سلسلة سداسية من 64 حرفاً

echo -n "message_to_sign" | openssl dgst -sha256 -hmac "my_secret"
# SHA2-256(stdin)= 7d11...

# تمرير ملف عبر HMAC لـ openssl
openssl dgst -sha256 -hmac "my_secret" < payload.json

# تخزين المفتاح في متغير بيئة لتجنب ظهوره في سجل الأوامر
export HMAC_KEY="sk_live_9f3a2b"
echo -n '{"event":"test"}' | python3 -c "
import hmac, hashlib, sys, os
key = os.environ['HMAC_KEY'].encode()
msg = sys.stdin.buffer.read()
print(hmac.new(key, msg, hashlib.sha256).hexdigest())
"

pip install cryptography

from cryptography.hazmat.primitives import hashes, hmac as crypto_hmac

key = b"webhook_signing_key_2026"
message = b'{"event":"subscription.renewed","plan":"enterprise"}'

h = crypto_hmac.HMAC(key, hashes.SHA256())
h.update(message)
signature = h.finalize()  # بايتات خام

print(signature.hex())
# "9c4e2a..."

# وضع التحقق — يُثير InvalidSignature عند عدم التطابق
h_verify = crypto_hmac.HMAC(key, hashes.SHA256())
h_verify.update(message)
h_verify.verify(signature)  # يُثير cryptography.exceptions.InvalidSignature إذا كان خاطئاً

pip install rich

import hmac
import hashlib
from rich.console import Console
from rich.table import Table

console = Console()

key = b"debug_signing_key"
messages = {
    "/api/v2/orders": b'{"status":"active"}',
    "/api/v2/invoices": b'{"status":"pending"}',
    "/api/v2/customers": b'{"status":"verified"}',
}

table = Table(title="HMAC-SHA256 Signatures")
table.add_column("Endpoint", style="cyan")
table.add_column("Signature (first 32 chars)", style="green")

for endpoint, body in messages.items():
    sig = hmac.new(key, body, hashlib.sha256).hexdigest()
    table.add_row(endpoint, sig[:32] + "...")

console.print(table)

import hmac
import hashlib

def hmac_file(key: bytes, filepath: str, chunk_size: int = 8192) -> str:
    """حساب HMAC-SHA256 لملف دون تحميله بالكامل في الذاكرة."""
    h = hmac.new(key, digestmod=hashlib.sha256)

    try:
        with open(filepath, "rb") as f:
            while True:
                chunk = f.read(chunk_size)
                if not chunk:
                    break
                h.update(chunk)
    except OSError as e:
        raise OSError(f"تعذّر قراءة الملف '{filepath}': {e}") from e

    return h.hexdigest()

# توقيع نسخة احتياطية لقاعدة بيانات بحجم 2 غيغابايت
signing_key = b"backup_integrity_key_2026"
signature = hmac_file(signing_key, "/var/backups/db-export-2026-03.sql.gz")
print(f"HMAC-SHA256: {signature}")

import hmac
import hashlib

def verify_file_hmac(key: bytes, filepath: str, expected_hex: str) -> bool:
    """التحقق من توقيع HMAC-SHA256 لملف."""
    h = hmac.new(key, digestmod=hashlib.sha256)

    with open(filepath, "rb") as f:
        for chunk in iter(lambda: f.read(65536), b""):
            h.update(chunk)

    return hmac.compare_digest(h.hexdigest(), expected_hex)

# التحقق من حزمة مُحمَّلة
is_valid = verify_file_hmac(
    key=b"release_signing_key",
    filepath="/tmp/release-v3.2.0.tar.gz",
    expected_hex="8e3a1f9b2c4d6e7f0a1b3c5d7e9f0a2b4c6d8e0f1a2b3c4d5e6f7a8b9c0d1e2f",
)
print(f"سلامة الملف: {'صالح' if is_valid else 'تالف'}")

import secrets

# توليد مفاتيح تطابق حجم كتلة خوارزمية التجزئة
sha256_key = secrets.token_bytes(32)   # 256 بتاً — لـ HMAC-SHA256
sha512_key = secrets.token_bytes(64)   # 512 بتاً — لـ HMAC-SHA512

# التمثيل السداسي — آمن لملفات الإعداد ومتغيرات البيئة
print(f"مفتاح HMAC-SHA256: {sha256_key.hex()}")
# مثال: "a3f1b9c04e7d2f8a1b3c5d7e9f0a2b4c6d8e0f1a2b3c4d5e6f7a8b9c0d1e2f"

print(f"مفتاح HMAC-SHA512: {sha512_key.hex()}")
# سلسلة سداسية من 128 حرفاً

# Base64 آمن لـ URL — مضغوط وآمن لترويسات HTTP
import base64
b64_key = base64.urlsafe_b64encode(sha256_key).decode("ascii")
print(f"مفتاح Base64: {b64_key}")
# مثال: "o_G5wE59L4obPF1-nwortG2ODwobPExdXnqLnA0dLi8="

import hmac
import hashlib

# bytearray — بايتات قابلة للتعديل، مفيدة لمخزّنات بروتوكول ثنائي
key = bytearray(b"protocol_signing_key")
frame = bytearray(b'\x01\x02\x03\x04payload_data_here')

sig = hmac.new(key, frame, hashlib.sha256).hexdigest()
print(f"توقيع الإطار: {sig[:32]}...")

# memoryview — شريحة بدون نسخ من مُخزَّن أكبر
large_buffer = bytearray(4096)
large_buffer[:20] = b"sensor_reading_12345"

# حساب HMAC للـ 20 بايت الأولى فقط دون نسخ
view = memoryview(large_buffer)[:20]
sig = hmac.new(key, view, hashlib.sha256).hexdigest()
print(f"توقيع المستشعر: {sig[:32]}...")