# Telegram · Безпека та обробка даних

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

Модель загроз, модель доступу, збереження конфіденційних даних, мережева вразливість, імпорт сеансів та порядок повідомлення про вразливість.

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

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

Модель загроз, модель доступу, збереження конфіденційних даних, мережева вразливість, імпорт сеансів та порядок повідомлення про вразливість.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документація](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Розгортання та відновлення](https://phishdestroy.io/tgwitness/uk/docs/reference/deployment/)

![Розгортання та відновлення](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

На цій сторінці описано доступ, зберігання та захист мережі в локальному робочому просторі або на сервері. Щодо збору даних на GitHub Runner або в конфіденційній віртуальній машині Intel TDX див. режими [перевірки](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope), які додають перевірки середовища збору даних. Підключення облікових записів, сповіщення, мітки часу, позасайтові копії та свідки мають власні налаштування маршрутизації.

| Область | Коротко |
| --- | --- |
| Доступ | Ключ адміністратора та обмежений доступ до облікових записів/чатів, сім рівнів дозволів та сесії, що можуть бути скасовані; за замовчуванням — localhost |
| Секрети в стані спокою | Сесія, пара API, ключ підпису та налаштування проксі-сервера шифруються за допомогою алгоритму Fernet |
| Повідомлення та мультимедіа | Файли в робочій області, захищені шифруванням диска або тома та правами доступу до файлів хоста |
| Цілісність | Ланцюжок хеш-кодів SHA-256 та підпис Ed25519 на кожному записі |
| Зовнішній час | Квитанції RFC 3161 та OpenTimestamps, публікації свідків із датуванням від Telegram та засвідчення GitHub; збережені контрольні точки, записи свідків та вимірювання Intel TDX є підтверджуючими доказами. Верифікатор повідомляє, яким умовам щодо доказів вони відповідають |

Щодо повідомлень про вразливості див. [політику безпеки](https://github.com/phishdestroy/TgWitness/blob/main/.github/SECURITY.md).

**На цій сторінці**

- [Модель доступу](https://phishdestroy.io/tgwitness/uk/docs/reference/security/#access-model)
- [Вміст панелі та експортні дані](https://phishdestroy.io/tgwitness/uk/docs/reference/security/#panel-content-and-exports)
- [Секрети в стані спокою](https://phishdestroy.io/tgwitness/uk/docs/reference/security/#secrets-at-rest)
- [Проксі-сервери та мережеві маршрути](https://phishdestroy.io/tgwitness/uk/docs/reference/security/#proxies-and-network-routes)
- [Вхід та імпорт сеансів](https://phishdestroy.io/tgwitness/uk/docs/reference/security/#sign-in-and-session-imports)
- [Журнали та транспорт](https://phishdestroy.io/tgwitness/uk/docs/reference/security/#logs-and-transport)
- [Цілісність та зовнішній час](https://phishdestroy.io/tgwitness/uk/docs/reference/security/#integrity-and-external-time)
- [Якщо ви підозрюєте наявність проблеми](https://phishdestroy.io/tgwitness/uk/docs/reference/security/#if-you-suspect-a-problem)

## Модель доступу

Токен головної панелі надає повний контроль. Інші користувачі можуть отримати власний [обмежений доступ](https://phishdestroy.io/tgwitness/uk/docs/reference/access/): обрані робочі простори та чати, дозволи, термін дії, обмеження за IP-адресами, обмеження на вхід та сесії, що можна скасувати. Користувач з обмеженим доступом до чату не може виконувати операції з усім робочим простором, навіть якщо його дозвіл відмічено. Кожна робоча область має власний журнал, сховище та ключ підпису в межах одного процесу; розмежування між користувачами на хості здійснюється за допомогою облікових записів операційної системи.

За замовчуванням панель слухає на localhost. При вході через браузер токен доступу обмінюється на сесійні облікові дані; браузер надсилає їх як токен-носій. Він зберігається у sessionStorage, а не у файлі cookie автентифікації. Блокування/вихід з системи очищає сесію браузера. Закриття браузера або завершення сесії не зупиняє збір даних.

Видані токени та облікові дані сеансів зберігаються у вигляді хеш-значень у зашифрованому сховищі. Анулювання призводить до завершення відповідних сеансів; зміни дозволів впливають на наступні запити. Завантажені файли неможливо відкликати. Адміністратор може обмежувати також власні сеанси браузера, але скрипти, що безпосередньо використовують токен головної панелі, зберігають повний доступ і обходять ці обмеження сеансів браузера.

Кількість невдалих спроб автентифікації обмежується за адресою клієнта. Обмеження за IP-адресою застосовуються до адреси, яку бачить додаток; перед тим, як покладатися на це, перевірте поведінку зворотного проксі-сервера. Повноваження Witness залишаються окремими повноваженнями для перевірки стану та контрольних точок, доступними лише для читання.

### Доступ до демо-версії

`/api/demo-access` — це навмисно неавтентифікований бутстрап для явно запущеної, ізольованої синтетичної демонстрації. Він видає окрему можливість, що діє протягом терміну існування процесу, але ніколи не видає справжній токен панелі або перезапис TGWITNESS_TOKEN. Для видачі та використання потрібні локальний вузол та хост, без переадресованих заголовків і без міждоменних запитів. Додаткові робочі простори або авторизована сесія блокують цей шлях. Активні робочі простори ніколи не видають цю можливість. Демо-версія не може пов’язувати акаунти або змінювати налаштування збору даних.

## Вміст панелі та експорт даних

Панель не використовує зовнішніх шрифтів, аналітики, ресурсів CDN або вбудованих віддалених медіафайлів. Текст із Telegram вставляється у вигляді тексту, а не HTML. Завантажені вкладення подаються як бінарні вкладення. Експорт у форматі JSONL зберігає оригінальні рядки; HTML замінює їх; комірки CSV, які можуть стати формулами, мають префікс у вигляді апострофа.

Експортовані дані не містять секретів автентифікації та підпису, але навмисно містять зібрані метадані джерела, ідентифікатори та, можливо, особистий або конфіденційний вміст. У необроблених метаданих джерела можуть зустрічатися хеші доступу до Telegram та посилання на файли.

## Секрети в стані спокою

Повноваження API Telegram, сесія та ключ підпису зашифровані за допомогою Fernet. Для локальних повідомлень та мультимедіа шифрування забезпечується диском або томом хоста; робоча область зберігає звичайні файли. Для експорту можна використовувати ZIP-архів із захистом паролем за алгоритмом AES-256, а для позасайтових копій — AES-256-GCM.

За замовчуванням ключ сховища зберігається у каталозі захищених даних. Використовуйте зовнішній файл головного ключа, наведений нижче, щоб зберігати його окремо. У Unix нові файли приватних ключів використовують режим 0600, а нові каталоги даних — 0700; у Windows налаштуйте список прав доступу (ACL) до каталогу для облікового запису служби та авторизованих адміністраторів. Існуючі права доступу до каталогу зберігаються.

### Зовнішній головний ключ

Для нового каталогу даних TGWITNESS_VAULT_KEY_FILE може надавати зовнішній випадковий головний ключ. HKDF-SHA256 та окремий випадковий солт генерують різний ключ Ферне для кожної робочої області. Файл vault.external.json необхідно зберегти для відновлення. Відсутність або неправильні головні ключі призводять до збою. Існуючі локальні сховища не мігруються автоматично. На панелі відображається вибраний режим зберігання ключів. Шифрування диска захищає локальні повідомлення та мультимедійні файли в обох режимах; деталі налаштування див. у розділах « [з’єднання» та «](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/) захист даних».

## Проксі-сервери та маршрути мережі

Налаштування проксі-сервера шифруються у сховищі. Паролі та секретні дані MTProxy не повертаються API та не записуються у записи доказів. Кожна робоча область обирає свій маршрут Telegram та [режим IP](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/#ip-modes).

**Функція «Приховати адресу»** відключає прямий резервний доступ до Telegram і вимагає використання проксі для зовнішніх HTTP-запитів. Явно обраний режим резервного доступу дозволяє прямий доступ до Telegram після певної затримки; режим тунелю/VPN дозволяє прямі маршрути. Вибір режиму тунелю не передбачає встановлення чи перевірку VPN. Ці налаштування не контролюють весь трафік комп’ютера, браузери, менеджери пакетів або вирішення DNS локальним проксі-хостом.

MTProxy передає лише трафік Telegram. Зовнішні запити можуть використовувати окремий проксі SOCKS5/HTTP, маршрут SOCKS5/HTTP робочого простору або дозволений прямий маршрут; їх також можна вимкнути. Незалежний свідок має власні налаштування транспорту. Звичайна аутентифікація SOCKS5/HTTP CONNECT не шифрується цими проксі- протоколами. Підроблені секретні ключі TLS для MTProxy залишаються непідтримуваними.

## Вхід та імпорт сеансів

Конвертовані файли .tgwitness-session містять секрет авторизації у вигляді звичайного тексту, доки їх не завантажено та не збережено у сховищі. Офлайн-інтерфейс командного рядка (CLI) підтримує перевірені схеми Telethon. Імпорт через панель додатково підтримує Pyrogram SQLite, сучасний ZIP-файл TData для одного облікового запису, а також задокументовані вхідні дані у форматі JSON. Він проходить автентифікацію, обмежений чотирма файлами / 8 МіБ, і обробляє завантажені дані в пам’яті без розпакування архіву чи збереження оригінальних файлів. Нормалізовані облікові дані повертаються лише браузеру, що надіслав запит та пройшов автентифікацію; вони зберігаються у зашифрованому сховищі після успішної авторизації в Telegram. Захищайте оригінали та конвертовані файли, а також уникайте одночасного клонування авторизації різними клієнтами.

Обробка TData перевіряє контрольні суми контейнерів, хеші локального дешифрування та довжини структур. Наданий локальний пароль для Desktop використовується тимчасово і не зберігається. Обмежений парсер підтримує формати Desktop, які він перевіряє, та відхиляє інші. QR-зображення генеруються локально, містять короткочасні токени входу в Telegram і ніколи не надсилаються до зовнішньої служби візуалізації. Блокування, перемикання робочого простору, новий вхід та зміни маршруту скасовують очікувані спроби QR-сканування. Перезавантаження/закриття вкладки може залишити спробу в стані очікування до закінчення терміну дії. Успішний вхід за QR-кодом все одно вимагає прив’язки облікового запису. Звичайні тіла запитів API залишаються обмеженими до 16 KiB; маршрут імпорту з автентифікацією приймає до 12 MiB закодованого JSON, окремо застосовуючи обмеження на розмір декодованого файлу.

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

## Журнали та передача даних

Стандартна відповідь API на перевірку замінюється, щоб вона не відбивала значення облікових даних. Реєстрація доступу до додатка вимкнена. Не налаштовуйте зворотний проксі для реєстрації заголовків авторизації або тіл запитів. Панель прослуховує localhost; віддалений доступ здійснюється через наданий SSH-тунель, Cloudflare Tunnel або Caddy HTTPS, тож токени та секретні дані для входу передаються через SSH або TLS.

## Цілісність та зовнішній час

Під час перевірки здійснюється зіставлення підписів записів, ланцюжка хеш-кодів, вкладень та маніфесту експорту з ключем колектора. Чинний підпис свідчить про те, що байти не зазнали змін з моменту їх підписання. Кожна робоча область створює свій ключ підписання під час першого запуску та відображає свій відбиток на панелі та в кожному експорті. Оператор передає відбиток одержувачу через окремий канал, а `--fingerprint` закріплює ключ.

Змінений, вставлений або видалений запис порушує хеш-ланцюг або підпис, і верифікатор повідомляє про це. Зовнішні мітки часу та свідок також фіксують журнал поза межами робочої області. Тригери SQLite для таблиці журналу лише запобігають тому, щоб програма випадково перезаписала або видалила запис. `TGWITNESS_VAULT_KEY_FILE` зберігає ключ сховища поза копією каталогу даних.

RFC 3161, квитанції OpenTimestamps та публікації свідків, дати яких верифікатор зчитує з Telegram, прив’язують префікс журналу, який вони охоплюють, до часу, встановленого третьою стороною. Раунд drand, записаний у журнал, свідчить про те, що записи, які йдуть за ним, були створені не раніше, ніж цей раунд був опублікований. Перевірене засвідчення GitHub також містить перевірений час свого підпису, що прив’язує весь архів до зовнішнього часу. Контрольна точка підписується ключем збирача та прив’язує записи до неї, починаючи з моменту, коли одержувач отримав її через інший канал. Свідчення показує, що другий ключ зберігав початок журналу; запис контролю ключів зберігача показує, хто володіє цим ключем. Обидва є допоміжними перевірками; мінімальною вимогою є час від третьої сторони. [Запис GitHub Actions](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) або [розгортання Intel TDX](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) додають походження робочого процесу або апаратні вимірювання середовища збору даних.

Кожна відповідь на перевірку містить перелік умов доказів із зазначенням того, як кожна з них була перевірена, згруповані за їхньою роллю у мінімумі:

| Роль | Умова |
| --- | --- |
| Обов’язкові вимоги | Цілісність; ключ підписувача закріплений за допомогою `--fingerprint`; зовнішній час, що охоплює останній запис (квитанція за RFC 3161 перевірена за допомогою `--tsa-ca`, квитанція OpenTimestamps підтверджена за допомогою `--check-bitcoin`, публікація свідка прочитана з t.me за допомогою `--channel`, печатка Bitcoin свідка або перевірене засвідчення GitHub) |
| Додаткові функції, що не входять до мінімального набору | Свідок із власним ключем; збережена контрольна точка; засвідчений цикл збору даних |

Цей **мінімальні вимоги до доказів** чи всі три необхідні умови виконуються щодо останнього експортованого запису; перевірений та засвідчений цикл збору даних додає `attested` профіль. В останньому рядку наводиться результат, а у відповіді вказано варіанти, які відповідають відсутнім умовам. Без `--fingerprint` останній рядок починається зі слів `EVIDENCE: minimum not met · missing: confirmed signer key`. Якщо перевірені часові мітки охоплюють лише попередні записи, у відповіді вказується запис, до якого зберігається мінімальне значення. `--require evidence` або `--require attested` програма завершується з кодом 2, коли профіль не досягається протягом усього експорту, а запит на перевірку в командному рядку, який неможливо виконати, позначається як невиконаний із тим самим кодом. Кожен звіт містить ті самі умови разом із їхнім станом у цій копії та командою, яка їх перевіряє. Рівні гарантії та `--strict` залишаються доступними; ці [формат доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope) містить перелік перевірок для кожного режиму збору даних.

## Якщо ви підозрюєте наявність проблеми

Збережіть оригінальний каталог даних і використовуйте окрему копію для аналізу. Повідомте про версію, операцію та кроки, що дозволяють відтворити проблему, через [політику безпеки](https://github.com/phishdestroy/TgWitness/blob/main/.github/SECURITY.md), зберігаючи конфіденційність даних облікового запису та облікових даних.
