TgWitness / مستندسازی

مستندسازی / 12

راه‌اندازی یک بات شاهد

اجازه دهید یک فرآیند جداگانه مجله را بررسی کرده و نقاط کنترل امضا شده را در کانال شما منتشر کند.

دو میزبان، دو کلید امضا

میزبان / گردآورندهحساب + دفترچه

کلید امضای گردآورنده جلسه تلگرام

نقطه پایانی نقطه‌کنترل فقط-خواندنی
میزبان B / شاهدتأیید و نگهداری

اثر انگشت جمع‌آوری ثابت‌شده کلید امضای شاهد جداگانه

ژورنال اختصاصی + توکن بات
شاهد ← رابط برنامه‌های کاربردی ربات تلگرام ←کانال شما · پست‌های امضا شده با TGW1
شاهد خود به‌صورت خودکار چک‌ها را انجام می‌دهد. دسترسی گردآورنده فقط خواندنی است. انتشار ربات از اتصال و توکن شاهد استفاده می‌کند؛ هیچ جلسه حساب کاربری‌ای به شاهد داده نمی‌شود.
۰۳ / تصمیمات نقطه‌کنترلپاسخ‌های مصور
آخرین پذیرش۱۲۰ رکوردhead 9c7d…
پاسخ بعدی۱۲۸ رکوردhead a4f2…

پذیرفته شد: شمارش افزایش می‌یابد، امضا تأیید می‌شود و کلید مطابقت دارد. شاهد این مرز جدید را حفظ می‌کند.

تمام مثال‌های پاسخ‌دهی فرض می‌کنند که امضای معتبر و کلید سنجاق‌شده وجود دارد. هش‌های اینجا نمونه‌های مختصر هستند. تنها تعداد بیشتر به‌تنهایی نمی‌تواند ثابت کند که کل پیش‌وند قدیمی بدون تغییر باقی مانده است؛ خروجی را با نقاط کنترل حفظ‌شده مقایسه کنید.

یک ربات و یک کانال آماده کنید

یک بات با BotFather بسازید و اجازه دهید در کانالی که کنترل آن را در دست دارید پست کند. یک کامپیوتر یا سرور برای شاهد انتخاب کنید. یک میزبان و اپراتور جداگانه استقلال بیشتری نسبت به یک فرآیند دوم روی سرور گردآورنده فراهم می‌کند.

سه مرحله در بخش اضافی

  1. دسترسی فقط-خواندنی. extras را باز کنید → یک ربات در کانال شما، یک توکن شاهد بسازید و فایل دسترسی را ذخیره کنید. این امکان را می‌دهد که نقاط کنترل و وضعیت سلامت را بخوانید، نه گفتگوها یا کنترل‌های گردآورنده.
  2. کانال و فاصله زمانی. کانال و آدرسی از یک جمع‌آورنده را که از طریق شاهد قابل دسترسی است وارد کنید. فایل تنظیمات را ذخیره کنید.
  3. راه‌اندازی. فایل‌های witness.json، witness-token.txt و bot-token.txt را که روی میزبان شاهد ایجاد شده‌اند، با هم قرار دهید. دستورات زیر را در محیط پروژه نصب‌شده اجرا کنید.
python -m tgwitness.witness run --config witness.json --check-config
python -m tgwitness.witness run --config witness.json

دانلود فایل‌ها باعث راه‌اندازی TgWitness نمی‌شود. بررسی کنید که اولین پست امضا شده در کانال ظاهر شود، سپس اثر انگشت کلید عمومی شاهد را به‌طور جداگانه ذخیره کنید.

انتخاب کنید هر چند وقت یک‌بار منتشر شود

انتشار هر چک یک رکورد خارجی منظم ایجاد می‌کند. با فواصل زمانی پنج دقیقه‌ای، این معادل حدود ۲۸۸ پست در هر فضای کاری در روز است. تنظیمات پیشرفته همچنین امکان انتشار تغییرات یا مشکلات، یک پروکسی و یک آدرس API ربات سفارشی را فراهم می‌کنند.

این بات در واقع چه چیزی را تصدیق می‌کند؟

شاهد از گردآورنده درخواست یک نقطه کنترل امضا‌شده می‌کند، آن را با کلید مورد انتظار تأیید می‌کند و یک دفتر امضا‌شده جداگانه نگه می‌دارد. این ابزار پاسخ‌های از دست رفته و پاسخ‌های ردشده را همان‌طور که بررسی‌های موفق را ثبت می‌کند. انتشار همچنان به اجرای شاهد و دسترسی آن به Bot API تلگرام بستگی دارد.

این ابزار وضعیت گزارش‌شده دفترچه را بررسی می‌کند. این ابزار به‌طور مستقل هر پیام تلگرام را مشاهده نمی‌کند. برای این کار، تست تحویل کنترل‌شده را اضافه کنید.

بعداً شواهد را بررسی کنید

دفترچه شاهد، پست‌های کانال و اثرانگشت‌های به‌طور مستقل ذخیره شده را نگهداری کنید. روند کامل تأیید، آن‌ها را با خروجی امضا شدهٔ گردآورنده مقایسه می‌کند.