تخطَّ إلى المحتوى
تسجيل الدخولاطلب حساب

السياق التقني وإخفاء البيانات

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

تحديد العنصر

مُحدِّد CSS ومسار DOM والموضع والوسم/الدور للعنصر اللي ثبّت عليه المُبلِّغ دبوسه، فيروح المطوّر مباشرةً للمكوّن المسؤول.

مسار الخطوات

آخر N إجراء (نقرات وإدخالات وتنقّلات) بالترتيب وبأوقاتها، فيقدر المُفرِز يعيد المسار اللي وصل للعلّة. في الوضع التقني فقط.

الطلبات الفاشلة

الطريقة والرابط وحالة نداءات الشبكة اللي فشلت أثناء الجلسة. في الوضع التقني فقط، بالسنيبت والإضافة سواء.

إخفاء البيانات الحسّاسة

القيم المكتوبة تُموَّه باللقطة، والسلاسل اللي شكلها سرّ تُمسح من النصوص، قبل ما يغادر التقرير المتصفّح.

الإخفاء وقائمة المُحدِّدات الحسّاسة دايماً موجودان في الودجت ← الإعداد، ببطاقة الخصوصية، جنب بطاقة وضع الالتقاط. أمّا مفتاح تحديد العنصر وعدد الخطوات، فما لهم خانة بهالشاشة — ولا بأي مكان ثاني بالمنتج — ويُضبطون من API اللوحة فقط. ولا وحدة من الأربع مقفلة بباقة، والوضعان متاحان في كل الباقات.

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

  • selector: مُحدِّد CSS مختصر. يفضّل #id ثابتاً؛ وإلا يبني مساراً tag.class:nth-of-type(n) (حتى خمسة مستويات)، ويتخطّى أسماء الأصناف اللي شكلها مولَّد أو مُجزَّأ: بادئة css- أو sc- أو jsx- أو emotion-، وأي اسم أطول من 30 محرفاً، وأي اسم فيه ثلاثة أرقام متتالية. وهذا ترجيح مو ضمان: اسم مبهم قصير زي a1b2c3d4 يعدّي كل هالفحوص ويُستعمل.
  • dom_path: مسار بنيوي أعمق (حتى اثني عشر مستوى) للسياق.
  • position: صندوق العنصر كـx وy وw وh.
  • tag و**role**: اسم الوسم ودور ARIA.
  • confidence: high لمّا يكون للعنصر id ثابت، وlow لمّا يضطرّ المسار يرجع لـ :nth-of-type موضعي أو ما لقى صنفاً ثابتاً، وmedium فيما عدا ذلك.

والحلّ تقريبي وما يرمي خطأ أبداً: الدبوس فوق منطقة ما تنعرف يسجّل حقول عنصر فاضية بثقة low، والإرسال ينجح برضه. وفي صفحة التقرير يُرسَم الدبوس فوق اللقطة كصندوق العنصر نفسه، أو كشريط برتقالي مع اسم الجهة لو كان المُبلِّغ علّق على هامش بدلاً منه. أمّا المُحدِّد نفسه فما يُطبَع بأي مكان: لا بهالصفحة، ولا في اللي ينسخه زرّ نسخ التقرير كنصّ. سطر Element: في ذاك الزرّ مبنيّ من كتلة الإثراء هذي، فما يطلع إلا بمشروع مشغّل فيه تحديد العنصر — يعني اليوم مشروع مضبوط عبر الـAPI. أمّا dom_path والمُحدِّد المخزَّن مع الدبوس نفسه فيرجعون من الـAPI وما تعرضهم أي شاشة.

الملاحظة اللي تنرسل والمشروع على الوضع التقني تحمل أثراً مرتّباً ومؤرّخاً لآخر N إجراء قبل الالتقاط. والملاحظة العادية ما فيها هالأثر، وفي الوضع العادي الصفحة ما تسجّله أصلاً:

النوع وش يُسجَّل
click مُحدِّد ثابت للعنصر المنقور، ومعه تسمية منتقاة (aria-label أو title حقّه).
input معرّف الحقل: name أو id أو aria-label أو placeholder.
route المسار الجديد عند التنقّل، بلا سؤال الاستعلام وبلا الشظيّة.

كل مُدخَل مختوم بـHH:MM:SS. والودجت يحتفظ بحلقة متدحرجة ويرفق آخر N (عدد الخطوات بالمشروع: الافتراضي 20، وحتى 100)؛ والأقدم يُسقَط عشان تبقى الحمولة محدودة. والخادم يعيد التسقيف والتنظيف، فما ياخذ عدد العميل على عمياها.

الودجت يلفّ fetch وXMLHttpRequest بهدوء ويسجّل النداءات اللي تفشل، والاثنان يرسمان الخطّ بنفس المكان: خطأ شبكة (fetch ينرفض، أو XMLHttpRequest بحالة 0) أو حالة 400 فما فوق. أمّا 304 تتعامل معها بنفسك، أو منارة no-cors مبهمة نجحت، فما هي فشل وما تُسجَّل. وكل مُدخَل هو الطريقة والرابط والحالة فقط؛ وأجسام الطلب والردّ ما تُلتقط أبداً.

والطلبات الفاشلة، مثل رسائل الكونسول، تابعة للوضع التقني: الملاحظة التقنية تخزّن آخر 20، والعادية ما فيها شي، لأنّ الودجت في الوضع العادي ما يلفّ fetch ولا XMLHttpRequest من الأساس. وإضافة المتصفّح تشغّل نفس المحرّك وتسجّل نفس القائمة المُهيكلة. والملاحظة التقنية تحمل كمان سجلّ الطلبات كامل (كل طلب سوّته الصفحة، بنوعه ومدّته وحجمه، والفاشل والبطيء موسوم)؛ وهالقائمة هي العرض المختصر للفاشل منه.

ومعاملات الاستعلام اللي اسمها يبان حسّاساً (token وkey وsecret وpassword وpasswd وpwd وauth وsession وsid وsig وsignature وotp وcode وemail وphone وكتابتها بـcamelCase) تُستبدل بـ[redacted] وقت الالتقاط نفسه، فما تدخل القيمة الخام المخزن اللي يُرسَل — وهذي تصير سواء كان الإخفاء مشغّلاً أو لا. ومع تشغيل الإخفاء، يُمسح الرابط كلّه من أشكال الأسرار كمان قبل الإرسال.

إخفاء البيانات الحسّاسة

Section titled “إخفاء البيانات الحسّاسة”

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

والطبقتان تغطّيان اللقطة ورسائل الكونسول وروابط الطلبات الفاشلة ومسار الخطوات. أمّا رابط الصفحة اللي كان عليها الزائر والمُحيل (referrer) فما هم منهما، لكن عليهم القاعدة الوحيدة الشغّالة دايماً، نفس قائمة الطلبات الفاشلة: قيمة باراميتر في سؤال الاستعلام اسمه يوحي بسرّ (token، session، email…) تُفرَّغ بالمتصفّح، وباقي العنوان يبقى. أمّا سرّ تحت اسم بريء، أو داخل المسار نفسه، فيوصل التقرير — خلّها ببالك بالصفحات اللي رابطها نفسه يحمل سرّاً.

قُبيل ما تنرسم اللقطة (وبعد ما تخفي أداة الالتقاط نفسها)، يموّه الودجت الحقول اللي تحمل قيماً في الـDOM الحيّ، ويرجّعها فوراً بعدها، فما تبقى صفحتك عارضة قيماً مموّهة أبداً:

  • قيم input وtextarea تُستبدل بنقاط. ومربّعات الاختيار وأزرار الراديو والأزرار وأزرار الإرسال والمنزلقات وحقول اللون والمخفية تُتخطّى، فما فيها نصّ حرّ أصلاً — وحقول الملفّات كمان، لأنّ المتصفّح يرفض الكتابة فوقها، فاسم الملفّ اللي اختاره الزائر ممكن يبان باللقطة.
  • مناطق contenteditable يُموَّه نصّها، لأنّ قيمتها تعيش بالمحتوى النصّي مو بخاصيّة value.
  • المُحدِّدات الحسّاسة دايماً اللي تسجّلها: تُموَّه قيمة الحقل لو عنده قيمة، وإلا يُموَّه نصّه.
  • الإطارات من نفس الأصل تُموَّه كمان؛ وإطارات الأصول الأخرى تُتخطّى، لأنها ما تنقرأ.

رسائل الكونسول، وروابط الطلبات الفاشلة، وتسميات الخطوات وروابطها، كلّها تمرّ على مُخفٍ يستبدل السلاسل اللي شكلها سرّ بـ[redacted]. ويستهدف:

  • المفاتيح المُسمّاة: تسمية sk أو pk أو api أو key أو token أو bearer أو secret وبعدها قيمتها. والفاصل يمكن يكون مسافة أو شرطة سفلية أو شرطة أو =، وهذا اللي يمسك ?token=abc123… في سؤال الاستعلام، وهو المكان الوحيد اللي تلقى فيه التسمية وسرّها لاصقين ببعض.
  • التوكنات الطويلة المبهمة: سلاسل من 32 محرفاً فأكثر.
  • الأرقام اللي شكلها بطاقة: مجموعات 13 إلى 16 رقماً.
  • عناوين البريد، وأرقام الجوال المكتوبة بالصيغة الدولية (+966… أو 00966…) أو كجوال سعودي (05…). أمّا سلاسل الأرقام المجرّدة فتبقى: الكونسول مليان طوابع زمنية ومعرّفات.

والمُخفي يميل عمداً نحو الزيادة بالتمويه. وبما إنّ المُبلِّغ يشوف اللقطة قبل الإرسال، فالتمويه الزائد مرئي مو صامت. وهذا احتياط تقريبي (تمويه تلقائي للحقول ومسح لأشكال الأسرار)، مو محرّك DLP كامل؛ والقيمة اللي تفوته عيبٌ يُصلَح، مو سبب لإطفاء التمويه.

الإعداد الأثر الافتراضي من وين تضبطه
وضع الالتقاط عادي أو تقني. التقني يضيف مسار الخطوات والطلبات الفاشلة والكونسول وباقي السجلّ التقني. عادي (للمشاريع الجديدة) الودجت ← الإعداد
تحديد العنصر يرفق مُحدِّد العنصر المُثبَّت ومسار DOM والموضع والوسم/الدور والثقة. مطفّي الـAPI فقط
إخفاء البيانات يموّه القيم المكتوبة باللقطة ويمسح أشكال الأسرار من النصّ. مطفّي الودجت ← الإعداد
عدد الخطوات كم إجراء أخير تحتفظ به الملاحظة التقنية (1–100). 20 الـAPI فقط
المُحدِّدات الحسّاسة عناصر تُموَّه دايماً باللقطة (واحد بكل صفّ، حتى 50). لا شي الودجت ← الإعداد

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