انتقل إلى محتوى الدرس

Generating and Hashing API Tokens توليد وتشفير رموز API

أمّن واجهات JSON البرمجية في PHP 8 باستخدام مصادقة رموز Bearer وتخزين مفاتيح API المشفرة بـ SHA-256 وضبط رؤوس CORS ومعالجة طلبات OPTIONS الاستباقية.
1 صفوف تعليمية
PHP
32 مشاهدة

شرح صفوف ومحتوى الفقرة

الصف 1 شرح توضيحي

تعتمد واجهات 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";