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

Canonical page: https://phishdestroy.io/tgwitness/uk/docs/security/

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

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt)

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

**127.0.0.1**адреса панелі за замовчуванням

**256-бітний**випадковий токен панелі

**0**CDN, аналітика або віддалені шрифти

**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-тунель.
- Перевіряйте охоплення на пропуски й тестуйте доставку на власних акаунтах і джерелах.

[Дайте доступ до справи](https://phishdestroy.io/tgwitness/uk/docs/access/) з правами, терміном дії й лімітом сесій.

## Зміцнення безпеки інсталяції

Виконано 0 з 8

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 з проханням про закритий канал, без деталей експлойту.
