مفاتيح الواجهة

أنشئ المفاتيح التي توثّق استدعاءاتك إلى Gurdx، وحدّد نطاقها، وبدّلها، واحمِها.

المفاتيح الفعلية والتجريبية#

يمكنك امتلاك عدة مفاتيح للحساب الواحد، مثلاً مفتاح لكل تطبيق أو بيئة، حتى لا يجبرك تسرّب في مكان واحد على تغيير كل شيء. راجع بيئة التطوير.

إنشاء مفتاح#

1. سجّل الدخول إلى لوحة التحكم على https://gurdx.cretip.com/app.
2. افتح صفحة مفاتيح الواجهة وأنشئ مفتاحاً، واختر فعلياً أو تجريبياً.
3. انسخه فوراً واحفظه في مدير أسرار أو متغير بيئة.

استخدم المفتاح كما في المصادقة.

المضيفون المصرّح لهم#

يمكنك حصر حسابك في قائمة مضيفين. حين لا تكون القائمة فارغة يُقبل الطلب فقط إذا:

• كان مضيف الترويسة Origin أو Referer ضمن القائمة، أو
• كان عنوان IP للمتصل ضمن القائمة.

وإلا أعادت الواجهة الخطأ 113 domain_not_whitelisted. طلبات الخوادم لا تحمل عادةً Origin، لذا أدرج عناوين IP لخوادمك. والقائمة الفارغة تسمح بكل شيء.

حماية مفتاحك#

Warning: من يملك مفتاحاً فعلياً يستطيع استهلاك حصتك وقراءة بياناتك. عامله كأنه كلمة مرور.

• لا تضمّن مفتاحاً فعلياً في جافاسكربت أو تطبيقات الجوال أو HTML. استدعِ Gurdx من خادمك الخلفي.
• لا ترفع المفاتيح إلى Git. استخدم ملفات .env المتجاهَلة أو مدير أسرار.
• فضّل ترويسة Authorization: Bearer على ?key= ليبقى المفتاح خارج السجلات وترويسات الإحالة.
• استخدم مفاتيح منفصلة لكل بيئة ولكل خدمة.
• قيّد المضيفين المصرّح لهم كلما كان مصدر حركتك معروفاً.

تدوير المفتاح#

دوّر المفتاح وفق جدول، أو عند مغادرة أحد أعضاء الفريق، أو فور الاشتباه بتسرّب:

1. أنشئ مفتاحاً جديداً.
2. انشره في تطبيقاتك.
3. تأكد من لوحة التحكم أن وقت آخر استخدام للمفتاح القديم لم يعد يتقدّم.
4. احذف المفتاح القديم.

الطلبات بمفتاح محذوف تعيد الخطأ 101 invalid_key.

إذا تسرّب مفتاح#

احذفه فوراً وأنشئ بديلاً وراجع الاستخدام الأخير في لوحة التحكم بحثاً عن حركة غير متوقعة. حد الإغراق (الخطأ 106) والحصة (الخطأ 103) يحدّان الضرر لكن لا تعتمد عليهما.

أخطاء شائعة#

القائمة الكاملة في رموز الأخطاء.