TgWitness / مستندسازی

آنچه آزمایش شده است ←

مستندسازی / 14

Telegram · آن را امن نگه دارید

چه چیزی از دستگاه شما خارج می‌شود، هر راز چه چیزی را باز می‌کند و حفاظت‌ها چه چیزی را پوشش می‌دهند در برابر آنچه بر عهده شماست.

127.0.0.1آدرس پنل به‌صورت پیش‌فرض
۲۵۶ بیتیتوکن پنل تصادفی
0شبکه‌های توزیع محتوا (CDN)، تحلیل‌ها یا فونت‌های دور
Ed25519امضا در هر رکورد

جایی که همه‌چیز زندگی می‌کند

جمع‌کننده، پنل و هر رکورد روی دستگاه شما می‌مانند. به‌طور پیش‌فرض فقط با Telegram تماس گرفته می‌شود؛ بقیه هر کدام یک کلید جداگانه است.

۰۶ / آنچه از دستگاه خارج می‌شودنصب شما
کامپیوتر یا سرور شما
پنل127.0.0.1:8787 · توکن حامل
مجموعه‌کنندهیک کلاینت تلگرام به ازای هر فضای کاری
پوشهٔ داده‌ها
مجلهSQLite · زنجیره‌ای هش · امضا شده
رسانه‌هافایل‌هایی با نام‌گذاری SHA-256
گنجینهفرنت · جلسه، جفت API، کلید امضا، پروکسی
  • تلگرامهمیشه · از طریق مسیر شما

    اتصال 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 استفاده کنید.
  • پوشش را از نظر شکاف‌ها بررسی کنید و تحویل را روی حساب‌ها و منابع خودتان آزمایش کنید.

دسترسی به یک پرونده را به اشتراک بگذارید با مجوزها، انقضا و محدودیت نشست.

سخت‌گیری یک نصب

  1. از یک حساب Telegram اختصاصی استفاده کنید، هرگز حساب اصلی‌تان را.
  2. پنل را روی 127.0.0.1 نگه دارید. دسترسی از راه دور فقط با HTTPS (Caddy همراه) یا تونل SSH.
  3. دیسک را رمزگذاری کنید که پوشه داده روی آن است.
  4. پوشه داده را محدود کنید به حساب سرویس (0700 در Unix، مجوزهای پوشه در Windows).
  5. کلید گاوصندوق را جای دیگری نگه دارید روی سرورها: پیش از اولین اجرا TGWITNESS_VAULT_KEY_FILE را تنظیم کنید.
  6. اثر انگشت و نقاط بازرسی را ذخیره کنید روی سیستمی دیگر، و شاهد را روی میزبانی دیگر اجرا کنید.
  7. هرگز کلیدهای data/، sessions، panel-token.txt یا vault را در گیت‌هاب یا یک چت آپلود نکنید.
  8. سربرگ‌های Authorization را در یک پروکسی معکوس ثبت نکنید.
آیا می‌توانم توکن پنل را بدون از دست دادن داده‌ها تغییر دهم؟

بله، فقط پنل را باز می‌کند. TgWitness را متوقف کنید، panel-token.txt را حذف کنید، دوباره اجرا کنید. ژورنال، نشست‌ها و کلیدها می‌مانند. اگر TGWITNESS_TOKEN تنظیم شده باشد، مقدار آن بر فایل مقدم است.

گزارش یک آسیب‌پذیری

Security → Report a vulnerability در GitHub. نسخه، تأثیر و بازتولید حداقلی با داده جعلی. هرگز اعتبارنامه، پوشه حساب یا شواهد واقعی نفرستید. اگر گزارش خصوصی خاموش است، یک issue باز کنید و کانال خصوصی بخواهید، بدون جزئیات بهره‌برداری.