TgWitness / دستاویزات

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

حوالہ / سیکیورٹی اور پروجیکٹ

Telegram · سیکیورٹی اور ڈیٹا ہینڈلنگ

دھمکی کا ماڈل، رسائی کا ماڈل، ذخیرہ شدہ راز، نیٹ ورک کی نمائش، سیشن امپورٹس اور کمزوری کی رپورٹنگ کا طریقہ۔

ٹی جی وٹنس / دستاویزات · تیناری اور بحالی

تیناری اور بحالی

یہ صفحہ کسی مقامی یا سرور ورک اسپیس میں رسائی، اسٹوریج اور نیٹ ورک کی حفاظت کو بیان کرتا ہے۔ GitHub runner یا Intel TDX confidential VM میں کلیکشن کے لیے، تصدیقی طریقوں کو دیکھیں، جو کلیکشن ماحول کی جانچ پڑتال شامل کرتے ہیں۔ اکاؤنٹ کنکشنز، نوٹیفیکیشنز، ٹائم اسٹیمپس، آف سائٹ کاپیاں اور ویٹنسز کی اپنی روٹنگ سیٹنگز ہوتی ہیں۔

علاقہ مختصراً
رسائی ایڈمنسٹریٹر کلید اور اکاؤنٹس/چٹس تک محدود رسائی، سات اجازت نامے اور منسوخ شدنی سیشنز؛ بطورِ ڈیفالٹ لوکل ہوسٹ
محفوظ راز سیشن، API جوڑی، دستخطی کلید اور پروکسی ترتیبات Fernet کے ساتھ خفیہ کردی گئی ہیں۔
پیغامات اور میڈیا ورک اسپیس میں فائلیں، جو ہوسٹ کی ڈسک یا والیوم انکرپشن اور فائل پرمیشنز کے ذریعے محفوظ ہیں
دیانتداری ہر ریکارڈ پر SHA-256 ہیش چین اور Ed25519 دستخط
بیرونی وقت RFC 3161اور OpenTimestamps کی رسیدیں، ٹیلیگرام اور GitHub کی تصدیق شدہ تاریخوں والی گواہ کی پوسٹس؛ برقرار رکھے گئے چیک پوائنٹس، گواہ کے ریکارڈز اور Intel TDX کی پیمائشیں معاون چیکس ہیں۔ تصدیق کنندہ رپورٹ کرتا ہے کہ وہ کون سی ثبوت کی شرائط پوری کرتا ہے۔

کمزوریوں کی رپورٹس کے لیے سیکیورٹی پالیسی ملاحظہ کریں۔

اس صفحے پر

رسائی ماڈل#

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

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

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

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

ڈیمو تک رسائی#

/api/demo-access ایک جان بوجھ کر غیر تصدیق شدہ بوٹ اسٹراپ ہے جو واضح طور پر شروع کیے گئے، الگ تھلگ مصنوعی ڈیمو کے لیے ہے۔ یہ ایک علیحدہ پراسیس-لائف ٹائم صلاحیت جاری کرتا ہے، کبھی بھی اصل پینل ٹوکن یا TGWITNESS_TOKEN اووررائیڈ نہیں۔ جاری کرنے اور استعمال کے لیے لوپ بیک پیئر اور ہوسٹ درکار ہے، کوئی فارورڈڈ ہیڈرز نہیں، اور کوئی کراس-اورجن درخواست نہیں۔ اضافی ورک اسپیسز یا ایک مجاز سیشن اس راستے کو غیر فعال کر دیتے ہیں۔ لائیو ورک اسپیسز کبھی بھی یہ صلاحیت جاری نہیں کرتے ہیں۔ یہ ڈیمو اکاؤنٹس کو مربوط نہیں کر سکتا یا کلیکشن سیٹنگز تبدیل نہیں کر سکتا۔

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

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

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

محفوظ راز#

ٹیلیگرام API کی کریڈینشلز، سیشن اور سائننگ کی Fernet کے ساتھ انکرپٹ کی گئی ہیں۔ مقامی پیغامات اور میڈیا کے لیے، انکرپشن ہوسٹ کی ڈسک یا والیوم فراہم کرتا ہے؛ ورک اسپیس عام فائلیں محفوظ کرتا ہے۔ ایکسپورٹس پاس ورڈ سے محفوظ شدہ AES-256 ZIP استعمال کر سکتے ہیں، اور آف سائٹ کاپیز AES-256-GCM استعمال کرتی ہیں۔

والٹ کی (vault key) بطورِ ڈیفالٹ محفوظ ڈیٹا ڈائریکٹری میں رکھی جاتی ہے۔ اسے علیحدہ طور پر محفوظ کرنے کے لیے نیچے دی گئی بیرونی ماسٹر-کی فائل (external master-key file) استعمال کریں۔ یونکس (Unix) پر، نئی پرائیویٹ-کی فائلیں موڈ 0600 استعمال کرتی ہیں اور نئی ڈیٹا ڈائریکٹریاں 0700 استعمال کرتی ہیں؛ ونڈوز (Windows) پر، سروس اکاؤنٹ اور مجاز منتظمین کے لیے ڈائریکٹری اے سی ایل (ACL) سیٹ کریں۔ موجودہ ڈائریکٹری اجازت نامے برقرار رکھے جاتے ہیں۔

بیرونی ماسٹر کلید#

نئی ڈیٹا ڈائریکٹری کے لیے، TGWITNESS_VAULT_KEY_FILE بیرونی بے ترتیب ماسٹر کلید فراہم کر سکتا ہے۔ HKDF-SHA256 اور ایک الگ بے ترتیب سالٹ ہر ورک اسپیس کے لیے ایک مختلف فرنیٹ کلید تیار کرتے ہیں۔ بحالی کے لیے vault.external.json کو برقرار رکھا جانا چاہیے۔ گمشدہ یا غلط ماسٹر کلیدوں کی صورت میں بندش ناکام ہو جاتی ہے۔ موجودہ مقامی والٹس خاموشی سے منتقل نہیں کیے جاتے۔ پینل منتخب کردہ کلید ذخیرہ موڈ دکھاتا ہے۔ ڈسک انکرپشن دونوں موڈز میں مقامی پیغام اور میڈیا فائلوں کی حفاظت کرتی ہے؛ سیٹ اپ کی تفصیلات کے لیے کنکشن اور ڈیٹا پروٹیکشن دیکھیں۔

پراکسیز اور نیٹ ورک راستے#

پراکسی کنفیگریشن والٹ میں انکرپٹ کی جاتی ہے۔ پاس ورڈز اور MTProxy سیکریٹس API کے ذریعے واپس نہیں کیے جاتے اور نہ ہی ثبوت کے ریکارڈز میں لکھے جاتے ہیں۔ ہر ورک اسپیس اپنا ٹیلیگرام راستہ اور IP موڈ منتخب کرتا ہے۔

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

MTProxy صرف ٹیلیگرام ٹریفک منتقل کرتا ہے۔ بیرونی درخواستیں ایک الگ SOCKS5/HTTP پروکسی، ورک اسپیس کے SOCKS5/HTTP راستے، یا ایک مجاز براہِ راست راستے کا استعمال کر سکتی ہیں؛ انہیں غیر فعال بھی کیا جا سکتا ہے۔ آزاد ویٹنس کی اپنی ٹرانسپورٹ سیٹنگز ہیں۔ عام SOCKS5/HTTP CONNECT توثیق خود ان پروکسی پروٹوکولز کے ذریعے خفیہ نہیں ہوتی۔ جعلی TLS MTProxy سیکرٹس کی حمایت نہیں کی جاتی۔

سائن ان اور سیشن امپورٹس#

تبدیل شدہ .tgwitness-session فائلوں میں ایک سادہ متن کا اجازت نامہ خفیہ ہوتا ہے جب تک کہ انہیں والٹ میں لوڈ اور محفوظ نہ کیا جائے۔ آف لائن CLI جائزہ شدہ Telethon سکیموں کو قبول کرتا ہے۔ پینل امپورٹ اضافی طور پر پائیروگرام SQLite، جدید سنگل اکاؤنٹ TData ZIP، اور دستاویزی JSON ان پٹس کو قبول کرتا ہے۔ یہ مستند شدہ ہے، چار فائلوں / 8 MiB تک محدود ہے، اور اپ لوڈز کو میموری میں آرکائیو نکالے یا اصل فائلوں کو محفوظ کیے بغیر پراسیس کرتا ہے۔ معیاری شدہ اسناد صرف درخواست کرنے والے تصدیق شدہ براؤزر کو واپس کی جاتی ہیں؛ کامیاب ٹیلیگرام اجازت کے بعد انہیں انکرپٹڈ والٹ میں محفوظ کیا جاتا ہے۔ اصل اور تبدیل شدہ فائلوں کو محفوظ رکھیں، اور ایک ہی اجازت کو بیک وقت کلون کرنے والے کلائنٹس سے بچیں۔

TData پراسیسنگ کنٹینر چیک سمز، مقامی ڈی کرپشن ہیشز، اور ساخت کی لمبائیوں کی تصدیق کرتی ہے۔ فراہم کردہ ڈیسک ٹاپ مقامی پاس کوڈ عارضی طور پر استعمال ہوتا ہے اور محفوظ نہیں کیا جاتا۔ باؤنڈڈ پارسر ان ڈیسک ٹاپ فارمیٹس کی حمایت کرتا ہے جنہیں یہ درست قرار دیتا ہے اور دوسروں کو مسترد کر دیتا ہے۔ QR تصاویر مقامی طور پر بنائی جاتی ہیں، ان میں مختصر مدت کے ٹیلیگرام لاگ ان ٹوکنز ہوتے ہیں، اور انہیں کبھی بھی کسی بیرونی رینڈرنگ سروس کو بھیجا نہیں جاتا۔ لاک، ورک اسپیس سوئچ، نیا لاگ ان، اور راستے میں تبدیلیاں زیر التواء QR کوششوں کو منسوخ کر دیتی ہیں۔ ٹیب کو دوبارہ لوڈ کرنے یا بند کرنے سے کوئی کوشش ختم ہونے تک معطل رہ سکتی ہے۔ ایک کامیاب QR لاگ ان اب بھی اکاؤنٹ کی منسلکیت کو نافذ کرتا ہے۔ عام API باڈیز 16 KiB تک محدود رہتی ہیں؛ تصدیق شدہ امپورٹ روٹ 12 MiB تک کے انکوڈڈ JSON کو قبول کرتا ہے، اور الگ سے چھوٹی ڈی کوڈ شدہ فائل کی حد کو نافذ کرتا ہے۔

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

لاگز اور ٹرانسپورٹ#

ڈیفالٹ API توثیقی جواب کو تبدیل کیا جاتا ہے تاکہ یہ کریڈینشل ویلیوز کو ظاہر نہ کرے۔ ایپلیکیشن کی رسائی لاگنگ غیر فعال ہے۔ ریورس پروکسی کو اتھارائزیشن ہیڈرز یا درخواست کے باڈی لاگ کرنے کے لیے ترتیب نہ دیں۔ پینل لوکل ہوسٹ پر سنتا ہے؛ دور دراز رسائی فراہم کردہ SSH ٹنل، کلاؤڈ فلیئر ٹنل یا کیڈی HTTPS کے ذریعے ہوتی ہے، لہٰذا ٹوکنز اور لاگ ان سیکرٹس SSH یا TLS کے اندر منتقل ہوتے ہیں۔

سالمیت اور بیرونی وقت#

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

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

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

ہر تصدیقی جواب میں شواہد کی شرائط اور ہر ایک کی جانچ کے طریقے درج ہوتے ہیں، جنہیں کم از کم میں ان کے کردار کے مطابق گروپ کیا گیا ہے:

کردار شرط
ضروری سالمیت؛ دستخط کنندہ کلید کو --fingerprint کے ساتھ پن کیا گیا؛ آخری ریکارڈ کا احاطہ کرنے والا بیرونی وقت (RFC 3161 رسید کو --tsa-ca کے ساتھ چیک کیا گیا، OpenTimestamps رسید کی تصدیق --check-bitcoin کے ساتھ کی گئی، گواہ کی پوسٹ کو t.me سے --channel کے ساتھ پڑھا گیا، گواہ کا Bitcoin سیل یا GitHub کی تصدیق چیک کی گئی)
مددگار، کم از کم کا حصہ نہیں اپنی چابی کے ساتھ گواہ؛ برقرار رکھا گیا چیک پوائنٹ؛ تصدیق شدہ کلیکشن رن

وہ شواہد کے لیے کم از کم آخری برآمد شدہ ریکارڈ کو کور کرنے والی تینوں ضروری شرائط ہیں؛ ایک تصدیق شدہ اور گواہی شدہ کلیکشن رن شامل کرتا ہے۔ attested پروفائل۔ آخری سطر نتیجہ بیان کرتی ہے، اور جواب ان اختیارات کے نام بتاتا ہے جو غائب شرائط کو پورا کریں گے۔ بغیر --fingerprint آخری سطر شروع ہوتی ہے EVIDENCE: minimum not met · missing: confirmed signer key. جب تصدیق شدہ ٹائم اسٹیمپ صرف پہلے کے ریکارڈز کو کور کرتے ہیں، تو جواب میں اُس ریکارڈ کا ذکر ہوتا ہے جس تک کم از کم صادق رہتا ہے۔ --require evidence یا --require attested کوڈ 2 کے ساتھ ختم ہوتا ہے جب پورے ایکسپورٹ کے لیے پروفائل تک رسائی نہ ہو، اور کمانڈ لائن پر ایک چیک کی درخواست کی گئی ہو جو چلایا نہیں جا سکتا، اسے اسی کوڈ کے ساتھ انجام نہ دیے جانے کے طور پر رپورٹ کیا جاتا ہے۔ ہر رپورٹ میں ان کی حالت کے ساتھ وہی شرائط اور وہ کمانڈ شامل ہوتا ہے جو انہیں چیک کرتا ہے۔ یقین دہانی کی سطحیں اور --strict دستیاب رہیں؛ شواہد کا فارمیٹ ہر وصولی کے طریقہ کار کے لیے چیکس کی فہرست دیتا ہے۔

اگر آپ کو کسی مسئلے کا شبہ ہو#

اصلی ڈیٹا ڈائریکٹری کو برقرار رکھیں اور تجزیے کے لیے ایک الگ کاپی استعمال کریں۔ سیکیورٹی پالیسی کے تحت متاثرہ ورژن، آپریشن اور قابلِ تکرار اقدامات کی رپورٹ کریں، اکاؤنٹ کے ڈیٹا اور اسناد کو نجی رکھیں۔