TgWitness / Документація

Що було протестовано →

Документація / 14

Telegram · Забезпечте безпеку

Що йде з вашої машини, що відкриває кожен секрет і що захищено, а що лишається на вас.

127.0.0.1адреса панелі за замовчуванням
256-бітнийвипадковий токен панелі
0CDN, аналітика або віддалені шрифти
Ed25519підпис на кожному записі

Де все зберігається

Збирач, панель і всі записи лишаються на вашій машині. Типово зв'язок є лише з Telegram, усе інше вмикається окремо.

06 / ЩО ВИХОДИТЬ З МАШИНИВаша інсталяція
ВАШ КОМП’ЮТЕР АБО СЕРВЕР
Панель127.0.0.1:8787 · токен-носій
КолекторОдин клієнт Telegram на робочу область
КАТАЛОГ ДАНИХ
ЖурналSQLite · з ланцюжком хеш-кодів · підписаний
ЗМІфайли, іменовані за SHA-256
СховищеFernet · сесія, пара API, ключ підпису, проксі
  • TelegramЗавжди · через ваш маршрут

    Підключення облікового запису до MTProto: пряме, SOCKS5, HTTP або MTProxy. Режим приховування IP-адреси очікує на працездатний проксі-сервер. Пряме резервне підключення вимагає режиму, який явно це дозволяє.

  • Текст для зовнішніх ресурсівНеобов’язкове · за замовчуванням вимкнено

    Журнал, файли та контрольні точки шифруються за допомогою алгоритму AES-GCM перед завантаженням у сховище, сумісне з S3. Ключ залишається у вас; вкладення іменуються за допомогою хеш-значень з ключем, а не за хешем їхнього вмісту.

  • СповіщенняНеобов’язкове · за замовчуванням вимкнено

    Проблеми та кількість змін із заголовками чатів. Витяги з повідомлень надсилаються лише в тому випадку, якщо ви ввімкнете цю функцію.

  • Служба міток часуНеобов’язкове · за замовчуванням вимкнено

    Лише SHA-256 підписаної контрольної точки та випадковий нонс. Жодних повідомлень, жодних імен учасників чату.

  • СвідокНеобов’язкове · за замовчуванням вимкнено

    За допомогою токена, призначеного лише для читання, витягує підписані контрольні точки та лічильники записів. Інструмент не може читати переписки або змінювати налаштування.

За замовчуванням: з цього комп’ютера надходить лише з’єднання з Telegram.

Додаткові місця призначення налаштовуються для кожного робочого простору.

Що відкриває кожна таємниця

СекретДе це зберігаєтьсяЩо це відкриваєУ разі витоку
Токен панеліpanel-token.txt у папці даних; браузер зберігає його для вкладкиУсе в усіх просторахЗупиніть TgWitness, видаліть panel-token.txt, запустіть знову — буде новий
Сесія TelegramСховище, зашифроване (credentials.enc)Сам акаунт у TelegramЗавершіть сесію в Telegram у меню «Налаштування» → «Пристрої»
Ключ підписуСховище, зашифроване (signing.enc)Підпис записів вашим відбиткомКонтрольні точки деінде, свідок і мітки часу все одно показують, що було раніше
Ключ сховищаvault.key поруч із даними або зовнішній майстер-ключСховище секретівВважайте, що сесія й ключ підпису теж витекли
Токен WitnessНа хостингу WitnessЛише читання: контрольні точки й станВидаліть його на сторінці свідка й створіть новий
Ключові фрази для зовнішніх матеріалівVault; завантажте його один раз для відновлення данихЗовнішню копіюТой, хто має ще й бакет, може її розшифрувати: вважайте копію розкритою

Що охоплює захист

Охоплено

  • Змінений, видалений чи переставлений запис: ламається ланцюжок хешів або підпис.
  • Журнал обрізали чи перебудували після того, як ви зберегли контрольну точку деінде: точка перестає збігатися.
  • Підбір токена: 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/, сесійні ключі, panel-token.txt або ключі сховища на GitHub або в чат.
  8. Не реєструйте заголовки Authorization або тіла запитів на зворотньому проксі-сервері.
Чи можна змінити токен панелі без втрати даних?

Так, він лише відкриває панель. Зупиніть TgWitness, видаліть panel-token.txt, запустіть знову. Журнал, сесії й ключі лишаться. Якщо задано TGWITNESS_TOKEN, використовується він, а не файл.

Повідомити про вразливість

Security → Report a vulnerability на GitHub. Версія, наслідки й мінімальний приклад на вигаданих даних. Ніколи не надсилайте облікові дані, папки акаунтів чи справжні докази. Якщо приватні звіти вимкнено, відкрийте issue з проханням про закритий канал, без деталей експлойту.