إدارة مفاتيح API

تتيح لك صفحة مفاتيح API إنشاء وعرض وإدارة المفاتيح التي تستخدمها تطبيقاتك لاستدعاء FourA API.

عرض مفاتيحك

تعرض الصفحة جميع المفاتيح التي تملك صلاحية الوصول إليها:

المفاتيح الشخصية التي أنشأتها مباشرةً.
مفاتيح المؤسسة إذا كنت مالكًا للمؤسسة أو مسؤولًا فيها.
مفاتيح الفريق المشاركة معك من خلال عضوية الفريق.

يعرض كل صف في الجدول ما يلي:

العمود	ما يعرضه
الاسم	اسم العرض والوصف (اختياري)
المفتاح	البادئة المقنعة (مثل `pk_live_••••••••`) مع زر كشف بجوارها
المالك	`ME` للمفاتيح الشخصية، و`TEAM` لمفاتيح المؤسسة أو المفاتيح المشتركة مع الفريق
القائمة البيضاء لعناوين IP	عناوين IP المقيدة في حال تعيينها، أو "جميع عناوين IP" إذا لم تكن مقيدة
تاريخ الانتهاء	تاريخ انتهاء الصلاحية في حال تعيينه، أو "أبدًا"
الحالة	نشط أو غير نشط
تاريخ الإنشاء	وقت إنشاء المفتاح
آخر استخدام	وقت آخر request أجراه المفتاح

استخدم مربع البحث للتصفية حسب الاسم أو الوصف، وفلتر الحالة لعرض المفاتيح النشطة أو غير النشطة فقط.

إنشاء مفتاح

انقر فوق Create Key واملأ ما يلي:

الحقل	مطلوب	الوصف
الاسم	نعم	تسمية توضيحية (مثل "production-scraper" أو "staging-test")
الوصف	لا	ملاحظات حول الغرض من استخدام هذا المفتاح

إذا كنت تنتمي إلى مؤسسة، يمكنك أيضًا تعيين المفتاح لتلك المؤسسة بدلاً من حسابك الشخصي.

يظهر المفتاح الكامل مرة واحدة فور إنشائه في مربع حوار جاهز للنسخ. يمكنك أيضًا استعادته لاحقًا عبر Reveal (انظر أدناه) طالما تم إنشاء المفتاح بعد إطلاق ميزة الكشف.

تستخدم المفاتيح البادئة pk_live_ وتبدو كالتالي: pk_live_a1b2c3d4e5f6.... ستتلقى تأكيدًا عبر البريد الإلكتروني عند إنشاء مفتاح جديد.

كشف مفتاح

انقر فوق أيقونة العين بجوار البادئة المقنعة للمفتاح لرؤية السر الكامل مجددًا. ستطلب منك لوحة التحكم التأكيد، ثم تفتح مربع حوار يحتوي على المفتاح الواضح، وزر نسخ، وعد تنازلي لمدة 15 ثانية. بعد انتهاء العد التنازلي، يمسح مربع الحوار السر من الصفحة.

يتم تسجيل كل عملية كشف في سجل التدقيق لأنها تعرض بيانات اعتماد نشطة.

المفاتيح القديمة

تظهر المفاتيح التي تم إنشاؤها قبل إطلاق هذه الميزة أيقونة قفل بدلاً من العين ولا يمكن كشفها. تم تخزين الرمز المجزأ (hash) الخاص بها فقط، لذا لا يمكن استرداد السر الأصلي. لتحويل مفتاح قديم، انقر فوق قائمة الإجراءات واختر Regenerate. سيكون السر الجديد قابلاً للكشف من ذلك الحين فصاعدًا.

من يمكنه الكشف

الدور	يمكنه الكشف
مالك المفتاح	نعم
مالك المؤسسة / المسؤول (لمفاتيح المؤسسة)	نعم
عضو الفريق الذي يملك صلاحية `write` أو `admin`	نعم
عضو الفريق الذي يملك صلاحية `read`	لا

تعديل مفتاح

انقر فوق Edit في أي صف لتحديث:

اسم العرض والوصف
القائمة البيضاء لعناوين IP (عنوان IP واحد في كل سطر، اتركه فارغًا للسماح بأي عنوان IP مصدر)
تاريخ انتهاء الصلاحية (اتركه فارغًا لعدم وجود تاريخ انتهاء)

الإعدادات الأخرى (تعيين المؤسسة، المالك) غير قابلة للتعديل. أنشئ مفتاحًا جديدًا إذا كنت بحاجة إلى ملكية مختلفة.

التنشيط وإلغاء التنشيط

استخدم زر Disable / Enable في الصف لتبديل حالة المفتاح. يؤدي إلغاء تنشيط المفتاح إلى حظر جميع الـ API requests التي تستخدمه. يمكنك إعادة تنشيطه في أي وقت. يدخل التغيير حيز التنفيذ في غضون ثوانٍ.

إعادة إنشاء مفتاح

إذا كنت تشك في تعرض أحد المفاتيح للاختراق، فافتح قائمة الإجراءات (زر النقاط الثلاث) واختر Regenerate. يؤدي هذا إلى إنشاء سر جديد لنفس معرف المفتاح (key ID). يتوقف السر القديم عن العمل فورًا. تظل جميع الإعدادات الأخرى (الاسم، تعيين المؤسسة، القائمة البيضاء لعناوين IP، تاريخ الانتهاء) كما هي.

يظل السر الجديد قابلاً للكشف بعد إغلاق مربع الحوار، لذلك لا يتعين عليك نسخه بدقة في المحاولة الأولى.

حذف مفتاح

افتح قائمة الإجراءات واختر Delete. بشكل افتراضي، يؤدي الحذف إلى إلغاء تنشيط المفتاح (حذف مؤقت). يمكنك إزالته نهائيًا من مربع حوار التأكيد.

ستتلقى إشعارًا عبر البريد الإلكتروني عند حذف المفتاح.

مفاتيح المؤسسة

تتم مشاركة المفاتيح التي تم إنشاؤها ضمن مؤسسة مع أعضاء المؤسسة بناءً على دورهم:

المالكون والمسؤولون يرون جميع مفاتيح المؤسسة ويعدلونها.
الأعضاء يرون فقط المفاتيح المعينة للفرق التي ينتمون إليها.

تُضاف مفاتيح المؤسسة تلقائيًا إلى الفريق الافتراضي للمؤسسة عند إنشائها.

صلاحيات المفاتيح من خلال الفرق

تتحكم الفرق فيمن يمكنه الوصول إلى أي مفاتيح. لكل تعيين مفتاح لفريق مستوى صلاحية محدد:

الصلاحية	عرض المفتاح	الكشف	تعديل إعدادات المفتاح
read	نعم	لا	لا
write	نعم	نعم	نعم
admin	نعم	نعم	نعم