Документація / 14
Telegram · Забезпечте безпеку
Що йде з вашої машини, що відкриває кожен секрет і що захищено, а що лишається на вас.
Де все зберігається
Збирач, панель і всі записи лишаються на вашій машині. Типово зв'язок є лише з Telegram, усе інше вмикається окремо.
- 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-тунель.
- Перевіряйте охоплення на пропуски й тестуйте доставку на власних акаунтах і джерелах.
Дайте доступ до справи з правами, терміном дії й лімітом сесій.
Зміцнення безпеки інсталяції
- Використовуйте окремий акаунт Telegram, ніколи не основний.
- Тримайте панель на 127.0.0.1. Віддалено — лише через HTTPS (вбудований Caddy) або SSH-тунель.
- Зашифруйте диск з папкою даних.
- Обмежте папку даних службовим обліковим записом (0700 в Unix, права папки у Windows).
- Зберігайте ключ сховища окремо на серверах: задайте
TGWITNESS_VAULT_KEY_FILEдо першого запуску. - Зберігайте відбиток і контрольні точки на іншій системі, запустіть свідка на іншому хості.
- Ніколи не завантажуйте ключі
data/, сесійні ключі,panel-token.txtабо ключі сховища на GitHub або в чат. - Не реєструйте заголовки
Authorizationабо тіла запитів на зворотньому проксі-сервері.
Чи можна змінити токен панелі без втрати даних?
Так, він лише відкриває панель. Зупиніть TgWitness, видаліть panel-token.txt, запустіть знову. Журнал, сесії й ключі лишаться. Якщо задано TGWITNESS_TOKEN, використовується він, а не файл.
Повідомити про вразливість
Security → Report a vulnerability на GitHub. Версія, наслідки й мінімальний приклад на вигаданих даних. Ніколи не надсилайте облікові дані, папки акаунтів чи справжні докази. Якщо приватні звіти вимкнено, відкрийте issue з проханням про закритий канал, без деталей експлойту.