TgWitness / دستاویزات

کیا جانچا گیا ہے ←

اس صفحے کے کچھ حصے اب بھی انگریزی میں ہیں: اصل انگریزی متن ترجمے کے بعد تبدیل کر دیا گیا۔

حوالہ / شواہد

Telegram · شواہد کا فارمیٹ

دستخط شدہ ZIP کے مندرجات، ریکارڈ کی اقسام، پراسیس رسیدیں، افراد کے پروفائلز، آف سائٹ نقول اور آف لائن تصدیق۔

ٹی جی وٹنس / دستاویزات

شواہد اور تصدیق

TgWitness اکاؤنٹ میں دکھائی دینے والی ٹیلیگرام مشاہدات کو ایک دستخط شدہ جرنل میں محفوظ کرتا ہے۔ موصول کنندگان محفوظ شدہ ریکارڈز، منسلکات اور رپورٹس کی تصدیق ایک قابلِ اعتماد کلیکٹر کلید کے خلاف کر سکتے ہیں، آخری ریکارڈ کے لیے کسی تیسرے فریق سے بیرونی وقت چیک کر سکتے ہیں، اور جرنل کا موازنہ ایک چیک پوائنٹ سے کر سکتے ہیں جو انہوں نے پہلے محفوظ کیا تھا۔ یہ صفحہ فارمیٹس، چیکس اور حوالگی کے لیے محفوظ رکھنے والی مواد کی وضاحت کرتا ہے۔

موصول کنندگان ونڈوز پر VERIFY.cmd کے ساتھ شروع کر سکتے ہیں: یہ اصل ZIP اور آزادانہ طور پر حاصل کردہ کلید کے فنگر پرنٹ کا مطالبہ کرتا ہے، ایک وضاحت شدہ نتیجہ دکھاتا ہے، اور ایک علیحدہ تصدیقی ٹرانسکرپٹ محفوظ کرتا ہے۔ سیٹ اپ اور اعتماد کی حدود کے لیے تصدیقی لانچرز اور پورٹیبل رن ٹائم دیکھیں۔

اس صفحے پر

دستخط شدہ کیا ہے#

مواد حفاظت کیا برقرار رکھنا ہے
ہر جرنل مشاہدہ، بشمول آپریشنل واقعات ہر واقعے کے لیے SHA-256 چین اور Ed25519 دستخط اصل events.jsonl، قابلِ اعتماد کلید کا فنگر پرنٹ، اور ایک برقرار رکھا گیا چیک پوائنٹ
شواہد کے زپ کا مواد manifest.sig کینونکل منیفیسٹ پر دستخط کرتا ہے، جو مواد کی فائلوں کے ہیشز کی فہرست دیتا ہے۔ مکمل ZIP، جس میں اس کا مینیفیسٹ اور دستخط شامل ہیں۔
محفوظ شدہ منسلکات SHA-256 اور بائٹ کاؤنٹ ایک دستخط شدہ media.saved واقعے میں؛ فائل ہیش دستخط شدہ ZIP منیفیسٹ میں تصدیق شدہ ZIP کے اندر اصل بائٹس
چیک پوائنٹ جرنل کی لمبائی، ہیڈ ہیش، عوامی کلید اور تخلیق کے وقت پر Ed25519 دستخط متنازع تبدیلی سے پہلے محفوظ کی گئی ایک آزاد کاپی
رن رسید جمع کرنے والے ورژن کا دستخط شدہ ریکارڈ، سورس فائل ہیشز اور شروعاتی ترتیبات، نیز process.started میں بھی شامل ہیں۔ منتخب تصدیقی موڈ کے لیے رسید، متعلقہ جرنل اور ماحولیاتی شواہد
قابلِ مطالعہ رپورٹس: report.html اور اس کے اجزاء، report.json، report.pdf، chat.pdf ہر فائل کے مواد پر ایک Ed25519 مہر؛ PDF میں ایک معیاری PDF دستخط بھی شامل ہے (دیکھیں قابلِ مطالعہ رپورٹس) موصول شدہ فائل اور قابلِ اعتماد کلید کا فنگر پرنٹ؛ وہ ZIP جس کا یہ بیان کرتا ہے
خودمختار CSV کوئی آزاد کرپٹوگرافک دستخط نہیں؛ صرف ایونٹ ہیشز کافی نہیں ہیں۔ سندیت کی جانچ کے لیے تصدیق شدہ ZIP کے اندر موجود عین نقل استعمال کریں۔
برائوزر کے ذریعے تیار کردہ اسکرین شاٹس، پرنٹ آؤٹس یا پی ڈی ایف ڈیرائیوویٹڈ پر TgWitness کے دستخط نہیں ہیں۔ اصلی تصدیق شدہ پیکیج کو محفوظ رکھیں اور دستاویزی طور پر بتائیں کہ مشتق کیسے تیار کیا گیا۔

کلیکٹر ہر ایکسپورٹ فارمیٹ بنانے سے پہلے جرنل کے دستخطوں کی تصدیق کرتا ہے۔ قابلِ مطالعہ HTML اور PDF رپورٹس اپنے اپنے سیل رکھتی ہیں؛ خود مختار CSV کو دستخط شدہ ZIP کے حصے کے طور پر چیک کیا جاتا ہے۔ منسلک بائٹس اور مینفیسٹ کو برقرار رکھنے کے لیے ZIP کو محفوظ رکھیں، اور جرنل کو پہلے کے حدِ فاصلے کے خلاف چیک کرنے کے لیے ایک علیحدہ چیک پوائنٹ استعمال کریں۔

فارمیٹس اور تصدیقی راستے#

حصول کا موڈ اور آؤٹ پٹ فارمیٹ مختلف سوالات کے جواب دیتے ہیں۔ موڈ جمع اور ماحول کے شواہد فراہم کرتا ہے؛ ہر فارمیٹ اس ریکارڈ کے ایک حصے کو نیچے دیے گئے چیکس کے ساتھ محفوظ یا پیش کرتا ہے۔

آؤٹ پٹ تصدیق اور استعمال
شواہد ZIP معیاری واقعات، دستخط شدہ منشور، کوریج، تحویل اندراجات، منسلکات اور دستیاب بیرونی رسیدیں؛ آرکائیو اور اس کے منتخب شدہ حصولی موڈ کی جانچ کریں۔
ASiC-E کنٹینر ثبوت کو ETSI ASiC-E کنٹینر (EN 319 162-1) کے طور پر ZIP کریں، جس میں mimetype انٹری اور META-INF/ASiCManifest.xml شامل ہوں، اور اسے ورک اسپیس کے اپنے سرٹیفیکیٹ کے ساتھ سطح B-B پر CAdES سے دستخط کریں، یا جب ٹائم اسٹیمپنگ فعال ہو تو B-T پر۔ EU DSS جیسے تصدیق کنندہ فارمیٹ اور سالمیت چیک کرتے ہیں اور چونکہ سرٹیفیکیٹ خود جاری شدہ ہے، کوئی ٹرسٹ اینکر رپورٹ نہیں کرتے۔ EU DSS 6.3 ڈیفالٹ سیٹنگز کے ساتھ 1000 سے زیادہ فائلوں والا کنٹینر مسترد کر دیتا ہے ("بہت سی فائلیں دریافت ہوئیں")۔ verify.py Ed25519 مینیفیسٹ اور ہر درج فائل، META-INF/ASiCManifest.xml میں SHA-256 ویلیوز اور ایک اضافی ASiCManifestNNN.xml یا ASiCEvidenceRecordManifest.xml میں موجود ویلیوز کو چیک کرتا ہے، اور اگر کوئی META-INF/ انٹری ایسی ہو جسے یہ سب کور نہ کریں تو ناکام ہو جاتا ہے۔ یہ CAdES سگنیچرز کو چیک نہیں کرتا اور اس بارے میں بتاتا ہے۔
HTML اور JSON رپورٹس ذرائع کے حوالوں کے ساتھ انفرادی طور پر مہر بند شدہ مناظرات، جو ZIP مینفیسٹ میں بھی درج ہیں۔ ان کی ریکارڈ شدہ تعداد جرنل کے واقعات کی اقسام کا خلاصہ پیش کرتی ہے۔
پی ڈی ایف رپورٹس ایک Ed25519 سیل کے ساتھ بائٹ رینج B-B پر PAdES بیس لائن PDF دستخط، یا جب ٹائم اسٹیمپنگ آن ہو تو دستخط کے ٹائم اسٹیمپ کے ساتھ B-T۔ TgWitness ویریفائر قابلِ اعتماد Ed25519 کلید استعمال کرتا ہے؛ ویوئر کے سرٹیفکیٹ ٹرسٹ ڈسپلے کا چیک الگ ہوتا ہے۔
CSV ایک اسپریڈشیٹ ویو جو ZIP مینفیسٹ کے تحت محفوظ ہے۔ فارمولے کی ایسکیپنگ اسپریڈشیٹ کے استعمال کا تحفظ کرتی ہے؛ اصل دستخط شدہ متن جرنل میں ہی رہتا ہے۔
JSONL دستخط شدہ ایونٹ ریکارڈز، جن میں منسلکات کے حوالہ جات شامل ہیں۔ ثبوت کا ZIP مزید محفوظ شدہ منسلک بائٹس بھی شامل کرتا ہے۔
چٹ ایکسپورٹ اور ڈیسک ٹاپ کے مطابق ویوز تاریخ کے حصول اور دستیاب ایڈمن لاگ ریکارڈز، درخواست کردہ پیشکش اور دستخط شدہ آرکائیو کے ساتھ۔ لائیو مانیٹرنگ کے محفوظ شدہ ورژنز ایک الگ حصولی راستہ ہیں۔
میڈیا اور صرف ہیش ریکارڈز محفوظ شدہ بائٹس کو ان کے SHA-256اور پیغام کے حوالے کے خلاف جانچا جاتا ہے۔ صرف ہیش حاصل کرنے سے دستیاب ہیش میٹا ڈیٹا کو بعد میں فائل بائٹس کے ساتھ موازنہ کے لیے محفوظ رکھا جاتا ہے۔
STIX/MISP اور افراد کے پروفائلز ماخذ سے منسلک نکالی گئی مشاہدات، اکاؤنٹ آئی ڈیز اور تجزیاتی مماثلتیں۔ پروفائل سگنیچرز اور ریکارڈ ہیشز کو اصل شواہد کے خلاف چیک کیا جا سکتا ہے؛ اوتار کیش کی منشأت کو الگ لیبل کیا گیا ہے۔
ہینڈ اوور کا خلاصہ دستخط شدہ انکشاف کے قواعد، بغیر تبدیلی کے ریکارڈز اور نشان زدہ کم شدہ ریکارڈز جو اصل ہیشز/دستخطات کو برقرار رکھتے ہیں۔ ان میدانوں کے موازنہ کے لیے جنہیں پوشیدہ رکھا گیا ہو، اصل برقرار رکھے گئے ریکارڈ کا استعمال کریں۔
گواہ اور وقتی رسیدیں پچھلی جرنل کی حدیں، تسلسل اور انفرادی تصدیق شدہ وقتی دعوے۔ یہ حصول اور آرکائیو چیکس کے ساتھ ہوتے ہیں۔
پاس ورڈ سے محفوظ شدہ ترسیل منتقل کے دوران بند شدہ پیکیج کو محفوظ رکھتا ہے۔ .tgwpw AES-GCM سے تصدیق شدہ انکرپشن استعمال کرتا ہے، جس میں ایک تصدیق شدہ آخری ریکارڈ بھی شامل ہے؛ بند شدہ جرنل اپنے دستخط اور حصول کی رسیدیں برقرار رکھتا ہے۔

پرنٹ آؤٹ یا اسکرین کیپچر دستخط شدہ مواد کی پیشکش ہے۔ اس کی رپورٹ آئی ڈی، کی فنگر پرنٹ اور کیو آر حوالہ تصدیق کے لیے اصل فائل کو تلاش کرنے میں مدد دیتے ہیں۔ حراستی اعلانات فراہم کردہ معائنے کرنے والے اور منتقلی کی معلومات کو ریکارڈ کرتے ہیں؛ تصدیق کنندہ کے نتائج اور حصول کی رسیدیں علیحدہ ثبوت کے طور پر محفوظ کی جاتی ہیں۔

بیرونی دستخط#

ایک دستخط ایسی کلید سے بھی آ سکتا ہے جو 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 آبجیکٹ کی کلید کا ترتیب اہم نہیں ہے؛ غیر موجودہ فیلڈز، نلز، ویلیو کی اقسام اور اری کا ترتیب اہم ہے۔ 300 حرفی پیش نظارہ صرف نمائش کے لیے ہے۔ تبدیل شدہ اندراجات، مختلف ٹاپ-لیول کو changed_fields کے نام سے موسوم کرتے ہیں، جس میں وہ تبدیلیاں بھی شامل ہیں جو اس پیش نظارہ میں نظر نہیں آتیں۔ میچنگ کے دوران ایک دوسرے کو اووررائٹ کرنے کے بجائے ڈپلیکیٹ میسج آئی ڈیز کو مسترد کر دیا جاتا ہے۔

فرق تبدیل شدہ ڈسپلے نام، ویو کاؤنٹ، کلیکشن تشریح یا دیگر مشاہداتی میٹا ڈیٹا ہو سکتا ہے۔ ٹیلیگرام ترمیمات اپنی ترمیمی واقعات کے طور پر ظاہر ہوتی ہیں، اور ہر آرکائیو کی تصدیق بتاتی ہے کہ آیا وہ آرکائیو سالم ہے۔ غیر پارس شدہ ریکارڈ موازنہ میں برقرار رہتے ہیں اور ان کے محفوظ شدہ نمائندہ کے ذریعے موازنہ کیے جاتے ہیں۔

مختلف یا غائب اکاؤنٹ/چٹ شناختوں کے لیے، یہ ٹول بھیجنے والے، مکمل متن، فائل ہیش، میڈیا کی قسم اور پانچ سیکنڈ کے وقت کی رواداری کا استعمال کرتے ہوئے ممکنہ مطابقت تلاش کرتا ہے، اور انہیں 'Unchanged' کے بجائے 'Matched' کے طور پر رپورٹ کرتا ہے۔ غیر تجزیہ شدہ ریکارڈز میل نہیں کھاتے۔ جوڑے والے ریکارڈز میں فرق کو changed میں درج کیا جاتا ہے، بشمول کنٹینٹ موڈ کے۔ --json کے ساتھ، matched ممکنہ جوڑوں کی گنتی کرتا ہے اور unchanged ان جوڑوں کی گنتی کرتا ہے جن کے مکمل محفوظ شدہ ریکارڈز برابر ہیں۔ موجودہ changed_fields اور انٹیجر unchanged آؤٹ پٹ پہلے کے موازنہ کے نتائج کے ساتھ مطابقت رکھتے ہیں۔ آرکائیو فارمیٹ اور سگنیچر کی تصدیق بغیر تبدیلی کے ہیں۔

تحقیقات کی منتقلی#

  1. اپنے کیس نوٹس میں کیس ریفرنس، آپریٹر، عددی ٹیلیگرام اکاؤنٹ آئی ڈی، منتخب ذرائع، کلیکشن پالیسی، اور کلیکشن کی مدت کو ریکارڈ کریں۔ TgWitness مشاہدات کو محفوظ کرتا ہے اور کیس بورڈ میں ماخذ سے منسلک نوٹس اور کلیکشنز کی حمایت کرتا ہے۔ اپنی کیس مواد کے ساتھ منتقلی اور تحویل کے ریکارڈز کو محفوظ رکھیں۔ متوقع کلیکشن سیٹ اپ کو لائیو قبولیت کے طریقہ کار کے ساتھ چیک کریں۔
  2. اس کے ایکسپورٹس پر انحصار کرنے سے پہلے ورک اسپیس کے پبلک کی فنگر پرنٹ کو آزادانہ طور پر محفوظ رکھیں۔ ایویڈنس موڈ آن رکھیں (ڈیفالٹ) تاکہ چیک پوائنٹس RFC 3161 اور OpenTimestamps کی رسیدیں وصول کریں۔ جمع‌آوری کے دوران دستخط شدہ چیک پوائنٹس کو کلیکٹر کے باہر محفوظ کریں۔ رکاوٹوں اور اکاؤنٹ کی نمائش کی حدود کو ریکارڈ کریں۔
  3. ایک دستخط شدہ ZIP ایکسپورٹ کریں اور دستخط شدہ رن رسید کو محفوظ رکھیں۔ ایک چیک پوائنٹ استعمال کریں یا ایکسپورٹ شدہ جرنل کی حد سے پہلے یا اس پر۔ ایک بعد کا چیک پوائنٹ درست طور پر مسترد کر سکتا ہے پہلے کے ایکسپورٹ کو بہت مختصر ہونے کی وجہ سے۔ ایکسپورٹس مکمل ورک اسپیس جرنل شامل کرتی ہیں، پینل فلٹرز سے قطع نظر؛ شیئر کرنے سے پہلے مواد کا جائزہ لیں۔
  4. موصول کنندہ سے کہیں کہ وہ ZIP کی تصدیق ویریفائر کی قابلِ اعتماد کاپی، آزادانہ طور پر فراہم کردہ فنگر پرنٹ اور ٹائم اسٹیمپ اتھارٹی کے روٹ سرٹیفیکیٹ (جو علیحدہ حاصل کیا گیا ہو) کے ساتھ کرے۔ ایک قابلِ اعتماد چیک آؤٹ سے جہاں اس کا Python ماحول فعال ہو:

    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، ایکسپورٹ باؤنڈری، منتقلی کی تاریخ، بھیجنے والا، اور وصول کنندہ کو اپنے تحویل ریکارڈ میں درج کریں۔ اصل پیکیج کو سالم رکھیں اور کاپیوں پر کام کریں۔ ایپلیکیشن کی نجی ڈیٹا ڈائریکٹری کے بجائے شواہد کی فائلیں شیئر کریں، جس میں اکاؤنٹ سیشنز اور سگننگ سیکرٹس بھی شامل ہیں۔ منتقلی کے لیے، پاس ورڈ سے محفوظ شدہ AES-256 ZIP یا زیادہ مضبوط .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 MiB ریم) اور AES-256-GCM استعمال کرتا ہے، جس میں 1 MiB کے ریکارڈز اور ایک تصدیق شدہ آخری ریکارڈ ہوتا ہے۔ ایک خفیہ شدہ میٹا ڈیٹا ریکارڈ اندرونی فائل کا نام محفوظ کرتا ہے، تاکہ ڈاؤن لوڈ کیے گئے کنٹینرز کا نام تبدیل کیا جا سکے۔

کامیاب تصدیق قابلِ اعتماد کلیکٹر کی اور برقرار رکھی گئی حد کے حوالے سے سالمیت قائم کرتی ہے۔ انجام دی گئی چیکس کے لیے اعتماد کے مفروضوں اور توثیقی نتائج کے لیے تصدیق کے دائرہ کار کو دیکھیں۔

ہینڈ اوور کا خلاصہ#

ایک دستخط شدہ زپ پورے ورک اسپیس جرنل کو محفوظ کرتا ہے۔ جب عدالت، وکیل یا کسی بدسلوکی ڈیسک کو صرف چند چیٹس، ایک مخصوص مدت یا مخصوص افراد کی ضرورت ہو، تو Exports → Handover extract منتخب کردہ انکشاف کے قواعد کے مطابق ایک مختصر کاپی (tgwitness-handover-v1) تیار کرتا ہے۔ آپریٹر مقصد بیان کرتا ہے اور چیٹس، ایک اختیاری مدت (UTC)، اُن افراد کا انتخاب کرتا ہے جن کے بارے میں خلاصہ تیار کیا جا رہا ہے، اور یہ بھی طے کرتا ہے کہ باقی سب کے ساتھ کیا ہوگا (دکھایا جائے، P01 کے فرضی ناموں سے تبدیل کیا جائے، P02… یا خارج کر دیے جائیں)، کون سے پیغامات کے متن شامل رہیں گے، کون سی منسلکات اور پروفائل تصاویر شامل کی جائیں گی، اور آیا پیغامات میں موجود فون نمبرز اور ای میل پتے کو چھپایا جائے یا نہیں۔ مقصد اور یہ قواعد دستخط شدہ منیفیسٹ اور رپورٹ میں موجود ہیں؛ جرنل میں handover.exported کو اس رسائی کے ساتھ ریکارڈ کیا جاتا ہے جس نے اسے تیار کیا اور فائل کا SHA-256 شامل ہوتا ہے، نہ کہ اس کا مواد۔

verify.py ایک خلاصے کی دو طریقوں سے جانچ کرتا ہے۔ ایک ریکارڈ جو بغیر تبدیلی کے دکھایا گیا ہے، اس کی مکمل تصدیق کی جاتی ہے: اس کے مواد کی اس کے ہیش سے، اس کے Ed25519 سگنیچر اور شامل کردہ پیشرو سے اس کے لنک کے خلاف۔ ایک کم کردہ ریکارڈ اصل ہیش اور دستخط کو برقرار رکھتا ہے، لہٰذا دستخط اب بھی تصدیق کرتا ہے، لیکن چھپائے گئے فیلڈز کو اس سے دوبارہ شمار نہیں کیا جا سکتا؛ ریکارڈ میں بتایا جاتا ہے کہ کیا چھپایا گیا تھا اور رپورٹ اسے نشان زد کرتی ہے۔ اکاؤنٹ بھر میں سروس ریکارڈز (شروع اور بند ہونے کے اوقات، کوریج میں خلا، کنکشن، نیٹ ورک اور اسٹوریج کے نوٹس، دائرہ کار اور ترتیبات میں تبدیلیاں) صرف ان شعبوں کو محفوظ رکھتے ہیں جو ان کی قسم کے لیے درج ہیں: ان میں موجود چیٹ کی فہرستیں منتخب کردہ چٹس اور ان کے کل اعداد و شمار دوبارہ گنے جاتے ہیں، اور انتخاب سے باہر کسی چٹ میں لائیو-پروب کا خلا اس چٹ، اس کے پیغامات کی تعداد اور گواہ اکاؤنٹ کو ختم کر دیتا ہے؛ ایک منتخب پروب چٹ میں گواہ اکاؤنٹ کو اس کے مستعار نام سے بدل دیا جاتا ہے جب تک کہ ہر کوئی دکھایا نہ گیا ہو یا یہ منتخب کردہ افراد میں سے ایک نہ ہو۔ مینفیسٹ میں جرنل کی لمبائی اور سربراہ کو کلیکٹر کے دستخط کے ساتھ اس سربراہ پر درج کیا جاتا ہے، اور خارج کیے گئے ریکارڈز کی تعداد گنی جاتی ہے؛ coverage.json منتخب کردہ چیٹس کی وضاحت کرتا ہے۔ نئے خلاصے proofs.jsonl بھی شامل کرتے ہیں: ہر شامل کردہ ریکارڈ اور جرنل سربراہ کے لیے، ریکارڈ کے اصل ہیش سے دستخط شدہ مینفیسٹ میں نامزد جرنل روٹ تک کا مرکل راستہ۔ verify.py ہر راستے کی تصدیق کرتا ہے، لہٰذا ہر ریکارڈ کو اسی لمبائی اور ہیڈ والے جرنل کا حصہ دکھایا جاتا ہے، بغیر پورے جرنل کے؛ 100 پیغامات کا ایک خلاصہ، چاہے جرنل کا سائز کچھ بھی ہو، تقریباً ایک سیکنڈ میں چیک ہو جاتا ہے۔ --range=CHAT:FROM-TO اضافی طور پر اس بات کی تصدیق کرتا ہے کہ کسی چیٹ کے FROM سے TO تک کے پیغامات اس خلاصے میں شامل ہیں اور رپورٹ کرتا ہے کہ اس نے ان کے لیے کتنے ریکارڈز چیک کیے۔ فائل کے ناموں کے اندر موجود نام معلوم نہیں کیے جاتے۔ شیئر کرنے سے پہلے حتمی فائلوں کا جائزہ لیں: آزاد متن، فائل کے نام اور منتخب کردہ منسلکات اب بھی لوگوں کی شناخت کر سکتے ہیں۔ مکمل دستخط شدہ ZIP کو محفوظ رکھیں: یہ خلاصہ ایک انکشاف ہے، متبادل نہیں۔

قابلِ مطالعہ رپورٹس#

دستخط شدہ شواہد، حوالگی اور چیٹ ZIPs میں پڑھنے کے قابل HTML اور JSON رپورٹس شامل ہوتی ہیں، نیز جب مطلوبہ فانٹس دستیاب ہوں تو منتخب کردہ رپورٹ زبان میں PDF بھی۔ ہر رپورٹ کو ورک اسپیس کی Ed25519 کلید کے ساتھ سیل کیا جاتا ہے اور اسے الگ سے تصدیق کیا جا سکتا ہے: python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]۔

  • report.html / chat.html: سیل بیان (tgwitness-report-seal-v1) فائل کو بند کرتا ہے اور اس سے پہلے کے ہر بائٹ کے SHA-256 پر دستخط کرتا ہے۔ طویل جرنلز اور چیٹس کو قابل ترتیب سائز کے حصوں میں تقسیم کیا جاتا ہے (رپورٹ سیٹنگز، 500 سے 100,000 ریکارڈز؛ ڈیفالٹ 5,000): records/records-0001.html یا messages/messages-0001.html، ہر ایک کو اس کے نمبر، حد اور کل کے ساتھ سیل کیا جاتا ہے، اور دستخط شدہ منسٹ میں اس کے SHA-256 کے ساتھ درج کیا جاتا ہے۔ کلیکٹر ہارٹ بیٹس کے سلسلوں کو ایک ہی لائن کے طور پر دکھایا جاتا ہے جب تک کہ رپورٹ سیٹنگز انہیں ایک ایک کر کے درج نہ کریں۔
  • report.json (tgwitness-report-json-v1، keys 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 کے ساتھ جب ٹائم اسٹیمپنگ آن ہو اور ٹائم اسٹیمپ اتھارٹی ٹیلیگرام کے باہر درخواستوں کے لیے راستے پر جواب دے۔ یہ ایک خود جاری کردہ دستاویز دستخطی سرٹیفیکیٹ استعمال کرتا ہے جو ورک اسپیس والٹ میں محفوظ ہوتا ہے؛ اس کا سبجیکٹ سیریل نمبر Ed25519 کلید کا فنگر پرنٹ ہے۔ Ed25519 سیل CMS کے اندر غیر دستخط شدہ خصوصیت کے طور پر سفر کرتا ہے 2.25.240684792623320047764573196045913242332 اور سرٹیفیکیٹ کے SHA-256 کو نامزد کرتا ہے "content": "pdf-byte-range"، اس طرح Ed25519 کلید اس سرٹیفیکیٹ کی ضمانت دیتی ہے۔ یہ سرٹیفیکیٹ مستند نہیں ہے: ایک PDF ریڈر دستخط کو درست دکھاتا ہے اور دستخط کنندہ کو نامعلوم یا غیر معتبر بتاتا ہے جب تک کہ سرٹیفیکیٹ پر اعتماد نہ کیا جائے؛ اس کے بجائے Ed25519 فنگر پرنٹ کا موازنہ کریں۔ چینی، جاپانی اور کوریائی PDF کے لیے سرور پر ایک فونٹ کی ضرورت ہوتی ہے (یا TGWITNESS_FONT_DIR)؛ اس کے بغیر ZIP صرف HTML اور JSON رپورٹس لے کر جاتا ہے۔
  • report.en.html، report.en.pdf / chat.en.html، chat.en.pdf: رپورٹ کی زبان انگریزی نہ ہونے پر اسی رپورٹ کا انگریزی اصل، اسی طرح مہر بند اور دستخط شدہ اور دستخط شدہ مینی فیسٹ میں report.original کے تحت درج۔ منتخب زبان کی رپورٹ انگریزی اصل کو تصدیق شدہ یا حلفیہ ترجمے کے ساتھ جمع کرانے کی سفارش سے شروع ہوتی ہے؛ دیکھیں عدالت کے لیے رپورٹس کا ترجمہ۔

Telegram ایک چینل یا سپر گروپ میں پیغامات 1، 2، 3… کو ترتیب سے نمبر کرتا ہے۔ ایک چیٹ ایکسپورٹ پہلے اور آخری نمبر، موجود پیغامات کی تعداد اور message-ids.json میں غیر موجود نمبروں کے ہر سلسلہ، مینفیسٹ اور chat.json ہیڈر کو درج کرتا ہے، اور ٹرانسکرپٹ میں ہر خلا کو نشان زد کرتا ہے۔ verify.py ان کو chat.json سے دوبارہ گنتا ہے۔ غیر حاضر نمبر وہ پیغام ہوتا ہے جس کا Telegram نے جواب نہیں دیا (ایکسپورٹ سے پہلے حذف کیا گیا، یا اکاؤنٹ کے لیے نظر نہ آنے والا)؛ نجی چیٹس اور بنیادی گروپس میں نمبر اکاؤنٹ کی تمام چیٹس کے ذریعے شیئر کیے جاتے ہیں اور خالی جگہیں شمار نہیں کی جاتیں۔

تاریخ پڑھنے کے بعد، ایکسپورٹ ہر غیر موجود نمبر کو نمبر کے لحاظ سے دوبارہ ٹیلیگرام سے مانگتا ہے (channels.getMessages، پہلے پیغام کے نیچے موجود 1,000 نمبروں سمیت 10,000 نمبروں تک، جب زیادہ ہوں تو تمام وقفوں میں یکساں طور پر تقسیم کیے جاتے ہیں)۔ نتیجہ میں ہوتا ہے message-ids.json اور رپورٹ میں۔ ایک خالی جواب ریکارڈ کرتا ہے کہ دوبارہ چیک کے وقت یہ نمبر اس اکاؤنٹ کے لیے دستیاب نہیں ہے؛ یہ وجہ غیر مخصوص چھوڑ دیتا ہے۔ دوبارہ چیک پر واپس کیا گیا پیغام ایکسپورٹ میں شامل کیا جاتا ہے اور نشان زد کیا جاتا ہے found_on_recheck.

جب مشاہداتی ورک اسپیس نے پیغامات کو حذف شدہ، دوبارہ چیک کرنے پر غائب یا ترمیم شدہ پایا، تو چیٹ ایکسپورٹ میں شامل کیا جاتا ہے journal-changes.jsonl: وہ جرنل ریکارڈز، ہر محفوظ شدہ ورژن اور نوٹس، ہر ایک اپنے ہیش اور Ed25519 دستخط کے ساتھ جو اسے جرنل میں موصول ہوا۔ verify.py ہر ریکارڈ کا ہیش دوبارہ حساب کرتا ہے، اس کے سگنیچر کو ایکسپورٹ کلید کے خلاف چیک کرتا ہے اور گنتی کا موازنہ دستخط شدہ منیفیسٹ سے کرتا ہے؛ ثبوت کا ایکسپورٹ مکمل ہیش چین رکھتا ہے۔ رپورٹ ان پیغامات کو حذف شدہ اور پرانی ورژنز کے تحت درج کرتی ہے۔

ہر رپورٹ مختصراً سے شروع ہوتی ہے: ایک پیراگراف، پھر وہ جو مواد دکھاتا ہے اور جو ریکارڈ میں شامل ہے۔ صفحے کی اپنی سیل اسٹیمپ تیلہِ رنگ کی ہوتی ہے جب براؤزر نے سیل کے دستخط کی تصدیق کی ہو، نہ کہ صفحے کی: ایک براؤزر صفحے کو اس کے اپنے بائٹس فراہم نہیں کرتا۔ یہ صرف اس وقت سبز ہوتی ہے جب قاری فائل کو صفحے کے آخر میں موجود چیک میں ڈالتا ہے اور ہر بائٹ کا میل ہوتا ہے، اور صرف اس صورت میں جب دکھایا گیا صفحہ وہی فائل ہو؛ ورنہ یہ سرخ ہو جاتی ہے۔

ہر رپورٹ پروگرام کا نام بالکل درست بتاتی ہے: وہ git commit جب کلیکٹر ایک چیک آؤٹ سے چلتا ہے یا انسٹالر TGWITNESS_COMMIT سیٹ کرتا ہے، اور اس کے ماخذ فائلوں کا SHA-256 (source_tree_sha256، path کا معیاری JSON → ہر .py کا SHA-256، .js، .css، .html اور .svg فائل پیکج میں)، جسے اس کمٹ کا چیک آؤٹ دوبارہ پیدا کرتا ہے جب تک فائلیں تبدیل نہ کی گئی ہوں۔ Telegram کلائنٹ کا نام اس کی لائبریری، API پرت اور ڈیٹا سینٹر کے نام پر رکھا گیا ہے۔ جب مشاہدہ شروع ہوتا ہے اور جب چیٹ ایکسپورٹ شروع اور ختم ہوتا ہے، تو کلیکٹر Telegram سے اس کا وقت (updates.getState، مکمل سیکنڈ) پوچھتا ہے اور Telegram کا وقت منہاس کر کے کلیکٹر کی گھڑی کے وقت میں سے، راؤنڈ ٹرپ سے پیدا ہونے والی غیر یقینی صورتحال کے ساتھ ریکارڈ کرتا ہے؛ رپورٹس ان پیمائشوں کو 'چین آف کسٹڈی' کے تحت دکھاتی ہیں۔ ایک چیٹ ایکسپورٹ پیغامات کی تاریخوں کے علاوہ یہ بھی ریکارڈ کرتا ہے کہ اس نے تاریخ کب پڑھی۔

آف لائن رپورٹ ویوئر اور آرکائیو گائیڈ#

chat.html یا report.html کھولنے سے پہلے مکمل ZIP نکالیں۔ ویوئر تلاش، فلٹرز، شرکاء، اشارے، ریکارڈ کی تفصیلات اور سرور کے بغیر JSON/CSV کے انتخاب فراہم کرتا ہے۔ رپورٹ کے ساتھ viewer/ اور media/ رکھیں۔ انتخاب مشتق ہیں: دستخط شدہ آرکائیو کے ساتھ موازنہ کرنے کے لیے verify.py SELECTION.json --evidence ARCHIVE.zip استعمال کریں۔ تصدیق کنندہ رپورٹ آئی ڈی، دستخطی کلید، آرکائیو کی حد اور ہر منتخب شے کی جانچ کرتا ہے؛ ترمیم شدہ، غائب اور ڈپلیکیٹ اشیاء ناکام ہو جاتی ہیں۔ انتخابی نوٹس اور تخلیقی وقت بغیر دستخط شدہ میٹا ڈیٹا رہتا ہے۔

پیغامات کے نمبروں میں وقفے صرف مکمل، غیر فلٹر شدہ صعودی چیٹ فیڈ میں دکھائے جاتے ہیں۔ کسی زمرے کو چھپانے یا ڈیٹا کے ٹکڑے کو لوڈ نہ کرنے سے حذف شدہ قطار کو غائب پیغام کا ثبوت نہیں سمجھا جائے گا۔ تلاش کے نمایاں حصے سادہ متن پر عمل کرتے ہیں، اس سے پہلے کہ 'HTML' کو فرار کیا جائے، اور لفظی مارک اپ کو برقرار رکھتے ہیں۔

براؤزر دستخط شدہ مینیفیسٹ، رپورٹ آئی ڈی اور کلید، اور تمام درج فائل ہیشز کی جانچ کرتا ہے۔ یہ مبہم یا خراب ساخت کے حامل ZIP ڈھانچے، ناموں کی نقل اور غیر محفوظ راستوں کو مسترد کرتا ہے، اور فائلوں کی حد 256 MiB اور کل مواد کی حد 4 GiB مقرر کرتا ہے۔ بڑے آرکائیوز کے لیے خود مختار ویریفائر استعمال کریں۔ یہ براؤزر چیک جرنل چینز اور ڈیٹا کے معنیات کے معائنہ کار کے چیکس کو مکمل کرتا ہے۔

README.txt میں ایک آغاز رہنما، ایک ہم آہنگ فائل انوینٹری، تصدیقی ہدایات اور رپورٹ کی زبان میں ڈیٹا فارمیٹ کے نوٹس شامل ہیں، جس کے بعد ایک مکمل انگریزی رہنما آتا ہے۔ SHA256SUMS اس میں شامل فائلوں کا احاطہ کرتا ہے، خود کو چھوڑ کر، manifest.json اور manifest.sig؛ دستخط شدہ منسٹ بھی SHA256SUMS کا احاطہ کرتا ہے۔ اصل ZIP کو بغیر تبدیل کیے رکھیں اور کام کرنے والی فائلوں کو نکالی گئی فولڈر کے باہر محفوظ کریں۔ PDF کی رپورٹس میں سیکشن بک مارکس اور کیس/رپورٹ کی شناخت بعد کے صفحات پر شامل ہیں۔

برآمد کے وقت چیٹ#

ایک چیٹ ایکسپورٹ اس بات کو ریکارڈ کرتا ہے کہ جب ایکسپورٹ شروع ہوا تو Telegram نے چیٹ کے بارے میں کیا کہا: Telegram کے اپنے لیبلز (scam, fake, restricted اپنے وجوہات کے ساتھ, verified), صارف کے نام, تفصیل, اراکین اور منتظمین کی تعداد, منسلک گفتگو, مواد کی حفاظت, آیا نئے اراکین پرانے پیغامات دیکھ سکتے ہیں اور اس اکاؤنٹ پر تاریخ کون سے پیغام سے دکھائی دیتی ہے (available_min_id), پیغام 1 کی تاریخ جب یہ چیٹ کی تخلیق ہو، اور چیٹ کی تصویر کا 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 درست ہو؛ ای وی ایم اور سولانا کے پتے اس طرح نشان زد کیے جاتے ہیں کہ وہ چیک نہیں کیے گئے۔ تصاویر کے ساتھ SHA-256 اور ایک پرسیپچوئل ہیش (dHash، 64 بٹس) ہوتا ہے، جو دوبارہ کمپریس یا ری سائز شدہ کاپیوں میں تقریباً تبدیل نہیں ہوتا۔ رپورٹس میں اشارے اس طرح لکھے جاتے ہیں کہ وہ غلطی سے نہ کھلیں (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

Python کے مطابقت رکھنے والے JSON کے ساتھ UTF-8 استعمال کرتے ہوئے سیریلائز کریں، ترتیب شدہ آبجیکٹ کیز کے ساتھ، ASCII ایسکیپنگ کے بغیر، غیر اہم وائٹسپیس کے بغیر، اور NaN/infinity کے بغیر:

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

ان بائٹس کا SHA-256 ہی ایونٹ ہیش بن جاتا ہے۔ دستخط 32 خام ہیش بائٹس پر Ed25519 کے ذریعے کیے جاتے ہیں، پھر base64 میں انکوڈ کیے جاتے ہیں۔ پہلا previous_hash 64 صفر پر مشتمل ہوتا ہے۔ سلسلہ وار نمبر 1 سے شروع ہوتے ہیں اور 1 کے اضافے سے بڑھتے ہیں۔ تمام واقعات، بشمول آپریشنل واقعات، ایک ہی چین شیئر کرتے ہیں۔ ڈپلیکیٹ ڈیلیوری کی روک تھام نہیں ہے: بار بار ہونے والی مشاہدات الگ الگ رسیدیں ہیں، نہ کہ الگ الگ ٹیلیگرام کارروائیوں کا دعویٰ۔

خام ٹیلیگرام کی تاریخیں ISO سٹرنگز ہوتی ہیں؛ بائنری فیلڈز اشیاء میں تبدیل ہو جاتے ہیں جن میں bytes_base64 شامل ہوتا ہے۔ پیغام کا متن، اینٹٹیز، میڈیا ڈسکرپٹرز، جوابی میٹا ڈیٹا، ردعمل، اور سروس ایکشنز، جب فراہم کیے جائیں، خام پیغام کے میٹا ڈیٹا میں برقرار رکھے جاتے ہیں۔ ایک لائیو پیغام بھی اُس ٹیلیگرام اپ ڈیٹ کو برقرار رکھتا ہے جس نے اسے پہنچایا تھا transport_update؛ جب وہ اپ ڈیٹ اسی پیغام کو لے کر آتا ہے جیسا کہ raw، اس کا message field ہے {"same_as": "raw"} کیونکہ دوسری کاپی کے بجائے اس میں ہوتا ہے۔

observed_at ریکارڈ لکھنے کے وقت کلیکٹر کا UTC وقت ہے؛ source_at وہ تاریخ ہے جو اس ٹیلیگرام ایونٹ نے فراہم کی ہے۔ لائیو اپ ڈیٹ کو ہینڈل کرتے ہوئے لکھے گئے ریکارڈز میں شامل ہوتا ہے payload.received_at، وہ UTC وقت جب اپ ڈیٹ کلیکٹر تک پہنچا، اور payload.processing_delay_ms۔ لائیو ایڈیٹس فراہم کردہ ترمیم کی تاریخ کو برقرار رکھتے ہیں، ہسٹری سنیپ شاٹس موجودہ مشاہدے کے وقت کے ساتھ پیغام کی تاریخ کو برقرار رکھتے ہیں، اور ایک عام محوّلیت کی اطلاع وصولی کے وقت کو ماخذ کی تاریخ کے بغیر ریکارڈ کرتی ہے۔ ایڈمن-لاگ انٹریاں اپنی فراہم کردہ کارروائی کی تاریخ کو علیحدہ طور پر برقرار رکھتی ہیں۔ وصولی کا ترتیب اور ماخذ واقعے کا ترتیب الگ الگ ٹائم لائنز ہیں، جن میں موازنہ کے لیے گھڑی کے مشاہدات اور بیرونی رسیدیں دستیاب ہیں۔

ایکٹر کے معنی#

منسوبیت واقعے کے ماخذ کی پیروی کرتی ہے۔ message.new.actor_id اور message.edited.payload.sender_id پیغام بھیجنے والے کو برقرار رکھتے ہیں۔ عام message.deleted اطلاعات میں پیغام کے آئی ڈی ہوتے ہیں اور ایک null actor فیلڈ ہوتی ہے؛ دستیاب ایڈمن-لاگ اندراجات میں ان کے فراہم کردہ ایکشن، ایکٹر اور تاریخ شامل ہوتی ہے۔ رکنیت سروس کے پیغامات بھیجنے والے اور ایکشن کی قسم کو برقرار رکھتے ہیں، خام شرکاء کی اپ ڈیٹس فراہم کردہ actor_id کو برقرار رکھتی ہیں، اور ردعمل کے سنپ شاٹس ان کی فراہم کردہ تعداد اور ظاہر ہونے والی شناختوں کو محفوظ رکھتے ہیں۔ ان ریکارڈز کو قید شدہ ورژنز اور پینل تعامل کی رسیدوں کے ساتھ پڑھیں۔

نجی چیٹس اور عام گروپس کے لیے حذف کرنے کی اطلاعات میں صرف میسج آئی ڈیز (message IDs) شامل ہوتی ہیں۔ وہ چیٹس ایک اکاؤنٹ بھر میں ایک ہی آئی ڈی کے تسلسل (ID sequence) کا اشتراک کرتی ہیں، لہٰذا ایک آئی ڈی اس اکاؤنٹ کے ایک واحد پیغام کی شناخت کرتی ہے۔ جب اس آئی ڈی والا پیغام پہلے اس جرنل میں محفوظ کیا گیا تھا، تو حذف کرنا اس چیٹ میں `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 کے ساتھ شروع ہوتا ہے اور ایک وقفہ، ایک توقف، ٹیلیگرام کنکشن کے ٹوٹنے، سائن آؤٹ، بغیر کسی منظم توقف کے عمل کے آغاز، یا مشاہدہ کے دوران بغیر کسی ریکارڈ کے تین منٹ سے زیادہ کے لیے رُک جانے پر ختم ہوتا ہے (ہارٹ بیٹس ہر منٹ لکھے جاتے ہیں، لہٰذا خاموشی کا مطلب ہے کہ عمل رک گیا، جم گیا یا کمپیوٹر سلیپ موڈ میں چلا گیا)۔ جب More tools → Parameters میں heartbeat کا وقفہ تبدیل کیا جاتا ہے، تو ہر heartbeat اسے ریکارڈ کرتی ہے اور اجازت شدہ خاموشی تین وقفوں کی ہو جاتی ہے، جو کبھی بھی تین منٹ سے کم نہیں ہوتی۔
  • خلائیں ادوار کے درمیان وقت اور وجہ درج کرتی ہیں۔ آخری ریکارڈ پر اب بھی کھلا ہوا ایک خلا not_resumed_by_last_record کے ساتھ نشان زد ہے۔
  • پیغامات کی شناختیں غیر مشاہدہ شدہ ہیں۔ چینلز اور سپر گروپس کے لیے، جو فی چٹ پیغامات کی تعداد درج کرتے ہیں، مشاہدہ شدہ شناختوں کے درمیان غائب شناختیں حدود کے طور پر درج کی جاتی ہیں۔ انہیں غیر مشاہدہ شدہ کے طور پر رپورٹ کیا جاتا ہے — حذف شدہ، کبھی بھی فراہم نہ کیے گئے، یا محفوظ شدہ تاریخ سے باہر — کبھی بھی حذف شدہ کے طور پر نہیں۔ نجی چٹس اور عام گروپس ایک اکاؤنٹ بھرے تسلسل کو شیئر کرتے ہیں، لہٰذا ایسے کسی چٹ کے اندر خالی جگہیں کچھ بھی ظاہر نہیں کرتیں اور وہاں درج نہیں ہوتیں۔
  • چٹ-سطح کے خلا کے نوٹس (مثلاً ٹیلیگرام کا ایک چینل میں فرق کی بازیابی کے لیے درخواست کرنا) نوٹس کے طور پر شمار کیے جاتے ہیں؛ یہ عالمی کوریج میں خلل نہیں ڈالتے۔
  • سیشن ریکارڈز۔ وہ ونڈوز جن میں ٹیلیگرام کا اپ ڈیٹ کاؤنٹر بڑھا جبکہ اس سیشن تک کوئی اپ ڈیٹ نہیں پہنچا (updates_diverted)، یہ سیشن ٹیلیگرام کی سیشن لسٹ سے نکل گیا جبکہ اس کا کنکشن کام کرتا رہا (session_revoked_externally)، یا ایک وِٹنس پروب کا جواب صرف ہسٹری سے آیا (probe_ack_missed_live) کو الگ درج کیا گیا ہے۔ تصدیق کنندہ یہ بھی رپورٹ کرتا ہے کہ ٹیلیگرام سیشن کلید کہاں سے آئی، مشاہدہ شروع ہونے پر کون سے دیگر سیشن سائن ان تھے، مشاہدے کے دوران شامل کیے گئے سیشن، ٹیلیگرام سیکیورٹی نوٹس (777000)، ورک اسپیس سے ختم کیے گئے دیگر سیشن، صرف سیشن کے ادوار، گواہ پروب کی گنتیاں اور فون کال اپ ڈیٹس۔ اکاؤنٹس دیکھیں۔ جب سخت منتخب چیٹس آن ہو (scope.strict میں observation.started)، تو سیشن کی فہرست (جب تک یہ واحد سیشن ہو، یا جب ٹیلیگرام ڈیوائسز آن ہو)، سیکیورٹی نوٹس اور فون کال اپ ڈیٹس جمع نہیں کیے جاتے، لہٰذا ان کی عدم موجودگی سے کچھ ظاہر نہیں ہوتا، اور ایک حذف کاری کو ایک سیشن کے ساتھ ملایا جاتا ہے صرف اس صورت میں چیک کریں اگر یہ اس سے پہلے کے 10 منٹ میں چلایا گیا ہو۔

اپ ڈیٹ سلسلہ (pts)#

Telegram نمبروں کے پیغام سے متعلق اپ ڈیٹس کے ساتھ 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 جب More tools → Parameters → Gap analysis میں بند کیا جائے
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.
  • پورے اکاؤنٹ کے لیے سلسلہ صرف پہلے پیغام سے آخری پیغام تک ناپا جاتا ہے جو اس دوران موصول ہوئے جب پورے اکاؤنٹ کی کلیکشن آن تھی اور نجی چیٹس، بوٹس، عام گروپس اور اکاؤنٹ کے اپنے پیغامات کو برقرار رکھا گیا، کسی بھی چیٹ کو خارج نہیں کیا گیا (scope.changed). جن اعداد کا نام رکھا گیا deletion.unscoped بغیر مواد کے مشاہدہ شدہ کے طور پر شمار کیے جاتے ہیں۔ منتخب چیٹس کی ایکسپورٹ یا حوالگی اسے ماپ نہیں سکتی۔ اگر پورے اکاؤنٹ کی کلیکشن بند اور پھر آن کی گئی، تو ایک نوٹ میں کہا گیا ہے کہ اس دوران استعمال ہونے والے نمبر خلا کے طور پر ظاہر ہوتے ہیں۔
  • سروس پیغامات جرنل کے ریکارڈز ہیں جن کے اپنے نمبر ہوتے ہیں، اس لیے یہ خود ہی اپنے خلا پُر کر لیتے ہیں؛ اختیاری تخمینہ صرف سیاق و سباق ہے۔

verify.py دوبارہ حساب gap_summary کی طرف events.jsonl دستیاب پیرامیٹرز کے ساتھ دستخط شدہ coverage.json ممبر (پرانے آرکائیوز کے لیے ڈیفالٹ) اور اپنے کوریج سمری میں اکاؤنٹ بھر کی لائن پرنٹ کرتا ہے۔ آرکائیو کا get_capture_status(MCP اور کمانڈ لائن) ان چیٹس کے لیے ایک ہی پیمائش واپس کرتا ہے جو ایک رسائی پڑھ سکتی ہے؛ پورے ورک اسپیس کو کور کرنے والی رسائی کے لیے ہی اکاؤنٹ بھرے سلسلہ کو دکھاتا ہے۔

ایک سروس پیغام کے بار بار مشاہدات کو ایک بار گنا جاتا ہے، اور اکاؤنٹ سروس کا تخمینہ صرف ناپے گئے دائرہ کار کے اندر موجود اعداد و شمار استعمال کرتا ہے۔ ایک لاگو کردہ دائرہ کار کو اکاؤنٹ بھر کی پیمائش فعال ہونے سے پہلے اکاؤنٹ کے اپنے پیغامات کو واضح طور پر محفوظ کرنا چاہیے؛ پیمائش ان ریکارڈز سے شروع ہوتی ہے جو اس معلومات کو اپنے ساتھ لے کر چلتے ہیں۔ ناپے گئے دائرہ کار میں جاری مشاہدات شامل ہوتے ہیں، اور اس کے دوبارہ شروع ہونے کو نوٹ کیا جاتا ہے۔ لائیو آرکائیو کوئری کا ایک وقتی بجٹ ہوتا ہے، جس میں اس کا ڈیٹا بیس اسکین بھی شامل ہوتا ہے، اور یہ ایک نامکمل پیمائش کو جزوی کے طور پر نشان زد کرتی ہے۔

ٹیلیگرام الگ الگ میسج آئی ڈی کے سلسلوں کو دستاویزی شکل دیتا ہے۔ یہ نمبر مشاہدات، حذف کرنے کے نوٹس، دوبارہ چیک اور ایڈمن لاگ کو بیان کرتے ہیں کہ ٹیلیگرام جہاں رپورٹ کرتا ہے وہاں کوئی نمبر کیوں غائب ہے۔

جب Telegram اکاؤنٹ قبول کرنا بند کر دیتا ہے، تو coverage.gap ریکارڈ جو مشاہدہ ختم کرتا ہے، اس میں cause (account_banned, account_frozen, account_deleted, session_duplicated, session_revoked, session_expired, session_ended یا not_authorized) اور Telegram ایرر شامل ہوتا ہے؛ verify.py اس وجہ کا نام بتاتا ہے جہاں مدت ختم ہوتی ہے۔

کوریج ریکارڈ شدہ مشاہداتی ادوار، وقفے اور پیغامات کے نتائج کو یکجا کرتی ہے۔ اس کا جائزہ منتخب کردہ چیٹس، مدت اور منسلکہ پالیسی کے ساتھ لیں۔ دوبارہ چیک کریں۔ نتائج اور ریکارڈ شدہ خلا یہ دکھاتے ہیں کہ اکاؤنٹ کی اپ ڈیٹس کو کتنی مکمل طور پر دیکھا گیا۔

تخلیق کار#

ثبوت ZIPs، چیٹ ایکسپورٹس، گواہ جرنلز اور پیپل-پروفائل فائلوں کے بیان کا دستخط شدہ منسٹف producer: سافٹ ویئر، ورژن، پروجیکٹ (PhishDestroy)، ہوم پیج اور ماخذ ریپوزیٹری پر مشتمل ہوتا ہے۔ HTML رپورٹ اور ویریفائر اس دستخط شدہ پروڈیوسر ریکارڈ کو دکھاتے ہیں۔ ماخذ-فائل ہیشز ایک قابلِ اعتماد چیک آؤٹ کے ساتھ موازنہ کے لیے ریکارڈ شدہ ماخذ ٹری کی شناخت کرتے ہیں۔ ایگزیکیوشن کی اصلیت کی تصدیق علیحدہ طور پر GitHub کی حصولی تصدیق یا 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

دستخط کی تصدیق کرتا ہے، خود ثبوت کی برآمد (دستخط، ہیش چین اور فائلیں) کی توثیق کرتا ہے اور یہ کہ ہر حوالہ شدہ ریکارڈ اسی ورک اسپیس کی برآمد میں بغیر تبدیلی کے موجود ہے۔ اوتار کے ہیشز کو مقامی کیش سے آئے ہوئے کے طور پر لیبل کیا گیا ہے (جرنل ریکارڈز نہیں)۔ ذکروں کا میچ پیٹرن کے مطابق ہوتا ہے اور یہ جانچ کے لیے اشارے ہیں۔ پروفائلز ہر چیٹ کے لیے الگ فعال کیے جاتے ہیں، AES-256 ZIP پاس ورڈ کے ساتھ برآمد کیے جا سکتے ہیں، اور جب انہیں بند کیا جائے یا چیٹ کو ذرائع سے ہٹایا جائے تو حذف ہو جاتے ہیں۔

آزاد شاہد#

ایک گواہ جرنل (tgwitness-witness-v1) اور اس کے چینل پوسٹس کو verify.py --witness … --channel … کے ساتھ ایک ثبوت ایکسپورٹ کے خلاف چیک کیا جاتا ہے؛ آزاد گواہ دیکھیں۔ ایک عوامی https://t.me/s/… یا https://telegram.me/s/… پتے کے ساتھ، تصدیق کنندہ ہر پوسٹ کی تاریخ ٹیلیگرام سے پڑھتا ہے، اور ایکسپورٹ ہیڈ پر کسی پوسٹ کی ایسی earliest تاریخ آخری ریکارڈ کے لیے بیرونی وقت ہوتی ہے۔ کسی بھی دوسرے ذریعہ سے تاریخیں فراہم کردہ میٹا ڈیٹا ہیں۔

منفیسٹ اور چیک پوائنٹس#

manifest.json میں فارمیٹ، ایکسپورٹ کا وقت، پبلک کی، فنگر پرنٹ، جرنل کی لمبائی، ہیڈ ہیش، دائرہ کار، پروڈیوسر، حدود، اور ہر مواد کے رکن کا SHA-256 شامل ہوتا ہے، سوائے خود manifest.json اور manifest.sig کے۔ manifest.sig بنیادی base64 Ed25519 دستخط ہے جو معیاری manifest JSON پر مبنی ہوتا ہے۔ تصدیق کنندہ غیر متوقع/غائب ارکان، ڈپلیکیٹ نام، خراب فائلیں، ٹوٹی ہوئی ترتیب/سلسلے، غیر درست دستخط، اور فراہم کردہ چیک پوائنٹ کے ساتھ عدم مطابقت کو مسترد کر دیتا ہے۔ یہ کبھی بھی آرکائیو راستے (archive paths) نکالنے کی کوشش نہیں کرتا۔ یہ کل اعلان کردہ غیر کمپریسڈ سائز کو 4 GB تک محدود کرتا ہے؛ --max-gib N ایک بڑھائی گئی پیرامیٹر حد کے ساتھ بنائے گئے بڑے آرکائیو کی اجازت دیتا ہے۔ مزید ٹولز → پیرامیٹرز۔

ایک بڑے آرکائیو کی جانچ بیک وقت متعدد عمل (processes) کے ذریعے کی جاتی ہے: ارکان کی ہیشنگ متوازی طور پر کی جاتی ہے، اور پہلے 5,000 ریکارڈز کے بعد، ہر ریکارڈ کا مواد ہیش اور دستخط ورکر عمل (worker processes) کے ذریعے چیک کیے جاتے ہیں، جبکہ مرکزی عمل (main process) ترتیب سے چین، کوریج اور بائنڈنگز کی پیروی کرتا ہے۔ --jobs N عملوں کی تعداد مقرر کرتا ہے؛ ڈیفالٹ auto ہر CPU کے لیے ایک استعمال کرتا ہے، زیادہ سے زیادہ 16، اور --jobs 1 سب کچھ ایک ہی عمل میں برقرار رکھتا ہے۔ جواب دونوں صورتوں میں ایک ہی ہوتا ہے، اور تبدیلی کو اسی پیغام کے ساتھ مسترد کر دیا جاتا ہے۔ برقرار رکھے گئے چیک پوائنٹس اور ٹائم اسٹیمپ اینکرز کے ذریعہ نامزد کردہ مقامات پر ہیشز اس ایک پاس کے دوران برقرار رکھے جاتے ہیں، تاکہ ہر اینکر کا موازنہ جرنل کو دوبارہ پڑھے بغیر کیا جا سکے۔ 32-تھریڈ کمپیوٹر پر 400,000 ریکارڈز پر مشتمل 10.8 GB کا آرکائیو ایک عمل میں 58.9 سیکنڈ، 4 کے ساتھ 15.2 سیکنڈ اور 16 کے ساتھ 8.4 سیکنڈ میں لگا؛ ریکارڈز پر ترتیب وار ایک پاس حد مقرر کر دیتا ہے۔

اپنے انسٹال شدہ TgWitness ورژن یا جائزہ شدہ چیک آؤٹ سے تصدیق چلائیں۔ آرکائیو میں شامل کاپی پورٹیبل استعمال کی حمایت کرتی ہے؛ اسے چلانے سے پہلے اس کاپی کا موازنہ اپنی قابلِ اعتماد تنصیب سے کریں۔

ایک چیک پوائنٹ ایک بیان پر دستخط کرتا ہے جس میں پبلک کی، جرنل کی لمبائی، ہیڈ ہیش، اور تخلیقی وقت شامل ہوتا ہے۔ اس میں وہ تازہ ترین drand راؤنڈ بھی شامل ہوتا ہے جو ورک اسپیس نے حاصل کیا ہوتا ہے (drand_anchor ): کلیکٹر ہر دورانیہ والے چیک پوائنٹ سے پہلے ورک اسپیس کے بیرونی راستے کے ذریعے ایک drand ریلے سے پوچھتا ہے، لہٰذا Hide IP، پروکسیز اور ایک بند بیرونی راستہ لاگو ہوتا ہے، اور خود چیک پوائنٹ کبھی بھی بیرونی کنکشن نہیں کرتا۔ تصدیق کنندہ یہ چیک کر سکتا ہے کہ بعد والا آرکائیو اسی پری فکس پر مشتمل ہے۔ --checkpoint اور --check-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 کیپچر GitHub کی تصدیق: آرکائیو ڈائجسٹ، منظور شدہ ورک فلو اور کلیکٹر کے کمٹس، ہوسٹڈ رنر، تازہ سیشن/کی کا آغاز اور اندرونی آرکائیو کی سالمیت قابلِ اعتماد تصدیق کنندہ کی پالیسی، کالر ریپوزیٹری اور گٹ ہب تصدیقی بنڈل؛ یہ مجموعہ پن کیے گئے ورک فلو کے تحت چلتا ہے۔
کلاؤڈ تعیناتی پرووائیڈر کے لائف سائیکل اور رسائی کے ریکارڈز، فائر وال اور کلاؤڈ فلئیر کی حالت، نیز کلیکٹر کے دستخط شدہ رن ریکارڈ فراہم کنندہ اور Cloudflare کے لیے صرف پڑھنے والی استفسارات؛ انفرادی چیکس کی دستیابی فراہم کنندہ پر منحصر ہے۔
Intel TDX خفیہ مجازی مشین سائنچر اور پلیٹ فارم کی حیثیت کا حوالہ دیں، کلیکٹر کے بیان سے وابستگی، کمپوز اور OS کی پیمائشیں Intel ٹرسٹ چین اور متوقع تعیناتی پیمائشیں؛ ہر ضروری TDX چیک کے نتائج کو برقرار رکھیں

مہر بند حصول میں، منظور شدہ کلیکٹر تصدیق شدہ ٹیلیگرام کنکشن کے ذریعے تصدیق شدہ ماحول کے اندر ڈیٹا وصول کرتا ہے۔ تصدیق نامہ آرکائیو کو اس عمل سے منسلک کرتا ہے، لہٰذا توثیق حصول کے ساتھ ساتھ بعد میں فائل کی سالمیت کا بھی احاطہ کرتی ہے۔ یہ منظور شدہ کوڈ اور اوپر درج پلیٹ فارم ٹرسٹ چین پر انحصار کرتا ہے۔ گٹ ہب کیپچر توثیق کے لیے رن کے اندر بنائے گئے سیشن کی ضرورت ہوتی ہے اور درآمد شدہ سیشن کیپچرز کو مسترد کر دیتا ہے۔

رن رسید کلیکٹر ورژن، فائل ہیشز اور اسٹارٹ اپ سیٹنگز کو ریکارڈ کرتی ہے۔ GitHub پروویننس اور TDX پیمائشیں ماحولیاتی چیکس فراہم کرتی ہیں؛ توثیقی ریکارڈ آزمائش شدہ کنفیگریشنز کی شناخت کرتا ہے۔

پیغامات کہاں سے آتے ہیں#

ٹیلیگرام ہر کلائنٹ تک، سرکاری ایپس سمیت، ایک MTProto سیشن کے اندر پیغامات پہنچاتا ہے۔ سیشن کی اجازت نامہ کی ٹیلیگرام کی پن کی گئی سرور کی کے خلاف طے کی جاتی ہے، اور ہر اپ ڈیٹ اس کی کے تحت خفیہ شدہ اور سالمیت کی جانچ کے ساتھ پہنچتی ہے۔ کلیکٹر اکاؤنٹ کے تصدیق شدہ سیشن کے ذریعے پیغامات وصول کرتا ہے اور ہر مشاہدے کو جرنل میں آنے کے ساتھ ہی دستخط کرتا ہے، جس میں چیٹ، پیغام اور بھیجنے والے کے شناختی نام اور وہ تاریخ شامل ہوتی ہے جو ٹیلیگرام نے ہر پیغام پر مقرر کی ہوتی ہے۔ GitHub میں ایکشنز کیپچر اور Intel TDX ڈیپلائمنٹس کو ریکارڈ کرتے ہیں، اور تصدیق اس سیشن اور سگننگ کی کو منظور شدہ کلیکٹر ایگزیکیوشن سے منسلک کرتی ہے۔

جرنل یہ ریکارڈ کرتا ہے کہ اجازت نامہ کی کلید (authorization key) کہاں سے آئی ہے۔ فون یا QR کے ذریعے سائن ان کرنا، یا سیشن فائل سے آزاد لاگ ان، account.authorized کو key_origin: "created" کے ساتھ لکھتا ہے۔ درآمد شدہ .session، TData یا JSON کلید پر کلیکٹ کرنے پر imported لکھتا ہے۔ ایک درآمد شدہ کلید وہاں بھی موجود ہوتی ہے جہاں سے وہ آئی ہو۔ تصدیق شدہ تعیناتیاں (Attested deployments) درآمد شدہ کلیدوں کو مسترد کر دیتی ہیں۔

کسی ریکارڈ کی ٹیلیگرام سے ابتدا اکاؤنٹ کے تصدیق شدہ کنکشن، جرنل میں کنکشن اور کیپچر ریکارڈز، جرنل انٹریوں سے مطابقت رکھنے والے کیپچر کیے گئے MTProto فریمز (tgwitness/forensics/)، ہر پیغام کی ٹیلیگرام تاریخ اور، تصدیق شدہ کیپچر کے لیے، تصدیق شدہ ایگزیکیوشن ماحول پر منحصر ہوتی ہے۔ آرکائیو سگنیچرز اس ریکارڈ کو بعد میں جانچ کے لیے محفوظ رکھتے ہیں۔ برقرار رکھے گئے چیک پوائنٹس پہلے کے جرنل کی حدوں کو طے کرتے ہیں، کوریج ریکارڈز اکٹھا کرنے کے نتائج دکھاتے ہیں، اور تصدیق شدہ بیرونی ٹائم اسٹیمپس محفوظ کیے گئے بائٹس کو وقت میں جگہ دیتے ہیں۔

ایک مقامی ورک اسپیس کے لیے، وصول کنندہ قابلِ اعتماد کلیکٹر یا گواہ ان پٹس فراہم کرتا ہے۔ سیل شدہ حصول کے لیے، قابلِ اعتماد پالیسی اور تصدیق آرکائیو ڈائجسٹ کو منظور شدہ کلیکٹر ایگزیکیوشن سے منسلک کرتی ہے۔ یہ مختلف تصدیقی راستے ہیں؛ منتخب راستے کے لیے مکمل شدہ چیکس کی رپورٹ کریں۔

منسلکات#

فائلیں media/ کے تحت SHA-256 کے ذریعے پتے جاتے ہیں۔ media.saved واقعہ ایک ہیش اور بائٹ کی لمبائی کو ایک مخصوص پیغام کے واقعے سے منسلک کرتا ہے۔ خام فائل کے نام میٹا ڈیٹا ہیں، کبھی بھی مقامی راستے نہیں۔ میڈیا بائٹس غیر ہم آہنگ (asynchronously) ڈاؤن لوڈ کیے جاتے ہیں، لہٰذا فوری حذف کرنے سے ان کی گرفتاری (capture) رک سکتی ہے۔ غیر فعال شدہ کلیکشن، حد سے زیادہ/نامعلوم سائز والی فائلیں، ڈاؤن لوڈ کی ناکامیاں، اور منقطع شدہ ڈاؤن لوڈز نتائج کے طور پر ظاہر ہوتے ہیں۔ پراسیس کے کریش ہونے سے غیر متعلقہ (unreferenced) جزوی فائلیں رہ سکتی ہیں؛ یہ ایکسپورٹس میں شامل نہیں ہوتیں۔

ZIP ایکسپورٹر محفوظ شدہ میڈیا کو اس کے ناموں کے خلاف تصدیق کرتا ہے۔ JSONL، CSV، اور HTML ایکسپورٹس ایونٹ سگنیچرز کی تصدیق کرتے ہیں لیکن میڈیا بائٹس منتقل نہیں کرتے۔ مشتق رپورٹس سہولت کے لیے ہیں؛ events.jsonl ہی مستند ایونٹ نمائندگی ہے۔

ایک مکمل چیٹ ایکسپورٹ، ورک اسپیس کی اٹیچمنٹ سیٹنگز کے اندر منسلکات کو media/ میں محفوظ کرتا ہے، جن کے نام SHA-256 ہیں۔ chat.json میں ہر پیغام کے ریکارڈ میں اپنی فائل کا نام (file، file_sha256) یا اس کی غیر موجودگی کی وجہ (file_status) درج ہوتا ہے، اس کے ساتھ قاری نے متن کے گرد جو کچھ دیکھا وہ بھی شامل ہوتا ہے: متن کے پیچھے کے لنکس، بھیجنے والا، بوٹ بٹنز، دستخط، ویوز اور خود بخود حذف ہونے کا ٹائمر۔ verify.py اس بات کی تصدیق کرتا ہے کہ ہر نامزد فائل اس ہیش کے تحت دستخط شدہ مینفیسٹ میں موجود ہے۔

دیرپا جمع‌آوری اور رسیدوں کا عمل (0.2)#

ایک میڈیا جاب اور اس کا میسج ایونٹ ایک ہی ٹرانزیکشن میں کمٹ ہوتے ہیں۔ جاب اصل TL میسج ڈسکرپٹر کو محفوظ کرتا ہے؛ دستخط شدہ مشاہدہ اس کی SHA-256، اکاؤنٹ، اور سائز پالیسی کو منسلک کرتا ہے۔ بحالی ڈاؤن لوڈ کرنے سے پہلے اس وابستگی کی تصدیق کرتی ہے۔ یہ کبھی بھی موجودہ پیغام کو حاصل نہیں کرتا اور خاموشی سے ایک نئے منسلکے کو تبدیل کر دیتا ہے۔ منقطع شدہ جابز کو دوبارہ آزمایا جاتا ہے، جبکہ مستقل ناکامی ایک واضح نتیجہ رہتی ہے۔

ہر ورک اسپیس کا اپنا جرنل اور دستخطی شناخت ہوتا ہے۔ process.started ایونٹ میں رن آئی ڈی، مقامی گھڑیاں، ڈیپنڈنسی ورژنز، سورس فائل ہیشز، ابتدائی اکاؤنٹ/سکوپ، اور کیپچر سیٹنگز شامل ہوتی ہیں۔ ہارٹ بیٹس میں رن آئی ڈی، مونوٹونک ٹائم، اور قطار کی حالت شامل ہوتی ہے۔ رن رسید کو ایک علیحدہ طور پر دستخط شدہ بیان کے طور پر بھی ڈاؤن لوڈ کیا جا سکتا ہے۔ ایگزیکیوشن ماحول کی توثیق کے لیے، اسے Verification scope میں بیان کردہ GitHub attestation یا TDX چیکس کے ساتھ جوڑیں۔

خودکار چیک پوائنٹس سٹارٹ اپ پر، مشاہدہ کے دوران ہر پانچ منٹ بعد (مزید ٹولز → پیرامیٹرز → ہر بار دستخط شدہ چیک پوائنٹ)، اور منظم طور پر بند کرنے پر مقامی طور پر محفوظ کیے جاتے ہیں۔ سٹارٹ اپ کی تصدیق اور برآمد جرنل کا موازنہ تازہ ترین محفوظ شدہ مقامی چیک پوائنٹ سے کرتی ہے۔ یہ ڈیٹا بیس رول بیک کا پتہ لگا سکتا ہے جب چیک پوائنٹ برقرار رہتا ہے۔ آزادانہ برقرار رکھنے سے وہ حوالہ ورک اسپیس کے باہر دستیاب رہتا ہے؛ ایک تصدیق شدہ بیرونی ٹائم اسٹیمپ اسے اضافی طور پر وقت میں مستحکم کرتا ہے۔

ری اسٹارٹ کے بعد محفوظ شدہ ٹیلیگرام اپ ڈیٹ پوزیشن دوبارہ بحال ہو جاتی ہے (catch_up_from میں observation.started) اور رہ جانے والی اپ ڈیٹس کی درخواست کی جاتی ہے۔ محفوظ شدہ پوزیشن صرف ان اپ ڈیٹس کا احاطہ کرتی ہے جن کی کارروائی مکمل ہو چکی ہوتی ہے، لہٰذا وہ اپ ڈیٹس جو کنکشن بند ہونے یا عمل کے رکنے کے وقت زیرِ التوا تھیں، دوبارہ طلب کی جاتی ہیں۔ ایک دورانیاتی دوبارہ جانچ ریکارڈ کرتی ہے message.recovered چھوٹے ہوئے پیغامات کے لیے اور message.missing_on_recheck جب ٹیلیگرام مزید محفوظ شدہ پیغام واپس نہیں کرتا؛ دوسرا حذف کرنے کی اطلاع نہیں ہے اور نہ ہی کسی حذف کرنے والے یا وقت کا ذکر کرتا ہے۔

آف سائٹ کاپی اور بحالی (S3)#

آف سائٹ کاپی (سیٹنگز → نوٹیفیکیشنز اور آف سائٹ کاپی → آف سائٹ کاپی، یا مزید ٹولز → ایکسٹرا → شواہد اور بیک اپ؛ بطورِ ڈیفالٹ فعال) جرنل کے حصے، محفوظ شدہ فائلیں، چیک پوائنٹس کو ان کے ٹائم اسٹیمپ کے ساتھ اور مکمل چیٹ ایکسپورٹس کو S3-مطابق اسٹوریج میں اپ لوڈ کرتی ہے، اپ لوڈ سے پہلے ورک اسپیس والٹ میں محفوظ شدہ کلید کے تحت AES-256-GCM کے ساتھ انکرپٹ کیا جاتا ہے؛ آبجیکٹ لاک ریٹینشن لاگو ہوتی ہے جب بکیٹ اسے سپورٹ کرتی ہو۔ ڈاؤن لوڈ کی گئی کلید کے بغیر اس کاپی کو پڑھا نہیں جا سکتا۔ بحال کریں اور تصدیق کریں python -m tgwitness.replica restore --key-file KEY.json --out DIR کے ساتھ۔

بحالی کے لیے ایک خالی عام ڈائریکٹری درکار ہوتی ہے۔ ڈاؤن لوڈ کی گئی اور ڈی کرپٹ شدہ اشیاء نجی عارضی اسٹوریج میں تب تک رہتی ہیں جب تک پورا جریدہ اور ہر محفوظ شدہ چیک پوائنٹ کی تصدیق نہ ہو جائے۔ غیر محفوظ آبجیکٹ پاتھز، غیر مطابقت پذیر سگمنٹ رینجز اور ایک چیک پوائنٹ سے کم طویل جریدے مسترد کر دیے جاتے ہیں؛ ناکام تصدیق کے بعد کوئی بحال شدہ فائل شائع نہیں ہوتی۔ ریٹینشن چیکس واپس کیے گئے آبجیکٹ لاک موڈ اور تاریخ کا موازنہ اپ لوڈ کے وقت بھیجی گئی ڈیڈ لائن سے کرتے ہیں (گولائی کی ایک سیکنڈ تک کی رواداری کے ساتھ)۔ ایک ختم شدہ، غیر درست یا مختصر ڈیڈ لائن کو تصدیق شدہ نہیں سمجھا جاتا۔ اسٹٹس اس نمونے والے آبجیکٹ کی رپورٹ دیتا ہے جس کی ریٹینشن اس اپ لوڈ پاس کے لیے واپس پڑھی گئی تھی۔

غائب یا خراب مقامی میڈیا کو پاس کی خرابی کے طور پر رپورٹ کیا جاتا ہے اور میڈیا کرسر کو اس کے سامنے روکا جاتا ہے، تاکہ فائل کو اگلے پاس میں دوبارہ آزمایا جا سکے؛ اس کے بعد والی فائلز، چیک پوائنٹس اور ایکسپورٹس پھر بھی کاپی کیے جاتے ہیں۔ بحالی چیکس تمام محفوظ شدہ میڈیا کے حوالوں کو ڈی کرپٹ شدہ ہیشز اور ریکارڈ شدہ سائزز کے خلاف چیک کرتے ہیں۔ رکے ہوئے اپ لوڈز کے یکساں اوورلیپنگ جرنل کے حصوں کو ڈی ڈوپلیکیٹ کیا جاتا ہے؛ متصادم اوورلیپز کو مسترد کر دیا جاتا ہے۔ اپ لوڈ کے دوران بنائے گئے چیک پوائنٹس کو اس وقت تک ملتوی کر دیا جاتا ہے جب تک کہ ان کے متعلقہ جرنل ریکارڈز کی کاپی نہ ہو جائے، تاکہ ایک مکمل پاس اپنے جرنل سے آگے کوئی چیک پوائنٹ شائع نہ کرے۔

اسٹریمنگ ایکسپورٹ کے سنپ شاٹس#

اسٹریمنگ ایکسپورٹس ایک مستحکم SQLite ریڈ سنپ شاٹ استعمال کرتی ہیں۔ جب ڈاؤن لوڈ مکمل ہو جائے تو اس کا ہیڈ موجودہ لائیو جرنل سے پرانا ہو سکتا ہے۔ اس سنپ شاٹ کے بعد بنایا گیا چیک پوائنٹ درست طور پر رپورٹ کر سکتا ہے کہ آرکائیو مختصر ہے؛ ایکسپورٹ کیے گئے پری فکس پر یا اس سے پہلے کے چیک پوائنٹ سے موازنہ کریں، نہ کہ کسی من مانی بعد کے چیک پوائنٹ سے۔

RFC 3161 کی تیاری اور جواب کی تصدیق (0.2)#

ایویڈنس موڈ ہر دستخط شدہ چیک پوائنٹ کا صرف SHA-256، ورک اسپیس راستے کے ذریعے درج کردہ RFC 3161 اتھارٹیز اور اوپن ٹائم اسٹیمپس کیلنڈرز کو بھیجتا ہے، اور کبھی بھی MTProxy کے ذریعے نہیں۔ ہر سیٹ اپ گول میں ٹائم اسٹیمپس ڈیفالٹ طور پر آن ہوتے ہیں؛ ایک کیس کے لیے ایویڈنس drand کو بھی ریکارڈ کرتا ہے۔ جوابات کو checkpoints/anchors/، کو بطور .tsr اور .ots فائلوں کے تحت anchors/، اور کی طرف سے جانچ پڑتال کی جاتی ہے verify.py (--tsa-ca TSA کے دستخط کی تصدیق کرتا ہے؛ OpenTimestamps کے ثبوت کی تصدیق کرتا ہے کے ساتھ ots upgrade اور ots verify).

ایک RFC 3161 اتھارٹی جو لگاتار دو بار ناکام ہوتی ہے، اگلی کوشش سے پہلے انتظار کرتی ہے: ایک وقفہ، پھر دو، چار اور اسی طرح بڑھتے ہوئے چھ گھنٹے تک، یا جب تک اس کا Retry-After کہتا ہے، ایک دن تک۔ ایک پاس جو صرف انتظار کرنے والی اتھارٹیز کو تلاش کرتا ہے کوئی ریکارڈ نہیں لکھتا؛ ورنہ anchor.completed انہیں deferred کے تحت retry_at کے ساتھ درج کرتا ہے۔ جب تک وہ دوبارہ جواب نہیں دیتیں، پینل ٹائم اسٹیمپ کو Degraded کے طور پر دکھاتا ہے۔

پینل ایک درخواست کا آرکائیو تیار کرتا ہے جس میں معیاری checkpoint.json بائٹس، ایک SHA-256 پیغام کا نشان اور timestamp.tsq میں بے ترتیب نونس، چیک سمز، اور ہدایات شامل ہوتی ہیں۔ کوئی نیٹ ورک درخواست نہیں کی جاتی؛ اس درخواست کے لیے اتھارٹی جو ٹوکن واپس کرتی ہے وہ ٹائم اسٹیمپ ہے۔

python -m tgwitness.anchor verify جواب کو چیک پوائنٹ بائٹس اور اصل درخواست کے مقابل OpenSSL کے بغیر جانچتا ہے۔ قابلِ اعتماد CA فائل واضح طور پر دینا ضروری ہے؛ شامل سرٹیفکیٹ خود بخود قابلِ اعتماد نہیں مانے جاتے۔ CLI میں درخواست کی جانچ اختیاری ہے، اس لیے درخواست محفوظ رکھیں اور nonce جانچنے کے لیے --request دیں۔ نتیجہ بتاتا ہے کہ آیا اسے جانچا گیا۔ کلیکٹر کے چیک پوائنٹ کے دستخط اور جرنل کی تصدیق پھر بھی قابلِ اعتماد کلیکٹر فنگر پرنٹ سے الگ کرنی ہوگی۔

تصدیق جواب کے سگنیچر، چیک پوائنٹ بائٹس اور، جب فراہم کیا جائے، مخصوص CA ٹرسٹ کے تحت اصل درخواست کی جانچ کرتی ہے۔ ثبوت کے موڈ میں حاصل کردہ ٹائم اسٹیمپ کے لیے verify.py محفوظ شدہ OCSP یا CRL ثبوت (دستخط کرنے والے سرٹیفیکیٹ کی منسوخی) کی بھی جانچ کرتا ہے۔ دیکھیں طریقہ کار اور تصدیقی نتائج۔

شہادت کے موڈ میں اختیاری ریکارڈز: drand اور Telegram ڈیوائسز#

دو مزید ریکارڈز ٹائم اسٹیمپز کے اسی پاسز پر چل سکتے ہیں۔ یہ دونوں صرف تب اثر کرتے ہیں جب ایویڈنس موڈ آن ہو۔ کیس کے لیے ثبوت ڈرانڈ آن کر دیتا ہے؛ ورنہ دونوں شروع ہو جاتے ہیں۔ انہیں More tools → Extras → Evidence & backups → More witnesses · optional کے تحت تبدیل کریں، یا "drand": true اور "devices": true میں POST /api/evidence۔ ایک خرابی دوسرے یا ٹائم اسٹیمپ کو نہیں روکتی؛ پینل فارم کے نیچے ہر ایک کے تازہ ترین نتائج دکھاتا ہے۔

drand (beacon.drand ). ہر پاس drand quicknet کے تازہ ترین راؤنڈ کو لکھتا ہے، جو لیگ آف اینٹروپی کی عوامی بے ترتیبی ہے (ہر 3 سیکنڈ میں ایک راؤنڈ)، جرنل میں: chain ، round ، randomness ، signature ، round_time اور وہ relay جس نے جواب دیا۔ ایک تصدیق شدہ غیر متوقع راؤنڈ بعد کے ہیش-لنکڈ مواد کے لیے ایک نچلا وقتی حوالہ فراہم کرتا ہے۔ بعد کے چیک پوائنٹ پر ایک تصدیق شدہ ٹائم اسٹیمپ ایک اعلیٰ زمانی حوالہ فراہم کرتا ہے۔ یہ چیکز منسلک مواد کو محدود کرتے ہیں۔ کلیکٹر پہلے drand.cloudflare.com سے پوچھتا ہے، پھر ورک اسپیس راستے کے ذریعے پروٹوکول لیبز کے ریلیز سے، ہر پاس میں ایک درخواست۔

verify.py یہ چیک کرتا ہے کہ ہر بے ترتیب پن اپنے دستخط کا SHA-256 ہے اور راؤنڈ کا وقت درست ہے، اور راؤنڈز، ایک کے بغیر سب سے طویل وقفہ اور کلیکٹر کی گھڑی drand سے کتنی پیچھے تھی، رپورٹ کرتا ہے۔ --check-drand راؤنڈز کا موازنہ Cloudflare ریلے اور Protocol Labs ریلے کے ساتھ کرتا ہے، ان سب کے ساتھ یا ایک طویل جریدے میں 100 کے بے ترتیب نمونے کے ساتھ؛ اگر کوئی راؤنڈ مختلف ہو تو توثیق ناکام ہو جاتی ہے۔

Telegram ڈیوائسز (account.devices). ہر پاس اکاؤنٹ کے سیشنز کو پڑھتا ہے account.getAuthorizations، وہ فہرست جو ٹیلیگرام سیٹنگز → ڈیوائسز میں دکھاتا ہے، اور اسے ریکارڈ کرتا ہے: پوری طرح جب یہ پچھلی پاس کے بعد تبدیل ہوئی ہو، کے ساتھ added اور removed سیشن ہیشز، ورنہ صرف اس کی گنتی اور SHA-256۔ ڈیوائس ماڈل، پلیٹ فارم، ایپ اور ورژن، تخلیق اور آخری سرگرمی، ملک اور خطہ محفوظ رکھا جاتا ہے؛ IP پتے نہیں، کیونکہ شواہد کی برآمدات آپ کے ہاتھ سے نکل جاتی ہیں۔ جمع کرنے والا اپنا سیشن ہر وقت فعال رکھتا ہے، لہٰذا صرف دوسرے سیشنز کی سرگرمی کو تبدیلی کے طور پر شمار کیا جاتا ہے۔ verify.py یہ رپورٹ کرتا ہے کہ فہرست کتنی بار ریکارڈ کی گئی اور ہر نئے اور ختم ہونے والے سیشن کے بارے میں۔ یہ فہرست صرف تب پڑھتا ہے جب مشاہدہ چل رہا ہو۔

وہ جو دکھاتے ہیں: drand ریکارڈز کو عوامی وقت کے مطابق ترتیب دیتا ہے، اور ڈیوائس فہرست کلیکٹر کے ذریعے ٹیلیگرام کا بیان ہے، جو ہر دوسرے ریکارڈ کی طرح کلیکٹر کے ذریعے دستخط شدہ ہے۔

Cloudflare گیٹ وے لاگ (cloudflare.gateway_dns). ایک سرور کے لیے جو Cloudflare Gateway (Gateway DNS) کے ذریعے حل کرتا ہے، ہر پاس اس کا نقل کرتا ہے جو Gateway نے پچھلی نقل کے بعد لاگ کیا ہے: ہر تین گھنٹے کے زیادہ سے زیادہ ونڈو کے لیے ایک ریکارڈ کے ساتھ from, until، سرور کا location_id، سرور کا address جب ایک سیٹ ہو، اور queries کی طرح [at, name, type, rcode, decision, colo]، نیز جب کوئی نہ ہوں۔ اسے Cloudflare Gateway لاگ کے تحت سیٹ کریں: اکاؤنٹ، مقام، اختیاری پتہ اور ایک ریڈ-ونلی ٹوکن (اکاؤنٹ اینالیٹکس ریڈ؛ شیئرڈ لوکیشن کے ایک پتہ کو محفوظ رکھنے کے لیے زیرو ٹرسٹ PII ریڈ)۔ پینل محفوظ کرنے سے پہلے ایک درخواست کے ساتھ ان کی تصدیق کرتا ہے؛ ٹوکن انکرپٹڈ رہتا ہے اور کبھی جرنل میں داخل نہیں ہوتا۔ verify.py ونڈوز کی فہرست دیتا ہے، وہ نام جو سب سے زیادہ تلاش کیے گئے اور کوئی بھی وقت جب کوئی کاپی موجود نہیں ہوتی؛ ایک ریکارڈ جس کی گنتی اس کے سوالات سے میل نہیں کھاتی، ناکام ہو جاتا ہے۔ ایک ونڈو جو ایک سیکنڈ میں ایک سے زیادہ صفحات کے سوالات رکھتی ہے، اس صفحے کو برقرار رکھتی ہے اور کہتی ہے کہ باقی غائب ہیں۔ کاپی ہے کلوڈ فلئیر کا جواب کلیکٹر کے ذریعے، کلیکٹر کے دستخط شدہ؛ 24 گھنٹوں کے اندر کوئی بھی جس کے پاس ریڈ-اونلی ٹوکن ہو اسے کلوڈ فلئیر کے ساتھ موازنہ کر سکتا ہے۔