أنشئ حسابك وأول مفتاح موقع لك
هذا أول ثلاثة دروس قصيرة. تأخذك معًا من حساب فارغ إلى تحدّي لعبة حقيقي يحرس نموذجًا حيًّا.
أنت تعمل في BananaSeed، ونموذج التواصل على موقعك يغرق في الرسائل المزعجة: روبوتات ووكلاء ذكاء اصطناعي مبرمَجون يطلقون عليه إرساليات نفاية على مدار الساعة. تريد Caputchin واقفًا أمام ذلك النموذج كي لا يمرّ سوى أشخاص حقيقيين.
وإليك كيف يفعل Caputchin ذلك. حين يفتح أحدهم نموذج تواصلك، يعطيه Caputchin تحديًا سريعًا في المتصفّح (خانة اختيار بسيطة، أو لعبة قصيرة). اجتيازه يكسب رمزًا للاستخدام مرة واحدة، ترسله الصفحة مع الإرسالية. يتحقّق خادمك بعد ذلك من ذلك الرمز مع Caputchin قبل أن يثق بالطلب. الروبوت الذي يرسل POST مباشرةً إلى نقطة وصولك لم يجتز تحديًا قطّ، فلا رمز صالح لديه، ويصدّه خادمك.
موقع BananaSeed واجهة React مع خادم خلفي Node.js يعمل على Express، لذا يسلّمك الدرسان التاليان كودًا عاملًا لهذه المنظومة بالذات. تنطبق الخطوات نفسها على أي إطار عمل أو لغة؛ ما يتغيّر هو الصياغة وحدها.
أولًا، تحتاج BananaSeed إلى حساب ومفتاح موقع. نحو دقيقتين، بلا بطاقة ائتمان، ولا شيء لتثبيته بعد.
ما الذي سيكون لديك في النهاية
- حساب Caputchin.
- مفتاح موقع واحد، وهو في الحقيقة زوج من القيم:
- مفتاح عام (
cpt_pub_...) يدخل في صفحتك، - سرّ (
cpt_sec_...) يبقى على خادمك.
- مفتاح عام (
1. سجّل الدخول (هذا ينشئ حسابك أيضًا)
اذهب إلى caputchin.com/login. لا توجد خطوة تسجيل منفصلة: أول تسجيل دخول لك ببريد إلكتروني هو ما ينشئ الحساب. اختر ما يناسبك:
- أرسِل رابط تسجيل دخول بالبريد، ثم انقر الرابط في البريد، أو
- تابع مع GitHub، أو
- تابع مع Google.
لا نقرأ أبدًا سوى عنوان بريدك الموثَّق.
بمجرّد دخولك، لاحظ أن شريط العنوان يعرض /app/troops. يضعك Caputchin مباشرةً في فرقك.
2. افتح فريقك الشخصي
قبل أن تصنع مفتاح موقع، يفيد أن تعرف أين يقيم. كل شيء في Caputchin تقريبًا يقع داخل فريق. الفريق مساحة عمل، وهو ما يملك مفاتيح مواقعك، وتخصيص اللعبة الذي تتشاركه تلك المفاتيح، و(في الباقات المدفوعة) الزملاء الذين تدعوهم لمساعدتك في إدارتها. بُني Caputchin حول الفرق عن قصد: مفتاح الموقع ينتمي دائمًا إلى فريق، لا إلى حسابك مباشرةً، وهذا ما يتيح لفريق كامل أن يدير المفاتيح نفسها لاحقًا دون مشاركة تسجيل دخول واحد. الفوترة والمقاعد تقع على مستوى الحساب، فوق فرقك، لا داخل أيٍّ منها.
كل حساب يبدأ بفريق واحد اسمه Personal، وهو أنت وحدك. هذا كل ما تحتاجه لهذا الدليل. حين يضيق بك، تنشئ فرقًا مشتركة وتدعو أعضاء، لكن لا شيء فيما يلي يتغيّر.
انقر Personal لفتحه. يُفتح الفريق مباشرةً على مفاتيح المواقع خاصته، فهناك تحطّ. لاحظ شريط العنوان: /app/troops/<id>/site-keys. المفتاح الذي توشك على صنعه متداخل تحت الفريق، وهذه بالضبط علاقة الملكية التي وصفناها للتوّ.
3. أنشئ أول مفتاح موقع لك
انقر إنشاء مفتاح موقع، وأعطِه اسمًا مثل My site، ثم انقر إنشاء. لا يطلب سوى اسم.
يعرض لك Caputchin قيمتين:
| القيمة | تبدو هكذا | إلى أين تذهب |
|---|---|---|
| المفتاح العام | cpt_pub_... | في صفحتك، على عنصر الأداة. آمن لكشفه للمتصفّح. |
| السرّ | cpt_sec_... | على خادمك فقط. لا تضعه أبدًا في كود جانب العميل. |
لاحظ اللافتة: "انسخ السرّ الآن. لن نعرضه مرة أخرى أبدًا." انسخ السرّ واحفظه في مكان يستطيع خادمك قراءته منه (متغيّر بيئة، مدير أسرارك). يمكنك دائمًا رؤية المفتاح العام مجدّدًا على صفحة التكامل الخاصة بالمفتاح، لكن السرّ يُعرَض مرة واحدة بالضبط. إن فقدته، تدوّره بدل أن تستعيده.
المفتاح الجديد تمامًا لا قيد أصل عليه بعد، وهذا بالضبط ما يتيح لصفحة الاختبار خاصتك أن تعمل محليًّا في الدرس التالي. مزيد عن إعدادات المفتاح في مفاتيح المواقع.
ما الذي حدث للتوّ
| الخطوة | أين | النتيجة |
|---|---|---|
| أول تسجيل دخول | المتصفّح | يُنشأ حسابك ويصبح فريق Personal جاهزًا. |
| إنشاء مفتاح الموقع | لوحة التحكّم | مفتاح عام للصفحة وسرّ لخادمك. |
صار لديك حساب وأول مفتاح موقع لك، الأساس الذي يُبنى عليه كل ما تبقّى. أحسنت. 🎉
التالي
صارت مفاتيحك بين يديك. حان وقت وضع الأداة على صفحة ومشاهدة تحقّق حقيقي يجري.
تابع إلى أضف الأداة إلى موقعك.