منبع / امنیت و پروژه
Telegram · امنیت و مدیریت دادهها
مدل تهدید، مدل دسترسی، اسرار در حالت استراحت، در معرض دید شبکه، وارد کردن جلسات و نحوه گزارش آسیبپذیری.
TgWitness / مستندسازی · راهاندازی و بازیابی
این صفحه دسترسی، ذخیرهسازی و حفاظت شبکه را در یک فضای کاری محلی یا سرور توصیف میکند. برای جمعآوری در یک GitHub runner یا در یک ماشین مجازی محرمانه Intel TDX، به حالتهای تأیید مراجعه کنید که بررسیهایی را برای محیط جمعآوری اضافه میکنند. اتصالات حساب کاربری، اعلانها، زمانمهرها، نسخههای خارج از محل و شاهدان تنظیمات مسیریابی خاص خود را دارند.
| حوزه | به طور خلاصه |
|---|---|
| دسترسی | کلید ادمین بهعلاوه دسترسی محدودشده به حسابها/چتها، هفت مجوز و جلسات قابلابطال؛ بهصورت پیشفرض localhost |
| رازهای در آرامش | تنظیمات جلسه، جفت API، کلید امضا و پروکسی با Fernet رمزگذاری میشوند. |
| پیامها و رسانهها | فایلها در فضای کاری، محافظتشده توسط رمزگذاری دیسک یا حجم و مجوزهای فایل میزبان |
| یکپارچگی | زنجیره هش SHA-256 و امضای Ed25519 بر روی هر رکورد |
| زمان خارجی | RFC 3161 و رسیدهای OpenTimestamps، پستهای شاهد تاریخگذاریشده توسط تلگرام و تأیید گیتهاب؛ چکپوینتهای نگهداریشده، سوابق شاهد و اندازهگیریهای Intel TDX، بررسیهای پشتیبان هستند. اعتبارسنج گزارش میدهد که کدام شرایط شواهد را برآورده میکند. |
برای گزارشهای آسیبپذیری، به سیاست امنیتی مراجعه کنید.
در این صفحه
مدل دسترسی#
توکن پنل اصلی کنترل کامل را اعطا میکند. افراد دیگر میتوانند دسترسی محدود خود را دریافت کنند: فضاهای کاری و چتهای انتخابشده، مجوزها، انقضا، محدودیتهای IP، محدودیتهای ورود و جلسات قابل لغو. یک دسترسی محدود به چت نمیتواند عملیات کل فضای کاری را انجام دهد، حتی اگر مجوز آن تیک خورده باشد. هر فضای کاری دارای دفترچه خاطرات، گاوصندوق و کلید امضای خود در یک فرآیند واحد است؛ جداسازی بین افراد روی میزبان از طریق حسابهای سیستمعامل انجام میشود.
پنل بهطور پیشفرض روی localhost گوش میدهد. ورود به سیستم از طریق مرورگر، یک توکن دسترسی را با یک اعتبارنامه جلسه (session credential) مبادله میکند؛ مرورگر آن را بهعنوان یک توکن حملکننده (bearer token) ارسال میکند. این توکن در sessionStorage نگهداری میشود، نه در یک کوکی احراز هویت. قفل کردن/خروج (Lock/sign-out) جلسه مرورگر را پاک میکند. بستن مرورگر یا پایان دادن به یک جلسه، جمعآوری دادهها را متوقف نمیکند.
توکنهای صادر شده و اعتبارنامههای جلسه به صورت هش در گاوصندوق رمزگذاری شده نگهداری میشوند. ابطال، جلسات مرتبط را پایان میدهد؛ تغییرات مجوز بر درخواستهای بعدی تأثیر میگذارد. فایلهای دانلود شده قابل بازیابی نیستند. مدیر میتواند جلسات مرورگر خود را نیز محدود کند، اما اسکریپتهایی که مستقیماً از توکن پنل اصلی استفاده میکنند، دسترسی کامل خود را حفظ کرده و از آن محدودیتهای جلسه مرورگر عبور میکنند.
احراز هویت ناموفق بر اساس آدرس کلاینت محدود شده است. محدودیتهای IP بر اساس آدرسی اعمال میشوند که توسط برنامه دیده میشود؛ پیش از اتکا به آن، عملکرد پروکسی معکوس را بررسی کنید. اعتبارنامههای Witness همچنان جداگانه و فقط-خواندنی برای نقاط کنترل/وضعیت سلامت باقی میمانند.
دسترسی دمو#
/api/demo-access یک بوتاسترپ عمدتا غیرمعتبر برای یک دمو مصنوعی، ایزوله و صریحاً راهاندازیشده است. این قابلیت یک فرآیند جداگانه با چرخه عمر محدود صادر میکند، هرگز توکن پنل واقعی یا بازنویسی TGWITNESS_TOKEN را صادر نمیکند. صدور و استفاده از آن نیازمند یک همتا و میزبان لوپبک، بدون سربرگهای فوروارد شده و بدون درخواست فرا-منشأ (cross-origin) است. فضاهای کاری اضافی یا یک جلسه مجاز، این مسیر را غیرفعال میکنند. فضاهای کاری زنده هرگز این قابلیت را صادر نمیکنند. این دمو نمیتواند حسابها را به هم متصل کند یا تنظیمات جمعآوری را تغییر دهد.
محتوای پنل و خروجیها#
این پنل از هیچ فونت خارجی، ابزار تحلیل، منابع CDN یا رسانههای خارجی جاسازیشده استفاده نمیکند. متن استخراجشده از تلگرام به صورت متن درج میشود، نه HTML. فایلهای پیوست دانلودشده به صورت پیوستهای باینری ارائه میشوند. خروجیهای JSONL رشتههای اصلی را حفظ میکنند؛ HTML آنها را فرار میکند؛ سلولهای CSV که میتوانند به فرمول تبدیل شوند، با یک آپاستروف پیشوند میشوند.
خروجیها شامل اسرار احراز هویت و امضا نمیشوند، اما عمداً شامل متادیتای منبع جمعآوریشده، شناسهها و احتمالاً محتوای شخصی یا حساس هستند. هشهای دسترسی تلگرام و ارجاعات فایلها میتوانند در متادیتای خام منبع وجود داشته باشند.
رازهای در آرامش#
اطلاعات احراز هویت API تلگرام، کلید جلسه و کلید امضا با Fernet رمزگذاری میشوند. برای پیامها و رسانههای محلی، رمزگذاری توسط دیسک یا حجم میزبان فراهم میشود؛ فضای کاری فایلهای معمولی را ذخیره میکند. خروجیها میتوانند از یک فایل فشرده ZIP با رمزگذاری AES-256 محافظتشده با رمز عبور استفاده کنند، و نسخههای خارج از محل از AES-256-GCM استفاده میکنند.
کلید گاوصندوق بهطور پیشفرض روی دایرکتوری دادههای محافظتشده قرار دارد. برای ذخیرهٔ جداگانهٔ آن، از یک فایل کلید اصلی خارجی در زیر استفاده کنید. در یونیکس، فایلهای کلید خصوصی جدید از حالت 0600 و دایرکتوریهای دادهٔ جدید از حالت 0700 استفاده میکنند؛ در ویندوز، ACL دایرکتوری را برای حساب سرویس و مدیران مجاز تنظیم کنید. مجوزهای موجود دایرکتوری حفظ میشوند.
کلید اصلی خارجی#
برای یک دایرکتوری داده جدید، TGWITNESS_VAULT_KEY_FILE میتواند یک کلید اصلی تصادفی خارجی را فراهم کند. HKDF-SHA256 و یک سالت تصادفی جداگانه، یک کلید فرنِت متفاوت برای هر فضای کاری استخراج میکنند. vault.external.json باید برای بازیابی حفظ شود. در صورت عدم وجود یا نادرست بودن کلیدهای اصلی، عملیات با خطا متوقف میشود. گاوصندوقهای محلی موجود به صورت خودکار مهاجرت نمیشوند. پنل، حالت ذخیرهسازی کلید انتخابشده را نمایش میدهد. رمزگذاری دیسک، فایلهای پیام و رسانه محلی را در هر دو حالت محافظت میکند؛ برای جزئیات راهاندازی به بخشهای اتصال و حفاظت از دادهها مراجعه کنید.
پروکسیها و مسیرهای شبکه#
پیکربندی پروکسی در گاوصندوق رمزگذاری میشود. گذرواژهها و اسرار MTProxy توسط API بازنمیگردند یا در سوابق شواهد نوشته نمیشوند. هر فضای کاری مسیر تلگرام و حالت آیپی خود را انتخاب میکند.
مخفی کردن آدرس، پشتیبانگیری مستقیم تلگرام را رد میکند و برای درخواستهای HTTP خارجی به یک پروکسی نیاز دارد. حالت پشتیبانگیری صریحاً انتخابشده پس از تأخیر، دسترسی مستقیم به تلگرام را مجاز میسازد؛ حالت تونل/VPN مسیرهای مستقیم را مجاز میکند. انتخاب حالت تونل، VPN را نصب یا تأیید اعتبار نمیکند. این تنظیمات، تمام ترافیک دستگاه، مرورگرها، مدیران بسته یا حل DNS میزبان پروکسی محلی را کنترل نمیکنند.
MTProxy فقط ترافیک تلگرام را منتقل میکند. درخواستهای خارجی میتوانند از یک پروکسی جداگانه SOCKS5/HTTP، مسیر SOCKS5/HTTP فضای کاری، یا یک مسیر مستقیم مجاز استفاده کنند؛ همچنین میتوان آنها را غیرفعال کرد. این شاهدی مستقل تنظیمات حملونقل خود را دارد. احراز هویت معمولی CONNECT در پروتکلهای SOCKS5/HTTP توسط خود این پروتکلها رمزگذاری نمیشود. پشتیبانی از رازهای MTProxy جعلی TLS همچنان فراهم نیست.
ورود و واردسازی جلسات#
فایلهای تبدیلشده .tgwitness-session حاوی یک رمز مخفی مجوز متن ساده هستند تا زمانی که در گاوصندوق بارگذاری و ذخیره شوند. CLI آفلاین، اسکیماهای بازبینیشده Telethon را میپذیرد. پانل واردات علاوه بر این، ورودیهای Pyrogram SQLite، TData ZIP مدرن تکحساب، و JSON مستند را میپذیرد. این قابلیت احراز هویت شده، به چهار فایل / ۸ مگابایت محدود است، و بارگذاریها را بدون استخراج آرشیو یا ذخیره فایلهای اصلی، در حافظه پردازش میکند. اطلاعات احراز هویت نرمالشده فقط به مرورگر احراز هویتشده درخواستکننده بازگردانده میشوند؛ آنها پس از موفقیت در احراز هویت تلگرام در گاوصندوق رمزگذاریشده ذخیره میشوند. از فایلهای اصلی و تبدیلشده محافظت کنید و از کپیبرداری همزمان یک مجوز توسط کلاینتها جلوگیری کنید.
پردازش TData، چکسامهای کانتینر، هشهای رمزگشایی محلی و طول ساختارها را تأیید میکند. گذرواژه محلی دسکتاپ ارائهشده بهطور موقت استفاده میشود و ذخیره نمیگردد. پارسر محدود، فرمتهای دسکتاپ را که تأیید میکند پشتیبانی میکند و سایرین را رد مینماید. تصاویر QR بهصورت محلی تولید میشوند، توکنهای ورود تلگرام با اعتبار محدود را در خود دارند و هرگز به سرویس رندرینگ خارجی ارسال نمیشوند. قفل کردن، تغییر فضای کاری، ورود جدید و تغییرات مسیر، تلاشهای QR در حال انتظار را لغو میکنند. بارگذاری مجدد/بستن یک تب ممکن است یک تلاش را تا زمان انقضای آن در حالت معلق رها کند. ورود موفقیتآمیز با QR همچنان الزام به اتصال حساب کاربری را اعمال میکند. بدنههای معمولی API به 16 کیلوبایت محدود باقی میمانند؛ مسیر وارداتی احراز شده تا 12 مگابایت JSON رمزگذاریشده را میپذیرد و محدودیت فایل رمزگشاییشده کوچکتر را به طور جداگانه اعمال میکند.
کدهای ورود و رمزهای احراز هویت دو مرحلهای تلگرام ذخیره نمیشوند. وضعیت شماره تلفن/کد-هش در حین تأیید اعتبار در حافظه نگهداری میشود. جلسات تلگرام دسترسی به حساب کاربری را فراهم میکنند؛ هرگز یک پوشه داده، جلسه، توکن، کلید گاوصندوق یا کلید امضای خصوصی را در گیتهاب بارگذاری نکنید.
لاگها و انتقال#
پاسخ اعتبارسنجی پیشفرض API جایگزین میشود تا مقادیر اعتبارنامهها را بازتاب ندهد. ثبت دسترسی برنامه غیرفعال است. از پیکربندی یک پروکسی معکوس برای ثبت سربرگهای احراز هویت یا بدنه درخواستها خودداری کنید. پنل روی localhost گوش میدهد؛ دسترسی از راه دور از طریق تونل SSH ارائهشده، تونل Cloudflare یا HTTPS Caddy انجام میشود، بنابراین توکنها و رمزهای ورود در داخل SSH یا TLS منتقل میشوند.
تمامیت و زمان خارجی#
تأیید صحت، امضاهای رکورد، زنجیره هش، پیوستها و فهرست صادرات را با کلید گردآورنده مطابقت میدهد. یک امضای معتبر نشان میدهد که بایتها از زمان امضا شدن تغییر نکردهاند. هر فضای کاری در اولین راهاندازی، کلید امضای خود را ایجاد میکند و اثر انگشت آن را در پنل و در هر صادرات نشان میدهد. اپراتور اثر انگشت را از طریق یک کانال جداگانه به گیرنده میدهد، و --fingerprint کلید را پین میکند.
یک رکورد تغییر داده شده، درج شده یا حذف شده، زنجیره هش یا امضا را میشکند و اعتبارسنج آن را گزارش میدهد. مهرهای زمانی خارجی و یک شاهد نیز ژورنال را خارج از فضای کاری تثبیت میکنند. تریگرهای جدول ژورنال فقط مانع از بازنویسی یا حذف تصادفی یک رکورد توسط برنامه میشوند. TGWITNESS_VAULT_KEY_FILE کلید گاوصندوق را از نسخه کپی موجود در دایرکتوری داده خارج نگه میدارد.
رسیدهای RFC 3161 و OpenTimestamps، و پستهای شاهدی که تاریخ آنها توسط راستیآزما از تلگرام خوانده میشود، پیشوند دفتر کل را که پوشش میدهند به زمانی که توسط شخص ثالث تعیین شده است، پیوند میدهند. یک دور drand که در دفتر کل نوشته شده است نشان میدهد که سوابق پس از آن، زودتر از زمانی که آن دور منتشر شده است، ایجاد نشدهاند. یک گواهی تأییدشده گیتهاب نیز زمان تأییدشده امضای خود را حمل میکند که کل آرشیو را به یک زمان خارجی پیوند میدهد. یک نقطه کنترل با کلید گردآورنده امضا میشود و سوابق تا آن نقطه را از لحظهای که گیرنده آن را از طریق یک کانال دیگر دریافت کرده است، پیوند میدهد. یک شاهد نشان میدهد که یک کلید دوم، سر دفتر را در اختیار داشته است؛ رکورد کنترل کلید متولی نشان میدهد که چه کسی آن کلید را در اختیار دارد. هر دو بررسیهای پشتیبان هستند؛ حداقل مورد نیاز، زمان یک شخص ثالث است. سنجش اقدامی گیتهاب یا یک پیادهسازی Intel TDX منشأ گردش کار یا اندازهگیریهای سختافزاری محیط جمعآوری را اضافه کنید.
هر پاسخ تأیید، شرایط شواهد را به همراه نحوه بررسی هر یک، طبق نقششان در حداقل، فهرست میکند:
| نقش | شرط |
|---|---|
| الزامی | تمامیت؛ کلید امضاکننده با --fingerprint پین شده است؛ زمان خارجی پوششدهنده آخرین رکورد (رسید RFC 3161 با --tsa-ca بررسی شده، رسید OpenTimestamps با --check-bitcoin تأیید شده، پست شاهد از t.me با --channel خوانده شده، مهر بیتکوین شاهد یا تأییدیه بررسیشده GitHub) |
| حمایتی، نه بخشی از حداقل | شاهد با کلید خود؛ نقطهٔ کنترل نگهداریشده؛ اجرای مجموعهٔ گواهیشده |
حداقل مدرک، برآورده شدن هر سه شرط الزامی مربوط به آخرین رکورد صادر شده است؛ یک اجرای مجموعه تأییدشده و گواهیشده، اضافه میکند attested پروفایل.
خط نهایی نتیجه را بیان میکند، و پاسخ، گزینههایی را نام میبرد که شرایط
مفقود را برآورده میکنند. بدون --fingerprint خط نهایی با شروع میشود
EVIDENCE: minimum not met · missing: confirmed signer key.
زمانی که مهرهای زمانی تأییدشده تنها سوابق قبلی را پوشش میدهند، پاسخ، رکوردی را که حداقل شرایط تا آن رکورد برقرار است، بیان میکند. بدونخط آخر با
یا
شروع میشود. --require evidence یا --require attested هنگامی که پروفایل برای کل عملیات صدور به دست نیاید، با کد 2 خروجی میگیرد، و بررسیای که در خط فرمان درخواست شده و قابل اجرا نیست، با همان کد به عنوان انجامنشده گزارش میشود. هر گزارش، شرایط یکسان را به همراه وضعیت آنها در آن نسخه و دستوری که آنها را بررسی میکند، در خود دارد. سطوح اطمینان و --strict در دسترس باقی میمانند؛ قالب شواهد، بررسیها را برای هر حالت جمعآوری فهرست میکند.
اگر به وجود مشکل مشکوک هستید#
دایرکتوری داده اصلی را حفظ کرده و برای تحلیل از یک نسخهٔ جداگانه استفاده کنید. نسخهٔ تحت تأثیر، عملیات و مراحل قابل تکرار را از طریق سیاست امنیتی گزارش کنید و دادهها و اعتبارنامههای حساب کاربری را خصوصی نگه دارید.