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

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

عرض مفاتيحك

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

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

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

العمود	ما يعرضه
Name	اسم العرض ووصف (اختياري)
Key	بادئة مخفية (مثل `pk_live_••••••••`) مع زر Reveal بجوارها
Owner	`Personal` للمفاتيح الشخصية، أو اسم المؤسسة للمفاتيح المملوكة للمؤسسة
Status	نشط أو غير نشط
Created	وقت إنشاء المفتاح
Last Used	وقت إجراء المفتاح لآخر request

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

إنشاء مفتاح

انقر على Create Key واملأ:

الحقل	مطلوب	الوصف
Name	نعم	تسمية وصفية (مثل "production-scraper" أو "staging-test")
Description	لا	ملاحظات حول الغرض من استخدام هذا المفتاح
Owner	نعم إذا كنت في مؤسسة	شخصي، أو إحدى المؤسسات التي تنتمي إليها. يظهر المحدد فقط عندما يكون لديك مؤسسة واحدة على الأقل.

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

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

كشف المفتاح

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

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

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

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

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

الدور	يمكنه الكشف
مالك المفتاح	نعم
مالك المؤسسة أو المسؤول (للمفاتيح المملوكة للمؤسسة)	نعم
أي شخص آخر	لا

تعديل مفتاح

انقر على Edit في أي صف لتحديث اسم العرض والوصف. لا يتم تغيير الملكية (شخصي مقابل مؤسسة) هنا. استخدم Transfer أدناه لنقل مفتاح بين المالكين.

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

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

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

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

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

نقل مفتاح

يحتوي كل صف على إجراء نقل في القائمة. استخدمه لنقل مفتاح بين الملكية الشخصية وملكية المؤسسة دون إعادة إنشاء السر. يتم الاحتفاظ بمعرف المفتاح (key ID) ومقاييسه وسجل نشاطه؛ يتغير المالك فقط.

الحالات الشائعة:

نقل مفتاح شخصي قمت بإنشائه لمشروع مشترك إلى المؤسسة (org) حتى يتمكن زميل الفريق من إدارته بعدك.
إعادة تعيين مفتاح مؤسسة (org) لنفسك إذا انفصل المشروع.

يمكنك نقل مفتاح تملكه (شخصي) إلى أي مؤسسة (org) تكون فيها مالكاً أو مسؤولاً، ويمكنك نقل مفتاح مؤسسة تديره لنفسك أو بين المؤسسات التي تديرها.

حذف مفتاح

افتح قائمة الإجراءات واختر حذف. يؤدي حذف مفتاح استخدمته من قبل إلى حذفه بشكل مبدئي: يتوقف المفتاح عن المصادقة ولكن يظل سجل النشاط والمقاييس الخاص به سليماً. يمكن حذف المفاتيح التي لم يتم استخدامها مطلقاً بشكل نهائي.

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

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

المفاتيح المملوكة لمؤسسة (org) مرئية لمالكي ومسؤولي المؤسسة. لا يراها الأعضاء الذين ليس لديهم دور مالك أو مسؤول.

يُحسب الاستخدام على مفتاح مملوك لمؤسسة ضمن خطة مالك المؤسسة.