التوثيق / 12

إعداد روبوت «Witness»

دع عملية منفصلة تتحقق من السجل وتنشر نقاط التحقق الموقعة على قناتك.

مضيفان، ومفتاحان للتوقيع

المضيف / المجمعالحساب + السجل

مفتاح التوقيع الخاص بـ «Telegram Session Collector»

نقطة نهاية نقطة تفتيش للقراءة فقط

← طلب إجابة موقعة →

HOST B / WITNESSالتحقق + الاحتفاظ

بصمة المجمع المثبتة ومفتاح التوقيع المنفصل لـ Witness

سجل خاص + رمز بوت

Witness → واجهة برمجة تطبيقات Telegram Bot →قناتك · منشورات TGW1 الموقعة

يقوم «الشهود» بإجراء عمليات التحقق بنفسه. ويكون وصول «المجمع» للقراءة فقط. ويستخدم «الروبوت» اتصال «الشهود» ورمزه المميز؛ ولا تُمنح «الشهود» أي جلسة حساب.

03 / قرارات CHECKPOINTأمثلة توضيحية

آخر قبول120 سجلًاhead 9c7d…

الإجابة التالية128 سجلًاhead a4f2…

تم القبول: يزداد العدد، ويتم التحقق من التوقيع، ويتطابق المفتاح. ويحتفظ الشاهد بهذا الحد الجديد.

تفترض جميع أمثلة الإجابات وجود توقيع صالح ومفتاح مثبت. التجزئات الواردة هنا هي أمثلة مختصرة. لا يمكن لعدد أكبر وحده أن يثبت أن البادئة القديمة بأكملها لم تتغير؛ قارن عملية التصدير مع نقاط التحقق المحتفظ بها.

قم بإعداد بوت وقناة

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

ثلاث خطوات في قسم «Extras»

وصول للقراءة فقط. افتح «Extras» → بوت في قناتك، وأنشئ رمز «witness token» واحفظ ملف الوصول. يتيح ذلك قراءة نقاط الفحص وحالة الأداء، وليس المحادثات أو عناصر التحكم في أداة التجميع.
القناة والفاصل الزمني. أدخل القناة وعنوان المجمع الذي يمكن الوصول إليه من الشاهد. احفظ ملف الإعدادات.
الإطلاق. ضع witness.json وwitness-token.txt وbot-token.txt التي تم إنشاؤها على مضيف Witness معًا. قم بتشغيل الأوامر أدناه في بيئة المشروع المثبتة.

python -m tgwitness.witness run --config witness.json --check-config
python -m tgwitness.witness run --config witness.json

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

اختر وتيرة النشر

يؤدي نشر كل عملية تحقق إلى إنشاء سجل خارجي منتظم. وبفواصل زمنية مدتها خمس دقائق، يبلغ عدد المنشورات حوالي 288 منشورًا لكل مساحة عمل يوميًا. كما تتيح الإعدادات المتقدمة إمكانية النشر عند حدوث تغييرات أو مشكلات، بالإضافة إلى وكيل (proxy) وعنوان مخصص لواجهة برمجة تطبيقات الروبوت (Bot API).

ما الذي يشهد به هذا البوت فعليًّا؟

يطلب الشاهد من المُجمِّع نقطة تفتيش موقعة، ويتحقق منها بمقارنتها بالمفتاح المتوقع، ويحتفظ بسجل منفصل موقّع. ويقوم بتسجيل الردود المفقودة والإجابات المرفوضة بالإضافة إلى عمليات التحقق الناجحة. ولا يزال النشر يعتمد على تشغيل الشاهد ووصوله إلى واجهة برمجة تطبيقات الروبوتات (Bot API) الخاصة بـ Telegram.

يقوم الموقع بالتحقق من حالة السجل المبلغ عنها من قِبل المُجمِّع. ولا يقوم بمراقبة كل رسالة Telegram بشكل مستقل. وللقيام بذلك، يُرجى إضافة اختبار التسليم الخاضع للرقابة.

تحقق من الأدلة لاحقًا

احتفظ بسجل الشهود ومنشورات القنوات والبصمات المحفوظة بشكل مستقل. وتقوم إجراءات التحقق الكاملة بمقارنتها مع التصدير الموقّع من قبل الجهة المجمعة.