TgWitness / مستندسازی

آنچه آزمایش شده است ←

بخشی از این صفحه هنوز به زبان انگلیسی است: متن اصلی انگلیسی پس از ترجمه تغییر کرده است.

منبع / شواهد

Telegram · فرمت مدرک

محتویات فایل ZIP امضا شده، انواع سوابق، رسیدهای فرایند، پروفایل افراد، نسخه‌های خارج از محل و تأیید آفلاین.

TgWitness / مستندسازی

شواهد و تأیید

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

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

در این صفحه

امضا شده چیست#

مطالب حفاظت چه مواردی را باید حفظ کرد
هر مشاهدهٔ دفترچه، از جمله رویدادهای عملیاتی زنجیره SHA-256 و امضای Ed25519 برای هر رویداد امضای اصلی events.jsonl، اثر انگشت کلید مورد اعتماد، و یک نقطه کنترل حفظ‌شده
محتویات فایل ZIP شواهد manifest.sig مانیفست کانونیکال را امضا می‌کند که هش فایل‌های محتوا را فهرست می‌کند فایل فشردهٔ کامل، شامل مانیفست و امضا
پیوست‌های نگهداری‌شده SHA-256 و شمارش بایت در یک رویداد امضا‌شده با media.saved؛ هش فایل در مانیفست ZIP امضا‌شده بایت‌های اصلی درون فایل ZIP تأییدشده
نقطهٔ کنترل امضای Ed25519 بر طول دفترچه، هش سر، کلید عمومی و زمان ایجاد یک نسخهٔ مستقل که پیش از تغییر مورد مناقشه نگهداری شده است
دریافت رسید سوابق امضا شده نسخهٔ گردآورنده، هش‌های فایل منبع و تنظیمات اولیه، همچنین در process.started گنجانده شده است. رسید، دفترچه یادداشت مرتبط و شواهد محیطی برای حالت تأیید انتخاب‌شده
گزارش‌های قابل‌خواندن: report.html و اجزای آن، report.json، report.pdf، chat.pdf یک مهر Ed25519 بر هر فایل بر روی محتوای آن؛ PDF همچنین دارای امضای استاندارد PDF است (رجوع کنید به گزارش‌های قابل‌خواندن ) فایل دریافت‌شده و اثر انگشت کلید مورد اعتماد؛ زیپی که آن را توصیف می‌کند
مستقل CSV امضای رمزنگاری مستقل وجود ندارد؛ هش‌های رویداد به‌تنهایی کافی نیستند برای بررسی یکپارچگی، از متن دقیق داخل فایل ZIP تأییدشده استفاده کنید.
اسکرین‌شات‌ها، خروجی‌های چاپی یا PDF تولیدشده توسط مرورگر امضای TgWitness روی مشتق وجود ندارد پکیج اصلی تأییدشده را حفظ کنید و نحوهٔ ساخت نسخهٔ مشتق را مستندسازی کنید

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

فرمت‌ها و مسیرهای تأیید اعتبار#

حالت اکتساب و فرمت خروجی به سؤالات متفاوتی پاسخ می‌دهند. حالت، شواهد جمع‌آوری و محیط را فراهم می‌کند؛ هر فرمت بخشی از آن رکورد را با بررسی‌های زیر حفظ یا ارائه می‌دهد.

خروجی تأیید و استفاده
شواهد ZIP رویدادهای کانونیکال، مانیفست امضا شده، پوشش، ورودی‌های نگهداری، پیوست‌ها و رسیدهای خارجی موجود؛ آرشیو و حالت اکتساب انتخابی آن را بررسی کنید.
کانتینر ASiC-E شواهد ZIP به‌عنوان یک کانتینر ETSI ASiC-E (EN 319 162-1) با یک ورودی mimetype و META-INF/ASiCManifest.xml، با امضای CAdES با گواهی خود فضای کاری در سطح B-B، یا B-T زمانی که زمان‌نگاری فعال است. اعتبارسنج‌هایی مانند EU DSS قالب و یکپارچگی را بررسی می‌کنند و از آنجا که گواهی خود صادر شده است، هیچ نقطه اعتماد گزارش نمی‌کنند. EU DSS 6.3 با تنظیمات پیش‌فرض، یک کانتینر با بیش از ۱۰۰۰ فایل را رد می‌کند («تعداد زیادی فایل شناسایی شد»). فایل verify.py، مانیفست Ed25519 و هر فایل فهرست‌شده، مقادیر SHA-256 در META-INF/ASiCManifest.xml و در یک فایل ASiCManifestNNN.xml یا ASiCEvidenceRecordManifest.xml اضافه‌شده را بررسی می‌کند و در صورتی که هیچ‌کدام از آن‌ها یک ورودی META-INF/ را پوشش ندهند، با خطا مواجه می‌شود. این ابزار امضاهای CAdES را بررسی نمی‌کند و این موضوع را گزارش می‌دهد.
گزارش‌های HTML و JSON نماهای به‌صورت جداگانه مهر و موم‌شده با ارجاعات منبع، که در فهرست ZIP نیز فهرست شده‌اند. شمارش‌های ثبت‌شده آن‌ها خلاصه‌ای از انواع رویدادهای دفترچه خاطرات است.
گزارش‌های PDF مهر Ed25519 به‌علاوه امضای PDF پایه PAdES بر روی بازه بایت B-B، یا B-T با مهر زمانی امضا وقتی که زمان‌گذاری فعال باشد. اعتبارسنج TgWitness از کلید مورد اعتماد Ed25519 استفاده می‌کند؛ نمایش اعتماد به گواهی‌نامه در نمای مشاهده‌گر بررسی جداگانه‌ای است.
CSV یک نمای صفحه‌گسترده که توسط مانیفست ZIP پوشش داده شده است. فرارخوانی فرمول‌ها از استفاده از صفحه‌گسترده محافظت می‌کند؛ متن امضا شده اصلی در مجله باقی می‌ماند.
JSONL سوابق رویداد امضا شده، شامل ارجاعات به پیوست‌ها. فایل ZIP مدرک همچنین بایت‌های پیوست حفظ‌شده را در خود دارد.
خروجی چت و نماهای سازگار با دسکتاپ تاریخچهٔ دریافت و سوابق موجود در لاگ‌های مدیر، با رندرینگ درخواستی و آرشیو امضا شده. نسخه‌های ذخیره شدهٔ نظارت زنده یک مسیر دریافت جداگانه هستند.
رسانه‌ها و رکوردهای فقط هش بایت‌های ذخیره‌شده با SHA-256 و مرجع پیام خود بررسی می‌شوند. استخراج صرفاً هش، متادیتای هش موجود را برای مقایسهٔ بعدی با بایت‌های فایل حفظ می‌کند.
پروفایل‌های STIX/MISP و افراد مشاهدات استخراج‌شده با منبع پیوندی، شناسه‌های حساب کاربری و تطبیق‌های تحلیلی. امضاهای پروفایل و هش‌های رکورد را می‌توان با شواهد اصلی مطابقت داد؛ منشأ کش آواتار به‌طور جداگانه برچسب‌گذاری می‌شود.
استخراج هاند‌اوور قوانین افشای امضا شده، رکوردهای بدون تغییر و رکوردهای علامت‌گذاری‌شده به حداقل‌رسیده‌شده که هش‌ها/امضاهای اصلی خود را حفظ کرده‌اند. از نسخه اصلی حفظ‌شده برای مقایسه‌ای که نیاز به فیلدهای پنهان‌شده دارد، استفاده کنید.
شاهد و رسیدهای زمانی مرزهای قبلی دفترچه، پیوستگی و ادعاهای زمانی تأییدشدهٔ فردی. این موارد همراه با بررسی‌های اکتساب و بایگانی هستند.
ارسال محافظت‌شده با رمز عبور محتویات بسته را در حین انتقال محافظت می‌کند. .tgwpw از رمزنگاری احراز هویت‌شده AES-GCM، شامل یک رکورد نهایی احراز هویت‌شده، استفاده می‌کند؛ ژورنال ضمیمه‌شده امضاها و رسیدهای دریافت خود را حفظ می‌کند.

یک پرینت یا تصویر صفحه (اسکرین‌شات) ارائه‌ای از محتوای امضا شده است. شناسه گزارش، اثر انگشت کلید و مرجع QR آن به یافتن فایل اصلی برای تأیید کمک می‌کنند. اعلامیه‌های تحویل، بازرس ارائه‌شده و اطلاعات انتقال را ثبت می‌کنند؛ نتایج تأییدکننده و رسیدهای دریافت، به عنوان شواهد جداگانه نگهداری می‌شوند.

امضاهای خارجی#

یک امضا همچنین می‌تواند از کلیدی حاصل شود که TgWitness هرگز آن را در اختیار ندارد، مانند امضای الکترونیکی معتبر یک بازرس یا مهر یک سازمان. در بخش صادرات، امضای خارجی روی یک خروجی آماده بدون رمز عبور، بایت‌های امضا را ارائه می‌دهد: یک جدید META-INF/ASiCManifestNNN.xml فهرست هر فایل با SHA-256 آن برای یک کانتینر ASiC-E، یا خروجی manifest.json برای یک فایل ZIP. امضاکننده یک CMS (CAdES) را بازمی‌گرداند .p7s، جداشده یا با محتوای جاسازی‌شده.

TgWitness بررسی می‌کند که امضا دقیقاً آن بایت‌ها را پوشش می‌دهد و آن را با گواهی امضاکننده (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448) تأیید می‌کند. این زنجیره تنها بر اساس گواهی‌نامه‌های ریشه‌ای که اپراتور ارائه می‌دهد بررسی می‌شود؛ ابطال، فهرست‌های مورد اعتماد و وضعیت واجد شرایط بررسی نمی‌شوند. پنل برای هر امضا یک وضعیت را نشان می‌دهد: در انتظار امضا، متصل و بررسی‌نشده، تأیید شده، الگوریتم پشتیبانی نمی‌شود، امضا نامعتبر، تطابق بایت‌های امضا شده با نمونه اولیه برقرار نیست، یا گواهی‌نامه به ریشه ارائه‌شده زنجیر نشده است. تغییر خروجی پس از توزیع بایت‌ها، وضعیت تمام امضاهای آن را روی «تطابق بایت‌های امضا شده با نمونه اولیه برقرار نیست» تنظیم می‌کند.

دانلود با امضاها، امضاها و مانیفست‌های آن‌ها را زیر META-INF در یک کانتینر ASiC-E. برای یک فایل ZIP، فایل ZIP بدون تغییر را قرار می‌دهد، .p7s فایل‌ها و SIGNATURES.txt در یک ZIP بیرونی قرار می‌گیرند. امضاهای نامعتبر و امضاهایی که روی بایت‌های دیگر قرار دارند، حذف می‌شوند. امضایی با الگوریتم TgWitness که قابل بررسی نیست، گنجانده می‌شود؛ پنل وضعیت آن را نشان می‌دهد، همان‌طور که SIGNATURES.txt برای یک فایل ZIP.

تصاویر امضاشدهٔ چت#

دانلود فایل ZIP امضا شده در پیش‌نمایش تصویر، صفحات PNG را ذخیره می‌کند. pages.sig.json و README.txt. هر صفحه با شماره‌های رکورد دفترچه خاطراتی که نمایش می‌دهد، چت، زمان رندر، اثر انگشت کلید فضای کاری و دستوری که آن را بررسی می‌کند، پایان می‌یابد. پنل فقط SHA-256 و شماره‌های رکورد هر صفحه را ارسال می‌کند؛ سرور تأیید می‌کند که رکوردها متعلق به چت هستند و بیانیه را امضا می‌کند (tgwitness-image-attestation-v1) با کلید فضای کاری امضا می‌کند و امضا را به عنوان export.image_attested.

python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip

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

مقایسه خروجی‌های چت#

دو فایل ZIP خروجی چت امضا شده را با اثرانگشت‌های امضاکننده که به‌طور مستقل نگهداری شده‌اند، تأیید و مقایسه کنید:

python -m tgwitness.verify first.zip --compare second.zip \
  --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256

پارامترهای --require و --require-tier به همراه --compare رد می‌شوند؛ پروفایل مورد نیاز هر آرشیو را با مکانیزم تأیید خود آن بررسی کنید.

زمانی که هر دو آرشیو، شناسه پیام و حساب کاربری و چت یکسانی را ثبت می‌کنند، سوابق بر اساس شناسه پیام جفت می‌شوند. بدون تغییر به معنای برابری کل رکورد JSON ذخیره شده است: متن کامل، نویسنده، تاریخ‌ها، هدف پاسخ، متادیتای درونی و فیلدهای ناشناخته همگی گنجانده شده‌اند. ترتیب کلیدهای شیء JSON اهمیتی ندارد؛ اما فیلدهای غایب، مقادیر null، انواع مقادیر و ترتیب آرایه‌ها اهمیت دارند. پیش‌نمایش 300 کاراکتری فقط برای نمایش است. ورودی‌های تغییر یافته، فیلد سطح بالایی به نام changed_fields را نام‌گذاری می‌کنند، که شامل تغییراتی است که در آن پیش‌نمایش نامرئی هستند. در حین تطبیق، شناسه‌های پیام تکراری به جای اینکه روی یکدیگر بنویسند، رد می‌شوند.

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

برای هویت‌های حساب/چت متفاوت یا گم‌شده، این ابزار با استفاده از فرستنده، متن کامل، هش فایل، نوع رسانه و تلرانس زمانی پنج ثانیه‌ای، تطابق‌های احتمالی را پیدا می‌کند و آن‌ها را به جای تغییر نکرده (Unchanged)، به عنوان تطابق یافته (Matched) گزارش می‌دهد. رکوردهای تجزیه‌نشده، تطبیق‌یافته باقی می‌مانند. تفاوت‌ها در رکوردهای جفتی در changed فهرست می‌شوند، از جمله در حالت محتوا. با استفاده از --json، matched جفت‌های کاندیدا را می‌شمارد و unchanged جفت‌هایی را می‌شمارد که رکوردهای کامل ذخیره شده‌شان برابر است. خروجی‌های موجود changed_fields و unchanged با نتایج مقایسه قبلی سازگار باقی می‌مانند. فرمت بایگانی و تأیید امضا بدون تغییر باقی می‌مانند.

واگذاری تحقیقات#

  1. مرجع پرونده، اپراتور، شناسه عددی حساب تلگرام، منابع انتخاب‌شده، سیاست جمع‌آوری و دوره جمع‌آوری را در یادداشت‌های پرونده خود ثبت کنید. TgWitness مشاهدات را حفظ می‌کند و از یادداشت‌ها و مجموعه‌های مرتبط با منبع در Case Board پشتیبانی می‌کند. سوابق انتقال و تحویل را همراه با مدارک پرونده خود نگهداری کنید. تنظیمات جمع‌آوری مورد نظر را با رویه پذیرش زنده بررسی کنید.
  2. اثر انگشت کلید عمومی فضای کاری را به‌طور مستقل حفظ کنید پیش از آنکه به خروجی‌های آن اتکا کنید. حالت شواهد را روشن نگه دارید (پیش‌فرض) تا نقاط کنترل رسیدهای RFC 3161 و OpenTimestamps را دریافت کنند. نقاط کنترل امضا شده را در حین جمع‌آوری خارج از گردآورنده ذخیره کنید. وقفه‌ها و محدودیت‌های دیده‌شدن حساب را ثبت کنید.
  3. یک فایل ZIP امضا شده صادر کنید و رسید اجرای امضا شده را نگه دارید. از یک نقطه کنترل در یا قبل از مرز روزنامه‌نگاری صادر شده استفاده کنید. یک نقطه کنترل بعدی می‌تواند به‌درستی یک خروجی قبلی را به‌دلیل کوتاه بودن بیش از حد رد کند. خروجی‌ها شامل کل روزنامه‌نگاری فضای کاری هستند، صرف‌نظر از فیلترهای پنل؛ پیش از اشتراک‌گذاری محتوا، آن را بررسی کنید.
  4. بگذارید گیرنده فایل ZIP را با یک نسخه مورد اعتماد از اعتبارسنج، اثر انگشت ارائه‌شده به‌طور مستقل و گواهی ریشه مرجع زمان‌بندی که به‌طور جداگانه به‌دست آمده است، تأیید کند. از یک خروجی مورد اعتماد با محیط پایتون فعال:

    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence

    اثر انگشت و یک مهر زمانی بررسی‌شده از آخرین رکورد، حداقل‌های لازم برای مدرک را فراهم می‌کنند؛ در غیر این صورت، دستور --require evidence با کد 2 خروجی می‌گیرد. نقطه کنترل یک بررسی پشتیبان است، زیرا با کلید گردآورنده امضا شده است. خروجی موفق، زمانی که هر دو ورودی ارائه و پذیرفته شوند، گزارش‌های key_pinned: true و checkpoint_checked: true را برمی‌گرداند. نتیجه تأیید را حفظ کنید.

    For a handover requiring the final exported record to be witnessed, use
    `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`.
    This refuses an export with an unwitnessed tail. Add
    `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the
    witness posts as external time. See the
    [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).
    
    1. SHA-256 بایگانی، مرز خروجی، تاریخ انتقال، فرستنده و گیرنده را در سوابق نگهداری خود ثبت کنید. بسته اصلی را دست‌نخورده نگه دارید و روی نسخه‌ها کار کنید. به جای پوشه داده خصوصی برنامه، که شامل جلسات حساب کاربری و اسرار امضا نیز می‌شود، فایل‌های مدرک را به اشتراک بگذارید. برای انتقال، از یک فایل ZIP محافظت‌شده با رمز عبور AES-256 یا کانتینر قوی‌تر .tgwpw استفاده کنید. ZIP از روش استنتاج رمز عبور کم‌هزینه WinZip استفاده می‌کند؛ از یک عبارت عبور طولانی و تصادفی استفاده کنید. .tgwpw از scrypt و AES-256-GCM استفاده می‌کند و با فرمان unseal-password در ابزار راستی‌آزمایی مستقل باز می‌شود. رمز عبور ذخیره نمی‌شود و فقط محرمانگی را حفظ می‌کند؛ گیرنده آرشیو را رمزگشایی می‌کند و خروجی امضا شده داخل آن را که بدون تغییر است، تأیید می‌کند.
    2. برای ثبت زمان یک نقطه کنترل خارج از حالت شواهد، رویه RFC 3161 را دنبال کنید و اطلاعات درخواست، نقطه کنترل، CA مورد اعتماد و پاسخ تأیید شده مرجع را حفظ کنید. صرفاً آماده کردن یک درخواست، زمان‌مهر را به دست نمی‌دهد.

برای .tgwpw، از یک اعتبارسنج مستقل استفاده کنید و یک فایل خروجی جدید با پسوند اصلی انتخاب کنید: python verify.py unseal-password export.tgwpw --out evidence.zip. دستورالعمل رمز عبور را می‌خواهد؛ --password-stdin یک خط را برای خودکارسازی می‌خواند. هرگز روی یک فایل موجود بازنویسی نمی‌کند و متن ساده را فقط پس از تأیید اعتبار تمام سوابق منتشر می‌کند. پس از آن، تأیید اعتبار امضای عادی را روی فایل رمزگشایی‌شده اجرا کنید. این کانتینر از scrypt استفاده می‌کند (N=131072, r=8, p=1، نمک 16 بایتی؛ حدود 128 مگابایت رم) و AES-256-GCM با رکوردهای 1 مگابایتی و یک رکورد نهایی احراز شده. یک رکورد فراداده رمزگذاری شده، نام فایل داخلی را ذخیره می‌کند، بنابراین می‌توان نام کانتینرهای دانلود شده را تغییر داد.

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

استخراج هاند‌اوور#

یک فایل ZIP امضا شده، کل مجلهٔ فضای کاری را در خود حمل می‌کند. هنگامی که دادگاه، وکیل یا میز رسیدگی به سوءاستفاده تنها به برخی چت‌ها، یک بازه زمانی یا افراد خاصی نیاز دارند، گزینهٔ «صادرات → تحویل» (Exports → Handover) یک نسخهٔ فشرده‌شده (tgwitness-handover-v1) را مطابق با قوانین افشای انتخاب‌شده آماده می‌کند. اپراتور هدف را اعلام می‌کند و چت‌ها، یک دوره اختیاری (UTC)، افرادی را که استخراج در مورد آن‌هاست، و اینکه با سایر افراد چه اتفاقی می‌افتد (نمایش داده شوند، با نام‌های مستعار P01 جایگزین شوند، P02… یا حذف شوند)، کدام متن‌های پیام باقی می‌مانند، کدام پیوست‌ها و عکس‌های پروفایل گنجانده می‌شوند، و اینکه آیا شماره‌های تلفن و آدرس‌های ایمیل در متن‌ها مخفی (ماسک) شوند. هدف و این قوانین در مانیفست امضا شده و در گزارش وجود دارند؛ مجله، handover.exported را با دسترسی‌ای که آن را آماده کرده و SHA-256 فایل را ثبت می‌کند، نه محتویات آن.

verify.py یک استخراج را به دو روش بررسی می‌کند. یک رکورد که بدون تغییر نشان داده شده است، به طور کامل تأیید می‌شود: محتوای آن در مقابل هش، امضای Ed25519 و لینک آن به یک رکورد قبلی که در آن گنجانده شده است، بررسی می‌شود. یک رکورد بهینه‌شده، هش و امضای اصلی را حفظ می‌کند، بنابراین امضا همچنان معتبر است، اما فیلدهای پنهان‌شده را نمی‌توان از آن دوباره محاسبه کرد؛ رکورد مشخص می‌کند که چه چیزی پنهان شده است و گزارش آن را علامت‌گذاری می‌کند. سوابق خدمات در سطح حساب (شروع و پایان، فواصل پوشش، اعلان‌های اتصال، شبکه و ذخیره‌سازی، تغییرات دامنه و تنظیمات) تنها فیلدهای فهرست‌شده برای نوع خود را نگه می‌دارند: فهرست‌های چت در آن‌ها به انتخابی محدود می‌شوند چت‌ها و جمع‌بندی‌های آن‌ها دوباره شمارش می‌شوند، و یک شکاف پروب زنده در چتی خارج از انتخاب، آن چت، شماره‌های پیام‌های آن و حساب شاهدی را از دست می‌دهد؛ در یک چت پروب انتخاب‌شده، حساب شاهدی با نام مستعار آن جایگزین می‌شود مگر اینکه همه نمایش داده شوند یا اینکه شاهدی یکی از افراد انتخاب‌شده باشد. فهرست (manifest) طول و سرآیند ژورنال را به همراه امضای گردآورنده بر روی آن سرآیند نام می‌برد و رکوردهای حذف‌شده را می‌شمارد؛ coverage.json چت‌های انتخاب‌شده را توصیف می‌کند. استخراج‌های جدید همچنین شامل proofs.jsonl هستند: برای هر رکورد گنجانده‌شده و برای سرآیند ژورنال، مسیر مرکل از هش اصلی رکورد تا ریشه ژورنالی که در فهرست امضا شده نام برده شده است. verify.py هر مسیر را بررسی می‌کند، بنابراین هر رکورد نشان داده می‌شود که به همان دفترچه خاطرات با آن طول و سربرگ تعلق دارد، بدون اینکه کل دفترچه خاطرات موجود باشد؛ یک استخراج ۱۰۰ پیامی در حدود یک ثانیه، صرف‌نظر از اندازه دفترچه خاطرات، این موضوع را بررسی می‌کند. نام‌های داخل نام فایل‌ها شناسایی نمی‌شوند. فایل‌های نهایی را قبل از اشتراک‌گذاری بررسی کنید. پارامتر --range=CHAT:FROM-TO همچنین تأیید می‌کند که پیام‌های یک چت از [FROM] به [TO] در استخراج وجود دارند و گزارش می‌دهد که برای آن‌ها چند رکورد را بررسی کرده است. نام‌های داخل نام فایل‌ها شناسایی نمی‌شوند. پیش از اشتراک‌گذاری، فایل‌های نهایی را بازبینی کنید: متن آزاد، نام فایل‌ها و پیوست‌های انتخاب‌شده می‌توانند همچنان افراد را شناسایی کنند. فایل ZIP امضا شده کامل را نگه دارید: استخراج یک افشا است، نه جایگزین.

گزارش‌های قابل‌خواندن#

شواهد امضا شده، فایل‌های ZIP تحویل و چت، گزارش‌های قابل خواندن HTML و JSON را همراه با PDF در صورت در دسترس بودن فونت‌های مورد نیاز، در زبان گزارش انتخابی، حمل می‌کنند. هر گزارش با کلید Ed25519 فضای کاری مهر و موم شده و می‌توان آن را به صورت جداگانه تأیید کرد: python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP].

  • report.html / chat.html: بیانیه مهر (tgwitness-report-seal-v1) فایل را می‌بندد و SHA-256 هر بایت قبل از آن را امضا می‌کند. ژورنال‌ها و چت‌های طولانی به بخش‌هایی با اندازه قابل پیکربندی تقسیم می‌شوند (تنظیمات گزارش، ۵۰۰ تا ۱۰۰٬۰۰۰ رکورد؛ به‌صورت پیش‌فرض ۵٬۰۰۰): records/records-0001.html یا messages/messages-0001.html، که هر کدام با شماره، بازه و مجموع خود مهر و موم شده و در منیفست امضا شده به همراه SHA-256 خود فهرست می‌شوند. سلسله‌ای از ضربان‌های قلب جمع‌کننده به صورت یک خط نمایش داده می‌شوند، مگر اینکه در تنظیمات گزارش به صورت جداگانه فهرست شده باشند.
  • report.json (tgwitness-report-json-v1، کلیدهای format، report، seal): مهر، SHA-256ِ JSONِ report را امضا می‌کند، بنابراین حقایق می‌توانند توسط سیستم‌های موردی و اسکریپت‌ها خوانده شوند و می‌توان از آن‌ها برای انتخابی جهت حفاظت از داده‌ها استفاده کرد، در حالی که فایل امضا شده دست‌نخورده باقی می‌ماند.
  • report.pdf / chat.pdf: یک سند رسمی برای چاپ و بایگانی، که دو بار بر روی همان بایت‌ها امضا شده است، کل فایل به جز مقدار امضا (/ByteRange). امضای استاندارد PDF، PAdES پایه (ETSI EN 319 142-1، /SubFilter /ETSI.CAdES.detached: CMS با SHA-256 و ECDSA P-256، signing-certificate-v2، بدون زمان امضای CMS؛ زمان ادعا شده است /M) در سطح B-B، یا B-T با یک مهر زمان امضای RFC 3161 در CMS هنگامی که زمان‌گذاری فعال است و یک مرجع زمان‌مهر در مسیر برای درخواست‌های خارج از تلگرام پاسخ می‌دهد. این سند از یک گواهی امضای سند خود صادر شده که در گاوصندوق فضای کاری نگهداری می‌شود استفاده می‌کند؛ شماره سریال موضوع آن اثر انگشت کلید Ed25519 است. مهر Ed25519 به صورت ویژگی بدون امضا در CMS جابجا می‌شود 2.25.240684792623320047764573196045913242332 و SHA-256 گواهی را با "content": "pdf-byte-range"، بنابراین کلید Ed25519 اعتبارسنجی‌کننده گواهی‌نامه است. این گواهی‌نامه معتبر (qualified) نیست: یک برنامه خواننده PDF امضا را معتبر و امضاکننده را ناشناس یا غیرقابل اعتماد نشان می‌دهد تا زمانی که به گواهی‌نامه اعتماد نشود؛ در عوض، اثر انگشت Ed25519 را مقایسه کنید. PDFهای چینی، ژاپنی و کره‌ای به یک فونت روی سرور (یا در TGWITNESS_FONT_DIR؛ بدون آن، فایل ZIP تنها حاوی گزارش‌های HTML و JSON خواهد بود.
  • report.en.html، report.en.pdf / chat.en.html، chat.en.pdf: نسخهٔ اصلی انگلیسی همان گزارش، وقتی زبان گزارش انگلیسی نیست؛ به همان شیوه مُهروموم و امضا می‌شود و در مانیفست امضاشده زیر report.original آمده است. گزارش به زبان انتخاب‌شده با توصیه به ارائهٔ اصل انگلیسی همراه با ترجمهٔ رسمی یا سوگندخورده آغاز می‌شود؛ نگاه کنید به ترجمهٔ گزارش‌ها برای دادگاه.

در یک کانال یا ابرگروه، Telegram پیام‌های ۱، ۲، ۳ و ... را به ترتیب شماره‌گذاری می‌کند. یک خروجی چت، شماره‌های اول و آخر، تعداد کل پیام‌ها، هر سری از شماره‌های غایب در message-ids.json ، مانیفست و هدر chat.json را فهرست می‌کند و هر شکاف را در جایی که در متن گفتگو قرار دارد، علامت‌گذاری می‌کند. verify.py آنها را از chat.json شمارش می‌کند. یک شماره غایب، پیامی است که Telegram بازنگشت (پیش از خروجی‌گیری حذف شده یا برای حساب قابل مشاهده نبوده است)؛ در چت‌های خصوصی و گروه‌های پایه، شماره‌ها در تمام چت‌های یک حساب مشترک هستند و فاصله‌ها شمرده نمی‌شوند.

پس از خواندن تاریخچه، خروجی مجدداً از تلگرام هر شماره غایب را بر اساس شماره درخواست می‌کند (channels.getMessages، تا ۱۰٬۰۰۰ شماره، شامل ۱٬۰۰۰ شماره زیر پیام اول، که در صورت وجود تعداد بیشتر، به‌طور مساوی در تمام فواصل زمانی توزیع می‌شوند). نتیجه در message-ids.json و گزارش. یک پاسخ خالی ثبت می‌کند که شماره در زمان بازپروژه کردن برای این حساب در دسترس نیست؛ و علت را مشخص نمی‌کند. پیامی که در زمان بازپروژه کردن بازگردانده می‌شود به خروجی اضافه شده و علامت‌گذاری می‌شود found_on_recheck.

وقتی فضای کاری مشاهده‌گر متوجه شد پیام‌های چت حذف، در بازبینی مجدد غایب یا ویرایش شده‌اند، خروجی چت اضافه می‌کند journal-changes.jsonl: آن سوابق دفترچه، هر نسخهٔ ذخیره شده و اطلاعیه، هر کدام با هش و امضای Ed25519 که در دفترچه دریافت کرده‌اند. verify.py هَش هر رکورد را مجدداً محاسبه می‌کند، امضای آن را با کلید خروجی (export key) بررسی می‌کند و تعداد را با منیفست امضا شده مقایسه می‌کند؛ خروجی شواهد شامل زنجیره کامل هَش است. گزارش این پیام‌ها را تحت عناوین حذف‌ها و نسخه‌های قبلی فهرست می‌کند.

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

هر گزارش برنامه را دقیقاً نام می‌برد: commit گیت زمانی که گردآورنده از یک checkout اجرا می‌شود یا نصب‌کننده TGWITNESS_COMMIT را تنظیم می‌کند، و SHA-256 فایل‌های منبع آن (source_tree_sha256، JSON کانونیکال از path → SHA-256 هر .py، .js، .css، .html و .svg فایل در بسته)، که یک checkout از آن commit آن را بازتولید می‌کند مگر اینکه فایل‌ها تغییر کرده باشند). کلاینت Telegram با نام کتابخانه، لایه API و مرکز داده خود نامگذاری شده است. هنگامی که مشاهده شروع می‌شود و زمانی که خروجی چت آغاز و پایان می‌یابد، گردآورنده زمان را از Telegram می‌پرسد (updates.getState، ثانیه‌های کامل) و زمان Telegram منهای ساعت گردآورنده را به همراه عدم قطعیت ناشی از رفت و برگشت ثبت می‌کند؛ گزارش‌ها این اندازه‌گیری‌ها را تحت عنوان «زنجیره امانت» (Chain of custody) نشان می‌دهند. صادرات چت، علاوه بر تاریخ‌های پیام‌ها، زمان خواندن تاریخچه را نیز ثبت می‌کند.

نمایشگر گزارش آفلاین و راهنمای بایگانی#

قبل از باز کردن chat.html یا report.html، فایل ZIP کامل را استخراج کنید. این ویوئر قابلیت جستجو، فیلترها، شرکت‌کنندگان، شاخص‌ها، جزئیات رکورد و گزینش‌های JSON/CSV را بدون نیاز به سرور فراهم می‌کند. فایل‌های viewer/ و media/ را در کنار گزارش نگه دارید. گزینش‌ها مشتق هستند: برای مقایسه آنها با آرشیو امضا شده، از verify.py SELECTION.json --evidence ARCHIVE.zip استفاده کنید. اعتبارسنج، شناسه گزارش، کلید امضا، مرز بایگانی و هر مورد انتخاب‌شده را بررسی می‌کند؛ موارد ویرایش‌شده، مفقود و تکراری ناموفق هستند. یادداشت‌های انتخاب و زمان ایجاد، متاداده‌های بدون امضا باقی می‌مانند.

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

این مرورگر امضاهای مانیفست، شناسه و کلید گزارش و تمام هش‌های فایل‌های فهرست‌شده را بررسی می‌کند. این ابزار ساختارهای ZIP مبهم یا ناقص، نام‌های تکراری و مسیرهای ناامن را رد می‌کند و فایل‌ها را به حداکثر ۲۵۶ مگابایت (MiB) و مجموع محتوای اعلام‌شده را به ۴ گیگابایت (GiB) محدود می‌نماید. برای آرشیوهای بزرگ‌تر از اعتبارسنج مستقل استفاده کنید. این بررسی مرورگر، بررسی‌های اعتبارسنج را که بر زنجیره‌های دفترچه خاطرات و معنایی داده‌ها انجام می‌دهد، تکمیل می‌کند.

README.txt شامل یک راهنمای شروع، فهرست فایل‌ها، دستورالعمل‌های تأیید و یادداشت‌های قالب داده به زبان گزارش است و پس از آن یک راهنمای کامل انگلیسی قرار دارد. فایل SHA256SUMS شامل فایل‌های فهرست‌شده در خود، به استثنای خودِ آن، manifest.json و manifest.sig است؛ مانیفست امضا شده همچنین شامل SHA256SUMS می‌شود. فایل ZIP اصلی را دست‌نخورده نگه دارید و فایل‌های در حال کار را خارج از پوشه استخراج‌شده ذخیره کنید. گزارش‌های PDF شامل نشانک‌های بخش و شناسایی پرونده/گزارش در صفحات بعدی هستند.

گفت‌وگو در زمان صدور#

صادرات یک چت، آنچه را که Telegram در مورد چت هنگام شروع صادرات گفته است، ثبت می‌کند: برچسب‌های خود Telegram (scam، fake، restricted با دلایل آن، verified)، نام‌های کاربری، توضیحات، تعداد اعضا و ادمین‌ها، بحث مرتبط، حفاظت از محتوا، اینکه آیا اعضای جدید پیام‌های قبلی را می‌بینند و از کدام پیام به بعد در این حساب تاریخچه قابل مشاهده است (available_min_id)، تاریخ پیام ۱ که همان تاریخ ایجاد چت است، و SHA-256 عکس چت (ذخیره شده در media/). این اطلاعات جایگاه حساب صادرکننده در چت را ثبت می‌کند: نقش، تاریخ پیوستن، اینکه چه کسی آن را دعوت کرده و برای یک ادمین، حقوق او. در عوض، درخواستی که Telegram رد می‌کند، نام‌گذاری می‌شود.

وقتی حساب صادرکننده ادمین باشد، خروجی، لاگ ادمین چت را (تلگرام حدود 48 ساعت نگه می‌دارد) وارد می‌کند admin-log.json: حذف‌ها و ویرایش‌ها با محتوای ارائه‌شده، حساب کاربری عمل‌کننده و تاریخ اقدام منبع. این موارد، نسخه‌های ضبط‌شده ژورنال زنده و سوابق دریافت حذف را تکمیل می‌کنند.

شاخص‌ها#

گزارش‌ها فهرست می‌کنند، و آرشیو شامل موارد زیر است که در پیام‌های ضبط‌شده، میز رسیدگی به تخلفات می‌تواند بر اساس آن‌ها اقدام کند: indicators.csv ، indicators.stix.json (STIX 2.1 ) و indicators.misp.json (رویداد MISP ): لینک‌ها و دامنه‌ها (که همچنین پشت متن، در دکمه‌ها و در پیش‌نمایش لینک‌ها پنهان شده‌اند)، آدرس‌های ارز دیجیتال، نام‌های کاربری و لینک‌های دعوت Telegram ، شماره‌های تلفن، آدرس‌های ایمیل و تصاویر ذخیره شده. آدرس‌های بیت‌کوین، لایت‌کوین، دوج‌کوین و ترون فقط زمانی فهرست می‌شوند که چک‌سام base58 آنها معتبر باشد، آدرس‌های سگ‌ویت زمانی که چک‌سام bech32 یا bech32m آنها معتبر باشد و آدرس‌های تون زمانی که CRC آنها معتبر باشد؛ آدرس‌های EVM و سولانا به عنوان بررسی‌نشده علامت‌گذاری می‌شوند. تصاویر دارای هش SHA-256 و هش دیداری (dHash، ۶۴ بیتی) هستند که در کپی‌های فشرده‌سازی یا تغییر اندازه مجدد شده، تقریباً بدون تغییر باقی می‌ماند. گزارش‌ها شاخص‌ها را طوری می‌نویسند که به طور تصادفی باز نشوند (hxxps[://]example[.]com )؛ فایل‌ها مقادیر را همان‌طور که بوده‌اند حفظ می‌کنند. هر شاخص به عنوان ناشناخته و نه برای تشخیص خودکار علامت‌گذاری شده است (STIX indicator_types: unknown , MISP to_ids: false ، توزیع در سازمان خود): قرار گرفتن در لیست به این معناست که پیامی حاوی آن بوده است، نه اینکه مخرب باشد. لینکی که متن آن آدرس متفاوتی را نسبت به آدرسی که با آن باز می‌شود نشان می‌دهد، در گزارش علامت‌گذاری می‌شود.

گزارش‌های PDF با اظهاریه‌ای از بازرس برای امضای دستی، یک چک‌لیست برای دفتر اسناد رسمی یا کارشناس دادگاه، و یک کد QR (که در صفحه اول نیز وجود دارد) به پایان می‌رسند که حاوی شناسه گزارش، اثر انگشت کلید و SHA-256 داده‌های معتبر است، به طوری که یک نسخه چاپی به آرشیو مربوطه منتهی می‌شود.

کانونی‌سازی رویداد#

ورودی هش دقیقاً شامل این فیلدها است:

seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash

سریال‌سازی با JSON سازگار با پایتون با UTF-8، کلیدهای شیء مرتب‌شده، بدون فرار ASCII، بدون فاصله‌های خالی بی‌اهمیت و بدون NaN/بی‌نهایت:

json.dumps(value, ensure_ascii=False, sort_keys=True,
           separators=(",", ":"), allow_nan=False).encode("utf-8")

هَش رویداد از SHA-256 آن بایت‌ها به‌دست می‌آید. امضا، امضای Ed25519 بر روی ۳۲ بایت خام هَش است که سپس به کد base64 تبدیل می‌شود. اولین previous_hash شامل ۶۴ صفر است. اعداد توالی از ۱ شروع شده و به اندازه ۱ افزایش می‌یابند. تمام رویدادها، از جمله رویدادهای عملیاتی، یک زنجیره مشترک دارند. هیچ سرکوب ارسال تکراری وجود ندارد: مشاهدات مکرر رسیدهای متمایزی هستند، نه ادعایی مبنی بر اقدامات متمایز تلگرام.

تاریخ‌های خام تلگرام رشته‌های ISO هستند؛ فیلدهای باینری به اشیایی حاوی bytes_base64 تبدیل می‌شوند. متن پیام، انتیت‌ها، توصیف‌کننده‌های رسانه، متادیتای پاسخ، واکنش‌ها و اقدامات سرویس در متادیتای پیام خام، در صورت ارائه، حفظ می‌شوند. یک پیام زنده همچنین به‌روزرسانی تلگرام را که آن را در transport_update؛ وقتی آن به‌روزرسانی حاوی همان پیام باشد raw، message field است {"same_as": "raw"} به جای یک کپی دوم، استفاده می‌شود.

observed_at زمان جهانی (UTC) گردآورنده در هنگام ثبت رکورد است؛ source_at تاریخ ارائه‌شده توسط آن رویداد تلگرام است. رکوردهایی که هنگام رسیدگی به یک به‌روزرسانی زنده نوشته می‌شوند، اضافه می‌کنند payload.received_at، زمان یوتی‌سی که به‌روزرسانی به گردآورنده رسید، و payload.processing_delay_ms. ویرایش‌های زنده تاریخ ویرایش ارائه‌شده را حفظ می‌کنند، اسنپ‌شات‌های تاریخچه تاریخ پیام را با زمان مشاهده فعلی حفظ می‌کنند، و یک اعلان حذف معمولی زمان دریافت را با تاریخ منبع خالی ثبت می‌کند. موارد ورودهای لاگ ادمین تاریخ اقدام ارائه‌شده خود را به‌طور جداگانه حفظ می‌کنند. ترتیب دریافت و ترتیب رویداد منبع، خطوط زمانی متمایزی هستند که مشاهدات ساعت و رسیدهای خارجی برای مقایسه در دسترس قرار دارند.

سمانتیک بازیگر#

منسوب‌کردن به منبع رویداد بستگی دارد. message.new.actor_id و message.edited.payload.sender_id فرستنده پیام را حفظ می‌کنند. اعلان‌های معمولی message.deleted حاوی شناسه پیام هستند و فیلد actor آنها null است؛ ورودی‌های موجود در لاگ ادمین، اقدام، actor و تاریخ ارائه‌شده خود را حمل می‌کنند. پیام‌های سرویس عضویت، فرستنده و نوع اقدام را حفظ می‌کنند، به‌روزرسانی‌های خام شرکت‌کنندگان، actor_id ارائه‌شده را حفظ می‌کنند، و اسنپ‌شات‌های واکنش، شمارش‌ها و هویت‌های قابل‌مشاهده ارائه‌شده خود را حفظ می‌کنند. این سوابق را همراه با نسخه‌های ضبط‌شده و رسیدهای تعامل با پنل بخوانید.

اعلان‌های حذف برای چت‌های خصوصی و گروه‌های عادی فقط شامل شناسه پیام‌ها هستند. این چت‌ها یک توالی شناسه در سطح کل حساب را به اشتراک می‌گذارند، بنابراین یک شناسه، یک پیام واحد از این حساب را شناسایی می‌کند. هنگامی که پیامی با آن شناسه قبلاً در این دفترچه خاطرات ذخیره شده بود، حذف در آن چت به عنوان message.deleted با payload.chat_resolution که نام متد است، ثبت می‌شود. شناسه‌هایی که هرگز ذخیره نشده‌اند به صورت deletion.unscoped نگه داشته می‌شوند: یک اعلان حذف واقعی که چت آن همبسته نشده است. این مورد با message.missing_on_recheck که نتیجه یک پرس‌وجوی در دسترس نبودن را ثبت می‌کند، و با یک شکاف در شناسه‌های پیام‌های ذخیره شده متفاوت است. کانال‌ها و ابرگروه‌ها پیام‌ها را برای هر چت شماره‌گذاری می‌کنند و هرگز به این شکل مطابقت داده نمی‌شوند. هنگامی که پیام حذف شده توسط حساب مشاهده‌شده ارسال شده باشد، payload.deleted_message_was_outgoing درست است؛ اما شخص حذف‌کننده هنوز مشخص نیست.

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

شناسههای متعدد که به یک چت از یک اعلان مربوط می‌شوند، صرف‌نظر از تعدادشان، به صورت یک deletion.batch گروهبندی می‌شوند، با شناسههای پیام دقیقاً همان‌طور که تلگرام ارسال کرده و بدون توجه به اینکه این حساب چندتای آنها را فرستاده است. اعلان تلگرام پیامها را فهرست می‌کند؛ و لاگ ادمین چت، مدیر اجرایی را که حساب می‌تواند پیام را در آنجا بخواند، نام می‌برد. لینک (message.deletion_attributed) بر اساس هر کدام که زودتر برسد ایجاد می‌شود: یک نظرسنجی که در آن ورود به لاگ ادمین قبل از اطلاعیه حذف مشاهده شده باشد، هنگام ثبت اطلاعیه مطابقت داده می‌شود.

پوشش: پیوستگی، فواصل و شناسه‌های نادیده#

هر فایل ZIP امضا شده حاوی coverage.json است، گزارش HTML با همان خلاصه باز می‌شود و verify.py آن را از روی events.jsonl بازحساب می‌کند به جای اینکه به فایل اعتماد کند:

  • به طور مداوم از X تا Y مشاهده می‌شود. یک دوره با observation.started شروع می‌شود و در یک مکث، یک توقف، قطع اتصال تلگرام، خروج، شروع فرآیندی بدون توقفی منظم، یا بیش از سه دقیقه بدون هیچ ثبت در حین مشاهده (ضربان‌ها هر دقیقه نوشته می‌شوند، بنابراین سکوت به معنای توقف، یخ‌زدگی فرآیند یا خواب رفتن کامپیوتر است) به پایان می‌رسد. هنگامی که فاصله ضربان قلب در ابزارهای بیشتر → پارامترها تغییر می‌کند، هر ضربان قلب آن را ثبت می‌کند و سکوت مجاز به سه بازه تبدیل می‌شود که هرگز کمتر از سه دقیقه نخواهد بود.
  • شکاف‌ها زمان بین دوره‌ها را همراه با دلیل فهرست می‌کنند. شکافی که در آخرین ثبت هنوز باز است با not_resumed_by_last_record علامت‌گذاری می‌شود.
  • شناسه پیام‌های مشاهده‌نشده. برای کانال‌ها و ابرگروه‌ها، که پیام‌ها را به‌ازای هر چت شمارش می‌کنند، شناسه‌هایی که بین موارد مشاهده‌شده مفقود هستند به‌صورت بازه فهرست می‌شوند. آن‌ها به‌عنوان مشاهده‌نشده گزارش می‌شوند — حذف‌شده، هرگز تحویل‌داده‌نشده، یا خارج از تاریخچه ذخیره‌شده — هرگز به‌عنوان حذف‌شده. چت‌های خصوصی و گروه‌های عادی از یک توالی در سراسر حساب استفاده می‌کنند، بنابراین فواصل درون یکی از این چت‌ها معنایی ندارند و در آنجا فهرست نمی‌شوند.
  • اخطاریه‌های شکاف در سطح گفتگو (برای مثال درخواست تلگرام برای بازیابی تفاوت در یک کانال) به‌عنوان یادداشت محسوب می‌شوند؛ آن‌ها پوشش کلی را مختل نمی‌کنند.
  • Session records. Windows in which Telegram's update counter grew while no update reached this session (updates_diverted), this session left Telegram's session list while its connection kept working (session_revoked_externally), or a witness probe's answer arrived only from history (probe_ack_missed_live) are listed separately. The verifier also reports where the Telegram session key came from, other sessions signed in when observation started, sessions added during observation, Telegram security notices (777000), other sessions ended from the workspace, only-session periods, witness probe counts and phone call updates. See accounts. While strict chosen chats is on (scope.strict in observation.started), the session list (except while this is the only session, or when Telegram devices is on), security notices and phone call updates are not collected, so their absence says nothing, and a deletion is matched to a session check only if one ran in the 10 minutes before it.

به‌روزرسانی توالی (pts)#

تلگرام شمارشگر به‌روزرسانی‌های مرتبط با پیام را با pts: یک توالی برای حساب کاربری (گفتگوهای خصوصی و گروه‌های پایه با هم) و یک توالی برای هر کانال یا ابرگروه. جمع‌آور هر بازه دریافتی بدون شکاف را به عنوان یک coverage.sequence ثبت: اولین و آخرین pts، تعداد به‌روزرسانی‌های هر نوع، و اینکه آیا آنها منتشر شدند یا توسط getDifference یا getChannelDifference. یک وقفه یک coverage.gap ثبت می‌کند، و coverage.gap_closed نام‌گذاری می‌کند pts که از آن توالی دوباره کامل می‌شود.

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

GET /api/continuity پاسخ‌ها برای یک بازه (since, until, chat_id) اینکه آیا هر دنباله بی‌وقفه است و وقفه‌ها را به همراه دلایلشان فهرست می‌کند. verify.py از سوابق یک آرشیو تحت پیوستگی توالی همان را چاپ می‌کند.

شماره‌های پیام‌های مفقود (gap_summary)#

For a reader's guide to this section and to observation periods and gaps, see Coverage and missing material.

پیش‌نمایش. coverage.json → gap_summary اعدادی را که تلگرام اختصاص داده و این گردآورنده هرگز ندیده است، اندازه‌گیری می‌کند. تلگرام پیام‌ها را یک‌بار در هر کانال یا ابرگروه، و یک‌بار در هر حساب کاربری در سراسر چت‌های خصوصی، ربات‌ها و گروه‌های عادی شماره‌گذاری می‌کند. عددی بین دو پیام مشاهده‌شده یا مشاهده شده یا مفقود است؛ یک بازه پیوسته، این گزاره مثبت را بیان می‌کند که هر پیام شماره‌گذاری‌شده در آن مشاهده شده است. یک شکاف، نه کنشگری را نام می‌برد و نه دلیلی را.

میدان معنی
status on یا off هنگام غیرفعال شدن در ابزارهای بیشتر → پارامترها → تحلیل شکاف
parameters پارامترهایی که نتیجه را تولید کرده‌اند، تا بتوان آن را تکرار کرد
chats[] برای هر کانال یا ابرگروه یک ورودی، که هر کدام به‌طور جداگانه شماره‌گذاری شده‌اند
account سلسلهٔ سراسری حساب شامل چت‌های خصوصی، ربات‌ها و گروه‌های عادی
status (به ازای هر توالی) applicable، یا not_applicable با reason
observed_from, observed_to, span اولین و آخرین شماره مشاهده‌شده و اندازهٔ بازه
observed, observed_without_content اعداد مشاهده‌شده؛ اعدادی که تنها از طریق سوابق حذف یا بازبینی مجدد شناخته می‌شوند
missing, density, gap_ranges, largest_gap اعدادی که هرگز مشاهده نشدند، سهم آن‌ها از بازه، تعداد اجراها، طولانی‌ترین اجرا
clusters[] شکاف‌های فهرست‌شده: low, high, missing، و اعداد مشاهده‌شده مجاور after / before به همراه زمان‌های مشاهدهٔ آن‌ها
service_estimate فقط زمانی که فعال باشد: چند شماره مفقود بر اساس سهم مشاهده‌شده‌شان به‌عنوان پیام‌های خدماتی محسوب می‌شوند. هرگز از missing

اعتبار از ژورنال استخراج می‌شود، هرگز فرض نمی‌شود:

  • کانال‌ها و ابرگروه‌ها به‌ازای هر چت اندازه‌گیری می‌شوند، همچنین در خروجی چت‌های منتخب. سوابق انتخاب‌شده توسط فرستنده اندازه‌گیری را انجام می‌دهند. not_applicable.
  • سecuence در سطح کل حساب فقط از اولین پیام تا آخرین پیامی که در حالی که جمع‌آوری کل حساب فعال بود دریافت شد، اندازه‌گیری می‌شود و چت‌های خصوصی، ربات‌ها، گروه‌های عادی و پیام‌های خود حساب را حفظ می‌کند، بدون اینکه هیچ چتی مستثنی شود (scope.changed). اعدادی که توسط deletion.unscoped به‌عنوان مشاهده‌شده بدون محتوا شمرده می‌شوند. خروجی‌گیری یا واگذاری چت‌های انتخابی نمی‌تواند آن را اندازه‌گیری کند. اگر جمع‌آوری کل حساب خاموش و سپس روشن شود، یادداشتی می‌گوید که اعدادی که در این فاصله استفاده شده‌اند، به‌صورت شکاف ظاهر می‌شوند.
  • پیام‌های سرویس، رکوردهای دفترچه یادداشت با شماره‌های اختصاصی خود هستند، بنابراین خودِ شکاف‌هایشان را می‌بندند؛ برآورد اختیاری تنها یک زمینه است.

verify.py محاسبه مجدد gap_summary از events.jsonl با پارامترها در ژورنال امضا شده coverage.json member (پیش‌فرض برای آرشیوهای قدیمی‌تر) و خط مربوط به کل حساب را در خلاصه پوشش خود چاپ می‌کند. آرشیو get_capture_status(MCP و خط فرمان) همان اندازه‌گیری را برای گفتگوهایی که یک دسترسی می‌تواند بخواند بازمی‌گرداند؛ سecuence در سطح کل حساب فقط برای دسترسی‌ای که کل فضای کاری را پوشش می‌دهد.

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

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

زمانی که Telegram پذیرش حساب را متوقف می‌کند، رکورد coverage.gap که نظارت را پایان می‌دهد، حاوی cause (account_banned، account_frozen، account_deleted، session_duplicated، session_revoked، session_expired، session_ended یا not_authorized) و خطای Telegram است؛ verify.py علت پایان دوره را نام‌گذاری می‌کند.

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

تهیه‌کننده#

منیفست امضا شده ZIPهای شواهد، خروجی‌های چت، ژورنال‌های شاهد و بیانیه فایل‌های پروفایل افراد حاوی producer است: نرم‌افزار، نسخه، پروژه (PhishDestroy)، صفحه اصلی و مخزن سورس. گزارش HTML و اعتبارسنج این رکورد تولیدکننده امضا شده را نمایش می‌دهند. هش‌های فایل‌های سورس، درخت سورس ضبط شده را برای مقایسه با یک چک‌اوت معتبر شناسایی می‌کنند. منشأ اجرای کد به‌طور جداگانه از طریق تأیید تصاحب گیت‌هاب یا اندازه‌گیری‌های Intel TDX، در صورت فعال بودن، بررسی می‌شود. آرشیوهایی که قبل از وجود فیلد تولیدکننده ایجاد شده‌اند همچنان پشتیبانی می‌شوند و به‌عنوان سوابق قدیمی شناسایی می‌گردند.

هر رکورد observation.started همچنین نام کلاینت Telegram را که مشاهده کرده است، ذکر می‌کند: api_id آن (هرگز هش آن)، اینکه آیا این یک جفت عمومی داخلی است یا اپلیکیشن خود اپراتور، توضیحات کلاینت ارسال‌شده در درخواست اتصال Telegram، و نوع مسیر اتصال با حالت IP (بدون آدرس پروکسی یا رمز). گزارش و custody.json، هر کلاینت و مسیر متمایز را به همراه زمان ثبت آن‌ها، و زمان‌هایی که هیچ پروکسی فهرست‌شده پاسخ نداد و Telegram آدرس سرور را مشاهده کرد، فهرست می‌کنند. ژورنال‌های ثبت‌شده پیش از این نیز همین را نشان می‌دهند.

پروفایل‌های افراد#

یک فایل پروفایل (tgwitness-dossier-v1، JSON) به درخواست از روی سوابق موجود در دفترچه خاطرات برای یک چت ساخته می‌شود؛ هیچ چیزی از تلگرام دریافت نمی‌شود و محتوای پروفایل هرگز در دفترچه خاطرات نوشته نمی‌شود (فعال و غیرفعال کردن پروفایل‌ها به عنوان dossier.changed ثبت می‌شود). برای هر شخص دارای پیام ذخیره شده، تاریخچه نام و نام کاربری، برچسب‌های تلگرام (ربات، کلاهبرداری، جعلی، پریمیوم، تأیید شده، محدود، حذف شده) همان‌طور که در زمان ذخیره مشاهده شده، پروفایل شناسه عکس‌ها، هش SHA-256 و هش بصری (pHash، سازگار با imagehash.phash) آواتار از کش آواتار محلی با آواتارهای مشابه، فعالیت (اولین و آخرین پیام، شمارش‌ها، اشتراک‌گذاری‌های ویرایش‌شده و حذف‌شده، پیام‌ها بر اساس ساعت UTC)، اینکه چه کسی به چه کسی پاسخ می‌دهد، چت‌های دیگر در این گزارش، جایی که آن شخص نوشته و از کیف‌پول‌ها (BTC، EVM، TRON، TON، LTC، DOGE، XMR، SOL؛ آدرس‌های Base58Check اعتبارسنجی شده‌اند) یاد کرده است، شماره‌های تلفن، نام‌های کاربری و لینک‌ها، از جمله لینک‌های پنهان‌شده پشت متن.

هر واقعیت فهرست سوابق دفترچه (seq) را که از آن آمده است، ذکر می‌کند و record_hashes حاوی هش هر رکورد مرجع است. این بیانیه با کلید فضای کاری امضا شده است:

python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip

امضا را بررسی می‌کند، خودِ خروجی مدرک را (امضا، زنجیره هش و فایل‌ها) اعتبارسنجی می‌کند و اطمینان حاصل می‌کند که هر رکورد ارجاع‌داده‌شده در همان خروجیِ همان فضای کاری بدون تغییر وجود دارد. هش‌های آواتار برچسب «منبع از کش محلی» (نه رکوردهای دفترچه) را دارند. @ها تطبیق الگو و سرنخی برای بررسی هستند. پروفایل‌ها به صورت جداگانه برای هر چت فعال می‌شوند، می‌توانند به صورت یک فایل فشرده ZIP با رمزگذاری AES-256 صادر شوند و هنگام غیرفعال شدن یا حذف چت از منابع، پاک می‌گردند.

شاهد مستقل#

یک دفترچه یادداشت شاهد (tgwitness-witness-v1) و پست‌های کانال آن با استفاده از دستور verify.py --witness … --channel … در برابر یک خروجی مدرک بررسی می‌شوند؛ به شاهد مستقل مراجعه کنید. با یک آدرس عمومی https://t.me/s/… یا https://telegram.me/s/…، اعتبارسنج تاریخ هر پست را از تلگرام می‌خواند، و اولین تاریخ مشابه یک پست در ابتدای خروجی، زمان خارجی برای آخرین رکورد است. تاریخ‌ها از هر منبع دیگری به عنوان متاداده‌های ارائه‌شده هستند.

منشور و نقاط کنترل#

فایل manifest.json شامل قالب، زمان خروجی، کلید عمومی، اثر انگشت، طول دفترچه خاطرات، هش سر، دامنه، تولیدکننده، محدودیت‌ها و SHA-256 هر عضو محتوای دیگر به جز خود فایل‌های manifest.json و manifest.sig است. manifest.sig امضای Ed25519 در قالب base64 بر روی JSON کانونیکال manifest است. تأییدکننده، اعضای غیرمنتظره/غایب، نام‌های تکراری، فایل‌های خراب، توالی/زنجیره شکسته، امضاهای نامعتبر و عدم تطابق با نقطه کنترل ارائه‌شده را رد می‌کند. این فایل‌ها را هرگز استخراج نمی‌کند. اندازه کل اعلام‌شده فشرده‌نشده را به 4 گیگابایت محدود می‌کند؛ پارامتر --max-gib N امکان ایجاد آرشیوهای بزرگ‌تر با استفاده از محدودیت افزایش‌یافته More tools → Parameters را فراهم می‌کند.

یک آرشیو بزرگ به طور همزمان توسط چندین فرآیند بررسی می‌شود: اعضا به صورت موازی هش می‌شوند، و پس از ۵۰۰۰ رکورد اول، هش محتوا و امضای هر رکورد توسط فرآیندهای کارگر بررسی می‌شود، در حالی که فرآیند اصلی به ترتیب زنجیره، پوشش و پیوندها را دنبال می‌کند. --jobs N تعداد فرآیندها را تعیین می‌کند؛ پیش‌فرض auto از هر CPU یک عدد استفاده می‌کند، حداکثر ۱۶، و --jobs 1 همه چیز را در یک فرآیند نگه می‌دارد. پاسخ در هر صورت یکسان است، و تغییر با همان پیام رد می‌شود. هش‌ها در موقعیت‌های نام‌گذاری‌شده توسط نقاط کنترل نگهداری‌شده و لنگرهای زمان‌مهر در طول آن یک گذر واحد حفظ می‌شوند، بنابراین هر لنگر بدون خواندن مجدد مجله مقایسه می‌شود. روی یک کامپیوتر ۳۲-ریسه‌ای، آرشیو ۱۰.۸ گیگابایتی با ۴۰۰,۰۰۰ رکورد در یک فرآیند ۵۸.۹ ثانیه، با ۴ فرآیند ۱۵.۲ ثانیه و با ۱۶ فرآیند ۸.۴ ثانیه زمان برد؛ سپس یک بار عبور متوالی از روی رکوردها محدودیت را تعیین می‌کند.

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

یک نقطه کنترل، بیانیه‌ای را امضا می‌کند که شامل کلید عمومی، طول دفترچه خاطرات، هش سرصفحه و زمان ایجاد است. این همچنین جدیدترین دور drand را که فضای کاری آن را بازیابی کرده است حمل می‌کند (drand_anchor ): گردآورنده قبل از هر نقطه کنترل دوره‌ای از یک رله drand از طریق مسیر خارجی فضای کاری می‌پرسد، بنابراین مخفی کردن IP، پروکسی‌ها و یک مسیر خارجی غیرفعال اعمال می‌شوند، و خودِ نقطه کنترل هرگز به بیرون متصل نمی‌شود. تأییدکننده می‌تواند بررسی کند که یک آرشیو بعدی حاوی همان پیش‌وند است. با استفاده از دستورهای --checkpoint و --check-drand ، این دور با رله‌های drand تأیید می‌شود و گزارش می‌شود که چک‌پوینت زودتر از زمان آن دور امضا نشده است؛ این دور سطح تضمین را تغییر نمی‌دهد. چک‌پوینت را خارج از گردآورنده نگه دارید، تا اعتبارسنجی بعدی آرشیو را با یک مرجع که به طور جداگانه نگهداری می‌شود مقایسه کند. کلید گردآورنده آن را امضا می‌کند، بنابراین فقط در صورتی سوابق را به آن متصل می‌کند که گیرنده آن را قبل از آرشیو، از طریق یک کانال دیگر دریافت کرده باشد؛ به خودی خود برای اثبات به حداقل شرایط لازم نمی‌رسد.

خواندن نتیجه تأیید#

تأییدکننده، یکپارچگی آرشیو، پینینگ امضاکننده و بررسی‌های اطمینان را به‌طور جداگانه گزارش می‌دهد. یک امضای معتبر نشان می‌دهد که بایت‌ها از زمان امضا شدن تغییر نکرده‌اند. اپراتور اثر انگشت کلید را از طریق یک کانال جداگانه به گیرنده می‌دهد. بدون --fingerprint، یک آرشیو سالم بررسی‌های امضا و فرمت خود را با signer_pinned: false، و خط نهایی با شروع می‌شود. EVIDENCE: minimum not met · missing: confirmed signer key.

برای یک سیاست آرشیو محلی خودکار که به یک امضاکننده ثابت و حداقل موارد لازم برای شواهد نیاز دارد:

python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence

از اثر انگشتی که از طریق کانال مورد اعتماد گیرنده نگهداری می‌شود، استفاده کنید. یک شاهد مورد اعتماد همچنین می‌تواند از طریق یک دفترچه یادداشت شاهددار و سازگار، گردآورنده را پین کند؛ --witness، --witness-fingerprint و --require-witness را فراهم کنید. --strict با وضعیت 2 برای امضاکننده‌ای که پین نشده است، خروجی می‌گیرد؛ عدم برآورده شدن --require-tier یا --require evidence نیز با وضعیت 2 خروجی می‌گیرد. --require evidence به --fingerprint و زمان خارجی از یک شخص ثالث که آخرین رکورد را پوشش می‌دهد، نیاز دارد. به signer_pinned، requirements_met و نتایج تضمین توجه کنید، نه فقط کد خروج. در مقابل، اکتساب مهر و موم‌شده از اعتبارسنج تأییدیه و سیاست تأییدشده خود برای احراز هویت هش اکتساب استفاده می‌کند.

دامنهٔ اعتبارسنجی#

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

حالت جمع‌آوری آنچه اعتبارسنج بررسی می‌کند ورودی‌های اعتبارسنجی و مرز اعتماد
فضای کاری محلی امضاها، زنجیره هش، مانیفست و بایت‌های پیوست اثر انگشت گردآورنده که توسط دریافت‌کننده نگهداری می‌شود و زمان خارجی از یک شخص ثالث: رسیدهای تأییدشده RFC 3161 یا OpenTimestamps، یا پست‌های شاهد خوانده‌شده از t.me. نقاط کنترل نگهداری‌شده و سوابق شاهد، بررسی‌های پشتیبان هستند.
محیط کاری محلی با شاهد مستقل آرشیو بررسی می‌کند و با پیش‌وند ژورنال قبلی که توسط شاهد حفظ شده است، تطابق را بررسی می‌کند اثر انگشت و سوابق شاهد؛ سابقهٔ کنترل کلید امانت‌دار نشان می‌دهد کلید شاهد در اختیار کیست. با --channel https://t.me/s/…، تاریخ‌هایی که تلگرام روی پست‌ها گذاشته زمان خارجی فراهم می‌کنند
GitHub Actions ضبط می‌کند تأیید گیت‌هاب هش آرشیو، گردش کار تأییدشده و کامیت‌های گردآورنده، راनर میزبانی‌شده، منشأ جلسه/کلید جدید و یکپارچگی داخلی آرشیو سیاست اعتبارسنج مورد اعتماد، مخزن تماس‌گیرنده و بسته گواهی‌نامه گیت‌هاب؛ مجموعه زیر جریان کاری ثابت‌شده اجرا می‌شود
استقرار ابری چرخهٔ عمر ارائه‌دهنده و سوابق دسترسی، وضعیت فایروال و Cloudflare، به‌علاوهٔ سوابق اجرای امضا‌شدهٔ گردآورنده پرس‌وجوهای فقط-خوانی به ارائه‌دهنده و Cloudflare؛ در دسترس بودن بررسی‌های فردی به ارائه‌دهنده بستگی دارد
ماشین مجازی محرمانه Intel TDX نقل‌قول امضا و وضعیت پلتفرم، پیوند به بیانیه گردآورنده، ترکیب و اندازه‌گیری‌های سیستم‌عامل زنجیره اعتماد اینتل و اندازه‌گیری‌های استقرار مورد انتظار؛ نتایج هر بررسی TDX الزامی را حفظ کنید

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

رسید اجرای برنامه، نسخهٔ گردآورنده، هش‌های فایل و تنظیمات راه‌اندازی را ثبت می‌کند. ریشه‌یابی گیت‌هاب و اندازه‌گیری‌های TDX بررسی‌های محیطی را فراهم می‌کنند؛ رکورد اعتبارسنجی پیکربندی‌های آزمایش‌شده را شناسایی می‌کند.

پیام‌ها از کجا می‌آیند#

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

ژورنال ثبت می‌کند که کلید مجوز از کجا آمده است. ورود با تلفن یا QR، یا یک ورود مستقل از یک فایل جلسه، مقدار account.authorized را با key_origin: "created" ثبت می‌کند؛ جمع‌آوری روی یک کلید وارداتی .session، TData یا JSON مقدار imported را ثبت می‌کند. یک کلید وارداتی همچنین در هر جایی که از آن آمده باشد وجود دارد. استقرارهای تأییدشده از کلیدهای وارداتی استفاده نمی‌کنند.

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

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

پیوست‌ها#

فایل‌ها در پوشه media/ با استفاده از SHA-256 آدرس‌دهی می‌شوند. یک رویداد media.saved یک هش و طول بایت را به یک رویداد پیام خاص پیوند می‌دهد. نام‌های خام فایل‌ها متادیتا هستند و هرگز مسیرهای محلی نیستند. بایت‌های رسانه به‌صورت ناهمزمان دانلود می‌شوند، بنابراین حذف فوری ممکن است از ضبط آن‌ها جلوگیری کند. موارد غیرفعال‌سازی جمع‌آوری، فایل‌های بزرگ/با اندازه نامشخص، خطاهای دانلود و دانلودهای قطع‌شده به‌عنوان نتایج قابل مشاهده هستند. از کار افتادن یک فرآیند می‌تواند فایل‌های ناقص و ارجاع‌نشده‌ای را باقی بگذارد؛ این فایل‌ها در خروجی‌ها گنجانده نمی‌شوند.

خروجی‌گیرنده ZIP، رسانه‌های ذخیره‌شده را با نام‌هایشان تطبیق می‌دهد. خروجی‌های JSONL، CSV و HTML امضاهای رویدادها را تأیید می‌کنند اما بایت‌های رسانه را منتقل نمی‌کنند. گزارش‌های مشتق شده صرفاً برای سهولت هستند؛ فایل events.jsonl، نمایش معتبر رویدادها است.

خروجی کامل چت، پیوست‌ها را در تنظیمات پیوست فضای کاری، در پوشه media/ ذخیره می‌کند که با نام SHA-256 نام‌گذاری شده‌اند. هر رکورد پیام در chat.json، فایل خود را (file، file_sha256) یا دلیل عدم وجود آن را (file_status)، به همراه آنچه خواننده در اطراف متن دیده است، ثبت می‌کند: لینک‌های پشت متن، منبع فوروارد، دکمه‌های ربات، امضا، بازدیدها و تایمر حذف خودکار. verify.py بررسی می‌کند که هر فایل نام‌گذاری‌شده در منیفست امضا‌شده زیر آن هش وجود داشته باشد.

جمع‌آوری پایدار و رسیدهای فرایند (۰.۲)#

یک جاب رسانه و رویداد پیام آن در یک تراکنش ثبت می‌شوند. این جاب، توصیف‌کننده اصلی پیام تلگرام (TL) را ذخیره می‌کند؛ مشاهده امضا شده، سیاست‌های SHA-256، حساب کاربری و اندازه آن را پیوند می‌دهد. بازیابی، پیش از دانلود، این پیوند را تأیید می‌کند. این جاب هرگز پیام فعلی را فراخوانی نمی‌کند و بی‌صدا یک پیوست جدیدتر را جایگزین آن می‌کند. جاب‌های متوقف‌شده دوباره امتحان می‌شوند، در حالی که شکست دائمی یک نتیجه صریح باقی می‌ماند.

هر فضای کاری (workspace) دارای ژورنال (journal) و هویت امضای (signing identity) خود است. یک رویداد process.started شامل شناسه اجرا (run ID)، ساعت‌های محلی، نسخه‌های وابستگی، هش‌های فایل منبع، حساب/دامنه اولیه (initial account/scope)، و تنظیمات ضبط (capture settings) است. تپش‌های قلب (Heartbeats) شامل شناسه اجرا، زمان مونوتونیک (monotonic time) و وضعیت صف (queue state) هستند. رسید اجرای برنامه را می‌توان به صورت یک بیانیه با امضای جداگانه نیز دانلود کرد. برای تأیید اعتبار محیط اجرا، آن را با تأییدیه گیت‌هاب یا بررسی‌های TDX که در دامنه تأیید اعتبار توضیح داده شده است، جفت کنید.

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

پس از راه‌اندازی مجدد، موقعیت ذخیره شده به‌روزرسانی تلگرام از سر گرفته می‌شود (catch_up_from در observation.started) و به‌روزرسانی‌های از دست رفته درخواست می‌شوند. موقعیت ذخیره‌شده تنها شامل به‌روزرسانی‌هایی است که پردازش آن‌ها به پایان رسیده است، بنابراین به‌روزرسانی‌هایی که هنگام قطع اتصال یا توقف فرآیند هنوز در حال انتظار بودند، مجدداً درخواست می‌شوند. یک بازبینی دوره‌ای ثبت می‌کند message.recovered برای پیام‌های از دست رفته و message.missing_on_recheck زمانی که تلگرام دیگر یک پیام ذخیره شده را بازنمی‌گرداند؛ مورد دوم یک اطلاعیه حذف نیست و نه حذفی را نام می‌برد و نه زمانی را مشخص می‌کند.

نسخه‌برداری و بازیابی خارج از محل (S3)#

نسخهٔ خارج از محل (Settings → Notifications and off-site copy → Off-site copy، یا More tools → Extras → Evidence & backups؛ به‌صورت پیش‌فرض غیرفعال است) بخش‌های دفترچه خاطرات، فایل‌های نگهداری‌شده، نقاط کنترل را با زمان‌بندی‌هایشان و خروجی‌های چت تکمیل‌شده را به یک فضای ذخیره‌سازی سازگار با S3 آپلود می‌کند، که پیش از بارگذاری با AES-256-GCM و تحت کلیدی که در گاوصندوق فضای کاری نگهداری می‌شود، رمزگذاری می‌گردد؛ نگهداری Object Lock زمانی اعمال می‌شود که سطل (bucket) از آن پشتیبانی کند. بدون کلید دانلود شده، این نسخه قابل خواندن نیست. با دستور python -m tgwitness.replica restore --key-file KEY.json --out DIR آن را بازیابی و تأیید کنید.

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

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

اسنپ‌شات‌های خروجی استریم#

صادرات جریانی از یک اسنپ‌شات خواندن پایدار SQLite استفاده می‌کند. ممکن است سر آن هنگام تکمیل دانلود، قدیمی‌تر از ژورنال زندهٔ فعلی باشد. یک نقطه‌کنترل که پس از آن اسنپ‌شات ایجاد می‌شود، می‌تواند به درستی گزارش دهد که آرشیو کوتاه‌تر است؛ آن را با یک نقطه‌کنترل در یا قبل از پیش‌وند صادر شده مقایسه کنید، نه یک نقطه‌کنترل دلخواه بعدی.

آماده‌سازی RFC 3161 و تأیید پاسخ (۰.۲)#

حالت مدرک تنها هش SHA-256 هر نقطه کنترل امضا شده را از طریق مسیر فضای کاری و هرگز از طریق MTProxy، به مراجع RFC 3161 و تقویم‌های OpenTimestamps فهرست‌شده ارسال می‌کند. مهرهای زمانی به طور پیش‌فرض در هر هدف پیکربندی فعال هستند؛ مدرک یک پرونده همچنین drand را ثبت می‌کند. پاسخ‌ها در checkpoints/anchors/، و صادر شده به صورت .tsr و .ots فایل‌های زیر anchors/، و توسط بررسی می‌شود. verify.py (--tsa-ca امضای TSA را بررسی می‌کند؛ اثبات‌های OpenTimestamps را با تأیید می‌کند. ots upgrade و ots verify).

یک مرجع RFC 3161 که دو بار متوالی ناموفق باشد، قبل از تلاش بعدی منتظر می‌ماند: یک بازه زمانی، سپس دو، چهار و غیره تا شش ساعت، یا تا زمانی که Retry-After آن درخواست کند، تا یک روز. یک چرخه که فقط مراجع در حال انتظار را پیدا کند، هیچ رکوردی ثبت نمی‌کند؛ در غیر این صورت، anchor.completed آنها را با retry_at زیر deferred فهرست می‌کند. تا زمانی که دوباره پاسخ ندهند، پنل زمان‌بندی‌ها را به عنوان Degraded (کاهش‌یافته) نمایش می‌دهد.

پنل یک آرشیو درخواست آماده می‌کند که حاوی بایت‌های استاندارد checkpoint.json، یک اثر انگشت پیام SHA-256، و یک نانس تصادفی در timestamp.tsq، چک‌سام‌ها و دستورالعمل‌ها است. هیچ درخواست شبکه‌ای انجام نمی‌شود؛ توکنی که مرجع برای این درخواست بازمی‌گرداند، همان timestamp است.

python -m tgwitness.anchor verify پاسخ را بدون OpenSSL با بایت‌های نقطه بازبینی و درخواست اصلی مقایسه می‌کند. فایل CA مورد اعتماد باید صریحاً مشخص شود؛ گواهی‌های همراه به‌طور خودکار مورد اعتماد نیستند. بررسی درخواست در CLI اختیاری است، پس درخواست را نگه دارید و برای بررسی nonce گزینه --request را بدهید. نتیجه نشان می‌دهد که آیا بررسی انجام شده است. امضای نقطه بازبینی گردآورنده و ژورنال همچنان باید جداگانه با اثرانگشت مورد اعتماد گردآورنده راستی‌آزمایی شوند.

فرآیند تأیید، امضای پاسخ، بایت‌های نقطه کنترل و در صورت ارائه، درخواست اصلی را تحت اعتماد CA مشخص‌شده بررسی می‌کند. برای مهرهای زمانی که در حالت شواهد به دست می‌آیند، verify.py شواهد ذخیره‌شده OCSP یا CRL (لغو گواهی امضا) را نیز بررسی می‌کند. به رویه و نتایج اعتبارسنجی مراجعه کنید.

سوابق اختیاری در حالت شواهد: دستگاه‌های drand و Telegram#

دو رکورد دیگر می‌توانند روی همان پاس‌های مربوط به مهرهای زمانی اجرا شوند. هر دو تنها زمانی که حالت شواهد فعال باشد، اعمال می‌شوند. شواهد برای یک پرونده drand را روشن می‌کند؛ در غیر این صورت، هر دو خاموش هستند. آنها را در مسیر More tools → Extras → Evidence & backups → More witnesses · optional، یا "drand": true و "devices": true در POST /api/evidenceیکی از آن‌ها مانع دیگری یا مهر و موم‌های زمانی نمی‌شود؛ پنل آخرین نتیجه هر کدام را زیر فرم نشان می‌دهد.

drand (beacon.drand ). هر بار عبور، جدیدترین دور از drand quicknet، یعنی تصادفی‌سازی عمومی League of Entropy (هر دور ۳ ثانیه)، را در مجله ثبت می‌کند: chain ، round ، randomness ، signature ، round_time و relay که پاسخ داده است. یک دور تأییدشده و غیرقابل‌پیش‌بینی، یک مرجع زمانی پایین‌تر برای محتوای پیوندداده‌شده با هش بعدی فراهم می‌کند. یک مهر زمانی تأییدشده در یک نقطه کنترل بعدی، یک مرجع زمانی بالا را فراهم می‌کند. این بررسی‌ها، محتوای پیوندداده‌شده را محدود می‌کنند. گردآورنده ابتدا از drand.cloudflare.com می‌پرسد، سپس از رله‌های Protocol Labs، از طریق مسیر فضای کاری، هر بار یک درخواست.

verify.py بررسی می‌کند که هر تصادفی بودن، SHA-256 امضای آن است و زمان دور صحیح است، و دورها، طولانی‌ترین بازه بدون یک دور و اینکه ساعت جمع‌آورنده چقدر از drand عقب بوده را گزارش می‌دهد. --check-drand دورها را با یک رله Cloudflare و یک رله Protocol Labs مقایسه می‌کند، همگی آن‌ها یا یک نمونه تصادفی ۱۰۰ تایی در یک ژورنال طولانی؛ دوری که متفاوت باشد، اعتبارسنجی را رد می‌کند.

دستگاه‌های تلگرام (account.devices). هر بار عبور، جلسات حساب را با account.getAuthorizations، فهرستی که تلگرام در تنظیمات → دستگاه‌ها نشان می‌دهد را می‌خواند و ثبت می‌کند: در صورت تغییر از بار قبلی، به‌طور کامل، با added و removed هش‌های جلسه، در غیر این صورت فقط شمارش و SHA-256 آن. مدل دستگاه، پلتفرم، برنامه و نسخه، زمان ایجاد و آخرین فعالیت، کشور و منطقه حفظ می‌شوند؛ آدرس‌های IP حفظ نمی‌شوند، زیرا خروجی‌های شواهد از کنترل شما خارج می‌شوند. سشن خود گردآورنده همیشه فعال است، بنابراین فقط فعالیت سشن‌های دیگر به عنوان تغییر در نظر گرفته می‌شود. verify.py گزارش می‌دهد که لیست هر چند وقت یک‌بار ثبت شده و هر جلسه جدید و خاتمه‌یافته. این لیست فقط زمانی خوانده می‌شود که نظارت در حال اجرا باشد.

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

لاگ Cloudflare Gateway (cloudflare.gateway_dns). برای سروری که از طریق Cloudflare Gateway (DNS Gateway) حل‌نشانی می‌کند، هر بار کپی، آنچه را که Gateway از زمان کپی قبلی ثبت کرده است، کپی می‌کند: یک رکورد برای هر بازه زمانی حداکثر سه ساعته با from, until، سرور location_id، سرور address زمانی که یکی تنظیم شده باشد، و queries به عنوان [at, name, type, rcode, decision, colo]، همچنین زمانی که هیچ‌کدام وجود نداشته است. آن را در زیر گزارش‌گیر Cloudflare Gateway تنظیم کنید: حساب کاربری، مکان، آدرس اختیاری و یک توکن فقط-خواندنی (خواندن تحلیل‌های حساب کاربری؛ خواندن PII اعتماد صفر برای حفظ یک آدرس از یک مکان مشترک). این پنل قبل از ذخیره، آنها را با یک درخواست بررسی می‌کند؛ توکن رمزگذاری‌شده باقی می‌ماند و هرگز وارد گزارش‌ها نمی‌شود. verify.py فهرست پنجره‌ها، نام‌های بیشترین جستجو و هر زمانی که هیچ کپی‌ای پوشش نمی‌دهد را فهرست می‌کند؛ رکوردی که تعدادش با پرس‌وجوهایش مطابقت ندارد، ناموفق است. پنجره‌ای که در یک ثانیه بیش از یک صفحه از پرس‌وجوها را در خود جای دهد، آن صفحه را نگه می‌دارد و می‌گوید بقیه مفقود است. کپی پاسخ کلودفلر از طریق گردآورنده، که توسط گردآورنده امضا شده است؛ ظرف ۲۴ ساعت هر کسی که توکن فقط-خواندن داشته باشد می‌تواند آن را با کلودفلر مقایسه کند.