# Telegram · Таємні чати: налаштування та запис

Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/secret-chats/

Встановіть протокольний модуль таємних чатів, увімкніть його для облікового запису та записуйте чати, які TgWitness створює або приймає.

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

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

Встановіть протокольний модуль таємних чатів, увімкніть його для облікового запису та записуйте чати, які TgWitness створює або приймає.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документація](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

Опублікований додаток містить серверну частину «Секретного чату», інтеграцію з колектором, маршрути API та інтерфейс **Pseudo-secret**. Бібліотека протоколів є окремим модулем: відкрийте **Pseudo-secret**, натисніть **Встановити та увімкніть**. Автоматичне прийняття вхідних повідомлень залишається вимкненим, доки ви його не увімкнете.

## Модуль протоколу

|  |  |
| --- | --- |
| Модуль | `kiaro-telethon-secret-chat` 0.2.0 |
| Автор | KiaroSama |
| Ліцензія | GPL-3.0 або пізніша версія; її `LICENSE` і `NOTICE` залишайтеся всередині збереженого архіву |
| Джерело | [KiaroSama/Telethon-Secret-Chat](https://github.com/KiaroSama/Telethon-Secret-Chat) у коміті `d87bf037b90060383c7b704d8a06ebb98c621c6f` |
| Перевірити | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` над списком файлів пакетів та їхніми власними значеннями SHA-256 |

Функція **Встановити та увімкнути** доступна головному адміністратору. TgWitness завантажує архів вихідного коду цього коміту з GitHub через маршрут робочого простору для запитів поза межами Telegram, порівнює кожен файл пакета зі значенням, зафіксованим у випуску TgWitness, зберігає архів у `modules/telethon-secret-chat-<commit>.zip` у каталозі даних і завантажує код з пам’яті. Перезапуск не потрібен. Перевірка виконується заново під час кожного запуску; архів, що відрізняється, не завантажується, і на сторінці з’являється відповідне повідомлення. Змінений, відсутній або доданий файл пакета призводить до невдачі перевірки.

Цей модуль є окремим програмним продуктом, що розповсюджується за власною ліцензією. TgWitness не включає його до свого пакету: під час кожної інсталяції він завантажується з репозиторію його автора. На сторінці **Деталі** відображаються інформація про завантажений модуль, його автора, ліцензію, коміт та SHA-256.

Користувач, який не має доступу до GitHub, може замість цього встановити той самий коміт у середовище Python; після цього панель використовуватиме саме цю копію:

```
python -m pip install ".[secret-chats]"
```

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

## Доступність пакета

8 листопада 2026 року опублікований інсталяційний пакет було перевірено за вихідним кодом [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) , версією `b35f8e18f3d1-1ff85ec98bb2` , попередньою версією 0.9.1 . [Незмінний файл wheel](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) та його блокування залежностей пройшли перевірку підписів випуску за алгоритмами SHA-256 та RSA. Упакований бекенд та інтерфейс повністю збігалися з цією ревізією вихідного коду байт за байтом. Пакет також містить реєстрацію API та хуки колектора.

Цей пакет не містив бібліотеку протоколів, і її немає у файлі lock. Додатковий `secret-chats` Елемент «extra» у [файлі pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml) фіксує той самий комміт, що й кнопка на панелі.

Ця перевірка пакета визначає, які файли та декларації залежностей постачаються. [Запис валідації](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/) ідентифікує окремі перевірки під час виконання. Попередній посібник від 6 листопада описував знімок розробки; він більше не описує вищезазначений пакет.

## Використовуйте інтерфейс

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

| Дія | Збережений результат |
| --- | --- |
| Почати чат за іменем користувача або ідентифікатором користувача | Вихідний запит; одноранговий вузол приймає його на своєму пристрої. |
| Прийняти запит | TgWitness стає приймальною кінцевою точкою. |
| Надіслати або отримати повідомлення | `secret_chat.message` із зазначенням напрямку, вмісту та заданого таймера. |
| Отримати файл | Розшифровані байти, що зберігаються за допомогою SHA-256 та квитанції `secret_chat.file`; включені до експорту доказів. |
| Отримати повідомлення про таймер або видалення | Окремий запис дії поряд із збереженими повідомленнями та файлами. |
| Переглянути чат | Відеозаписи розмов, квитанції про отримання файлів, повідомлення та візуалізація ключів. |

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

## Знайти збережені повідомлення

Скористайтеся **функцією пошуку повідомлень** у відкритому чаті, щоб знайти точну фразу, не зважаючи на регістр. **Кнопки Попереднє** та **Наступне** або комбінації клавіш Enter і Shift+Enter у полі пошуку дозволяють переходити між повідомленнями, що відповідають запиту. Лічильник підраховує кількість повідомлень; перша фраза, що відповідає запиту, у кожному повідомленні виділяється. Клавіша Escape очищає поле пошуку.

Функція пошуку залишає видимими супутню розмову, збережені файли та повідомлення про видалення. Вона здійснює пошук серед записів, які вже завантажено на панелі. Якщо є старіші записи, панель повідомляє про це; **команда Завантажити старіші записи** розширює історію та оновлює результати пошуку, залишаючи поточне повідомлення на місці.

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

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

## Засоби забезпечення стійкості та взаємодії

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

Розшифровані повідомлення, запис яких у журнал завершився невдало, зберігаються у сховищі для повторної спроби. Перевірка розміру вкладень та вільного місця на диску відкладає завантаження, зберігаючи при цьому відповідні завдання. Модуль повторно використовує існуюче з’єднання облікового запису. Повідомлення про прочитання та набір тексту надсилаються лише відповідно до налаштувань у розділі [Що бачить інша сторона](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees); повідомлення зі знімками екрана ніколи не надсилаються. Див. [secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py), [маршрути API](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py) та [політику доступу](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py).

[Історичний аудит](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) зберігає свої оригінальні результати знімків. Поточну доступність та реалізацію слід перевіряти за версією пакета, вказаною вище, та [поточними можливостями](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md).

## Демонстрація інтерфейсу

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