سجل الأمان ومفتاح API

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

1. اقرأ سجل الدخول

   افتح الحساب ثم سجل الدخول. كل سطر حدث واحد وقع في حسابك. الجدول أربعة أعمدة.

   

   1. 1 النوع. ماذا حدث. الأسماء بالإنجليزية، وقائمتها كاملة في الخطوة 2.
   2. 2 IP. رقم الجهاز الذي وقع منه الحدث على الإنترنت. لكل اتصال رقم.
   3. 3 التفاصيل. ثلاث أيقونات: نوع الجهاز، ونظام التشغيل، وعلم الدولة. مرّر الفأرة فوق أي أيقونة ليظهر اسمها.
   4. 4 التاريخ. «منذ ساعة»، «منذ 3 أيام». مرّر الفأرة فوقه لترى التاريخ والوقت بالضبط.
   5. 5 سطران فيهما login.wrong_password من رقم IP آخر ومن علم دولة أخرى. هذا هو الشكل الذي تبحث عنه. اقرأ الخطوة 3.

2. افهم أسماء الأحداث

   عمود النوع يكتب الاسم بالإنجليزية. هذه كل الأسماء التي قد تراها، وليس غيرها:

   ما تراه	معناه
   login.success	دخول ناجح إلى حسابك.
   login.wrong_password	أحدهم كتب كلمة مرور خاطئة لبريدك. الدخول لم يقع.
   register.success	يوم فتح الحساب. يظهر مرة واحدة فقط.
   register.google.success	فتح الحساب بحساب جوجل. وبنفس الشكل register.apple.success لحساب أبل.
   activate.success	تفعيل الحساب من رابط البريد.
   email_change.success	تأكيد بريدك الجديد من رابط الرسالة، وبه صار بريد دخولك.
   lost_password.request_sent	طُلبت رسالة «نسيت كلمة المرور» لبريدك.
   reset_password.success	غُيّرت كلمة المرور من رابط تلك الرسالة.
   verify_email.resend	أُعيد إرسال رسالة تأكيد البريد.
   profile_step.save	حفظ بيانات صفحة «أكمل ملفك» بعد التسجيل.
   profile_step.skip	تخطّي تلك الصفحة.
   legal.accept	موافقتك على النسخة الحالية من الشروط وسياسة الخصوصية.

   السجل يحفظ 90 يوماً فقط. كل سطر أقدم من 90 يوماً يُحذف تلقائياً. إن أردت الاحتفاظ به فصدّره الآن: زر التصدير في أعلى الصفحة يعطيك ملف CSV أو JSON.

3. اكتشف دخولاً ليس منك

   لا تقرأ السجل سطراً سطراً. اقرأ ثلاثة أشياء فقط، وقارنها بما تعرفه عن نفسك:

   1. العلم. هل هناك علم دولة لم تدخل منها أبداً؟
   2. رقم IP. هل تكرر رقم غريب لا يشبه أرقامك المعتادة؟
   3. الوقت. هل هناك دخول ناجح في وقت كنت فيه نائماً أو بلا إنترنت؟

   الفرق المهم: سطر login.wrong_password يعني أن أحداً حاول ولم يدخل. سطر login.success من مكان غريب يعني أنه دخل فعلاً. الثاني أخطر بكثير.

   وثلاثة أسطر أخرى تستحق نفس الانتباه إن لم تكن أنت من فعلها: reset_password.success يعني أن كلمة مرورك تغيّرت، وemail_change.success يعني أن بريد دخولك تغيّر، وlost_password.request_sent يعني أن أحداً طلب رسالة استرجاع لبريدك.

   إن رأيت دخولاً ناجحاً ليس منك، افعل هذا بالترتيب وفي نفس الجلسة:
   1. غيّر كلمة المرور من صفحة الحساب. تغييرها يُخرج كل جلسة مفتوحة.
   2. فعّل التحقق على مرحلتين.
   3. افتح مفتاح API واضغط أعد توليد مفتاح الAPI.
   4. راجع صفحة الطلبات وإعدادات الدفع، وتأكد أن شيئاً لم يتغيّر.

   بضعة أسطر login.wrong_password من دولة بعيدة أمر شائع على الإنترنت، ولا يعني أن حسابك اختُرق. لكنه سبب كافٍ لتفعيل التحقق على مرحلتين اليوم لا غداً: كلمة المرور والدخول بخطوتين.

4. اعرف ما هو مفتاح API

   API باب خلفي لحسابك يستعمله برنامج، لا إنسان. البرنامج لا يفتح صفحاتنا ولا يكتب كلمة مرور، بل يرسل طلباً ومعه مفتاح يقول: «أنا هذا الحساب». ذلك المفتاح هو مفتاح API.

   من يحتاجه؟ قلة. تحتاجه إن كان عندك مبرمج يربط نظاماً آخر بحسابك — نظام محاسبة مثلاً — أو أداة جاهزة تطلب منك مفتاحاً. إن لم يطلب منك أحد مفتاحاً، فأنت لا تحتاج هذه الصفحة أبداً.

   

   1. 1 مفتاح الAPI. 32 محرفاً. الحقل للقراءة فقط، فأنت تنسخه ولا تكتبه. المفتاح في الصورة وهمي.
   2. 2 زر أعد توليد مفتاح الAPI. اقرأ الخطوة 5 قبل أن تضغطه.
   عامل المفتاح كما تعامل كلمة المرور. من يملكه يقرأ بيانات حسابك بلا كلمة مرور وبلا تحقق على مرحلتين. لا ترسله في محادثة عامة، ولا تضعه في صورة، ولا تلصقه في موقع لا تعرفه.
   يعمل أيضاً: البرنامج يرسل المفتاح في ترويسة Authorization: Bearer، والحد 60 طلباً في الدقيقة لكل مفتاح. وبعض الباقات لا تشمل الـ API أصلاً، وعندها يرد الخادم برسالة «خطتك الحالية لا تشمل الوصول إلى الAPI».

5. أعد توليد المفتاح، واعرف ماذا يتوقف

   الزر يعطيك مفتاحاً جديداً في نفس اللحظة. والمفتاح القديم يموت فوراً. لا توجد مهلة، ولا يعمل الاثنان معاً، ولا يمكن استرجاع القديم.

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

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

   لا نسألك مرة ثانية. ضغطة واحدة على الزر تكفي، ويظهر لك بعدها: «لقد تمت إعادة توليد مفتاح الAPI الخاص بك بنجاح!». جهّز المكان الذي ستلصق فيه المفتاح الجديد قبل أن تضغط.

← كل الشروحات