شرح صفوف ومحتوى الفقرة
تعتمد واجهات JSON API عديمة الحالة (Stateless) على رموز Bearer العشوائية لمصادقة العملاء بدلاً من كوكيز الجلسات. ولّد هذه الرموز باستخدام المولد التشفيري الآمن bin2hex(random_bytes(32)) وخزّن بصمتها المشفرة بـ SHA-256 فقط في قاعدة البيانات.
- أضف بادئة واضحة للرمز الخام (مثل
ct_live_) لمساعدة المطورين وأدوات فحص الأسرار على تمييز المفاتيح فوراً. - اعرض الرمز النصي الخام للمستخدم مرة واحدة فقط لحظة إنشائه، وخزّن ناتج
hash('sha256', $plainToken)في عمودtoken_hash. - نظراً لأن الرمز المولد من 32 بايت عشوائي يمتلك كثافة احتمالات تبلغ 256 بت، فإن تجزئة
SHA-256آمنة تماماً ضد القواميس وتسمح بالبحث المفهرس السريع في SQL.
يولّد هذا الكود رمز API عشوائياً ببادئة قياسية ويحسب بصمة SHA-256 المكونة من 64 محرفاً لتخزينها في قاعدة البيانات:
PHP
<?php
$plainToken = 'ct_live_' . bin2hex(random_bytes(32));
$tokenHash = hash('sha256', $plainToken);
echo 'Token Prefix: ' . substr($plainToken, 0, 16) . "...\n";
echo 'SHA-256 Length: ' . strlen($tokenHash) . " hex chars\n";