مستندسازی / 14
Telegram · آن را امن نگه دارید
چه چیزی از دستگاه شما خارج میشود، هر راز چه چیزی را باز میکند و حفاظتها چه چیزی را پوشش میدهند در برابر آنچه بر عهده شماست.
جایی که همهچیز زندگی میکند
جمعکننده، پنل و هر رکورد روی دستگاه شما میمانند. بهطور پیشفرض فقط با Telegram تماس گرفته میشود؛ بقیه هر کدام یک کلید جداگانه است.
- تلگرامهمیشه · از طریق مسیر شما
اتصال MTProto حساب: مستقیم، SOCKS5، HTTP یا MTProxy. حالت مخفیسازی IP منتظر یک پروکسی فعال است. بازگشت مستقیم نیازمند حالتی است که صراحتاً آن را مجاز کند.
- نسخه خارج از محلاختیاری · بهصورت پیشفرض غیرفعال
ژورنال، فایلها و نقاط کنترل با AES-GCM رمزگذاری میشوند پیش از بارگذاری در ذخیرهسازی سازگار با S3. کلید نزد شما باقی میماند؛ پیوستها با هشهای کلیدمحور نامگذاری میشوند، نه هش محتوای آنها.
- اخطاریههااختیاری · بهصورت پیشفرض غیرفعال
مشکلات و شمارش تغییرات همراه با عناوین چت. گزیدههای پیام تنها در صورتی ارسال میشوند که آنها را فعال کنید.
- مرجع زمانبندیاختیاری · بهصورت پیشفرض غیرفعال
فقط هش SHA-256 یک نقطهٔ کنترل امضا شده و یک عدد یکبار مصرف تصادفی. بدون پیامها، بدون نامهای چت.
- شاهداختیاری · بهصورت پیشفرض غیرفعال
با یک توکن فقط-خواندن، نقاط کنترل امضاشده و شمارندههای ضبط را استخراج میکند. نمیتواند مکالمات را بخواند یا تنظیمات را تغییر دهد.
پیشفرض: تنها اتصال تلگرام از این دستگاه خارج میشود.
هر رمز چه چیزی را آشکار میکند
| مخفی | محلی که نگهداری میشود | آنچه را که باز میکند | اگر فاش شود |
|---|---|---|---|
| توکن پنل | panel-token.txt در پوشه داده؛ مرورگر آن را برای هر زبانه نگه میدارد | همه چیز در هر فضای کاری | TgWitness را متوقف کنید، panel-token.txt را حذف کنید، دوباره اجرا کنید: یک توکن جدید میگیرید |
| جلسه تلگرام | گاوصندوق، رمزگذاریشده (credentials.enc) | خود حساب تلگرام | جلسه را در تلگرام تحت «تنظیمات» → «دستگاهها» پایان دهید. |
| کلید امضا | گاوصندوق، رمزگذاریشده (signing.enc) | امضای رکوردها با اثر انگشت شما | نقاط بازرسی در جای دیگر، شاهد و مهرهای زمانی همچنان نشان میدهند پیشتر چه وجود داشت |
| کلید گاوصندوق | vault.key کنار دادهها، یا یک کلید اصلی خارجی | گاوصندوق | فرض کنید نشست و کلید امضا هم نشت کردهاند |
| توکن شاهد | روی میزبان شاهد | فقطخواندنی: نقاط بازرسی و سلامت | آن را در صفحه شاهد حذف کنید، یکی تازه بسازید |
| کپی کلید خارج از محل | گاوصندوق؛ یکبار آن را دانلود کنید تا در صورت نیاز بازیابی شود | کپی خارج از محل | هر کسی که bucket را هم داشته باشد میتواند رمزگشایی کند: کپی را افشاشده فرض کنید |
محدودهٔ پوشش حفاظتی
پوشش داده شده
- رکوردی که تغییر کرده، حذف یا جابهجا شده: زنجیره هش یا یک امضا میشکند.
- ژورنالی که پس از ذخیره نقطه بازرسی در جای دیگر کوتاه یا بازسازی شده: نقطه بازرسی دیگر منطبق نیست.
- حدس زدن توکن: 256 بیت تصادفی، مقایسه با زمان ثابت، 15 شکست در دقیقه و آدرس مسدود میشود.
- محتوای خصمانه گفتگو: متن متن میماند و هرگز HTML نمیشود؛ پیوستها بهصورت فایل دانلود میشوند؛ پنل چیزی از سایتهای دیگر بارگذاری نمیکند.
- پوشه داده دزدیدهشده با کلید گاوصندوق خارجی: نشستها و کلیدها رمزگذاریشده میمانند.
به شما واگذار شد
- توکن اصلی همه کار میکند. به دیگران دسترسی محدود بدهید و توکن اصلی را برای خودتان نگه دارید.
- اثر انگشت و نقاط بازرسی را جای دیگری نگه دارید.
- دیسک را رمزگذاری کنید و مجوزها را محدود کنید.
- HTTP ساده بیرون از localhost توکن را نشت میدهد. از HTTPS یا تونل SSH استفاده کنید.
- پوشش را از نظر شکافها بررسی کنید و تحویل را روی حسابها و منابع خودتان آزمایش کنید.
دسترسی به یک پرونده را به اشتراک بگذارید با مجوزها، انقضا و محدودیت نشست.
سختگیری یک نصب
- از یک حساب Telegram اختصاصی استفاده کنید، هرگز حساب اصلیتان را.
- پنل را روی 127.0.0.1 نگه دارید. دسترسی از راه دور فقط با HTTPS (Caddy همراه) یا تونل SSH.
- دیسک را رمزگذاری کنید که پوشه داده روی آن است.
- پوشه داده را محدود کنید به حساب سرویس (0700 در Unix، مجوزهای پوشه در Windows).
- کلید گاوصندوق را جای دیگری نگه دارید روی سرورها: پیش از اولین اجرا
TGWITNESS_VAULT_KEY_FILEرا تنظیم کنید. - اثر انگشت و نقاط بازرسی را ذخیره کنید روی سیستمی دیگر، و شاهد را روی میزبانی دیگر اجرا کنید.
- هرگز کلیدهای
data/، sessions،panel-token.txtیا vault را در گیتهاب یا یک چت آپلود نکنید. - سربرگهای
Authorizationرا در یک پروکسی معکوس ثبت نکنید.
آیا میتوانم توکن پنل را بدون از دست دادن دادهها تغییر دهم؟
بله، فقط پنل را باز میکند. TgWitness را متوقف کنید، panel-token.txt را حذف کنید، دوباره اجرا کنید. ژورنال، نشستها و کلیدها میمانند. اگر TGWITNESS_TOKEN تنظیم شده باشد، مقدار آن بر فایل مقدم است.
گزارش یک آسیبپذیری
Security → Report a vulnerability در GitHub. نسخه، تأثیر و بازتولید حداقلی با داده جعلی. هرگز اعتبارنامه، پوشه حساب یا شواهد واقعی نفرستید. اگر گزارش خصوصی خاموش است، یک issue باز کنید و کانال خصوصی بخواهید، بدون جزئیات بهرهبرداری.