مفاتيح المشروع
كل مشروع له مفتاح عام لإرسال الأحداث. مكانه كود الواجهة، وما يقدر يقرأ أي شيء.
أنواع المفاتيح
| البادئة | الاستخدام | وين ينفع يظهر |
|---|---|---|
pk_live_ | إرسال الأحداث من موقعك أو تطبيقك الفعلي | كود الواجهة، عام |
pk_test_ | التطوير: يقبل بعد localhost و 127.0.0.1 و Expo Go | كود الواجهة، عام |
rk_ | مفتاح قراءة: يفتح لوحة التحكم حق مساحة عملك | أبد مو في كود الواجهة |
datacub_mcp_ | ربط أداة ذكاء اصطناعي عن طريق MCP | أبد مو في كود الواجهة |
مفتاح pk_ يقدر بس يرسل أحداث، وبس من الأماكن اللي تسمح لها. عشان كذا آمن تنشره. والـ SDK يرفض أي مفتاح يبدأ بـ sk_ في أي بيئة: السر في المتصفح أو التطبيق يعتبر مكشوف.
تلقى المفتاح في الإعدادات، الربط تحت مفاتيح الإرسال.
المواقع والتطبيقات المسموح لها
datacub يقبل الأحداث بس من:
- مواقع في قائمة المشروع: نطاق مثل
shop.example.sa، أو*.example.saلكل النطاقات الفرعية (ما تشمل النطاق الأساسي نفسه: أضفه بعد إذا فيه صفحات) - تطبيقات معرّفها (bundle ID أو package name) في قائمة المشروع، مثل
sa.example.shop
القائمتين في الإعدادات، عام تحت من وين تجي البيانات. ومواقع الجهات الحكومية والتعليمية والصحية والعسكرية يراجعها datacub قبل ما ينحفظ أي حدث منها.
الطلب من أي مكان ثاني ينرفض بـ 403 origin_not_allowed أو 403 app_not_allowed، والـ SDK يوقف الإرسال لهذي الصفحة أو هذي الفتحة للتطبيق. هذي الفحوصات تمنع مفتاحك ينستخدم بالغلط في موقع غيرك. وهي مو سر: أي أحد يقدر يرسل طلبات يدّعي إنها من موقعك، فتعامل مع الأحداث الواصلة كبيانات، مو كإثبات.
التجربة والإنتاج
استخدم مفتاح pk_test_ وقت التطوير، والأفضل في مشروع منفصل، عشان زيارات التجربة ما تختلط بالمستخدمين الحقيقيين. datacub يقبل الأحداث من localhost و 127.0.0.1 و Expo Go بس مع مفتاح التجربة؛ ومفتاح الإنتاج ينرفض هناك. وكل مشروع جديد يجي ومعه مفتاح تجربة، مكتوب جنبه اختبار في الإعدادات، الربط؛ و مفتاح اختبار جديد يسوي غيره.
حط مفتاح التجربة في نسخ التطوير، ومفتاح الإنتاج في النسخة الفعلية. في Vite اكتب datacub.init('%VITE_DATACUB_KEY%') في الكود اللي في index.html، وحط VITE_DATACUB_KEY في .env.development و .env.production.
تغيير المفاتيح
المشروع يقدر يكون له مفتاحين بنفس الوقت، عشان تبدّل بدون انقطاع: في الإعدادات، الربط سوّ مفتاح جديد، وانشره، وبعدها ألغِ القديم. المفتاح الملغي يوقف خلال 15 ثانية.
مفتاح pk_ عام من الأساس، فنسخه مو اختراق. بدّل المفاتيح إذا أحد صار يرسل فيه بيانات خربانة.