دستاویزات / 02
Telegram · GitHub Actions کی گرفت
عارضی GitHub رنر پر Takeout, عام API ایکسپورٹ یا چیٹ جرنل منتخب کریں.
مکمل حوالہ
ٹی جی وٹنس / دستاویزات · آزاد گرفتاری
main سے پیش نظارہ دستیاب ہے۔ ایک فورک ایک پن کیے گئے دوبارہ استعمال کے قابل ورک فلو کو لانچ کرتا ہے
phishdestroy/TgWitness. یہ ورک فلو ایک نئے بنائے گئے ٹیلیگرام سیشن کے ذریعے اکاؤنٹ، منتخب چیٹس یا ایک چیٹ کے ایونٹ جرنل کو ایکسپورٹ کرتا ہے، ثبوت (ZIP یا ملٹی پارٹ منیفیسٹ) کی تصدیق کرتا ہے، اور صرف وصول کنندہ کے خفیہ کردہ ہینڈآفسز کو اپ لوڈ کرتا ہے۔ عام انتظامی پینل ظاہر نہیں ہوتا۔
منتخب کریں client=official_web سرکاری کلائنٹ ویٹنس کو محفوظ ٹیلیگرام ویب کنٹرولز اور ویڈیو کے ساتھ چلانے کے لیے۔ اس کے لیے آپ کی اپنی اپ اسٹریم پراکسی درکار ہے اور یہ ایک رینڈر کی گئی چیٹ کا مشاہدہ کرتا ہے۔ ڈیفالٹ client=api مندرجہ ذیل میں بیان کردہ مکمل اکاؤنٹ ایکسپورٹ موڈز کو برقرار رکھتا ہے۔
تصدیق کنندہ آرکائیو کی اس کے گٹ ہب تصدیق نامے، منظور شدہ ورک فلو اور کلیکٹر کے کمٹس، اور دستخط شدہ جرنل اور منسلک ہیشز کے ساتھ جانچ کرتا ہے۔ جمع کرنے کے عمل میں پن کیے گئے اپ اسٹریم کوڈ اور تازہ اسٹوریج استعمال ہوتی ہے۔ ایک جائزہ لینے والا اس کوڈ کا معائنہ کر سکتا ہے اور فراہم کردہ آرکائیو کی اس کے ریکارڈ شدہ رن کے خلاف تصدیق کر سکتا ہے۔
اس صفحے پر
صارف کے بہاؤ#
مددگار پانچ مراحل کی وضاحت کرتا ہے اور آپ کو نمونہ ڈیٹا پر پیغام یا کلیکٹر کی تبدیلی آزمانے دیتا ہے۔ 'میری کیپچر شروع کریں' وِزارڈ کھولتا ہے۔
- پروجیکٹ کے ہوم پیج، ورک اسپیس لاگ ان اسکرین، یا Exports → Open capture helper پر GitHub Actions کیپچر (پریویو) کا انتخاب کریں۔ آپ ایک جدید براؤزر میں ایک معتبر چیک آؤٹ سے سرکاری ہیلپر یا
tgwitness/static/capture.htmlبھی کھول سکتے ہیں۔ ہیلپر کلید یا فائل پراسیسنگ کے لیے کوئی نیٹ ورک درخواست نہیں کرتا۔ ہیلپر سائٹ کے انٹرفیس زبانوں کی حمایت کرتا ہے؛ عارضی کلیکشن پینل انگریزی اور روسی کو سپورٹ کرتا ہے اور جب براؤزر کی زبان ان میں سے ایک ہو تو اسی زبان میں کھلتا ہے۔ - ایک کلید تیار کریں اور sealed-key.json محفوظ کریں۔ یہ واحد نجی ڈی کرپشن کلید ہے۔ الگ عوامی وصول کنندہ کی قدر کاپی کریں۔ نجی کلید کھو جانے سے کنکشن اور آرکائیو دونوں تک رسائی ختم ہو جائے گی۔ اگلے مرحلے کو انلاک کرنے کے لیے تصدیق کریں کہ آپ نے اسے محفوظ کر لیا ہے۔ اگر آپ کے پاس پہلے سے ہی ڈیلیوری فائل موجود ہے تو محفوظ شدہ کلید لوڈ کریں اور میرے پاس پہلے سے آرکائیو موجود ہے کا انتخاب کریں۔
- Fork TgWitness کریں، فورک میں Actions کو فعال کریں، اور Sealed chat capture چلائیں۔ عوامی وصول کنندہ کو پیسٹ کریں اور 30، 60، یا 120 منٹ منتخب کریں۔ کبھی بھی فون نمبر، لاگ ان کوڈ، Telegram پاس ورڈ، پرائیویٹ کی، یا سیشن کو ورک فلو ان پٹس، کمٹس، ایشوز، یا لاگز میں شامل نہ کریں۔
- چلانے کے دوران، Artifacts سے sealed-connection ڈاؤن لوڈ کریں اور اسے ان زپ کریں۔
لوڈ کریں
connection.tgwsealedہیلپر میں محفوظ نجی کلید استعمال کریں۔ نتیجے میں بننے والا لنک اپنے URL کے فرگمنٹ میں ایک بے ترتیب رسائی راز (secret) رکھتا ہے۔ اس لنک کو نجی رکھیں۔ پینل فرگمنٹ کو ہٹا دیتا ہے اور راز کو اس ٹیب کے سیشن اسٹوریج میں محفوظ رکھتا ہے؛ یہ HTTP رسائی لاگز میں شامل نہیں ہوتا۔ - کنکشن لنک کھولیں۔ QR کوڈ کے ذریعے سائن ان کریں، یا اپنا فون نمبر اور لاگ ان کوڈ استعمال کریں۔ اگر ٹیلیگرام دو مرحلوں کی تصدیق کا پاس ورڈ مانگے تو اسے درج کریں۔ بلٹ ان API کریڈنشل پول بطورِ ڈیفالٹ استعمال ہوتا ہے، بالکل عام ورک اسپیس کی طرح۔ آپ اختیاری کسٹم کریڈنشلز سیکشن کو کھول کر دونوں درج کر سکتے ہیں۔
api_idاورapi_hashmy.telegram.org/apps سے۔ بلٹ ان پول استعمال کرنے کے لیے دونوں فیلڈز کو خالی چھوڑ دیں؛ جزوی یا غلط جوڑا مسترد کر دیا جاتا ہے۔ سیشن امپورٹس کی اجازت نہیں ہے۔ ایکسپورٹ موڈ اور اسکوپ منتخب کریں۔ کنکشن لنک میں ایک ایکسس سیکرٹ ہوتا ہے: اسے نجی رکھیں۔ - Telegram Takeout، ریگولر Telegram API یا Chat ایونٹ جرنل منتخب کریں۔ اکاؤنٹ ایکسپورٹ کے لیے، تمام قابل رسائی چیٹس منتخب کریں یا لوڈ کر کے ایک یا زیادہ چیٹس منتخب کریں، پھر تاریخیں، چیٹ کی اقسام، اکاؤنٹ کی زمروں اور اٹیچمنٹ کے قواعد طے کریں۔ سیٹنگز اور سائز چیک کریں، اختیاری طور پر ایک آزاد جائزہ لینے والے کے لیے سیٹنگز JSON محفوظ کریں، پھر اسٹارٹ کیپچر دبائیں۔ شروع کرنے کے بعد سیٹنگز مستقل ہو جاتی ہیں۔ ری سمی شروع صرف اس وقت کام کرتی ہے جب یہ رنر موجود ہو؛ جلدی ختم کرنے سے حاصل شدہ ڈیٹا محفوظ رہتا ہے اور خالی جگہوں کو ریکارڈ کیا جاتا ہے۔ شروع کرنے کے بعد ڈیڈ لائن ختم ہونے سے واضح طور پر جزوی آرکائیو بنتا ہے؛ شروع کرنے سے پہلے ختم ہونے یا منسوخی کی صورت میں کوئی آرکائیو نہیں بنتا۔
- سیلڈ-ریزلٹ کے لیے انتظار کریں، اسے ڈاؤن لوڈ اور ان زپ کریں، اور ڈیکریپٹ کریں۔
delivery.tgwsealedہیلپر میں۔ آپ کو موصول ہوتا ہےdelivery.zip، جس میں شامل ہےevidence.zip,attestation.jsonl، اور ہدایات۔ براؤزر کی ڈیکرپشن 256 MiB تک محدود ہے؛ بڑے پیکجز نیچے دیے گئے اسٹریمنگ لوکل کمانڈ کا استعمال کرتے ہیں۔ بڑے نتائج میں بھی شامل ہیںdelivery-NNNNNN.tgwsealedحصے؛ مرکزیdelivery.tgwsealedپھر پر مشتمل ہوتا ہےevidence.parts.jsonاور تصدیق۔ ہر حصہ ڈاؤن لوڈ کریں اور نیچے بیان کردہ طریقے کے مطابق مقامی طور پر جوڑیں۔ - اگر منسوخی کی تصدیق نہ ہوئی ہو یا رنر ختم ہو گیا ہو تو ٹیلیگرام سیٹنگز → ڈیوائسز میں عارضی سیشن ختم کریں۔ معمول کی تکمیل کی درخواستیں لاگ آؤٹ کر دیتی ہیں، اور رن یہ ریکارڈ کرتا ہے کہ منسوخی کی تصدیق ہوئی تھی یا نہیں۔
ریپوزیٹری میں شائع شدہ پن کیا گیا سورس اور قابلِ استعمال ورک فلو کے کمِٹس شامل ہونے چاہئیں۔ صرف ایک مقامی برانچ کو دوسری گٹ ہب ریپوزیٹری کے ذریعے کال نہیں کیا جا سکتا۔
اجلاس کے وقت کا بجٹ#
جمع کرنے سے پہلے وقت اور سائز کا حساب لگائیں۔ پیغامات کی تعداد اور ایک محدود نمونے کی بنیاد پر منتخب کردہ تاریخ اور فائلوں کا تخمینہ لگاتا ہے۔ ڈسپلے میں سائن ان کرنے میں پہلے ہی صرف ہونے والا وقت، تخمینی کلیکشن کا وقت اور پیکیجنگ کے لیے ایک ریزرو شامل ہے۔ فائلوں کے لیے، ابتدائی تخمینہ 1 MiB/s اور دوگنا وقت کے مارجن کا استعمال کرتا ہے؛ پیش رفت اس مفروضے کو ناپی گئی شرح سے بدل دیتی ہے۔ استعمال کریں صرف پیغامات یا جب تخمینہ باقی وقت سے زیادہ ہو تو کم چیٹس منتخب کریں۔
ٹیلیگرام کے رپورٹ شدہ ٹیک آؤٹ انتظار کو بجٹ میں شامل کیا جاتا ہے۔ کلیکٹر حصول کو روک دیتا ہے جب باقی ماندہ وقت پیکیجنگ کے لیے درکار ہو، حاصل کردہ ڈیٹا کو برقرار رکھتا ہے اور جزوی نتیجہ نشان زد کرتا ہے۔ لہٰذا ایک 120 منٹ کا سیشن آرکائیو تیار کرنے سے پہلے ڈیڈ لائن کا انتظار کرنے کے بجائے اپنی باقی ماندہ کلیکشن ونڈو استعمال کرتا ہے۔ ڈسپلے ان انتخابوں کی نشاندہی کرتا ہے جن کے مکمل سائز کا نمونہ نہیں لیا جا سکا۔
اس موڈ یا ایک مستقل ورک اسپیس منتخب کریں۔
| قید کرنے کا موڈ | تشکیل پذیر دائرہ | فرق |
|---|---|---|
| ٹیلیگرام ٹیک آؤٹ، ڈیفالٹ | تمام قابل رسائی کلاؤڈ چیٹس یا منتخب چیٹس، تاریخیں، اکاؤنٹ کی زمروں، میڈیا پالیسیاں اور JSON/HTML ویوز | Telegram کے سرکاری ایکسپورٹ میکنزم کا استعمال کرتا ہے؛ منظوری یا انتظار ضروری ہو سکتا ہے۔ Takeout ان بائیں چینلز/گروپس کی فہرست بنا سکتا ہے جہاں Telegram اجازت دیتا ہے اور اضافی ذاتی ڈیٹا کی درخواست کر سکتا ہے۔ |
| معمولی ٹیلیگرام API | اکاؤنٹ کے دائرہ کار اور آؤٹ پٹ کے انتخاب وہی ہیں، جو باقاعدہ API کے ذریعے دستیاب طریقوں کے تابع ہیں۔ | Takeout کو ابتدائی طور پر فعال نہیں کرتا؛ بائیں چینلز/سپر گروپس کی فہرست نہیں نکالی جا سکتی اور نہ ہی صرف Takeout سے متعلق ذاتی ڈیٹا حاصل کیا جا سکتا ہے۔ رابطے مکمل محفوظ شدہ فون رابطہ فہرست کے بجائے Telegram صارفین کو کور کرتے ہیں۔ ریٹ لمیٹس اب بھی لاگو ہیں۔ |
| چٹ ایونٹ جرنل | ایک منتخب چیٹ، منسلکات کی پالیسیاں اور اختیاری اوتار | اس چلانے کے دوران دیکھی گئی تاریخ اور تبدیلیاں محفوظ کرتا ہے۔ اکاؤنٹ کی زمروں، تاریخ کے فلٹرز اور ڈیسک ٹاپ کے مطابق ویوز لاگو نہیں ہوتے۔ |
تمام تینوں موڈز میں ایک ہی GitHub تصدیق اور خفیہ شدہ ترسیل ہوتی ہے۔ Takeout حصول کا طریقہ منتخب کرتا ہے اور اسے کبھی بھی خاموشی سے معمول کی API رسائی سے تبدیل نہیں کیا جاتا۔ TgWitness پکڑے گئے ریکارڈز سے JSON/HTML ویوز تیار کرتا ہے اور برآمد میں منتخب کردہ حصول کے طریقہ کو محفوظ رکھتا ہے۔ سرکاری Takeout API دیکھیں۔
ڈیفالٹس میں ٹیک آؤٹ، تمام قابلِ رسائی چیٹ اقسام بشمول آرکائیو شدہ چیٹس، تمام تاریخیں، اکاؤنٹ پروفائل اور رابطے، مطابقت پذیر JSON اور HTML، اور فائل ڈاؤن لوڈز شامل ہیں۔ ابتدائی میڈیا بجٹ 4 GiB ہے، جس میں ہر قسم کے لیے ظاہر ہونے والی فائل حدود ہیں؛ بڑی فائلوں یا ختم شدہ ڈاؤن لوڈ بجٹ کے لیے دستیاب ہونے پر سرور ہیشز استعمال کیے جاتے ہیں۔ جمع کرنے سے پہلے ان حدود کا جائزہ لیں۔ ہیشز ایک فائل کو دوبارہ تشکیل نہیں دے سکتے۔ اختیاری تصاویر، کہانیاں، سیشن میٹا ڈیٹا اور اضافی ذاتی ڈیٹا الگ الگ اختیارات کے طور پر رہتے ہیں۔
ٹیک آؤٹ کے لیے ایک قائم شدہ ٹیلیگرام سیشن میں منظوری درکار ہو سکتی ہے۔ ٹیلیگرام تاخیر مقرر کرتا ہے؛ نیا لاگ ان یا رنر اسے بائی پاس نہیں کرتا۔ زیادہ سے زیادہ کیپچر ونڈو لاگ ان اور منظوری سمیت 120 منٹ ہے، لہٰذا ایک بڑا اکاؤنٹ یا طویل منظوری کا انتظار مکمل نہیں ہو سکتا۔ ایک مستقل مقامی ایکسپورٹ اسی سیشن کو دوبارہ شروع کر سکتا ہے، لیکن یہ گٹ ہب کی تصدیق کو وراثت میں نہیں پاتا۔
سیٹنگز سے اتفاق کریں اور تصدیق کریں۔
سیٹنگز اور سائز چیک کرنے کے بعد، تصدیق کے لیے سیٹنگز محفوظ کریں۔ متفق
نتیجے کے sealed-export-settings.json جمع کرنے سے پہلے جائزہ لینے والے کے ساتھ۔
تبدیلیاں محفوظ شدہ تشخیص کو کالعدم کر دیتی ہیں۔ کلیکٹر مؤثر ترتیبات اور ان کے SHA-256 پر دستخط کرتا ہے، اور اکاؤنٹ-ایکسپورٹ رسیدیں انہی اختیارات کو پابند کرتی ہیں۔
تصدیق کنندہ اصل موڈ، انتخاب اور مکمل ہونے کی رپورٹ کرتا ہے، اور جرنل اور نیسٹڈ اکاؤنٹ ایکسپورٹ کے درمیان عدم مطابقت کو مسترد کر دیتا ہے۔
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete
--expected-selection ایک مختلف ٹرانسپورٹ، چیٹ اسکوپ، فلٹر یا اٹیچمنٹ پالیسی کو مسترد کرتا ہے۔ --require-complete صرف اکاؤنٹ ایکسپورٹس اور چیٹ جرنلز کو قبول کرتا ہے جو مکمل کے طور پر ریکارڈ کیے گئے ہوں۔ ان فلیگز کے بغیر، توثیق پھر بھی ماخذ اور سالمیت کی جانچ کرتی ہے، جبکہ ریکارڈ شدہ ترتیبات اور خامیوں کی رپورٹنگ کرتی ہے۔ رن سے پہلے متوقع انتخاب پر اتفاق کریں اور اسے آرکائیو سے الگ رکھیں۔ دائرہ کار اور حصول کے وقفے رن کے دوران حاصل کردہ مواد کی شناخت کرتے ہیں؛ پچھلے ورژنز کا موازنہ کرتے وقت پہلے سے محفوظ شدہ مشاہدات استعمال کریں۔
| ضرورت | موڈ |
|---|---|
| ایک محدود سیشن کے دوران قابل رسائی اکاؤنٹ کا ڈیٹا یا منتخب چیٹس برآمد کریں اور جائزہ لینے والے کو بیرونی طور پر تصدیق شدہ آرکائیو فراہم کریں۔ | GitHub ایکشنز کیپچر (پریویو) |
| متعدد چیٹس کو مسلسل ملاحظہ کریں، اکاؤنٹس کا انتظام کریں، بڑھتے ہوئے آرکائیو کو تلاش کریں اور پڑھیں۔ | مقامی یا ڈاکر ورک اسپیس |
یہ ایک نئے لاگ ان کے ساتھ ایک علیحدہ کیپچر شروع کرتا ہے۔ یہ آپ کے موجودہ مقامی جرنل کو اپ لوڈ نہیں کرتا، موجودہ کھلے ورک اسپیس کو ایکسپورٹ نہیں کرتا، یا اس کے ٹیلیگرام سیشن کو دوبارہ استعمال نہیں کرتا۔ ایک نامکمل کلاؤڈ کیپچر اپنے رنر کے ختم ہونے کے بعد دوبارہ شروع نہیں کیا جا سکتا؛ ایک نیا ورک فلو ایک نیا کیپچر شروع کرتا ہے۔
ورک اسپیس کا Exports → اوپن کیپچر ہیلپر پینل کے اندر مکمل وزرڈ کھولتا ہے۔ اسٹینڈالون صفحہ بھی اسی وزرڈ، کنٹرولز اور تھیمز کا استعمال کرتا ہے۔ دونوں آپ کے براؤزر میں کیز اور ڈی کرپشن کو برقرار رکھتے ہیں۔ گٹ ہب ورک فلو کا آغاز اور عارضی ٹیلیگرام پینل الگ ٹیبز میں کھلتے ہیں؛ وزرڈ آپ کو بتاتا ہے کہ کب واپس آنا ہے۔ ورک اسپیس کو لاک کرنے سے وزرڈ کی ان-میوری کی صاف ہو جاتی ہے۔ آپ کی محفوظ شدہ کی فائل آپ کے ڈیوائس پر ہی رہتی ہے۔
کیا عوامی ہے، اور کیا نجی رہنا چاہیے؟
کلیکشن ایک معیاری گٹ ہب ہوسٹڈ رنر پر چلتی ہے۔ گٹ ہب، منظور شدہ کلیکٹر اور ڈیپنڈنسیز، ہیلپر پیج، براؤزر اور HTTPS ٹنل اس سیٹ اپ کے قابلِ اعتماد حصے ہیں۔ عارضی ہوسٹ ٹیلیگرام سیشن اور پلین ٹیکسٹ پیغامات کو پراسیس کرتا ہے؛ فراہم کردہ آرتفیکٹس وصول کنندہ کے لیے انکرپٹڈ ہوتے ہیں۔
فورکنگ پروجیکٹ کوڈ کو آپ کی ریپوزیٹری میں کاپی کرتی ہے۔ یہ آپ کے ٹیلیگرام اکاؤنٹ کو ایکسپورٹ نہیں کرتی۔ وصول کنندہ ورک فلو ان پٹ ایک عوامی انکرپشن کلید ہے۔ محفوظ رکھیں sealed-key.json، ٹیلیگرام کی اسناد، لاگ ان کوڈز، 2FA پاس ورڈز اور ڈی کرپٹ شدہ کنکشن URL کو کمٹس، ورک فلو ان پٹس اور پبلک لاگز سے دور رکھیں۔
ورک فلو ایک دن کے لیے انکرپٹڈ کنکشن/نتائج کے آرٹیفیکٹس شائع کرتا ہے۔ وقت پر دونوں کو ڈاؤن لوڈ کریں؛ GitHub Actions کی دستیابی، اکاؤنٹ کی حدیں اور بلنگ لاگو ہوں گے۔ ایک پبلک فورک لامحدود مفت کمپیوٹ کا وعدہ نہیں ہے۔ کوئی ادائیگی یا GitHub ایکسس ٹوکن ہیلپر میں درج نہیں کیا جاتا۔
نجی ڈی کرپشن کلید آپ کے براؤزر/فائل میں رہتی ہے۔ ٹیلیگرام سیشن کا مواد اور پلین ٹیکسٹ مشاہدات لازماً عارضی کلیکٹر کے اندر موجود ہوتے ہیں۔ گٹ ہب اور HTTPS ٹنل قابل اعتماد انفراسٹرکچر کے طور پر برقرار رہتے ہیں۔ تصدیق آرکائیو ڈائجسٹ اور ورک فلو شناخت کو عوامی کر سکتی ہے؛ آرکائیو کا مواد تصدیق میں شامل نہیں کیا جاتا۔ تصدیق کا ٹائم اسٹیمپ پیغام کا ٹائم اسٹیمپ نہیں ہوتا۔
حلِ مسائل#
| علامت | اگلا قدم |
|---|---|
| نو رن ورک فلو بٹن | اپنا فورک کھولیں، ایکشنز کو فعال کریں، اور اسے اپ اسٹریم کے ساتھ ہم آہنگ کریں۔ mainناکامی کو بائی پاس کرنے کے لیے منظور شدہ اپ اسٹریم پنز میں ترمیم نہ کریں۔ |
نہیں sealed-connection نُسخہ |
چیک کریں کہ آیا کام نے اپنا آغاز/اپلوڈ مرحلہ شروع کیا اور مکمل کیا ہے۔ قطار، رنر، امیج ڈاؤن لوڈ، سرنگ یا ریپوزیٹری پالیسی کی ناکامیاں آغاز کو روک سکتی ہیں۔ |
| کنکشن کھول نہیں جا سکتا | اس رن کے لیے محفوظ شدہ کلید لوڈ کریں، ڈاؤن لوڈ کردہ آرٹیفیکٹ کو ان زپ کریں اور منتخب کریں connection.tgwsealedرنر کو اب بھی فعال ہونا چاہیے۔ |
| تاریخ رک گئی ہے | پینل کی حالت چیک کریں اور جب تک سیشن فعال ہو، Resume استعمال کریں، یا پہلے سے جمع شدہ ڈیٹا کے ساتھ ختم کر دیں۔ ٹیلیگرام کی حدیں اور ناقابل رسائی مواد خلا چھوڑ سکتے ہیں۔ |
نہیں sealed-result |
جمع شروع کرنے سے پہلے منسوخی یا میعاد ختم ہونے پر کوئی آرکائیو تیار نہیں ہوتا؛ اس کے بعد عمل 'کوئی آرکائیو نہیں' کے نوٹس کے ساتھ ختم ہو جاتا ہے۔ ناکام جمع، تصدیق یا پیکیجنگ کے مرحلے بھی ترسیل کو روکتے ہیں؛ ناکام مرحلہ نگران کی وجہ بغیر ذاتی ڈیٹا کے بتاتا ہے۔ اسے شناختی دستاویزات درج کیے بغیر ہی معائنہ کریں۔ |
| براؤزر ایک بڑے آرکائیو کو ڈیکرپٹ نہیں کر سکتا۔ | 256 MiB سے بڑے پیکجز کے لیے نیچے دیے گئے اسٹریمنگ CLI کا استعمال کریں۔ غلط یا گمشدہ نجی کلید نتیجہ کو ڈیکریپٹ نہیں کر سکتی۔ |
| تصدیق دستخط کنندہ کو مسترد کرتی ہے۔ | ایک معتبر موجودہ TgWitness انسٹالیشن اور بالکل درست کالر استعمال کریں۔ OWNER/REPOSITORYآرکائیو کے ساتھ فراہم کردہ متبادل پالیسی قبول نہ کریں۔ |
| ٹیلیگرام اب بھی عارضی سیشن کو فہرست میں دکھاتا ہے۔ | اسے سیٹنگز → ڈیوائسز میں ختم کریں۔ لاگ آؤٹ ناکام ہو سکتا ہے اور زبردستی ختم کیا گیا ورک فلو صفائی نہیں کر سکتا۔ |
اس پیش نظارہ پر انحصار کرنے سے پہلے، ایک چھوٹی سی گفتگو آزمائیں جسے آپ کنٹرول کرتے ہیں: ایک پیغام اور منسلکہ بنائیں، انہیں جمع کریں، نتیجہ کو ڈیکریپٹ کریں، ویریفائر چلائیں، کوریج/میڈیا کے نتائج چیک کریں اور ٹیلیگرام سیشن کی منسوخی کی تصدیق کریں۔ خودکار چیکس میں ایک مصنوعی ٹیلیگرام کلائنٹ اور ایک الگ حقیقی گٹ ہب سرٹیفیکیٹ ٹیسٹ استعمال ہوتا ہے؛ موجودہ نظر ثانی میں کسی بھی لائیو اکاؤنٹ کے چلانے کا ریکارڈ نہیں ہے۔
مقامی ڈی کرپشن اور تصدیق
ایک آزاد اور معتبر انسٹالیشن سے فراہم کردہ ٹولز استعمال کریں، نہ کہ نامعلوم ذریعہ سے حاصل کردہ قابلِ عمل فائلیں:
python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip
# Unzip delivery.zip using your archive manager, then:
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
کثیر حصوں والی ترسیل کے لیے، پہلے مرکزی پیکیج کو ڈیکریپٹ کریں اور اس کے نکالے گئے مینیفیسٹ کو ہر انکرپٹڈ حصے کے ساتھ رکھیں، پھر چلائیں:
python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip
python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
مینفیسٹ تصدیق شدہ موضوع ہے اور ہر حصے اور مرتب شدہ ZIP کو باندھتا ہے۔
استعمال کریں --max-gib بڑے آرکائیو کے لیے مناسب غیر کمپریسڈ تصدیقی حد مقرر کرنے کے لیے؛ ڈیفالٹ 4 GiB ہے۔ Expected-selection اور complete-scope چیکس بھی کثیر حصوں والی ترسیل کے ساتھ کام کرتے ہیں۔
Python 3.11+، پروجیکٹ کی انحصارات، اور ایک حالیہ GitHub CLI جو سپورٹ کرتی ہے
--signer-digest اور --deny-self-hosted-runners درکار ہیں۔ ایک CLI کلید جنریٹر بھی دستیاب ہے: python -m tgwitness.sealed_crypto keygen sealed-key.json.
تصدیق کنندہ استعمال کرتا ہے tgwitness/sealed_policy.json بھروسے مند تنصیب سے۔
یہ کالر ریپوزیٹری، اپ اسٹریم سگنر ورک فلو، منظور شدہ سگنر کمٹ، ہوسٹڈ رنر کی ضرورت، مکمل ZIP ڈائجسٹ، اندرونی جرنل اور منسلک کی سالمیت، تازہ اکاؤنٹ-کی کا آغاز، اور متوقع کلیکٹر کمٹ کی جانچ کرتا ہے۔
یہ اس بات کا اشارہ دینے کے بجائے کہ تمام ڈیٹا محفوظ ہو گیا ہے، تاریخ اور میڈیا کے نتائج دکھاتا ہے۔
ایک خالی منظور شدہ ریلیز فہرست بندش کا باعث بنتی ہے۔ پالیسی کو اپ ڈیٹ کرنا ایک واضح اعتماد کا فیصلہ ہے؛ کبھی بھی کسی آرکائیو کی اپنی تجویز کردہ پالیسی کو خودکار طور پر قبول نہ کریں۔
آف لائن استعمال کے لیے، پہلے سے ایک قابلِ اعتماد ماحول سے قابلِ اعتماد روٹس حاصل کریں:
gh attestation trusted-root > trusted_root.jsonl
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl
تصدیق کا ٹائم اسٹیمپ آرکائیو کے عزم سے متعلق ہے۔ یہ پیغام کے ٹائم اسٹیمپ یا کلیکٹر کی وال کلاک کی تصدیق نہیں کرتا۔ GitHub کے تصدیقی اختیارات دیکھیں۔
چنگال کو گرفتاری کے عمل سے باہر کیسے رکھا جاتا ہے#
کالر میں اپ اسٹریم دوبارہ استعمال کے قابل ورک فلو کا جاب-لیول حوالہ ہوتا ہے ایک مکمل کمٹ SHA پر۔ وہ ورک فلو واضح طور پر اپ اسٹریم ریپوزیٹری کو ایک مقررہ کلیکٹر SHA پر چیک آؤٹ کرتا ہے۔ ایک ڈیفالٹ actions/checkout ایک قابلِ استعمال ورک فلو میں کالر کو چیک آؤٹ کرے گا اور جان بوجھ کر استعمال نہیں کیا جاتا۔
ورک فلو کالر کیشز کو بحال نہیں کرتا، کالر آرٹیفیکٹس استعمال نہیں کرتا، کالر فائلز کو چلاتا نہیں ہے، یا سائن کرنے کے لیے سورس/تصویری یو آر ایل، شیل کمانڈز، تیار شدہ زیپ فائلز، یا ہیش قبول نہیں کرتا۔ یہ ایک محدود عوامی وصول کنندہ اور سیشن کی مدت قبول کرتا ہے۔ ایکشنز، پائتھن بیس امیج، اور cloudflared کو ناقابلِ تبدیلی ڈائجسٹ کے ذریعے پن کیا گیا ہے؛ پائتھن کی انحصار شدہ فائلوں میں موجودہ ہیش لاک شدہ ضروریات استعمال ہوتی ہیں۔ امیج کو کیش کے بغیر قابلِ اعتماد ماخذ سے تیار کیا جاتا ہے۔
کلیکٹر ایک نان-روٹ صارف کے طور پر چلتا ہے، جس میں ریڈ-اونلی امیج، لینکس کی صلاحیتیں ختم کی گئی ہوں، وسائل کی حدیں مقرر ہوں، اور نہ کوئی ڈاکر سوکت یا گٹ ہب-ٹوکن ماحول ہو۔ اس کے واحد ماؤنٹ تازہ ترین کنفیگریشن، ورک اسپیس، اور آؤٹ پٹ ڈائریکٹریز ہیں۔ محدود FastAPI ایپلیکیشن لاگ ان، ڈائیلاگز، قابل ترتیب اکاؤنٹ یا چیٹ کلیکشن، اسٹیٹس، ریزوم، فنش، اور منسوخی کو ظاہر کرتی ہے۔ اس میں کوئی پلین ٹیکسٹ ڈاؤن لوڈ روٹ، عمومی انتظامی روٹ، امپورٹ روٹ، یا سائننگ اینڈ پوائنٹ نہیں ہے۔
سپروائزر تصدیقی عمل سے پہلے نیٹ ورک کی جانب منہ کرنے والے کنٹینرز کو روکتا ہے
حتمی مقررہ پڑھتا ہے evidence.zip یا evidence.parts.json۔ پیکجنگ کنٹینر کا نیٹ ورک نہیں ہوتا۔ صرف اپ لوڈ کے مراحل کا نام connection.tgwsealed اور delivery*.tgwsealed؛ نہ تو پلین ٹیکسٹ ثبوت اور نہ ہی ٹیلیگرام کی کریڈینشلز بطور آرٹیفیکٹ اپ لوڈ کی جاتی ہیں۔
کلین اپ نجی ڈائریکٹریز اور کنٹینرز کو ہٹا دیتا ہے، اور گٹ ہب کام کے بعد ہوسٹڈ رنر وی ایم کو ضائع کر دیتا ہے۔
آرٹیفیکٹ کو ایک دن کے لیے محفوظ رکھا جاتا ہے؛ میعاد ختم ہونے سے پہلے ڈاؤن لوڈ کر لیں۔
ایک فورک کا مالک کالر کو تبدیل کر سکتا ہے یا ایک مختلف سگنڈ فائل بنا سکتا ہے۔ سخت تصدیق کنندہ کو نتیجے میں بننے والے مختلف سگنر کے ورک فلو/ڈائجسٹ کو مسترد کرنا چاہیے۔ یہ طریقہ کار اب بھی منظور شدہ کوڈ میں قابل استحصال بگز کی عدم موجودگی اور GitHub کے رنر اور دستخطی انفراسٹرکچر کی سالمیت پر منحصر ہے۔
کریپٹوگرافک ہینڈ آف#
ہر وصول کنندہ کلید RSA-3072 ہے (RSA-4096 کی درآمد بھی قبول ہے)، نمائی 65537۔ ہر لفافے میں ایک تازہ بے ترتیب AES-256 کلید اور 96-بٹ نونس ہوتا ہے۔ RSA-OAEP کے ساتھ SHA-256/MGF1-SHA256، AES کلید کو لپیٹتا ہے۔ AES-GCM ایک 128-بٹ ٹیگ کے ساتھ مکمل پری فکس اور پے لوڈ کی تصدیق کرتا ہے۔ عوامی وصول کنندہ base64 میں DER SPKI ہے؛ نجی کلید فائل میں base64 میں DER PKCS8 شامل ہے۔
Envelope بائٹس ہیں TGWSEAL1\n، ایک بگ-اینڈین uint32 JSON-ہیڈر کی لمبائی، ہیڈر، سائفر ٹیکسٹ، اور ایک 16 بائٹ GCM ٹیگ۔ ہیڈر میں بالکل algorithm,
key، اور nonce؛ الگورتھم ہے RSA-OAEP-256+A256GCM. ہیڈر کے ذریعے مکمل پری فکس GCM اضافی تصدیق شدہ ڈیٹا ہے۔ ہیڈر کا سائز 8192 بائٹس تک محدود ہے۔ CLI 8 GiB تک کے پے لوڈز کو اسٹریم کرتا ہے اور مطلوبہ آؤٹ پٹ انسٹال کرنے سے پہلے اس کی تصدیق کرتا ہے؛ یہ موجودہ منزل کو اووررائٹ کرنے سے انکار کرتا ہے۔
یہ معیاری کرپٹوگرافک بنیادی اجزاء کے گرد ایک پروجیکٹ-مخصوص خول ہے: RSA-OAEP بذریعہ SHA-256 اور AES-256-GCM، جو OpenSSL اور ہر بڑی کرپٹوگرافی لائبریری میں دستیاب ہے۔
اصلی ثبوت بائٹس کو، ثبوت اور تصدیق کو انکرپٹڈ بیرونی پیکیج میں رکھنے سے پہلے تصدیق کیا جاتا ہے۔ اس سے آرکائیو کے ہیش اور اسی آرکائیو کے اندر شامل سرٹیفیکیٹ کے درمیان دائرہ کار دار انحصار سے بچا جا سکتا ہے۔ عوامی ریپوزیٹریوں کے لیے، تصدیقی میٹا ڈیٹا (ریپوزیٹری، ورک فلو، کمٹ، آرٹیفیکٹ کا نام اور ڈائجسٹ) عوامی ہوتا ہے۔ عوامی میٹا ڈیٹا میں چیٹ کے نام کبھی شامل نہ کریں۔
دائرہ کار اور توثیق
یہ موڈ دستخط شدہ جرنل اور اکاؤنٹ-ایکسپورٹ انجن استعمال کرتا ہے۔ خفیہ چیٹس، کلیکشن سے پہلے حذف شدہ تاریخ اور اکاؤنٹ کے لیے ناقابل رسائی ڈیٹا کو خارج کر دیا جاتا ہے۔ نجی کلاؤڈ چیٹس منتخب کیے جانے پر اہل ہوتی ہیں۔ چیٹ پِکر 20,000 ڈائیلاگز تک محدود ہے؛ اکاؤنٹ ایکسپورٹ اپنی انوینٹری خود دریافت کرتا ہے۔ گمشدہ ڈیٹا، ناکام فائلیں اور نامکمل کام ریکارڈ کیے جاتے ہیں۔ اٹیچمنٹ کی حدیں اور رنر ڈسک/وقت کی حدیں اب بھی لاگو ہیں۔ بڑی ڈیلیوری ایک مقررہ 4 GiB ڈیلیوری حد کے بجائے انکرپٹڈ حصوں کا استعمال کرتی ہے۔ مکمل ہونے کا مطلب ہے کہ منجمد کردہ منتخب کام ختم ہو گئے ہیں، نہ کہ ہر تاریخی ٹیلیگرام ریکارڈ آرکائیو میں موجود ہے۔ چیٹ جرنل لائیو اپ ڈیٹس بھی دیکھ سکتا ہے؛ دونوں میں سے کوئی بھی موڈ ایک ایٹمک سنپ شاٹ نہیں ہے۔ بنائے گئے اسکرین شاٹس اور اسکرین ریکارڈنگز اس موڈ کا حصہ نہیں ہیں۔
ٹیسٹوں میں مصنوعی تازہ لاگ ان، دائرہ کار کا علیحدہ کرنا، میڈیا، منسوخی، جزوی ڈیڈ لائن کی تکمیل، ناکام لاگ آؤٹ، ممنوعہ API راستے اور فیلڈز، پہلے سے لوڈ شدہ ورک اسپیس کی مستردگی، غلط کلید اور چھیڑ چھاڑ کی مستردگی، ضروری ویریفائر جھنڈیاں، اور براؤزر/پائتھن انکرپشن کے باہمی تعامل کا احاطہ کیا جاتا ہے۔ براؤزر کی قبولیت ٹیسٹ ایک واضح لیبل والی نقلی تصدیق استعمال کرتی ہے؛ یہ کوئی حقیقی Sigstore ٹیسٹ نہیں ہے۔ حقیقی ہوسٹڈ رنر، ڈاکر، گٹ ہب تصدیق، اور لائیو ٹیلیگرام قبولیت کو مقامی مصنوعی چیکس سے الگ رپورٹ کرنا ضروری ہے۔
GitHub Actions کی شرائط ہوسٹڈ رنرز کے استعمال کو سافٹ ویئر پروجیکٹ کے لائف سائیکل تک محدود کرتی ہیں۔ ایک فورک ان پابندیوں کو ختم نہیں کرتا؛ اس پریویو کو غیر محدود مفت پروڈکشن ہوسٹنگ کے طور پر مارکیٹ نہیں کیا جانا چاہیے۔ Cloudflare Quick Tunnels بھی ٹیسٹنگ اور ڈیولپمنٹ کے لیے ہیں۔ ہیلپر/ورک فلوز اس فیچر کا جائزہ لینے کے لیے موزوں ہیں؛ پروڈکشن سروس کے اہلیت ایک علیحدہ ڈیپلائمنٹ کی ضرورت ہے۔
مینٹینر ریلیز کا سلسلہ#
- جمع کرنے والا، نگران اور کنٹینر کی تعریف اور ٹیسٹوں کا عہد کریں اور ان کا جائزہ لیں۔
- اس کلیکٹر کمٹ کو میں پِن کریں
sealed-collector.yml، پھر قابلِ استعمال ورک فلو کو کمٹ/نظرِ ثانی کریں۔ کالر کے SHA سے خاموشی سے چیک آؤٹ نکالنے کی کبھی کوشش نہ کریں۔ - دوبارہ استعمال کے قابل ورک فلو کمٹ کو میں پِن کریں
sealed-witness.ymlاور اس کے workflow/collector SHA جوڑے کوsealed_policy.jsonایک قابلِ اعتماد ریلیز میں۔ - تمام حوالہ شدہ کمٹس اور ہیلپر شائع کریں، پھر ایک آزاد فورک اور اصلی GitHub سرٹیفیکیٹ کو ٹیسٹ کریں۔ ان پِنز کے حوالہ کردہ کمٹس کو اسکواش نہ کریں جب تک کہ حوالہ جات دوبارہ تیار اور شائع نہ کیے جائیں۔
کالر ریپوزیٹری اور اپ اسٹریم سگنیئر کے درمیان فرق کے لیے دوبارہ استعمال کے قابل ورک فلو اور تصدیقات دیکھیں۔