نظرة عامة

مفتاح الموقع هو الاعتماد الذي يصل أداتك بـ Caputchin. تنشئ واحدًا داخل فريق، وكل مفتاح زوج من القيم إضافةً إلى إعداداته وإحصاءاته وتاريخه الخاص.

مفتاح واحد أم عدّة؟

معظم المواقع تحتاج واحدًا فقط. أنشئ مفتاحًا منفصلًا حين تريد سطحًا يُقاس أو يُضبط على حِدة:

واحد لكل بيئة (التجهيز والإنتاج) كي لا تعكّر حركة الاختبار إحصاءاتك الحقيقية.
واحد لكل نموذج أو منتج حين تريد إحصاءات مستقلة، أو إعدادات أمان مختلفة، لكل منها.

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

أنشئ مفتاحًا

افتح فريقك واذهب إلى مفاتيح المواقع.
انقر إنشاء مفتاح موقع، وأعطِه اسمًا، ثم انقر إنشاء. لا يطلب سوى اسم.

هذا يعيد القيمتين اللتين ستستخدمهما في كل مكان آخر:

القيمة	تبدو هكذا	إلى أين تذهب
المفتاح العام	`cpt_pub_...`	سمة `sitekey` للأداة، في صفحتك. آمن في المتصفّح.
السرّ	`cpt_sec_...`	خادمك، في نداء `/siteverify`. لا تشحنه إلى المتصفّح أبدًا.

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

الاسم

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

لكل مفتاح مبدّل مفعّل على صفحة الإعدادات خاصته. المفتاح المعطّل يرفض كل نداء /siteverify، فيتوقّف التحقّق فورًا دون حذف أي شيء. عطّل مفتاحًا حين تبتعد عن نشر مُسرَّب، وفعّله مجدّدًا حين تكون جاهزًا.

دوّر السرّ

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

احذف مفتاحًا

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

إعدادات لها صفحتها الخاصة

الأمان: أصول CORS، والترويسات المطلوبة، وصعوبة proof of work، وحجب الروبوتات، وحدّ المعدّل.
الإحصاءات والجلسات: قمع التحقّق وسجلّ كل جلسة.
سجلات التدقيق: سجلّ للتغييرات التي تجري على المفتاح.