# Telegram · چگونگی کارکرد شواهد

Canonical page: https://phishdestroy.io/tgwitness/fa/docs/reference/how-it-works/

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

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/fa/llms.txt)

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

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [شواهد و تأیید](https://phishdestroy.io/tgwitness/fa/docs/reference/evidence/)

![شواهد و تأیید](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

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

[وب‌سایت مستندات](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally) [محلی](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally)، نمونه‌های تعاملی را در `/docs/concepts/`، یک کاوشگر تصمیم‌گیری نقطه‌کنترل را در `/docs/witness/`، و راهنماهای گام‌به‌گام برای [Case Board](https://phishdestroy.io/tgwitness/fa/docs/reference/case-board/)، [طراحی گزارش](https://phishdestroy.io/tgwitness/fa/docs/reference/case-reports/) و [خروجی‌های handover](https://phishdestroy.io/tgwitness/fa/docs/reference/evidence/#handover-extract)را اضافه می‌کند. تمام پیام‌های نمونه، شمارش‌ها و تأخیرها فرضی هستند. هش‌ها در محیط شبیه‌سازی زنجیره با SHA-256 در مرورگر محاسبه می‌شوند. هیچ چیزی به تلگرام ارسال نمی‌شود.

**در این صفحه**

- [یک پیام تغییر می‌کند؛ مشاهدات انباشته می‌شوند](https://phishdestroy.io/tgwitness/fa/docs/reference/how-it-works/#a-message-changes-observations-accumulate)
- [آنچه یک هش پوشش می‌دهد](https://phishdestroy.io/tgwitness/fa/docs/reference/how-it-works/#what-a-hash-covers)
- [آنچه یک نقطهٔ کنترل قبلی اضافه می‌کند](https://phishdestroy.io/tgwitness/fa/docs/reference/how-it-works/#what-an-earlier-checkpoint-adds)
- [جایی که شاهد تعلق دارد](https://phishdestroy.io/tgwitness/fa/docs/reference/how-it-works/#where-a-witness-belongs)
- [تحویل تست در مقابل اقدامات شناخته‌شده](https://phishdestroy.io/tgwitness/fa/docs/reference/how-it-works/#test-delivery-against-known-actions)
- [یک گردش کار را انتخاب کنید](https://phishdestroy.io/tgwitness/fa/docs/reference/how-it-works/#pick-a-workflow)

## پیامی تغییر می‌کند؛ مشاهدات انباشته می‌شوند

نمودار توالی · تلگرام → جمع‌آور: پیام جدید: ساعت ۱۰:۰۰ ملاقات کنیم; جمع‌آور → دفترچه ثبت‌شده: پیوست: message.new; تلگرام → جمع‌آور: ویرایش: ساعت ۱۱:۰۰ ملاقات; جمع‌آور → دفترچه ثبت‌شده: پیام را ضمیمه کنید. ویرایش‌شده; تلگرام → جمع‌آور: اطلاعیه حذف; جمع‌آور → دفترچه ثبت‌شده: پیوست: پیام حذف‌شده; یادداشتی دربارهٔ دفترچه ثبت‌شده: مشاهدهٔ اصل + ویرایش + حذف باقی می‌ماند · تلگرام · جمع‌آور · دفترچه ثبت‌شده · پیام جدید: ساعت ۱۰:۰۰ ملاقات کنیم · پیوست: message.new · ویرایش: ساعت ۱۱:۰۰ ملاقات · پیام را ضمیمه کنید. ویرایش‌شده · اطلاعیه حذف · پیوست: پیام حذف‌شده · مشاهدهٔ اصل + ویرایش + حذف باقی می‌ماند

**نمودار به صورت متن**

1. تلگرام → جمع‌آور: پیام جدید: ساعت ۱۰:۰۰ ملاقات کنیم
2. جمع‌آور → دفترچه ثبت‌شده: پیوست: message.new
3. تلگرام → جمع‌آور: ویرایش: ساعت ۱۱:۰۰ ملاقات
4. جمع‌آور → دفترچه ثبت‌شده: پیام را ضمیمه کنید. ویرایش‌شده
5. تلگرام → جمع‌آور: اطلاعیه حذف
6. جمع‌آور → دفترچه ثبت‌شده: پیوست: پیام حذف‌شده
7. یادداشتی دربارهٔ دفترچه ثبت‌شده: مشاهدهٔ اصل + ویرایش + حذف باقی می‌ماند

این توالی ساده‌شده فرض می‌کند که تلگرام هر به‌روزرسانی را تحویل داده و حساب انتخاب‌شده قادر به مشاهده آن بوده است. رویدادهای عملیاتی نیز ژورنال را به اشتراک می‌گذارند. یک اعلان حذف، حذف‌کننده یا زمان دقیق حذف را ارائه نمی‌دهد. تحویل‌های تکراری مشاهدات جداگانه‌ای هستند؛ هیچ حذف تکراری در سطح کل ژورنال انجام نمی‌شود.

## آنچه یک هش پوشش می‌دهد

![مشاهده، رمزگذاری، هش‌گیری و امضا: هر رویداد جدید شامل هش رویداد قبلی است.](https://phishdestroy.io/tgwitness/assets/evidence-chain-animated.svg?v=368c25a3be9c)

فرمول را از داخل به بیرون بخوانید: **C** نُه فیلد را به بایت‌های دقیق تبدیل می‌کند؛ **SHA-256** هش آن‌ها را تولید می‌کند؛ **هگز** روشی است که آن هش با آن ذخیره می‌شود. هش قبلی از قبل در رویداد وجود دارد. **unhex** هش ذخیره‌شده را دوباره به ۳۲ بایت که Ed25519 امضا می‌کند، تبدیل می‌کند.

[نمودار ثابت زنجیره](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-chain-static.svg)

بگذارید C(ei) نشان‌دهندهٔ JSON استاندارد UTF-8 از نه فیلد رویداد باشد. اولین `previous_hash` شامل ۶۴ کاراکتر صفر است. هر رکورد بعدی شامل هش هگزادسیمال رکورد قبلی است:

hi = hex(SHA256(C(ei)))

σi = Ed25519.Sign(sk,unhex(hi))

امضا، ۳۲ بایت هش خام را پوشش می‌دهد. ورودی هش دقیقاً حاوی `seq`، `observed_at`، `source_at`، `kind`، `chat_id`، `message_id`، `actor_id`، `payload` و `previous_hash` است. کلیدهای شیء مرتب شده‌اند؛ فاصله‌های خالی و فرار ASCII حذف شده‌اند؛ NaN و بی‌نهایت رد شده‌اند. [رمزگذاری دقیق](https://phishdestroy.io/tgwitness/fa/docs/reference/evidence/#event-canonicalization) را ببینید.

نمودار جریان · ۶۴ کاراکتر صفر → ثبت ۱ / هَش h1; ثبت ۱ / هَش h1 → رکورد ۲ شامل h1 / هَش h2; رکورد ۲ شامل h1 / هَش h2 → رکورد ۳ شامل h2 / هَش h3; رکورد ۳ شامل h2 / هَش h3 → نقطهٔ کنترل امضا شده: شمارش ۳، سربرگ h3 (در جای دیگری نگهداری کنید) · ۶۴ کاراکتر صفر · ثبت ۱ / هَش h1 · رکورد ۲ شامل h1 / هَشh2 · رکورد ۳ شامل h2 / هَشh3 · نقطهٔ کنترل امضا شده:شمارش ۳، سربرگ h3 · در جای دیگری نگهداری کنید

**نمودار به صورت متن**

1. ۶۴ کاراکتر صفر → ثبت ۱ / هَش h1
2. ثبت ۱ / هَش h1 → رکورد ۲ شامل h1 / هَش h2
3. رکورد ۲ شامل h1 / هَش h2 → رکورد ۳ شامل h2 / هَش h3
4. رکورد ۳ شامل h2 / هَش h3 → نقطهٔ کنترل امضا شده: شمارش ۳، سربرگ h3 (در جای دیگری نگهداری کنید)

| تغییر به ژورنال ارائه‌شده | چه چیزی آن را تشخیص می‌دهد |
| --- | --- |
| سوابق رکورد ۲ را تغییر دهید در حالی که هش ذخیره‌شدهٔ آن دست‌نخورده باقی می‌ماند | هَش رویداد بازمحاسبه‌شده متفاوت است؛ امضای آن دیگر رویداد تغییر یافته را پوشش نمی‌دهد |
| سوابق تغییر یافته و هر هش بعدی را بازسازی کنید | امضاهای اصلی ناموفق هستند؛ یک نقطهٔ کنترل نگه‌داشته‌شده در مرز آسیب‌دیده نیز با آن اختلاف دارد |
| دم را حذف کنید اما پیش‌وند باقی‌مانده را دست‌نخورده نگه دارید | یک نقطه‌کنترل نگه‌داشته‌شده‌ی قبلی که فراتر از پیشوند ارائه‌شده قرار دارد نشان می‌دهد که خروجی بیش از حد کوتاه است |
| روزنامه جایگزین را با کلید دیگری مجدداً امضا کنید | اثر انگشت کلید مورد اعتماد جداگانه، هویت جایگزین را رد می‌کند |

![تغییر یک فیلد ذخیره‌شده هش آن را تغییر می‌دهد؛ بازسازی هش‌ها امضاهای اصلی را بازیابی نمی‌کند.](https://phishdestroy.io/tgwitness/assets/evidence-tamper-animated.svg?v=5ca92399bea5)

**منطق را روی رکورد ۲ امتحان کنید:** در رویداد ذخیره شده، `Meet at 11:00` را به `Meet at 12:00` تغییر دهید. هش بازمحاسبه‌شده آن دیگر مطابقت ندارد. بازمحاسبه زنجیره بعدی می‌تواند پیوندهای آن را ترمیم کند، اما نمی‌تواند باعث شود امضاهای اصلی، هش‌های جدید را پوشش دهند. در مقابل، یک ویرایش مشاهده‌شده در تلگرام به یک رکورد جدید در دفترچه تبدیل می‌شود.

[نمودار تغییرات ایستا](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-tamper-static.svg)

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

## آنچه یک نقطه کنترل قبلی اضافه می‌کند

![شمارش ۳ را حفظ کنید و سرفصل h3 را نگه دارید؛ خروجی بعدی شامل ۴ رکورد در موقعیت ۳ بررسی می‌شود.](https://phishdestroy.io/tgwitness/assets/evidence-checkpoint-animated.svg?v=e68f4e7be4b9)

**مرجع ثابت می‌ماند در حالی که مجله در حال رشد است.** اگر نقطه کنترل بگوید «۳ رکورد، سر h3»، یک خروجی چهار رکوردی می‌تواند با تطبیق h3 در موقعیت ۳ عبور کند. سر جدیدتر آن h4 است که انتظار می‌رود متفاوت باشد. یک خروجی شامل فقط دو رکورد با شکست مواجه می‌شود.

[نمودار نقطه‌کنترل ایستا](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-checkpoint-static.svg)

پس از تأیید امضای نقطه کنترل، الزامی است:

Nexport ≥ Ncheckpoint and hexport[Ncheckpoint] = Hcheckpoint

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

## جایی که شاهد به آن تعلق دارد

نمودار جریان · جمع‌آورنده / جلسه حساب / کلید A → نقطه پایانی نقطه‌کنترل فقط-خواندنی; شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → روزنامه شاهد امضا شده جداگانه; شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → نقطه پایانی نقطه‌کنترل فقط-خواندنی (درخواست بررسی); نقطه پایانی نقطه‌کنترل فقط-خواندنی → شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B (پاسخ امضا شده); شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → کانالی با پست‌های امضا‌شده TGW1 (رابط برنامه‌نویسی ربات / توکن اختصاصی) · میزبان A · میزبان B · جمع‌آورنده / جلسه حساب /کلید A · نقطه پایانی نقطه‌کنترلفقط-خواندنی · شاهد / کلید جمع‌آوریثابت‌شده / کلید خود B · روزنامه شاهد امضا شدهجداگانه · کانالی با پست‌های امضا‌شدهTGW1 · درخواست بررسی · پاسخ امضا شده · رابط برنامه‌نویسی ربات / · توکن اختصاصی

**نمودار به صورت متن**

1. جمع‌آورنده / جلسه حساب / کلید A → نقطه پایانی نقطه‌کنترل فقط-خواندنی
2. شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → روزنامه شاهد امضا شده جداگانه
3. شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → نقطه پایانی نقطه‌کنترل فقط-خواندنی (درخواست بررسی)
4. نقطه پایانی نقطه‌کنترل فقط-خواندنی → شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B (پاسخ امضا شده)
5. شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → کانالی با پست‌های امضا‌شده TGW1 (رابط برنامه‌نویسی ربات / توکن اختصاصی)

شاهد بازگشت به عقب، سرِ متفاوت در همان شمارش، کلیدهای تغییرکرده، پاسخ‌های نامعتبر و پاسخ‌های غایب را ثبت می‌کند. برای تأیید اینکه همهٔ سوابق قبلی تغییر نکرده‌اند، خروجی را با نقاط کنترل نگه‌داشته‌شده مقایسه کنید. شاهدی روی میزبان دیگر در قطعی میزبان گردآورنده شریک نیست؛ یک اپراتور جداگانه استقلال بیشتری می‌دهد. راستی‌آزما بررسی می‌کند که کلید شاهد با کلید گردآورنده متفاوت باشد؛ سابقهٔ کنترل کلید امانت‌دار نشان می‌دهد کلید در اختیار کیست. تلگرام هر پست در کانال عمومی را تاریخ‌گذاری می‌کند و `verify.py --channel https://t.me/s/…` این تاریخ‌ها را به‌عنوان زمان خارجی می‌خواند.

شاهد به وضعیت گزارش‌شده دفترچه یادداشت گردآورنده گواهی می‌دهد. از یک آزمون تحویل کنترل‌شده برای اندازه‌گیری اینکه کدام اقدامات تلگرام به یک حساب گردآورنده رسیده‌اند، استفاده کنید. به [بخش راه‌اندازی شاهد](https://phishdestroy.io/tgwitness/fa/docs/reference/witness/) مراجعه کنید.

## ارسال را در برابر اقدامات شناخته‌شده آزمایش کنید

از یک گروه کنترل‌شده، حساب‌های جمع‌آوری مجزا و یک نشانگر جدید استفاده کنید. پیام‌ها را عمداً ارسال، ویرایش و حذف کنید و در فواصل مراحل، ضبط را بررسی نمایید. اقدامات مورد انتظار و یک نقطه قطع را تعریف کنید و سپس نتایج را بازرسی کنید.

R = |observed∩expected| / |expected| Δ t = treceipt - taction

تنها اقدامات مطابقت‌یافته با انتظار شمرده می‌شوند؛ رسیدهای تکراری مخرج را افزایش نمی‌دهند. مخرج باید غیرصفر باشد. یک رسید مفقود، تأخیر اندازه‌گیری‌شده‌ای ندارد. عدم قطعیت ساعت سند را مستند کنید؛ از زمان اقدام حذف کنترل‌شده خود استفاده کنید، زیرا تلگرام زمان دقیق حذف را ارائه نمی‌دهد. نتایجه‌ای مانند ۵/۶ (۸۳.۳٪) اقدامات آزمایشی را توصیف می‌کند، نه کامل بودن کل ترافیک تلگرام را.

## یک گردش کار را انتخاب کنید

[راهنمای کامل تحقیق](https://phishdestroy.io/tgwitness/fa/docs/reference/investigation/)، یک رویداد را در یک کانال، گروه، ربات و چت خصوصی دنبال می‌کند:

1. در یک حساب جمع‌آوری اختصاصی، حالت تحقیق کل حساب را فعال کرده و فهرست چت‌های قابل دسترسی را ایجاد کنید. از چت‌های منتخب یا یک پوشه برای حساب اصلی استفاده کنید.
2. دریافت اسنپ‌شات‌های ژورنال، تاریخچه کامل هر چت و پیوست‌های نگهداری‌شده.
3. تغییرات زنده و هرگونه تعامل عمدی با پنل را همراه با رسیدهایشان حفظ کنید.
4. شناسه‌های عددی فرستنده، روابط پاسخ‌گویی، مقاصد تکراری و هش‌های فایل را در سوابق استنادشده و پروفایل‌های افراد دنبال کنید.
5. افزودن یادداشت‌ها و مجموعه‌های مرتبط با منبع در Case Board. بازسازی خط زمانی میان‌گفتگوها با هر دو زمان‌بندی و فواصل صریح.
6. فضای کاری سایر حساب‌ها را مقایسه کنید، در حالی که منشأ و کلیدهای آن‌ها را جدا نگه می‌دارید.
7. ژورنال‌های امضا شده، پروفایل‌ها و خروجی‌های تاریخچه را همراه با یادداشت‌های پرونده گردآوری و تأیید کنید.

راهنمای وب‌سایت به آدرس `/docs/cases/` شامل یک نقشه مورد تعاملی و گزینه‌های مختلف برای اختلافات ربات، پیام‌های حذف‌شده و تغییر نام شرکت‌کنندگان است. Case Board یادداشت‌ها و مجموعه‌ها را در یک فضای کاری نگه می‌دارد. خروجی‌های گروهی، بسته‌های مجزای فضای کاری را جمع‌آوری می‌کنند؛ همبستگی بین فضاهای کاری و خط زمانی ترکیبی همچنان به عنوان وظیفه تحلیلگر باقی می‌ماند.

[اعتبارسنجی انجام‌شده و کارهای باقیمانده](https://phishdestroy.io/tgwitness/fa/docs/reference/verification/) · [صادرات و تأیید](https://phishdestroy.io/tgwitness/fa/docs/reference/evidence/#investigation-handoff) · [با یک حساب کاربری شروع کنید](https://phishdestroy.io/tgwitness/fa/docs/reference/quickstart/)
