# TgWitness · Українська > Documentation edition: Українська. Project version: `0.9.3`. Source branch: `main`. This index links the Markdown editions of the public pages. The complete handbook is built from the same page content, including source URLs. Sections without a translation appear in English. - [Project context, installation, measured scale and verification](https://phishdestroy.io/tgwitness/docs/reference/overview/index.md) - [English project summary](https://phishdestroy.io/tgwitness/llms.txt) - [Complete handbook · Українська](https://phishdestroy.io/tgwitness/uk/llms-full.txt) - [Complete handbook as Markdown · Українська](https://phishdestroy.github.io/TgWitness/uk/llms-full.md) - [Source code and release history](https://github.com/phishdestroy/TgWitness) - [Collection modes and evidence levels](https://phishdestroy.io/tgwitness/uk/guides/modes.md) - [Published checks and measurements](https://phishdestroy.io/tgwitness/docs/validation/index.md) ## Complete documentation map ### Guides - [Робота з архівом](https://phishdestroy.io/tgwitness/uk/docs/archive/index.md): Завантажуйте історію, шукайте збережені записи, переглядайте джерела штучного інтелекту та підключайте свої інструменти. - [Запис дій на GitHub Actions](https://phishdestroy.io/tgwitness/uk/docs/capture/index.md): Виберіть Takeout, експорт через звичайний API або журнал чату на тимчасовому раннері GitHub. - [Спеціальний обліковий запис](https://phishdestroy.io/tgwitness/uk/docs/dedicated-account/index.md): Створіть окремий акаунт у Telegram для збору даних. - [Почніть за лічені хвилини](https://phishdestroy.io/tgwitness/uk/docs/start/index.md): Встановіть однією командою, підключіть обліковий запис Telegram та експортуйте архів, який можна перевірити, на Windows, Linux або macOS. - [Підключити обліковий запис](https://phishdestroy.io/tgwitness/uk/docs/accounts/index.md): Підключіть Telegram за допомогою QR-коду, номера телефону або імпорту сеансу. Оберіть джерела та переконайтеся, що нові повідомлення надходять до вашого журналу. - [Виберіть проксі-сервер](https://phishdestroy.io/tgwitness/uk/docs/proxies/index.md): Підтримуйте автоматичні маршрути MTProxy або використовуйте власний проксі-сервер. Обирайте режими IP, правила резервного переходу та маршрут для зовнішніх запитів. - [Експорт та перевірка](https://phishdestroy.io/tgwitness/uk/docs/exports/index.md): Експортуйте збережену історію Telegram, перевіряйте підписи та порівнюйте журнал із контрольною точкою, збереженою незалежним свідком. - [Дізнайтеся, як працює система збереження доказів](https://phishdestroy.io/tgwitness/uk/docs/concepts/index.md): Простежте шлях повідомлення від моменту фіксації до контрольної точки. Змініть зразок запису, перерахуйте його ланцюжок SHA-256 і подивіться, що виявить збережена контрольна точка. - [Проведіть розслідування у всіх чатах](https://phishdestroy.io/tgwitness/uk/docs/cases/index.md): Проведіть комплексне розслідування в Telegram, охопивши канали, групи, приватні чати та боти: повне копіювання облікового запису, історію, користувачів, посилання, файли, хронологію та перевірені докази. - [Створити «Case Board»](https://phishdestroy.io/tgwitness/uk/docs/case-board/index.md): Збирайте збережені спостереження, точні виділення та фрагменти дій на приватній дошці, обговорюйте їх зі своєю командою та презентуйте збірку. - [Створіть звіт](https://phishdestroy.io/tgwitness/uk/docs/reports/index.md): Виберіть дані звіту, один із восьми макетів та зміст, а потім перегляньте попередній варіант і експортуйте HTML, підписаний PDF або повний пакет доказів. - [Підготуйте копію для поширення](https://phishdestroy.io/tgwitness/uk/docs/handover/index.md): Виберіть записи та поля, які може отримати одержувач, перевірте готову копію та переконайтеся у правильності підписаного маніфесту та меж журналу джерел. - [Управління групою облікових записів](https://phishdestroy.io/tgwitness/uk/docs/groups/index.md): Порівнюйте групові робочі простори, знаходьте джерела, переглядайте періоди спостереження та застосовуйте спільні налаштування з винятками для окремих облікових записів. - [Забезпечте безпеку](https://phishdestroy.io/tgwitness/uk/docs/security/index.md): Дізнайтеся, де зберігаються сесії, ключі та докази, що виходить за межі вашого комп’ютера, що охоплює система захисту та як посилити безпеку інсталяції. - [Поділитися справою](https://phishdestroy.io/tgwitness/uk/docs/access/index.md): Надайте рецензентам та аналітикам доступ до вибраних акаунтів і чатів із окремими правами доступу, обмеженнями сеансів та токенами, які можна скасувати. - [Налаштування бота-свідка](https://phishdestroy.io/tgwitness/uk/docs/witness/index.md): Публікуйте підписані контрольні точки журналу у своєму каналі Telegram із окремим свідком, власним ключем та доступом до колектора лише для читання. - [Чому саме «нульова довіра»: Taylor Wessing, д-р Цурхайде, д-р Шелінський](https://phishdestroy.io/tgwitness/uk/docs/signed-export/index.md): Приклад застосування моделі «нульової довіри»: відповідь щодо GDPR, підписана д-ром Патріком Цурхайде та д-ром Тобіасом Шелінскі з юридичної фірми Taylor Wessing, перевірена на відповідність власним документам, а також перевірюваній моделі, яка не залишала б місця для обману чи сумнівів. - [Забезпечте його безперебійну роботу](https://phishdestroy.io/tgwitness/uk/docs/server/index.md): Запустіть TgWitness на сервері з постійним сховищем даних, приватним доступом до панелі управління, резервним копіюванням та перевірками після перезапуску. - [З’ясуйте, що пішло не так](https://phishdestroy.io/tgwitness/uk/docs/troubleshooting/index.md): Перевіряйте доступ до панелі, з’єднання з Telegram, відсутні повідомлення, FloodWait та статус свідка, використовуючи відповідні сигнали для кожної проблеми. ### Reference - [Таємні чати: налаштування та запис](https://phishdestroy.io/tgwitness/uk/docs/reference/secret-chats/index.md): Встановіть протокольний модуль таємних чатів, увімкніть його для облікового запису та записуйте чати, які TgWitness створює або приймає. - [TgWitness: початок, масштаб та докази](https://phishdestroy.io/tgwitness/uk/docs/reference/overview/index.md): Встановіть за допомогою однієї команди або запустіть на GitHub Actions. Ознайомтеся з варіантами розслідування, опублікованим масштабом та тим, що перевіряє архів. - [Завантажити історію джерел](https://phishdestroy.io/tgwitness/uk/docs/reference/history/index.md): Завантажуйте минулі повідомлення з увімкнених джерел, призупиняйте та відновлюйте процес, а також перевіряйте підписаний звіт про хід роботи. - [Аналіз архіву](https://phishdestroy.io/tgwitness/uk/docs/reference/analysis/index.md): Здійснюйте пошук серед збережених повідомлень, переглядайте результати роботи штучного інтелекту та зберігайте аналітичні звіти з посиланнями на джерела. - [Командний рядок](https://phishdestroy.io/tgwitness/uk/docs/reference/cli/index.md): Здійснюйте пошук, читайте контекст, підраховуйте активність та експортуйте збережені повідомлення зі скриптів та агентів із виведенням у форматі --json, стабільними кодами завершення та токенами з обмеженим доступом, призначеними лише для читання. - [Повнотекстовий пошук](https://phishdestroy.io/tgwitness/uk/docs/reference/search/index.md): Знайдіть збережені повідомлення за формами слів, точними фразами, доменами та @іменами користувачів, з найкращими збігами на початку, з індексом, прив’язаним до підписаного журналу. - [MCP тільки для читання](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/index.md): Підключіть клієнт MCP до вибраних робочих просторів та чатів із тимчасовим, відкличним доступом. - [Локальне розпізнавання тексту (OCR) та транскрипція](https://phishdestroy.io/tgwitness/uk/docs/reference/media-analysis/index.md): Розпізнавайте захоплені зображення та аудіо за допомогою локального робочого процесу; зберігайте отриманий текст із посиланням на вихідний файл. - [Вихідні веб-хуки](https://phishdestroy.io/tgwitness/uk/docs/reference/webhooks/index.md): Надсилайте визначені події на HTTPS-приймачі з HMAC-підписами, повторними спробами та статусом доставки. - [Повідомлення про несумісність з певними операторами](https://phishdestroy.io/tgwitness/uk/docs/reference/notice/index.md): Наше повідомлення оператора щодо компанії Taylor Wessing та її джерела інформації. - [Повідомлення про несумісність ліцензій та архітектури](https://phishdestroy.io/tgwitness/uk/docs/reference/license/index.md): TgWitness надається під ліцензією MIT для загального користування, і чому він архітектурно несумісний із робочим процесом Taylor Wessing. - [Швидкий старт](https://phishdestroy.io/tgwitness/uk/docs/reference/quickstart/index.md): Усі способи встановлення та запуску TgWitness: пакет для Windows, Python, Docker та синтетична демонстраційна версія з першими перевірками. - [Формати облікових записів та сеансів](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/index.md): Увійдіть за допомогою телефону, QR-коду або ключа автентифікації, імпортуйте сесії з Telethon, Pyrogram або Telegram Desktop та керуйте кількома обліковими записами. - [Доступ та дозволи](https://phishdestroy.io/tgwitness/uk/docs/reference/access/index.md): Надавайте доступ до облікових записів та чатів з обмеженим обсягом повноважень, обирайте права доступу, обмежуйте сеанси та IP-адреси, а також скасовуйте доступ. - [Підключення, проксі-сервери та захист даних](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/index.md): Аутентифікація, автоматичні пули проксі-серверів, режими IP, політика резервного переходу, зовнішні запити та зберігання секретних даних. - [Впровадження](https://phishdestroy.io/tgwitness/uk/docs/reference/deployment/index.md): Запускайте TgWitness як службу на Windows, Linux, macOS або в Docker, через HTTPS, із резервним копіюванням та оновленнями. - [Як відбувається збір даних](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/index.md): Обсяг спостереження, оновлення в режимі реального часу, повторні перевірки, вкладення, власні дії та значення пропусків — запис за записом. - [Робочі процеси та операції](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/index.md): Щоденна робота панелі: режими, категорії моніторингу, параметри, сповіщення, експорт даних, резервне копіювання та ємність. - [Режим розслідування](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/index.md): Повні розслідування акаунтів у каналах, групах, приватних чатах та ботах — від визначення обсягу до формування перевіреного пакету матеріалів справи. - [Довідка щодо Case Board](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/index.md): Закладки, точні виділення, фрагменти дій, обговорення, обмежений доступ та історія підписаних анотацій, що використовуються Case Board. - [Налаштування та перевірка звітів](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/index.md): Фільтри звітів, вісім макетів, пресети змісту, збережені історії змін та оцінка, що містяться у підписаних експортованих файлах. - [Можливості та охоплення](https://phishdestroy.io/tgwitness/uk/docs/reference/features/index.md): Поточна модель збору даних, робочі процеси з кількома обліковими записами, експорт даних та операційні обмеження TgWitness. - [Як працює система збереження доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/how-it-works/index.md): Пояснення щодо хеш-ланцюга, підписів, контрольних точок та свідків із зазначенням точних формул, які використовує верифікатор. - [Формат доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/index.md): Вміст підписаного ZIP-архіву, типи записів, підтвердження обробки, профілі користувачів, зовнішні копії та офлайн-перевірка. - [Незалежний свідок](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/index.md): Запустіть «witness» із власним ключем та ботом, опублікуйте підписані контрольні точки в каналі та звіряйте експортовані дані з ними. - [Часові мітки](https://phishdestroy.io/tgwitness/uk/docs/reference/timestamp/index.md): Часові мітки RFC 3161 для підписаних контрольних точок: що надсилається до центру авторизації та як перевіряється відповідь. - [Переклад звітів для суду](https://phishdestroy.io/tgwitness/uk/docs/reference/translation/index.md): Який файл є оригіналом, що подавати разом із завіреним перекладом і які терміни зберігають перекладачі. - [Безпека та обробка даних](https://phishdestroy.io/tgwitness/uk/docs/reference/security/index.md): Модель загроз, модель доступу, збереження конфіденційних даних, мережева вразливість, імпорт сеансів та порядок повідомлення про вразливість. - [Архітектура](https://phishdestroy.io/tgwitness/uk/docs/reference/architecture/index.md): Компоненти колектора, панелі, журналу, робочих процесів та свідка, а також схема передачі даних між ними. - [Що було протестовано](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/index.md): Тестування Telegram у режимі реального часу, автоматизовані перевірки, перевірки в браузері та наступні кваліфікаційні прогони. - [Журнал змін](https://phishdestroy.io/tgwitness/uk/docs/reference/changelog/index.md): Усі зміни за версіями, включаючи ті, що ще не опубліковані. - [Посібник з панелей](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/index.md): Кожен екран панелі: чати, щоденник, джерела, експорт, додаткові функції, режими захисту та перевірка коду. - [Перше налаштування та параметри](https://phishdestroy.io/tgwitness/uk/docs/reference/settings/index.md): Майстер налаштування, цілі, рівні інтерфейсу, маршрути підключення та налаштування, спільні для групи облікових записів. - [Встановлення, перевірка та оновлення](https://phishdestroy.io/tgwitness/uk/docs/reference/installation/index.md): Встановіть за допомогою однієї команди, перевіряйте підписи та хеші, оновлюйте та видаляйте інсталяцію. - [Зберігання та відновлення](https://phishdestroy.io/tgwitness/uk/docs/reference/storage/index.md): Резервне копіювання, переміщення старих файлів у хмарне сховище, копії під захистом Object Lock та відновлення на новому комп’ютері. - [Експорт облікового запису](https://phishdestroy.io/tgwitness/uk/docs/reference/account-export/index.md): Експортуйте те, що обліковий запис може переглянути зараз: обсяг даних, завдання, які можна відновити, підписаний архів та мінімізовані копії для спільного доступу. - [Публічна вітрина](https://phishdestroy.io/tgwitness/uk/docs/reference/showcase/index.md): Публікуйте збережені повідомлення з обраних публічних каналів та підписані знімки за допомогою посилань з обмеженим терміном дії, які можна скасувати. - [Розгортання з високим рівнем безпеки](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/index.md): Захищений сервер, що працює цілодобово без вихідних, на Hetzner або Phala Cloud, шлюз DNS та перевірки, які може повторити третя сторона. --- # Telegram · Почніть за лічені хвилини Canonical page: https://phishdestroy.io/tgwitness/uk/docs/start/ Встановіть однією командою, підключіть обліковий запис Telegram та експортуйте архів, який можна перевірити, на Windows, Linux або macOS. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Встановіть за допомогою однієї команди, підключіть обліковий запис Telegram та виберіть, що зберігати. ## Встановіть на свій комп’ютер Інсталятор містить Python та необхідні залежності. Почніть з експорту чату; додавайте інструменти спостереження та розслідування за потреби. ### Linux / macOS ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` ### Windows · PowerShell / CMD ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Сервер Ubuntu: запускайте як root. Настільний комп’ютер: запускайте як звичайний користувач. Відкрийте адресу панелі, вказану інсталятором, і скористайтеся її ключем доступу. Потім підключіть свій обліковий запис Telegram. Ключ панелі та ваша авторизація в Telegram є окремими. [Встановлення, підписи та оновлення](https://phishdestroy.io/tgwitness/docs/reference/installation/) містить пояснення щодо завантаженої збірки, локального доступу та параметрів сервера. [Інструкції щодо вихідного коду та Docker](https://phishdestroy.io/tgwitness/docs/reference/quickstart/) залишаються доступними. ## Оберіть своє перше завдання 1. [Підключіть обліковий запис](https://phishdestroy.io/tgwitness/uk/docs/accounts/) за допомогою телефону, QR-коду або імпорту сеансу, що підтримується. 2. Виберіть чати, папку або обліковий запис як область дії. 3. [Експортувати вибрану історію](https://phishdestroy.io/tgwitness/docs/reference/account-export/) або розпочати спостереження, щоб зберегти майбутні зміни. 4. [Перевірити архів](https://phishdestroy.io/tgwitness/uk/docs/exports/) за допомогою окремого довіреного відбитка ключа. ## Використовуйте тимчасовий GitHub-раннер [Посібник «GitHub Actions capture](https://phishdestroy.io/tgwitness/docs/capture/)» допоможе вам із створенням форку, авторизацією, налаштуванням обсягу та паролем архіву. Завантажте зашифрований результат та інформацію про походження робочого процесу після його виконання. Для цього робочого процесу не потрібен постійний сервер-збирач. ## Ознайомтеся з сайтом без реєстрації [Відкрийте демо-версію в браузері](https://phishdestroy.github.io/TgWitness/demo/?lang=uk), щоб ознайомитися з вигаданими повідомленнями, порівняти редагування та перевірити експортні дані, перш ніж встановлювати будь-що. ![Вигляд діалогу в TgWitness із прикладами повідомлень](https://phishdestroy.io/tgwitness/assets/chats-dark.png?v=684f81f890cc) Приклад робочого простору. Ваш власний журнал створюється окремо. ## Продовжити розслідування Для поточної роботи додайте джерела, правила роботи з файлами, пошук, звіти та дозволи на обмін даними, необхідні для вашої справи. [Запуск, масштабування та докази](https://phishdestroy.io/tgwitness/docs/reference/overview/) пояснює варіанти вибору та опубліковані вимірювання. Для встановлення на сервер дотримуйтесь інструкцій у розділі [«Keep it running](https://phishdestroy.io/tgwitness/uk/docs/server/)». --- # Використовуйте окремий обліковий запис. Ніколи не використовуйте основний. Canonical page: https://phishdestroy.io/tgwitness/uk/docs/dedicated-account/ Створіть окремий акаунт у Telegram для збору даних. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Ознайомтеся з цією інформацією перед підключенням облікового запису Наша порада не використовувати ваш основний акаунт — це не жарт. Це реальність. Основний обліковий запис - За допомогою власного хешу додатка 99% облікових записів виходять із системи - Часто трапляються блокування акаунтів лише через низький рівень довіри - Використовувати свій основний акаунт — справді дурна ідея Додатковий акаунт на основі пар ідентифікаторів публічного API та хешів API - За допомогою цих пар API-ідентифікаторів та API-хешів було зареєстровано понад мільйон облікових записів - Ці пари API-ідентифікаторів та API-хешів існують вже понад 5 років - Ніхто не може побачити жодних ваших даних через ці пари API 01 ## Чому не слід використовувати свій основний акаунт Це достовірна інформація. Ми точно знаємо, у чому полягають підводні камені цих проблем. 1. ### За допомогою власного хешу додатка 99% облікових записів виходять із системи Увійти на my.telegram.org з облікового запису, до якого ви не маєте доступу, щоб отримати хеш додатка, а потім будь-який запит через цей хеш додатка означає, що ймовірність того, що обліковий запис буде виведений із системи, становить 99%. Ви можете це перевірити. 2. ### Часто трапляються блокування акаунтів лише через низький рівень довіри Акаунти блокують просто тому, що Telegram їм не довіряє, і такі блокування трапляються часто. Ви також можете це перевірити. Використовувати власний акаунт — справді дурна ідея. 3. ### Скопійовані сесійні ключі можуть бути анульовані Одночасне використання імпортованого ключа TData/сесії в Telegram Desktop та TgWitness може спричинити появу помилки `AUTH_KEY_DUPLICATED`. Telegram анулює цю авторизацію, тому обидві копії потребують нового входу. Наявність окремого облікового запису не запобігає цьому. Повністю закрийте оригінальний клієнт і тримайте його закритим під час використання імпортованої сесії. Для паралельного використання увійдіть у TgWitness за допомогою телефону або QR-коду, щоб створити окрему авторизацію; інші клієнти з окремою авторизацією можуть залишатися увійшовшими. [Ознайомтеся з попередженням щодо імпорту сеансу](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=uk#session-warning) Документація Telegram - [Помилки виходу з системи: AUTH_KEY_UNREGISTERED, SESSION_REVOKED](https://core.telegram.org/api/errors) - [Створення власного хешу додатка: отримання api_id](https://core.telegram.org/api/obtaining_api_id) 02 ## Чому TgWitness працює через публічні пари хеш-коду додатка та ідентифікатора додатка Саме тому ми побудували TgWitness на основі публічних пар хеш/ID додатків. За нашою логікою, ймовірність блокування з ними менша: через ці пари зареєстровано понад мільйон облікових записів Telegram, і через них працюють багато різних програм. На нашу думку, це краще, ніж працювати безпосередньо з особистим хешем додатка: ці пари, безсумнівно, існують вже понад 5 років. ### Ваша власна нова пара API-ідентифікатора та API-хешу Створено на my.telegram.org з цього облікового запису. - Приблизно 99% цих облікових записів виходять із системи - Один новий додаток, один обліковий запис ### Пари публічних ідентифікаторів API/хешів API з пулу Ті самі пари API-ідентифікатора та API-хешу, які використовують багато програм. - Зареєстровано понад мільйон облікових записів - Багато різних програм - Ці пари API працюють вже понад 5 років ### Чому ніхто не може побачити ваші дані через ці пари API - #### Пара API — це ім’я, а не ключ Telegram запитує ідентифікатор API та хеш API, коли програма підключається та коли вона запитує код входу. Вони ідентифікують додаток і не надають доступу до жодного облікового запису; у документації Telethon зазначено, що одна пара працює з будь-яким номером телефону. - #### Ваш сесійний ключ ніколи не залишає ваш сервер Під час входу створюється ключ авторизації за допомогою обміну за алгоритмом Діффі–Хеллмана між вашим TgWitness та Telegram; сам ключ ніколи не надсилається. Згідно з документацією Telegram: після авторизації ключ прив’язується до користувача, і кожен виклик із цим ключем виконується від імені цього користувача. Інші програми з тією самою парою мають власні ключі й не можуть використовувати ваш. - #### Трафік шифрується за допомогою вашого ключа Кожен запит і відповідь шифруються за допомогою ключа авторизації сеансу, а не за допомогою хешу API. Знання хешу API не дозволяє розшифрувати жодних даних. - #### Власник пари API-ідентифікатора та API-хешу нічого не бачить У Telegram немає способу перелічити акаунти, сесії або повідомлення за ідентифікатором API. Власник пари бачить лише налаштування свого додатка на сайті my.telegram.org. - #### Лише ваш обліковий запис бачить, про який додаток йдеться У розділі «Налаштування» → «Пристрої» вашого облікового запису міститься перелік назв додатків та ідентифікаторів API, пристроїв, IP-адрес і дат для кожного сеансу. Ніхто інший не має доступу до цього переліку. Документація Telegram - [Авторизація користувача: ключ прив’язується до користувача](https://core.telegram.org/api/auth) - [auth.sendCode: api_id, api_hash](https://core.telegram.org/method/auth.sendCode) - [initConnection](https://core.telegram.org/method/initConnection) - [Створення ключа авторизації MTProto](https://core.telegram.org/mtproto/auth_key) - [Шифрування MTProto](https://core.telegram.org/mtproto/description) - [account.getAuthorizations](https://core.telegram.org/method/account.getAuthorizations) - [Що містить запис про авторизацію (сесію) у Telegram](https://core.telegram.org/constructor/authorization) - [Отримання api_id](https://core.telegram.org/api/obtaining_api_id) - [Відкритий вихідний код додатків Telegram](https://telegram.org/apps#source-code) Бібліотеки та теми для обговорення - [Телетон: вхід у Telegram](https://docs.telethon.dev/en/stable/basic/signing-in.html) - [opentele: облікові дані API офіційних додатків](https://opentele.readthedocs.io/en/latest/documentation/authorization/api/) - [opentele: TelegramClient](https://opentele.readthedocs.io/en/latest/documentation/telethon/telegramclient/) - [Stack Overflow: чи слід зберігати api_hash у таємниці?](https://stackoverflow.com/questions/49490818/should-telegram-api-hash-be-kept-secret) ### Ті самі пари API-ідентифікатора/API-хешу в інших програмах 7 Пари API-ідентифікатора та API-хешу офіційних додатків Telegram є загальнодоступними та вбудованими в багато незалежних програм і бібліотек: - [opentelePython · src/api.py](https://github.com/anmv/opentele/blob/4df17bd8c443d6452afc5a2d29ec7922fad1a5c3/src/api.py#L575) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [opentele2Rust · opentele2-core/src/api.rs](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/api.rs#L641) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [GrampoPython · Grampo/ut/api.py](https://github.com/abbas-bachari/Grampo/blob/00aa662d853c4ac2180432371c5e0d9444bbfe9e/Grampo/ut/api.py#L526) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [tgmanagePython · api/schemas/api_app.py](https://github.com/xdsnich/tgmanage/blob/f67c46be0ab234bd04526a8663d3936bd98a8597/api/schemas/api_app.py#L47) - Android 6 - iOS 8 - Desktop 2040 - macOS 2834 - Telegram X 21724 - Web K 2496 - [LyChatBotTDLib · helpers/tdlib/index.js](https://github.com/LyoSU/LyChatBot/blob/fac0ae5d5f2cddb8a26312014f51c0f6f40ec191/helpers/tdlib/index.js#L11) - macOS 2834 - [hsadasdPython · config.py](https://github.com/herobrinovaleksandr-png/hsadasd/blob/6842c74895038c16e219324fcd07dbe8153f37f0/config.py#L68) - Desktop 2040 - Desktop 17349 - Telegram X 21724 - macOS 2834 - iOS 10840 - Web 2496 - +4 - [blb.teamblb.team/threads/…294](https://blb.team/threads/app-hash-app-id-ofitsial-nykh-kliyentov.294/) - Android 4 · 5 · 6 - iOS 8 - Desktop 2040 - Desktop 17349 - macOS 2834 - Telegram X 21724 Повідомлення на форумі зі списком пар API-ID/API-хеш офіційних додатків Telegram, опубліковане для реєстрації облікових записів 03 ## Способи створення додаткового облікового запису Для облікового запису Telegram потрібен номер телефону, на який надходить код для входу. Оберіть варіант залежно від того, як довго має існувати цей обліковий запис. - Найкращий вибір ### Предоплачена SIM-картка або eSIM ******** Як довго це триває Поки ви поповнюєте рахунок Майте на увазі Найбільш надійний варіант: Telegram найкраще сприймає справжні номери мобільних телефонів. Номер, який оператор відкликає, передається комусь іншому. - ### Додаток із віртуальними телефонними номерами ******** Як довго це триває Доки додаток зберігає номер телефону Майте на увазі Telegram може відмовити у видачі віртуального номера, не надіслати код або одразу обмежити можливості нового облікового запису; деякі додатки відкликають номери, які не використовуються. - ### Оренда телефонного номера ******** Як довго це триває На період оренди Майте на увазі Коли термін дії закінчується, номер переходить до наступного клієнта. - ### Одноразова активація ******** Як довго це триває Лише один код входу Майте на увазі Номер одразу повертається до пулу, часто разом з історією попередніх власників. Перш за все встановіть пароль до хмарного сховища. Той, хто згодом стане власником цього номера, зможе запросити код для входу. Хмарний пароль (двофакторна аутентифікація) не дозволить йому увійти в систему; без нього обліковий запис перейде до наступного власника цього номера. Документація Telegram - [Часті запитання щодо спаму: віртуальні номери та попередні власники](https://telegram.org/faq_spam) - [Двоступенева верифікація](https://core.telegram.org/api/srp) ### Орендовані номери з префіксом +888 (Fragment) Деякі торгові майданчики та сервіси пропонують тимчасову оренду офіційних номерів Telegram з префіксом +888 від Fragment. Орієнтовна вартість: 20 доларів США на день. - Ви можете зареєструвати обліковий запис безпосередньо в Telegram Web або Telegram Desktop. - Ви можете видаляти акаунти за цим номером і створювати нові. - Ці акаунти, як правило, піддаються меншій кількості перевірок на предмет шахрайства, але це не надає їм імунітету чи особливих привілеїв. Цей номер не належить вам. Після закінчення терміну оренди власник може його повернути. Негайно встановіть «хмарний пароль» і не розглядайте цей акаунт як довгостроковий. Набагато надійніше мати номер +888 у власній власності або користуватися передплаченою SIM-карткою, яку ви контролюєте. ### Готові акаунти з торгових майданчиків Деякі торгові майданчики (наприклад, G2G або Z2U) продають готові акаунти Telegram — нові, зі стажем або з файлами сесій. - [G2G: списки облікових записів Telegram](https://www.g2g.com/uk/categories/telegram-accounts) - [Z2U: списки облікових записів Telegram](https://www.z2u.com/telegram/accounts-5-15140) НІКОЛИ НЕ ВИКОРИСТОВУЙТЕ СВІЙ ОСНОВНИЙ АКАУНТ! Спеціальний акаунт, створений таким чином, все одно є безпечнішим, ніж підключення вашого основного акаунта Telegram до TgWitness. #### Попередження перед купівлею - Це порушує Умови надання послуг Telegram. - Багато акаунтів зареєстровані масово (автореєстрація) або мають невідому історію. - Деякі продавці можуть досі мати доступ до відновлення. - Акаунти з таких ринків часто пізніше блокуються або обмежуються. - Уникайте торгових майданчиків, які відкрито продають програми для крадіжки даних, фішингові інструменти або явно вкрадені акаунти. - Придбання акаунта — навіть того, що рекламується як «автореєстрація» — на платформах, які відкрито продають фішингові інструменти, програми для крадіжки даних, вкрадені сесії або акаунти, порушує не лише Умови надання послуг Telegram, а й законодавство більшості країн. Це може згодом призвести до визнання ваших доказів недійсними. Обирайте обережно. #### Якщо ви використовуєте цю опцію 1. Вважайте цей акаунт одноразовим. 2. Негайно завершіть усі інші сесії, встановіть «хмарний пароль» та змініть методи відновлення доступу. 3. Використовуйте 2–3 акаунти від різних провайдерів або акаунти, які ви зареєстрували самостійно. **«Преміум», видалення та семиденна затримка** Якщо акаунт має підписку «Premium», особа, яка має доступ до номера телефону, не зможе видалити акаунт одразу. Ви отримаєте сповіщення та матимете сім днів до видалення. Це важливо, оскільки ваше розслідування залежить від цього акаунта: у вас є час підготувати замінник. **Нові акаунти та облікові дані API** Якщо ви отримаєте та використаєте власні api_id/api_hash з нового акаунта, який ви зареєстрували самостійно за допомогою номера з SMS-сервісу, акаунт буде виведений із системи під час першого запиту до API або авторизації сеансу. Майте це на увазі під час планування розслідування. 04 ## Створення облікового запису Від отримання номера телефону до першого записаного чату. 1. ### Отримати номер телефону Попередньо оплачена SIM-картка або eSIM, якщо обліковий запис має діяти тривалий час; оренда або одноразова активація для короткострокового завдання. Перелік послуг наведено нижче. 2. ### Зареєструйтеся окремо від вашого основного облікового запису Зареєструйтеся в офіційному додатку Telegram на окремому пристрої, в емуляторі або у профілі телефону, а не поруч із вашим основним обліковим записом. 3. ### Захистіть обліковий запис за допомогою хмарного пароля Відразу ж встановіть пароль для хмарного сховища та адресу електронної пошти для відновлення, які не використовуються більше ніде. 4. ### Обмежте налаштування конфіденційності облікового запису Номер телефону **«Ніхто»**, «Знайти мене за номером», **«Мої контакти**», «Останнє з’явлення», фото профілю та біографія: **«Ніхто»** або **«Мої контакти»**; вимкнути синхронізацію контактів. 5. ### Запобігайте самознищенню облікового запису Встановіть найдовший термін самознищення облікового запису, щоб зупинка роботи TgWitness не призвела до втрати облікового запису. 6. ### Створіть для облікового запису нейтральний профіль Жодних імен, фотографій, імен користувачів чи біографій з ваших інших облікових записів, жодних особистих контактів. 7. ### Дайте новому акаунту «розігрітися» Спочатку приєднуйтесь лише до кількох чатів на день. Нові акаунти, які поспішають, обмежуються першими. 8. ### Не діліться нічим із ботами Ніколи не натискайте кнопки «Поділитися номером телефону» або «Поділитися місцезнаходженням» для бота. Відкривайте посилання та міні-додатки через VPN або проксі на цьому пристрої. 9. ### Підключіть обліковий запис до TgWitness У власному робочому просторі підключіться через **«Акаунт» → «QR-код**», а потім натисніть **«Джерела» → «Режим розслідування**». Додаток — це місце, де ви дієте, а TgWitness — це запис. Документація Telegram - [Двоступенева верифікація](https://core.telegram.org/api/srp) - [Налаштування конфіденційності](https://core.telegram.org/api/privacy) - [Самознищення облікового запису в разі неактивності](https://core.telegram.org/method/account.setAccountTTL) 05 ## Сервіси телефонних номерів Це варіанти, з яких можна почати. Країни, ціни та те, чи приймає Telegram певний номер, часто змінюються, тому перевіряйте це перед оплатою. ### Попередньо оплачені SIM-карти та eSIM 11 - [SMARTYsmarty.co.uk](https://smarty.co.uk) - UK - SIM - [VOXIvoxi.co.uk](https://www.voxi.co.uk) - UK - SIM - [iD Mobileidmobile.co.uk](https://www.idmobile.co.uk) - UK - SIM - [Threethree.co.uk](https://www.three.co.uk) - UK - SIM - [Asda Mobilemobile.asda.com](https://mobile.asda.com) - UK - SIM - [Ultra Mobileultramobile.com](https://www.ultramobile.com) - US - Попередня оплата Тарифний план PayGo, дуже дешевий - [US Mobileusmobile.com](https://www.usmobile.com) - US - Попередня оплата - [Mint Mobilemintmobile.com](https://www.mintmobile.com) - US - Попередня оплата - [Tracfonetracfone.com](https://www.tracfone.com) - US - Попередня оплата - [eSIM Plusesimplus.me](https://esimplus.me) - eSIM - [Numero eSIMnumeroesim.com](https://numeroesim.com) - eSIM ### Додатки з віртуальними телефонними номерами 20 - [Google Voicevoice.google.com](https://voice.google.com) - US Тільки для США; для реєстрації потрібен номер телефону у США - [TextNowtextnow.com](https://www.textnow.com) - US - CA Номер буде відкликано, якщо ви ним не скористаєтеся - [TextFreetextfree.us](https://www.textfree.us) - US - [2ndLine2ndline.co](https://www.2ndline.co) - US - CA - [Talkatonetalkatone.com](https://www.talkatone.com) - US - [TextMego-text.me](https://go-text.me) - US - CA - Інші країни - [textPlustextplus.com](https://textplus.com) [Google Play](https://play.google.com/store/apps/details?id=com.gogii.textplus) - [FreeToneGoogle Play](https://play.google.com/store/apps/details?id=com.textmeinc.freetone) - US [TextMe Up · textmeup.com](https://www.textmeup.com) - [Nextplusnextplus.me](https://nextplus.me) - US - [Dingtonedingtone.me](https://www.dingtone.me) - US - CA - [Burnerburnerapp.com](https://www.burnerapp.com) - US - CA - Платна послуга З пробним періодом - [Hushedhushed.com](https://hushed.com) - Багато країн - Платна послуга Низька ціна - [Sidelinesideline.com](https://www.sideline.com) - US - [MySudomysudo.com](https://mysudo.com) - US - CA - UK - [2NumberGoogle Play](https://play.google.com/store/apps/details?id=com.bpmobile.second.phone) [App Store](https://apps.apple.com/app/id1216135390) - [SLYNUMBERslynumber.com](https://slynumber.com) [Google Play](https://play.google.com/store/apps/details?id=com.dev.slynumber) - [Phonerphonerapp.com](https://phonerapp.com) - [Onoffonoff.app](https://www.onoff.app) - EU Європейські номери мобільних телефонів у додатку - [Sonetelsonetel.com](https://sonetel.com) - Багато країн - Безкоштовний номер - [Zadarmazadarma.com](https://zadarma.com) - Багато країн Віртуальні телефонні номери ### Оренда телефонного номера та одноразова активація 12 Оренда телефонного номера дозволяє користуватися ним протягом тижнів або місяців. Одноразова активація надає єдиний код для входу: встановіть пароль до хмарного сховища одразу після реєстрації. - [OnlineSimonlinesim.io](https://onlinesim.io) - Оренда номера - Одноразові активації - [SMSPVAsmspva.com](https://smspva.com) - Оренда номера - Одноразові активації - [5SIM5sim.net](https://5sim.net) - Оренда номера - Одноразові активації - [SMSPoolsmspool.net](https://www.smspool.net) - Оренда номера - Одноразова активація - [VAK-SMSvak-sms.com](https://vak-sms.com) - Оренда номера - Одноразові активації - [TextVerifiedtextverified.com](https://www.textverified.com) - Оренда номера - Одноразові активації - [JuicySMSjuicysms.com](https://juicysms.com) - Оренда номера - Одноразові активації - [365SMS365sms.org](https://365sms.org) - Оренда номера - Одноразові активації - [SIMSMSsimsms.org](https://simsms.org) - Оренда номера - Одноразові активації - [GrizzlySMSgrizzlysms.com](https://grizzlysms.com) - Одноразова активація - [SMS-MANsms-man.com](https://sms-man.com) - Одноразова активація - [Tiger SMStiger-sms.com](https://tiger-sms.com) - Одноразова активація --- # Telegram · Підключити обліковий запис Canonical page: https://phishdestroy.io/tgwitness/uk/docs/accounts/ Підключіть Telegram за допомогою QR-коду, номера телефону або імпорту сеансу. Оберіть джерела та переконайтеся, що нові повідомлення надходять до вашого журналу. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Один простір = один акаунт, його журнал і його ключ. ## Виберіть спосіб входу **Акаунти** → додати простір → налаштування підключення. Використовуйте для цього окремий акаунт. - **QR-код:** відскануйте його на екрані «Пристрої» в Telegram і підтвердьте. - **Номер телефону:** номер, код, потім пароль 2FA, якщо він є. - **Імпорт сесії:** ваш власний файл сесії або дані Telegram Desktop. Використовуйте вбудований профіль API або власні API ID і hash. Він лише називає застосунок — не входить в акаунт і нічого не приховує. **Спочатку потрібен проксі-сервер?** Ви можете [вибрати та перевірити маршрут з’єднання](https://phishdestroy.io/tgwitness/uk/docs/proxies/) перед входом у систему. Кожен обліковий запис має свій власний маршрут. ## Виберіть, що спостерігати 1. Оберіть потрібні чати, групи чи канали. 2. Перевірте налаштування збору, зокрема медіа. 3. Запустіть і перевірте підключення та нещодавню активність. Акаунт повинен мати доступ. Адміни й учасники бачать різне, журнал показує те, що отримав цей акаунт. Весь акаунт? **Джерела → Охоплення спостереження → Режим розслідування**, перевірте й натисніть **Зберегти охоплення**. Повний розбір: [розслідування по всьому акаунту](https://phishdestroy.io/tgwitness/uk/docs/cases/). ## Перегляньте весь шлях У тестовій групі надішліть повідомлення з іншого акаунта, відредагуйте й видаліть його. У журналі мають з'явитися всі три події. Потім [експортуйте й перевірте](https://phishdestroy.io/tgwitness/uk/docs/exports/). «Підключено» означає, що зв'язок працює. Спіймане тестове повідомлення означає, що події справді доходять. ## Додати ще один обліковий запис Новий простір в **Акаунтах**, ті самі кроки. Запишіть відбиток ключа кожного акаунта, щоб потім розрізняти експорти. --- # Telegram · Виберіть проксі-сервер Canonical page: https://phishdestroy.io/tgwitness/uk/docs/proxies/ Підтримуйте автоматичні маршрути MTProxy або використовуйте власний проксі-сервер. Обирайте режими IP, правила резервного переходу та маршрут для зовнішніх запитів. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Тримайте акаунт на зв'язку й самі вирішуйте, чи може він колись показати IP вашого сервера. ## Спочатку виберіть режим IP 01**Приховати адресу** Лише проксі. Якщо жоден не працює — чекає. 02**Direct — як крайній захід** Після затримки йде напряму, а щойно проксі запрацює — повертається до нього. 03**Сервер за тунелем або VPN** Напряму можна. VPN цей режим не налаштовує й не перевіряє. Маршрут визначає тип з’єднання. Режим IP визначає, чи дозволено пряме з’єднання. ## Нехай пул підтримує маршрут 1. **Акаунт → Налаштування → Налаштування підключення**. 2. Оберіть режим IP і **Автоматичний MTProxy** або фіксований маршрут. 3. Збережіть, потім **Перевірити підключення до Telegram** (працює і до входу). 4. Запустіть збір і надішліть собі тестове повідомлення. Нові простори стартують на автоматичному MTProxy з режимом **Приховувати адресу**. Пул бере чотири публічні списки, перевіряє сервери, лишає робочі й замінює мертві. ## Використовуйте власний проксі-сервер SOCKS5, HTTP CONNECT, посилання на проксі Telegram або каталог оператора. Перед перемиканням призупиніть спостереження. Секрети Fake TLS (`ee`…) не підтримуються. **Налаштування черговості, обміну та повторних спроб** **Параметри → Автоматичний MTProxy**: пороги збоїв, паузи, ротація, акаунтів на проксі. Ліміт 1 означає, що акаунт чекатиме, а не ділитиме проксі. Різні проксі однаково можуть мати спільну зовнішню IP. ## Відокремлення Telegram від зовнішніх запитів MTProxy возить лише Telegram. Мітки часу, сповіщення, копії й перевірка коду йдуть через окремий SOCKS5/HTTP-проксі, маршрут акаунта SOCKS5/HTTP або напряму, якщо режим дозволяє. Або вимкніть їх. `TGWITNESS_PROXY_FEED_PROXY` задає маршрут для завантаження списків. [Свідок](https://phishdestroy.io/tgwitness/uk/docs/witness/) має власні налаштування. Ніщо з цього не торкається вашого браузера й системної мережі. Ще: [режими й типові значення](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/#ip-modes), [хто може змінювати маршрути](https://phishdestroy.io/tgwitness/uk/docs/access/). --- # Telegram · Експорт та перевірка Canonical page: https://phishdestroy.io/tgwitness/uk/docs/exports/ Експортуйте збережену історію Telegram, перевіряйте підписи та порівнюйте журнал із контрольною точкою, збереженою незалежним свідком. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Передайте файли, які отримувач сам звірить із вашим простором. Зберегти посиланняЕкспорт підписаного ZIP-файлуОдержувач перевіряє Уперше чуєте про підписи й контрольні точки? [Змініть приклад запису](https://phishdestroy.io/tgwitness/uk/docs/concepts/#chain) й подивіться, які перевірки це помітять. Хочете зберігати копію окремо від сервера-збирача? Перейдіть до [налаштувань S3](https://phishdestroy.io/tgwitness/uk/docs/exports/#s3), функції [Object Lock](https://phishdestroy.io/tgwitness/uk/docs/exports/#s3-retention) або [верифікованого відновлення](https://phishdestroy.io/tgwitness/uk/docs/exports/#s3-restore). ## Збережіть надійне джерело інформації Запишіть відбиток ключа робочого простору десь поза межами колектора. Під час збору увімкніть режим доказів, щоб контрольні точки отримували часові мітки за стандартами RFC 3161 та OpenTimestamps, або запустіть [свідка](https://phishdestroy.io/tgwitness/uk/docs/witness/), який публікує повідомлення у публічному каналі. Зберігайте підписані контрольні точки також в іншому місці: одержувач перевіряє за ними ключ, час та попередній стан журналу. ## Завантажити підписаний ZIP-файл **Експорт** → підписаний ZIP з доказами. У ньому весь журнал і підписаний маніфест файлів. Читабельний звіт налаштовується в [Report studio](https://phishdestroy.io/tgwitness/uk/docs/reports/), а якщо треба віддати лише вибране — зробіть [виписку для передачі](https://phishdestroy.io/tgwitness/uk/docs/handover/). Звіти HTML, PDF і JSON мають власні печатки. CSV — лише робоча копія; для перевірки цілісності беріть CSV з перевіреного ZIP. ## Перевірте за допомогою надійної копії TgWitness В оточенні проєкту, з власним відбитком і шляхами: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence ``` У разі успішного проходження перевірок відображаються значення `key_pinned: true` та `checkpoint_checked: true`. `--require evidence` також вимагає стороннього часу для останнього запису, наприклад, перевіреного часового штампу: контрольна точка підписана вашим власним ключем, тому сама по собі вона недостатня. Зберігайте цей вивід поруч з архівом. Контрольна точка має бути в кінці експорту або перед ним. ## Використовуйте результат перевірки - **Файли:** маніфест пов'язує їхні хеші, підписи — журнал. Будь-яку зміну буде помітно. - **Ключ:** збережений вами відбиток підтверджує, що це той самий ключ. - **Попередній стан:** контрольна точка порівнює експорт з початком журналу, збереженим до передачі. - **Охоплення:** прогалини, результати збору й тест «надіслати → змінити → видалити» показують, що ця конфігурація справді впіймала. Докладніше: [що доводить перевірка](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope). ## Налаштування позасайтової копії в S3 **Експорт → Зовнішня копія** у вашому просторі. Працює з AWS S3 і будь-яким S3-сумісним сховищем. Копіює сегменти журналу, збережені файли, контрольні точки з мітками часу та готові експорти чатів, кожен шифрується `AES-256-GCM` ще на збирачі. В онлайн-демо ці налаштування показано з вимкненим завантаженням. Справжні облікові дані вводьте лише у своєму встановленні. [![Повна панель налаштувань поза сайтом: кінцева точка, регіон, сховище, ключі доступу, розклад, блокування об’єктів та управління ключами відновлення](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4)](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4) Повна панель з розгорнутими розширеними налаштуваннями. Дані для входу до сховища не відображаються. | Галузь | Що ввести | | --- | --- | | Кінцева точка | URL сховища, без шляху до бакета й облікових даних. Приклад: `https://s3.example.invalid`. | | Регіон | Що вимагає ваш провайдер. Типово `us-east-1`. | | Контейнер | Наявний бакет із правом запису. Приклад: `example-case-backup`. | | Папка у контейнері | Префікс, типово `tgwitness`. Зверху додається префікс простору. | | Ідентифікатор ключа доступу / Секретний ключ доступу | Обидва разом, зберігаються в сховищі секретів. Щоб лишити збережені, потім залиште обидва порожніми. | | Адреси у форматі Path | Увімк.: `endpoint/bucket`. Вимк.: `bucket.endpoint`. Залежить від провайдера. | | Інтервал копіювання | Від 1 до 1440 хвилин, типово 5. Лише поки застосунок запущено. | | Зберігання даних Object Lock | Дні й режим, якщо бакет підтримує Object Lock. Нуль лишає типове налаштування бакета. | 1. Створіть бакет, заповніть адресу й облікові дані зі знятою позначкою **Зберігати зовнішню копію** та натисніть **Зберегти зовнішню копію**. 2. **Перевірити підключення** завантажує зашифрований тестовий об'єкт. 3. **Завантажити ключ шифрування** й зберігайте його подалі від збирача. Немає ключа — немає відновлення. 4. Позначте **Зберігати зовнішню копію**, збережіть, потім **Копіювати зараз** або лишіть працювати за розкладом. ## Перевірка терміну зберігання та прогресу копіювання У розділі **Додатково** оберіть термін зберігання та `GOVERNANCE` або `COMPLIANCE`. TgWitness зчитує термін із завантаженого об'єкта й повідомляє: підтверджено, відсутній або перевірка не вдалася. Панель показує останній прохід, кількість об'єктів, байти, скопійовану межу журналу та помилки. Відсутній локальний файл потрапляє у звіт і повторюється наступного разу, решта копіюється далі. Завантаження йде напряму, через SOCKS5 або HTTP. З маршрутом лише через MTProxy копія чекає з помилкою. ## Зберігайте ключ відновлення окремо У JSON-ключі — ключ розшифрування, адреса, префікс і відбиток ключа. Для відновлення потрібен він і облікові дані сховища з правом читання. Змінили адресу, бакет чи префікс? Завантажте ключ знову. У новому місці почнеться свіжа копія, старі експорти чатів лишаться там, де були. ## Відновлення та перевірка на іншому комп’ютері Потрібні встановлення TgWitness, якому ви довіряєте, JSON-ключ, облікові дані лише для читання й порожня папка: ### Windows PowerShell ``` $env:TGWITNESS_S3_ACCESS_KEY = 'YOUR_READ_ACCESS_KEY' $env:TGWITNESS_S3_SECRET_KEY = 'YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` ### Linux / macOS ``` export TGWITNESS_S3_ACCESS_KEY='YOUR_READ_ACCESS_KEY' export TGWITNESS_S3_SECRET_KEY='YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` Спершу все перевіряється в тимчасовій закритій папці: весь журнал, контрольні точки, хеші й розміри файлів. Небезпечні шляхи, конфліктні сегменти чи журнал коротший за контрольну точку — помилка, і тоді нічого не записується. У разі успіху отримаєте `events.jsonl`, `media/`, `checkpoints/` і `exports/`. Збережіть JSON-вивід команди поруч і звірте все з контрольними точками чи записами свідка, які зберігаєте самі. --- # Telegram · Запис дій на GitHub Actions Canonical page: https://phishdestroy.io/tgwitness/uk/docs/capture/ Виберіть Takeout, експорт через звичайний API або журнал чату на тимчасовому раннері GitHub. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Виберіть Takeout, експорт через звичайний API або журнал чату на тимчасовому раннері GitHub. Увімкніть JavaScript, щоб згенерувати ключ і розшифрувати архів. **Повне посилання** [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документація](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Незалежне захоплення](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md) ![Незалежне захоплення](https://phishdestroy.io/tgwitness/assets/chapter-capture.svg?v=c979502bc92b) **Попередній перегляд доступний з `main`.** Форк запускає закріплений багаторазовий робочий процес із `phishdestroy/TgWitness`. Робочий процес експортує обліковий запис, вибрані чати або журнал подій одного чату за допомогою новоствореної сесії Telegram, засвідчує доказовий файл ZIP або багаточастинний маніфест і завантажує лише зашифровані на стороні одержувача передачі даних. Звичайна панель адміністрування не відображається. Виберіть `client=official_web` запуск [офіційного клієнта-свідка](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md) з захищеними елементами керування Telegram Web та відео. Для цього потрібен власний проксі-сервер, що забезпечує зв'язок із сервером, і він відстежує один відтворений чат. За замовчуванням `client=api` зберігає режими повного експорту облікового запису, описані нижче. Верифікатор перевіряє архів на відповідність його сертифікату на GitHub, затвердженому робочому процесу та комітам колектора, а також підписаним хешам журналу та вкладень. У процесі збору використовується зафіксований вихідний код та нове сховище. Рецензент може перевірити цей код та порівняти наданий архів із записаним ходом процесу. **На цій сторінці** - [Послідовність дій користувача](https://phishdestroy.io/tgwitness/uk/docs/capture/#user-flow) - [Час, відведений на сесію](https://phishdestroy.io/tgwitness/uk/docs/capture/#session-time-budget) - [Виберіть цей режим або постійне робоче середовище](https://phishdestroy.io/tgwitness/uk/docs/capture/#choose-this-mode-or-a-persistent-workspace) - [Що є публічним, а що має залишатися приватним](https://phishdestroy.io/tgwitness/uk/docs/capture/#what-is-public-and-what-must-stay-private) - [Усунення несправностей](https://phishdestroy.io/tgwitness/uk/docs/capture/#troubleshooting) - [Локальне розшифрування та перевірка](https://phishdestroy.io/tgwitness/uk/docs/capture/#local-decryption-and-verification) - [Як вилка залишається поза процесом захоплення](https://phishdestroy.io/tgwitness/uk/docs/capture/#how-the-fork-is-kept-outside-the-capture-process) - [Криптографічна передача](https://phishdestroy.io/tgwitness/uk/docs/capture/#cryptographic-handoff) - [Сфера застосування та валідація](https://phishdestroy.io/tgwitness/uk/docs/capture/#scope-and-validation) - [Послідовність випусків, що здійснюються відповідальним за проект](https://phishdestroy.io/tgwitness/uk/docs/capture/#maintainer-release-sequence) ## Послідовність користувача# Помічник пояснює п’ять етапів і дає змогу спробувати заміну повідомлень або колекторів на прикладі зразкових даних. **Натискання кнопки Почати запис** відкриває майстер. 1. Виберіть **GitHub Actions capture (попередній перегляд)** на головній сторінці проєкту, на екрані входу в робочу область або в меню **Експорт → Відкрити допоміжний інструмент capture**. Ви також можете відкрити [офіційний допоміжний](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) інструмент або файл `tgwitness/static/capture.html` із надійного репозиторію в сучасному браузері. Допоміжний інструмент не надсилає мережевих запитів для обробки ключів або файлів. Допоміжний інструмент підтримує мови інтерфейсу сайту; панель тимчасового збору даних підтримує англійську та російську мови й відкривається мовою браузера, якщо вона є однією з них. 2. Створіть ключ і збережіть **файл sealed-key.json**. Це єдиний приватний ключ для розшифрування. Скопіюйте окреме значення відкритого ключа **одержувача**. У разі втрати приватного ключа ви втратите доступ як до з’єднання, так і до архіву. Підтвердьте, що ви зберегли його, щоб перейти до наступного кроку. Якщо у вас уже є файл доставки, завантажте збережений ключ і виберіть **У мене вже є архів**. 3. Створіть форк TgWitness, увімкніть функцію «Дії» у цьому форку та запустіть **функцію Зашифрований запис чату**. Вставте публічний ID одержувача та виберіть 30, 60 або 120 хвилин. Ніколи не вказуйте номер телефону, код входу, пароль Telegram, приватний ключ або сесію в вхідних даних робочого процесу, комітах, завданнях або журналах. 4. Під час виконання завантажте **файл sealed-connection** із розділу «Artifacts» та розпакуйте його. Завантажте `connection.tgwsealed` у допоміжній програмі, використовуючи збережений приватний ключ. Отримане посилання містить випадковий секрет доступу у фрагменті URL-адреси. Не розголошуйте це посилання. Панель видаляє цей фрагмент і зберігає секрет у сховищі сеансу цієї вкладки; він не записується в журнали доступу HTTP. 5. Відкрийте посилання для підключення. Увійдіть за допомогою QR-коду або за номером телефону та кодом входу. Введіть пароль двоступеневої аутентифікації, якщо Telegram його запитає. За замовчуванням використовується вбудований пул облікових даних API, так само як і у звичайному робочому просторі. Ви можете розгорнути додатковий розділ для введення власних облікових даних і ввести обидва `api_id` , і `api_hash` з [my.telegram.org/apps](https://my.telegram.org/apps). Залиште обидва поля порожніми, щоб використовувати вбудований пул; неповна або неправильно сформована пара відхиляється. Імпорт сеансів заборонено. Оберіть режим експорту та область дії. Посилання на підключення містить секрет доступу: зберігайте його в таємниці. 6. Оберіть **Telegram Takeout**, **Regular Telegram API** або **Журнал подій чату**. Для експорту облікового запису оберіть усі доступні чати або завантажте та виберіть один чи кілька чатів, а потім встановіть дати, типи чатів, категорії облікових записів та правила щодо вкладень. Перевірте налаштування та розмір, за бажанням збережіть налаштування у форматі JSON для незалежного рецензента, а потім натисніть **Почати збір**. Після запуску налаштування не можна змінити. Функція «Продовжити» працює лише доки існує цей запуск; дострокове завершення зберігає отримані дані та фіксує пропуски. Закінчення терміну після запуску створює явно неповний архів; закінчення терміну до запуску або скасування не створює архіву. 7. Дочекайтеся отримання **архіву з результатами**, завантажте та розпакуйте його, а потім розшифруйте `delivery.tgwsealed` за допомогою допоміжної програми. Ви отримаєте `delivery.zip`файл, що містить `evidence.zip`, `attestation.jsonl`та інструкції. Розшифрування у браузері обмежене до 256 МіБ; для більших пакетів використовуйте наведену нижче локальну команду потокового передавання. Великі результати також містять `delivery-NNNNNN.tgwsealed` частини; основний `delivery.tgwsealed` потім містить `evidence.parts.json` та підтвердження. Завантажте кожну частину та зберіть їх локально, як описано нижче. 8. Завершіть тимчасову сесію в налаштуваннях Telegram → «Пристрої», якщо скасування доступу не було підтверджено або процес було зупинено. При нормальному завершенні сесії відбувається вихід із системи, і у записі про сеанс фіксується, чи було підтверджено скасування доступу. Репозиторій повинен містити опубліковані фіксовані коміти вихідного коду та коміти з повторно використовуваними робочими процесами. Інший репозиторій GitHub не може викликати лише локальну гілку. ## часу сесії# Перед збором **функція Розрахувати час і розмір** оцінює вибрану історію та файли на основі кількості повідомлень та обмеженої вибірки. На екрані відображається час, вже витрачений на вхід у систему, приблизний час збору та запас часу на упаковку. Для файлів у початковій оцінці використовується швидкість 1 Мб/с та двократний часовий запас; у міру прогресу це припущення замінюється виміряною швидкістю. Використовуйте **опцію Тільки повідомлення** або виберіть меншу кількість чатів, якщо оцінка перевищує час, що залишився. Зазначений у Telegram час очікування Takeout додається до бюджету. Колектор припиняє збір даних, коли час, що залишився, необхідний для упаковки, зберігає зібрані дані та позначає результат як частковий. Отже, 120-хвилинна сесія використовує час, що залишився для збору, замість того, щоб чекати на закінчення терміну перед підготовкою архіву. На екрані відображаються елементи, повний розмір яких не вдалося відібрати. ## Виберіть цей режим або постійне | Режим зйомки | Налаштовуваний діапазон | Різниця | | --- | --- | --- | | Telegram Takeout — варіант за замовчуванням | Усі доступні хмарні чати або вибрані чати, дати, категорії облікових записів, політики щодо мультимедіа та представлення у форматі JSON/HTML | Використовує офіційний механізм експорту Telegram; може знадобитися підтвердження або очікування. Takeout може перелічити канали та групи, що залишилися, якщо Telegram це дозволяє, та запросити додаткові особисті дані. | | Стандартний API Telegram | Ті самі параметри облікового запису та варіанти виведення даних, з урахуванням методів, доступних через стандартний API | Не ініціалізує Takeout; неможливо перелічити ліві канали/супергрупи або отримати особисті дані, доступні лише в Takeout. Контакти охоплюють користувачів Telegram, а не повний список збережених телефонних контактів. Обмеження частоти запитів залишаються в силі. | | Журнал подій чату | Один обраний чат, правила щодо вкладень та опціональні аватари | Відображає історію та зміни, зафіксовані під час цього циклу. Категорії рахунків, фільтри за датою та режими перегляду, сумісні з настільними комп’ютерами, не застосовуються. | Усі три режими мають однакове підтвердження на GitHub та забезпечують зашифровану передачу даних. Takeout вибирає метод збору даних і ніколи не замінюється без попередження звичайним доступом до API. TgWitness генерує JSON/HTML-представлення на основі записаних даних і зберігає обраний метод збору даних під час експорту. Дивіться [офіційний API Takeout](https://core.telegram.org/api/takeout). За замовчуванням використовуються функції «Takeout», усі доступні типи чатів, включаючи архівні, усі дати, профіль облікового запису та контакти, сумісні формати JSON і HTML, а також завантаження файлів. Початковий ліміт для мультимедійних даних становить 4 ГіБ, з видимими обмеженнями за типами файлів; для файлів більшого розміру або у разі вичерпання ліміту на завантаження використовуються хеш-коди сервера, якщо вони доступні. Ознайомтеся з цими обмеженнями перед початком збору даних. За допомогою хеш-кодів неможливо відтворити файл. Необов’язкові фотографії, історії, метадані сеансів та додаткові особисті дані залишаються окремими пунктами вибору. Для виведення даних може знадобитися підтвердження у вже створеному сеансі Telegram. Telegram встановлює затримку; новий вхід або новий процес не дозволяють її обійти. Максимальний час обробки становить 120 хвилин, включаючи вхід та підтвердження, тому обробка великого облікового запису або тривале очікування підтвердження може не завершитися. Постійний локальний експорт може відновити той самий сеанс, але не успадковує атестацію GitHub. ### Погодьтеся та підтвердьте налаштування Після **перевірки налаштувань та розміру** скористайтеся функцією **Зберегти налаштування для підтвердження**. Узгодьте отримані `sealed-export-settings.json` з рецензентом перед збором даних. Зміни роблять збережену оцінку недійсною. Збирач підписує чинне налаштування та його SHA-256, а квитанції про експорт облікового запису закріплюють ті самі параметри. Верифікатор повідомляє про фактичний режим, вибір та повноту даних і відхиляє невідповідність між журналом та вкладеним експортом облікового запису. ``` python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete ``` `--expected-selection` відхиляє інші параметри транспорту, області чату, фільтра або політики щодо вкладень. `--require-complete` приймає лише експортовані дані облікових записів та журнали чатів, позначені як завершені. Без цих прапорців перевірка все одно контролює походження та цілісність, водночас повідомляючи про зафіксовані налаштування та прогалини. Узгодьте очікуваний вибір перед запуском і зберігайте його окремо від архіву. Обсяг та інтервали збору визначають матеріал, зафіксований під час запуску; під час порівняння попередніх версій використовуйте збережені ранні спостереження. | Потрібно | Режим | | --- | --- | | Експортуйте доступні дані облікового запису або вибрані чати під час сеансу з обмеженим доступом та надайте рецензенту архів, засвідчений зовнішньою організацією | Знімок екрана GitHub Actions (попередній перегляд) | | Постійно стежте за кількома чатами, керуйте обліковими записами, шукайте та переглядайте архів, що постійно поповнюється | Локальна робоча область або робоча область Docker | Це запускає окремий процес збору даних із новим логіном. При цьому не відбувається завантаження вашого існуючого локального журналу, експорт поточної відкритої робочої області або повторне використання сесії Telegram. Незавершений процес збору даних у хмарі не можна відновити після завершення роботи його виконавця; новий робочий процес запускає новий збір даних. Функція **Експорт → Відкрити помічник для збору даних** у робочій області відкриває повний майстер всередині панелі. Автономна сторінка використовує той самий майстер, елементи керування та теми. В обох випадках ключі та дешифрування зберігаються у вашому браузері. Запуск робочого процесу GitHub та тимчасова панель Telegram відкриваються в окремих вкладках; майстер повідомить вас, коли повернутися. Блокування робочої області призводить до очищення ключа майстра, що зберігається в оперативній пам’яті. Ваш збережений файл ключа залишається на вашому пристрої. ## Що є публічним, а що має залишатися Збір виконується на стандартному запуску, розміщеному на GitHub. GitHub, затверджений збирач та його залежності, допоміжна сторінка, браузер і HTTPS-тунель є надійними компонентами цієї конфігурації. Тимчасовий хост обробляє сесію Telegram та повідомлення у вигляді відкритого тексту; передані артефакти шифруються для одержувача. Форкування копіює код проєкту у ваш репозиторій. При цьому **не** експортується ваш обліковий запис у Telegram. Вхідними даними для робочого процесу одержувача є відкритий ключ шифрування. Зберігайте `sealed-key.json`, облікові дані Telegram, коди входу, паролі 2FA та розшифровану URL-адресу з’єднання поза комітами, вхідними даними робочих процесів та публічними журналами. Цей робочий процес публікує зашифровані артефакти з’єднання та результатів протягом одного дня. Завантажте обидва вчасно; діють обмеження щодо доступності GitHub Actions, ліміти облікового запису та умови оплати. Публічний форк не гарантує необмежених безкоштовних обчислювальних ресурсів. У допоміжну програму не вводяться ні платіжні дані, ні токен доступу до GitHub. Приватний ключ дешифрування зберігається у вашому браузері/файлі. Матеріали сеансу Telegram та спостереження у вигляді відкритого тексту обов’язково зберігаються у тимчасовому сховищі. GitHub та HTTPS-тунель залишаються надійною інфраструктурою. Атестація може оприлюднити дайджест архіву та ідентифікатор робочого процесу; вміст архіву не включається до атестації. Мітка часу атестації не є міткою часу повідомлення. ## Усунення | Симптом | Наступний крок | | --- | --- | | Кнопка «Відсутність **робочого процесу»** | Створіть власний форк, увімкніть функцію «Дії» та синхронізуйте його з основним репозиторієм `main`. Не редагуйте затверджені в оригінальному репозиторії позначки, щоб обійти помилку. | | Ні `sealed-connection` артефакту | Перевірте, чи завдання було запущено та чи завершився етап запуску/завантаження. Помилки, пов’язані з чергою, виконавцем, завантаженням образу, тунелем або політикою репозиторію, можуть перешкодити запуску. | | Не вдається встановити з'єднання | Завантажте збережений ключ для цього запуску, розпакуйте завантажений артефакт і виберіть `connection.tgwsealed`. Запуск повинен залишатися активним. | | Історія призупинена | Перевірте стан панелі та скористайтеся функцією «Продовжити», поки сесія залишається активною, або завершіть роботу з уже зібраними даними. Обмеження Telegram та недоступний контент можуть призвести до прогалин у даних. | | Ні `sealed-result` | Скасування або закінчення терміну дії до початку збору даних не призводить до створення архіву; у такому разі цикл завершується повідомленням **Архів відсутній**. Невдалий етап збору, засвідчення або пакування також унеможливлює доставку; у повідомленні про невдалий етап вказується причина, зазначена керівником, без розкриття особистих даних. Перегляньте це, не вводячи облікові дані. | | Браузер не може розшифрувати великий архів | Для пакетів розміром понад 256 МіБ використовуйте наведений нижче командний рядок потокової передачі. У разі помилкового або втраченого приватного ключа розшифрувати результат неможливо. | | Під час перевірки підписант відхиляється | Використовуйте перевірену актуальну версію TgWitness та саме той модуль-виклик `OWNER/REPOSITORY`. Не приймайте заміну політики, що міститься в архіві. | | Telegram досі відображає тимчасовий сеанс | Вимкніть цю функцію в меню «Налаштування» → «Пристрої». Вихід із системи може завершитися невдало, і в разі примусового завершення робочого процесу очищення може не відбутися. | Перш ніж покладатися на цей попередній перегляд, спробуйте провести невеликий чат, який ви контролюєте: створіть повідомлення та вкладення, об’єднайте їх, розшифруйте результат, запустіть верифікатор, перевірте результати щодо прикриття/медіа та підтвердьте скасування сеансу Telegram. Автоматизовані перевірки використовують синтетичний клієнт Telegram та окремий реальний тест сертифіката GitHub; виконання на реальному обліковому записі в поточній версії не фіксувалося. ## Локальне розшифрування та Використовуйте інструменти з незалежно перевіреного джерела, а не виконувані файли, надані невідомим архівом доказів: ``` python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip # Unzip delivery.zip using your archive manager, then: python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness ``` У разі багаточастинної доставки спочатку розшифруйте головний пакет і розмістіть його розпакований маніфест поруч із кожною зашифрованою частиною, а потім виконайте: ``` python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness ``` Маніфест є підтвердженим об’єктом і пов’язує між собою всі частини та зібраний ZIP-архів. Використовуйте `--max-gib` для встановлення відповідного верхнього межі перевірки в розпакованому вигляді для великого архіву; значення за замовчуванням становить 4 ГіБ. Перевірки «expected-selection» та «complete-scope» також працюють із багаточастинною передачею. Python 3.11+, залежності проєкту та найновіша версія GitHub CLI, що підтримує `--signer-digest` та `--deny-self-hosted-runners` . Також доступний генератор ключів для CLI : `python -m tgwitness.sealed_crypto keygen sealed-key.json`. Верифікатор використовує `tgwitness/sealed_policy.json` дані з надійної інсталяції. Він перевіряє репозиторій виклику, робочий процес підписувача-розробника, затверджене коміт підписувача, вимоги до розміщеного запуску, повний дайджест ZIP, внутрішній журнал та цілісність вкладень, свіже походження ключа облікового запису та очікуване коміт колектора. Він відображає історію та результати роботи з мультимедіа, замість того, щоб припускати, що всі дані були збережені. Порожній список затверджених випусків призводить до відмови. Оновлення політики є явним рішенням щодо довіри; ніколи не приймайте запропоновану самою архівою політику автоматично. Для роботи в автономному режимі заздалегідь отримайте кореневі сертифікати з надійного середовища: ``` gh attestation trusted-root > trusted_root.jsonl python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl ``` Часовий штамп сертифіката стосується зобов’язання архіву. Він не підтверджує автентичність часових штампів повідомлень або системного часу колектора. Див. [параметри верифікації GitHub](https://cli.github.com/manual/gh_attestation_verify). ## Як вилка залишається поза сом захоплення# Функція-виклик містить посилання на рівні завдання на багаторазовий робочий процес, що знаходиться вище за ланцюгом, за повним SHA-кодом коміту. Цей робочий процес явно виконує вилучення коду **з репозиторію, що знаходиться вище за ланцюгом, за фіксованим SHA-кодом колектора**. За замовчуванням `actions/checkout` у багаторазовому робочому процесі виконував би вивантаження виклику і навмисно не використовується. Цей робочий процес не відновлює кеші виклику, не використовує артефакти виклику, не виконує файли виклику та не приймає URL-адреси джерел/образів, команди оболонки, підготовлені ZIP-файли, або хеші для підписання. Він приймає обмежене публічне ім’я одержувача та тривалість сеансу. Дії, базовий образ Python та cloudflared закріплені незмінними дайджестами; залежності Python використовують існуючі вимоги з фіксацією хеш-значень. Образ складається з надійного джерела без використання кешу. Колектор працює під обліковим записом користувача, що не має прав суперкористувача, з образом «тільки для читання», обмеженими можливостями Linux, обмеженнями ресурсів та без сокета Docker або середовища з токеном GitHub. Єдиними підключеними каталогами є каталоги з новою конфігурацією, робочою областю та вихідними даними. Обмежений додаток FastAPI надає доступ до входу, діалогових вікон, настроюваних параметрів облікового запису або чату, статусу, відновлення, завершення та скасування. Немає маршруту завантаження у вигляді звичайного тексту, загального маршруту адміністрування, маршруту імпорту або кінцевої точки підписання. Супервізор зупиняє контейнери, підключені до мережі, до того, як операція перевірки зчитає остаточний виправлений `evidence.zip` або `evidence.parts.json`. Контейнер для пакування не має доступу до мережі. У кроках завантаження вказано лише `connection.tgwsealed` та `delivery*.tgwsealed`; ні докази у вигляді відкритого тексту, ні облікові дані Telegram не завантажуються як артефакти. Під час очищення видаляються приватні каталоги та контейнери, а GitHub видаляє віртуальну машину хостованого запуску після завершення завдання. Термін зберігання артефактів становить один день; завантажте їх до закінчення терміну. Власник форку може замінити викликувача або створити інший підписаний файл. Суворий верифікатор повинен відхилити отриманий **робочий процес/дайджест з іншим підписувачем**. Ця конструкція все ще залежить від відсутності вразливих помилок у затвердженому коді та від цілісності інфраструктури GitHub, що забезпечує виконання та підписання. ## Криптографічна Кожен ключ одержувача — RSA-3072 (також приймаються імпортовані ключі RSA-4096), експонента 65537. Кожен конверт має новий випадковий ключ AES-256 та 96-бітний нонс. RSA-OAEP із SHA-256/MGF1-SHA256 шифрує ключ AES. AES-GCM із 128-бітним тегом автентифікує весь префікс та корисне навантаження. Відкритий ключ одержувача представлений у форматі DER SPKI в кодуванні base64; файл приватного ключа містить DER PKCS8 у кодуванні base64. Байти конверта — це `TGWSEAL1\n`: довжина заголовка JSON у форматі uint32 з порядком байтів «big-endian», заголовок, зашифрований текст та 16-байтовий тег GCM. Заголовок містить саме `algorithm`, `key`, а `nonce`; алгоритм — `RSA-OAEP-256+A256GCM`. Повний префікс у межах заголовка є додатковими автентифікованими даними GCM. Розмір заголовка обмежений 8192 байтами. CLI передає корисні дані обсягом до 8 ГіБ та здійснює автентифікацію перед записом запитуваного вихідного даних; він відмовляє у перезаписі існуючого місця призначення. Це специфічна для проекту оболонка навколо стандартних криптографічних примітивів: RSA-OAEP із SHA-256 та AES-256-GCM, доступна в OpenSSL та всіх основних бібліотеках криптографії. Вихідні байти доказів проходять процедуру засвідчення **перед тим, як** докази та засвідчення поміщаються у зашифрований зовнішній пакет. Це дозволяє уникнути циклічної залежності між хешем архіву та сертифікатом, що міститься в цьому самому архіві. Для публічних репозиторіїв метадані засвідчення (репозиторій, робочий процес, коміт, назва артефакту та дайджест) є публічними. Ніколи не вказуйте імена чатів у публічних метаданих. ## Сфера застосування та валідація Цей режим використовує механізм з підписаним журналом та експортом облікового запису. Таємні чати, історія, видалена до початку збору, та дані, недоступні для облікового запису, виключаються. Приватні хмарні чати враховуються, якщо їх обрано. Кількість діалогів у вікні вибору чатів обмежена 20 000; механізм експорту облікового запису самостійно визначає обсяг даних. Відсутні дані, пошкоджені файли та незавершені завдання фіксуються. Обмеження на вкладення та обмеження дискового простору/часу роботи виконавця залишаються чинними. При передачі великих обсягів даних використовуються зашифровані частини замість фіксованого обмеження розміру передачі в 4 ГіБ. Завершення означає, що вибрані завдання, які були призупинені, виконано, а не те, що кожен історичний запис Telegram присутній в архіві. Журнал чату також може відстежувати оновлення в режимі реального часу; жоден із режимів не є атомарним знімком. Створені скріншоти та записи екрану не є частиною цього режиму. Тести охоплюють синтетичний перший вхід, ізоляцію області дії, мультимедіа, скасування, часткове виконання в строк, невдалий вихід із системи, заборонені шляхи та поля API, відхилення попередньо завантаженого робочого простору, відхилення через неправильний ключ та втручання, обов’язкові прапори верифікатора та сумісність шифрування між браузером і Python. Приймальний тест браузера використовує явно позначене фіктивне засвідчення; це не є справжнім тестом Sigstore. Про результати реальних тестів із використанням хостованого запускача, Docker, атестації GitHub та приймальних тестів у Telegram у реальному режимі необхідно звітувати окремо від локальних синтетичних перевірок. [Умови використання GitHub Actions](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#actions) обмежити використання хостованих бігунів термінами життєвого циклу програмного проекту. Створення форку не скасовує цих обмежень; цей попередній варіант не повинен позиціонуватися як необмежений безкоштовний хостинг для виробничого середовища. [Швидкі тунелі Cloudflare](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) також призначені для тестування та розробки. Допоміжні функції/робочі процеси підходять для оцінки цієї функції; відповідність вимогам виробничого середовища залишається окремою вимогою до розгортання. ## випусків, що здійснює відповідальний за підтримку# 1. Зафіксуйте та перевірте колектор, супервізор, визначення контейнера та тести. 2. Збережіть цей коміт колектора в `sealed-collector.yml`, а потім зафіксуйте/перегляньте робочий процес, що може бути використаний повторно. Ніколи не виводьте чек-аут з SHA викликувача без попередження. 3. Додайте до вибраного багаторазове підтвердження робочого процесу `sealed-witness.yml` та додайте його пару SHA робочого процесу/колектора до `sealed_policy.json` у надійному релізі. 4. Опублікуйте всі коміти, на які є посилання, а також допоміжний файл, а потім протестуйте незалежний форк та справжній сертифікат GitHub. Не об’єднуйте коміти, на які є посилання в цих фіксаціях, доки ці посилання не будуть перегенеровані та опубліковані знову. Ознайомтеся з [багаторазовими робочими процесами та підтвердженнями,](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) щоб зрозуміти різницю між репозиторієм, що ініціює виклик, та підписником на верхньому рівні. --- # Telegram · Проведіть розслідування у всіх чатах Canonical page: https://phishdestroy.io/tgwitness/uk/docs/cases/ Проведіть комплексне розслідування в Telegram, охопивши канали, групи, приватні чати та боти: повне копіювання облікового запису, історію, користувачів, посилання, файли, хронологію та перевірені докази. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Ціла справа по каналах, групах, особистих чатах і ботах: зібрати, пов'язати, відновити хронологію, передати. Один вигаданий інцидент від початку до кінця. Збір, пошук і профілі людей знаходять записи, [Case Board](https://phishdestroy.io/tgwitness/uk/docs/case-board/) їх упорядковує, [Report studio](https://phishdestroy.io/tgwitness/uk/docs/reports/) оформлює. РЕАЛЬНИЙ ВИПАДОК / ЗМІНА АДРЕСАТА ПЛАТЕЖУ ### Один інцидент. Чотири розмови. Слід, який потрібно відтворити. Пост у каналі веде на бота. У групі обговорюють нове платіжне посилання, бот його показує. Пост редагують, в особистому чаті посилання повторюють, повідомлення в групі зникає. Хто опублікував кожну версію?Де з’явилося це посилання?Який файл було збережено?Що змінилося і коли? Завантаження історії, ШІ, MCP, OCR і вебхуки: [Робота з архівом](https://phishdestroy.io/tgwitness/uk/docs/archive/). ## 1. Забезпечити охоплення всього облікового запису Охоплення всього акаунта — лише на окремому акаунті. Основному — вибрані чати або папка. 1. [Підключіть акаунт](https://phishdestroy.io/tgwitness/uk/docs/accounts/) в окремому просторі. Запишіть номер справи, ID акаунта, простір і відбиток ключа. 2. **Джерела → Охоплення спостереження → Режим розслідування**: **Весь акаунт**, усі чотири типи джерел, **Власні дії**. Для кожного нового чату зберігаються профіль і останні **200 видимих повідомлень**. **Зберегти охоплення** й підтвердьте. 3. **Завантажити чати** й порівняйте зі списком чатів акаунта. Ліміт — 1000 діалогів (до 20 000 у **Параметри → Чати зі списку акаунта**); чати понад ліміт з'являться, коли стануть активними. 4. **Налаштування запису** → **Уся видима активність**, перевірте ліміти вкладень і місце на диску. Запустіть і перевірте на повідомленні, правці й видаленні. КаналиГрупиПриватні чатиБоти ОДИН ОБЛІКОВИЙ ЗАПИС / ОДИН КЛЮЧ ПІДПИСАННЯ**Уся вибрана активність, видима для облікового запису, → один журнал** Повідомлення · редагування · повідомлення про видалення · видимі реакції · події, пов’язані з членством · власні дії «Весь акаунт» — це всі чати, які цей акаунт може відкрити, за винятком виключень. Таємні чати записує модуль Secret Chats. Нові чати додаються в міру появи, стара історія завантажується на запит. ## 2. Збирання історії та збереження файлів Створіть колекцію в Case Board і позначте важливе. Ведіть реєстр джерел: ID чату, назва, акаунт, роль, початок живого збору, результат історії, результат медіа, прогалини. | Потрібно | Дії на панелі | Що він пропонує | | --- | --- | --- | | Історія у всіх увімкнених чатах | Джерела → Завантажити повну історію | Доступні попередні повідомлення потрапляють до журналу робочого простору з можливістю призупинення/відновлення та підписаним звітом про хід роботи. [Посібник з історії](https://phishdestroy.io/tgwitness/uk/docs/reference/history/). | | Існуючий контекст чату в журналі | Джерела → Налаштування запису → Знімок історії | Нещодавні повідомлення як підписані записи. Типово 500, до 10 000 у **Параметри → Найбільший знімок історії**. | | Повна історія одного чату, яка наразі доступна для перегляду | Експорт повного чату → Експорт повного чату або Чати → Експорт чату | Окремий підписаний архів із `chat.json` і `chat.html`, по одному на чат. | | Контекст появи нового чату | Сфера спостереження → Коли з’являється новий чат або бот | Його профіль і до 1000 останніх повідомлень (200 у режимі розслідування). На наявні чати не поширюється. | | Обсяг вкладення в байтах | Завантаження видимих вкладень + обмеження за типами | Шукайте `media.saved` із SHA-256 і розміром. «У черзі», «пропущено» чи «помилка» — значить, не збережено. | Експорт чату не потрапляє в журнал і профілі людей. Щоб шукати по старій історії всередині TgWitness, використовуйте **Завантажити всю історію** або знімки. Тут: канал, група, чат із ботом і особистий чат, плюс файл рахунку та його хеш. Видалене до початку збору вже не повернути. ## 3. Відстежуйте розвиток розмови та свої власні дії Хай працює. Позначте гарячі чати зірочкою як пріоритетні, налаштуйте перевірки в **Налаштування запису → Повторна перевірка** й стежте за `recheck.completed`, FloodWait і результатами медіа. **Чати → Профіль → Зберегти профіль зараз** зберігає опис чату, команди бота й інші метадані. **Підписка на бота або прийняття запрошення в рамках справи** 1. **Чати → Відкрити посилання Telegram**, спершу збережіть прев'ю. Посилання й прев'ю стають підписаними записами. 2. Якщо потрібно, **Приєднатися / відкрити й спостерігати** вступає в чат або запускає бота з його стартовим параметром. 3. Щоб задокументувати дію, відповідайте або натисніть **Натиснути кнопку** в панелі. Отримаєте `interaction.requested` і `interaction.result` з відповіддю бота. Це справжні дії. Натискання кнопок в іншому застосунку не видно, лише відповідь бота. Без вебзастосунків, платежів і телефону/геолокації. ## 4. Відстежуйте користувачів, посилання та файли у чатах 1. **Журнал**, **Усі джерела**, шукайте фразу, домен чи юзернейм. Відкривайте результати й надсилайте їх **На дошку**. 2. **Чати → Люди → Увімкнути профілі**, оберіть людину: історія імен, відповіді, активність, **Також у…**, посилання, гаманці, телефони. Відкривайте процитовані записи. 3. Простежте той самий числовий ID користувача в інших чатах. Збіг імені, гаманця чи аватара — зачіпка, яку слід звірити з числовим ID. 4. Порівняйте хеші файлів. Однаковий SHA-256 = однакові байти. КАРТА СПРАВИ / ПЕРЕЙДІТЬ ЗА ПОСИЛАННЯМИВигаданий випадок · це не реальний графік КАНАЛ / ОГОЛОШЕННЯ**Оригінал → відредагований варіант** Записи № 101, № 188, повідомлення № 84 · відправник не вказаний ГРУПА / ОПЕРАЦІЇ**Користувач 71001 опублікував нове посилання** Запис № 146 · повідомлення № 309 Збережена квитанція про отримання файлу № 151 Бот / Розмова щодо замовлення**Кнопка веде на цю сторінку** Запис № 173 · повідомлення № 12 Метадані кнопки «Повернутися» ПРИВАТНЕ / ПОДАЛЬШІ ДІЇ**Користувач 71001 повторює пункт призначення** Запис № 205 · повідомлення № 922 Збережена квитанція про отримання файлу № 209 Чотири чати містять різні спостереження. Слідкуйте за вихідними записами для кожного з’єднання; допис у каналі не має вказаного відправника. Числові ідентифікатори та посилання на записи вигадані для цього покрокового керівництва. Ця пояснювальна схема показує, як пов’язати результати пошуку, профілі та перевірені записи; «Case Board» зберігає відповідні картки та посилання на джерела. | Зв’язок | Додаткові спостереження | Висновок: залишити | | --- | --- | --- | | Той самий акаунт у Telegram | Ідентифікатор користувача 71001 у групі № 146 та приватному чаті № 205 | Той самий ID відправника в обох чатах. | | Повторне призначення | `pay.example.invalid/new` у #146, метадані кнопки #173, відредаговані дописи #188 та #205 | Те саме посилання в чотирьох місцях. | | Кількість байтів у файлі | Ідентичні повні значення SHA-256 у завершених квитанціях про надсилання медіафайлів № 151 та № 209 | Обидва файли збігаються побайтно. | Профілі охоплюють лише тих, хто щось написав у *цьому просторі*, це не список учасників. Кількість цитат на факт: **Параметри → Записів на факт**. ## 5. Відтворити послідовність та позначити пропуски Версії в **Чатах**, потім **Журнал** з **Усі джерела** + **Правки**, **Видалення**, **Охоплення**. У хронологію ставте обидва часи: дату Telegram і момент спостереження. 1. 09:00 · #101**Збережений допис у каналі** Початкове призначення збережено. 2. 09:12 · #146 / #151**Група надає інше посилання** Користувач 71001 публікує його; завантаження вкладення завершено. 3. 09:16 · #173**Бот показує те саме місце призначення** Збережені метадані клавіатури містять посилання. 4. 09:20 · #188**Зміни в оголошеннях каналу** Зберігаються як оригінальні, так і відредаговані спостереження. 5. 09:24 · #205 / #209**У приватному повідомленні це повторюється** Збережене вкладення має той самий повний SHA-256, що й № 151. 6. 09:28 · #231**Надходить повідомлення про видалення групи** Попереднє зауваження залишається в силі: не вказується ані особа, яка здійснила видалення, ані точний час видалення. Наведені приклади часу спостереження та посилання. Між цими записами містяться й інші записи журналу. Порядок у журналі — це порядок надходження, а не обов'язково порядок подій. Тримайте окремо живі записи, знімки, відновлені повідомлення, видалення й «не знайдено під час перевірки» та позначайте кожну прогалину як невідому. ## 6. Розширити сферу застосування на інші облікові записи, що збирають дані Один простір на акаунт, ті самі кроки. Запишіть роль і відбиток кожного. Номери повідомлень свої в кожного акаунта, тож завжди вказуйте простір і чат. [Група акаунтів](https://phishdestroy.io/tgwitness/uk/docs/groups/) показує статус, ділиться налаштуваннями й експортує всіх разом — у кожного свій журнал і ключ. Спільну хронологію по акаунтах збирайте у своїх нотатках. Довга справа? Додайте [незалежного свідка](https://phishdestroy.io/tgwitness/uk/docs/witness/) й перевірте, що насправді ловить кожен акаунт. ## 7. Надайте пакет матеріалів справи, який можна перевірити Підписаний ZIP з кожного простору (завжди весь журнал, фільтри не важливі), плюс профілі людей, експорти чатів і файли. ``` CASE-001/ # assembled by the analyst case-notes.md # question, findings, alternative explanations sources.csv # every chat, role, acquisition result and gap timeline.csv # account + chat + message + seq + both times workspace-A/ evidence.zip # complete signed observation journal retained-checkpoint.json profiles-operations.json # separately signed people profiles history-channel.zip # signed current-history export history-group.zip verification.txt workspace-B/ # separate journal and trusted fingerprint witness/ # retained checks, journal and signed posts SHA256SUMS # hashes of the delivered files ``` Відбитки передавайте окремо. Перевіряйте все за його власним простором: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` Контрольна точка підписана ключем збирача, тому сама по собі вона не відповідає мінімальним вимогам до доказів; для параметра `--require evidence` також потрібен перевірений часовий штамп або публікація свідка, що охоплює останній запис. Зберігайте вивід верифікатора, оригінали, охоплення й запис про передачу разом із висновками. Оформіть усе в Report studio. Якщо отримувачу треба менше, зробіть [скорочену передачу](https://phishdestroy.io/tgwitness/uk/docs/handover/). --- # Telegram · Створити «Case Board» Canonical page: https://phishdestroy.io/tgwitness/uk/docs/case-board/ Збирайте збережені спостереження, точні виділення та фрагменти дій на приватній дошці, обговорюйте їх зі своєю командою та презентуйте збірку. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Перетворіть збережені повідомлення на справу, над якою працює вся команда. Закладки, точні цитати, зрізи й обговорення, кожне пов'язане з джерелом. Кожна зміна — підписана ревізія. ## Від повідомлення до картки справи 1. **Розслідування → Case Board** (режим «Стандартний» або «Експерт»). Створіть колекцію для справи. 2. У **Журналі** або в чаті натисніть **На дошку** (або **B**). Картка потрапить у «Вхідні», дайте їй назву й перемістіть. 3. Виділіть текст у повідомленні — **Виділити → на дошку** збереже точну цитату й версію. Позначте, чому це важливо. 4. Обговорюйте, ставте статус, повертайтеся до джерела, коли треба. **Презентація** проведе команду через увесь матеріал. ### Слідуйте за одним зміненим посиланням для оплати Синтетичний приклад · локальна ілюстрація 1. **Збір даних.** Відкрийте збережене спостереження № 142 та його версію повідомлення. 2. **Додайте до закладок.** Запишіть цитату, посилання на джерело та своє запитання на картці. 3. **Переглянути.** Додайте коментар команди та перемістіть картку до статусу «Переглянути». 4. **Покажіть.** Пройдіться по колекції та відкрийте контекст цитованого джерела. #### Збережене спостереження № 142 «Скористайтеся новим посиланням для оплати». Оперативний чат · повідомлення 38 · зафіксовано о 09:12 UTC #### Картка: змінено місце призначення > Використовуйте нове посилання для оплати. Питання: яка цільова мова була вказана в попередній версії? #### Перевірка командою Аналітик: порівняйте з зауваженням № 101. Статус: Перегляд · версія збережена #### Контекст оригіналу Картка → збережена версія → попереднє спостереження Анотації та спостереження за Telegram залишаються окремо ідентифікованими. ## Збережіть корисний діапазон один раз Shift-клік по двох повідомленнях для **Зріз між**, **Зріз за часом** або збереження поточних фільтрів журналу. **Показати записи після закладки** покаже, що надійшло пізніше. Зрізи за часом використовують час спостереження, зрізи за ID повідомлень стежать за цими повідомленнями в міру їхніх змін. ## Присвойте кожному колезі відповідну роль **Рецензент** читає, **Аналітик** додає картки й коментарі, **Оператор** ще й керує колекціями та рішеннями. Права на чати діють і на картки. ## Перенесіть результат роботи у кінцевий продукт Зрізи експортуються в підписаний JSON або CSV. У звіти можна додати закладки, зрізи й коментарі — це налаштовується в [Report studio](https://phishdestroy.io/tgwitness/uk/docs/reports/). Для отримувача з обмеженим доступом використовуйте [передачу](https://phishdestroy.io/tgwitness/uk/docs/handover/). Докладніше: [довідник з Case Board](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/). --- # Telegram · Створіть звіт Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reports/ Виберіть дані звіту, один із восьми макетів та зміст, а потім перегляньте попередній варіант і експортуйте HTML, підписаний PDF або повний пакет доказів. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Ведіть читача від питання справи просто до збережених записів. Report studio збирає вибрані дані, історії змін, графіки й ваші висновки. Вісім дизайнів, HTML і нативний PDF. Кожен звіт у HTML, PDF і JSON запечатується вашим ключем. ## Створіть звіт у три етапи 1. **Експорт → Налаштування й попередній перегляд → Дані**: увесь простір або вибрані чати, автори, дати (UTC, коли TgWitness побачив запис) і типи записів. 2. **Дизайн і вміст**: оберіть дизайн і що ввійде у звіт — графіки, учасники, листування, зміни, матеріали Case Board, дані справи й нотатки. 3. **Попередній перегляд**: перевірте кількості, активність, приклади й діапазони відсутніх ID. Збережіть і завантажте потрібний формат. ### Упорядкуйте збережений матеріал так, щоб він був зрозумілим для читача Синтетичний приклад · схематичне оформлення, а не згенерований звіт 1. **Виберіть.** Оберіть два чати та період спостереження для справи. 2. **Складіть текст.** Оберіть макет та розділи, які дають відповідь на питання. 3. **Попередній перегляд.** Перегляньте кількість перекладів та збережений текст «до» і «після». 4. **Перевірте.** Створіть остаточний файл і порівняйте його підпис із відбитком надійного робочого простору. #### Вибрані зауваження 2 чати · 1 день спостереження Повідомлення, редагування та повідомлення про видалення #### Структура звіту ##### Змінено реквізити для оплати Питання щодо справи → обсяг → висновки → посилання на записи **Контекст повідомлення** Зауваження № 142: «Скористайтеся новим посиланням для оплати». **Збережено зміни** До: old.example.invalid → Після: new.example.invalid #### Переглянути вибір 18 коментарів · 2 збережених редагувань Час відправлення, редагування та перегляду має окремі позначки. #### Кінцевий результат Підписаний PDF + підписаний JSON або підписаний ZIP-архів із читабельним звітом Одержувач перевіряє файл та надійний цифровий відбиток. ## Оберіть стиль викладу **Classic, Editorial, Briefing, Analytics, Technical, Overview, Reading series, and Ledger & margin**: ті самі записи, різний вигляд. Під час зміни зберігаються вибір і нотатки. Будь-яка з 25 мов. PDF збираються з вбудованими шрифтами, браузер не потрібен. Для китайської, японської та корейської потрібен шрифт на кшталт Noto Sans CJK на сервері (у системі або в `TGWITNESS_FONT_DIR`), інакше будуть лише HTML і JSON. ## Ознайомтеся зі змінами в контексті Правки показуються «до» і «після», видалення — з останньою збереженою версією. Відповіді, пересилання, реакції, кнопки й вкладення зберігають свої посилання. Попередній перегляд дизайну використовує перші 50 000 записів, попередній перегляд даних рахує все точно. Остаточну верстку сторінок покаже лише згенерований PDF. ## Ретельно підбирайте варіант тексту для конкретного одержувача Фільтри впливають лише на звіт, у ZIP з доказами, як і раніше, увесь журнал і файли. Якщо отримувачу треба менше, використовуйте [скорочену передачу](https://phishdestroy.io/tgwitness/uk/docs/handover/). Ще: [вміст звітів](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/), [перевірка експорту](https://phishdestroy.io/tgwitness/uk/docs/exports/). --- # Telegram · Підготуйте копію для поширення Canonical page: https://phishdestroy.io/tgwitness/uk/docs/handover/ Виберіть записи та поля, які може отримати одержувач, перевірте готову копію та переконайтеся у правильності підписаного маніфесту та меж журналу джерел. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Діліться лише потрібним, оригінал лишається недоторканим. Передача — це окрема підписана виписка: оберіть чати й людей, приховайте особи чи текст, відберіть файли й нотатки команди. Маніфест фіксує, що лишено, скорочено й виключено. ## Підготуйте витяг для одержувача 1. **Експорт → Виписка для передачі**: вкажіть мету, оберіть чати й період, **Завантажити людей вибраних чатів**, якщо потрібні конкретні люди. 2. Усі інші: псевдоніми, виключення або як записано. Текст і файли вмикаються окремо, телефони й пошту можна приховати. 3. Case Board: нічого, закладки й зрізи або картки з коментарями. Імена команди можна замінити псевдонімами. 4. **Завантажити виписку для передачі**, відкрийте, перевірте, перегляньте перед відправленням. ### Один оригінал, одна копія для поширення Синтетичний приклад · наведено лише для ілюстрації 1. **Виберіть.** Включіть чат справи та вкажіть особу, про яку йдеться у витягу. 2. **Зменшуйте обсяг тексту.** Вибирайте, як інший учасник відображатиметься у копії, що надається для спільного доступу. 3. **Перевірте.** Відкрийте згенерований звіт та записи архіву перед відправленням. 4. **Поділіться.** Надішліть перевірений текст та окремо повідомте його надійний цифровий відбиток. #### Початкове зауваження Нора · користувач 71002 «Я отримав переглянуте посилання». Журнал джерел зберігає ці збережені спостереження. #### Копія для одержувача Показати так, як записано: Нора · користувач 71002 · «Я отримала оновлене посилання». Псевдонім: P01 · «Я отримав оновлене посилання». Опустити: повідомлення цього учасника не включається до тексту. #### Перегляньте фактичні файли Ознайомтеся з файлами report.html та records.jsonl. Перевіряйте ідентифікаційні дані, текст, вкладення та додаткові коментарі команди. #### Підписаний витяг Вибір + хеші файлів + підписаний маніфест Окремий пакет, пов’язаний із межами вихідного журналу ## Використовуйте ці елементи управління разом | Контроль | Вплив на текст | | --- | --- | | Люди | Вибрані люди лишаються названими, інші отримують псевдоніми або виключаються. | | Текст | Увесь текст, лише текст вибраних людей і вашого акаунта або жодного. | | Файли | Файли вибраних людей і вашого акаунта, усі показані файли або жодних. | | Дошка випадків | Нічого, закладки й зрізи або картки з обговоренням. | Прочитайте і сам текст, і файли: псевдонім не прибирає імен, написаних усередині повідомлення чи вкладення. Якщо вибраного файлу немає, відновіть його або виключіть вкладення. ## Текст має бути таким, щоб його можна було незалежно перевірити ``` python -m tgwitness.verify handover.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` Оригінальний архів і контрольні точки зберігайте в себе. Отримувач може перевірити свою копію, не отримуючи весь простір. Оформлення: [Report studio](https://phishdestroy.io/tgwitness/uk/docs/reports/). Довірені посилання: [перевірка експорту](https://phishdestroy.io/tgwitness/uk/docs/exports/). --- # Telegram · Управління групою облікових записів Canonical page: https://phishdestroy.io/tgwitness/uk/docs/groups/ Порівнюйте групові робочі простори, знаходьте джерела, переглядайте періоди спостереження та застосовуйте спільні налаштування з винятками для окремих облікових записів. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Ведіть кілька акаунтів разом — у кожного, як і раніше, свої записи й ключ. Група збирає статус підключення, запуск/паузу, спільні налаштування й експорт на одному екрані. Зручно, коли кілька акаунтів працюють над однією справою. ## Відкрити огляд групи Відкрийте групу в **Акаунтах**. Для кожного акаунта видно стан, маршрут, затримку й останнє збережене повідомлення. **Потребує уваги** перелічує зламані, **Виправити** веде просто туди. **Запустити всі** / **Призупинити всі** питають перед дією. **Налаштування групи** спільні, але власні значення акаунта лишаються, доки ви їх не заміните. ### Переглянути зміну маршруту в групі Синтетичний приклад · ілюстративні перевірки та результати 1. **Виберіть.** Оберіть групу та перегляньте, які облікові записи зазнають змін. 2. **Підготуйте текст.** Зберігайте окремий маршрут для кожного облікового запису, коли це необхідно. 3. **Перевірте.** Протестуйте запропоноване з’єднання та проаналізуйте отримані результати. 4. **Подайте заявку.** Перед збереженням перевірте текст ще раз і перегляньте результат для кожного облікового запису. #### Команда, що веде справу Колектор каналів · Колектор груп · Довідковий обліковий запис 3 окремі робочі простори #### Переглянутий вибір 2 акаунти дотримуються запропонованого підходу. Довідковий обліковий запис має власний маршрут. #### Перевірка підготовки Колектор каналів: час передачі даних у Telegram — 84 мс Груповий колектор: час передачі даних Telegram — 91 мс Ці цифри є вигаданими показниками, наведеними для прикладу. #### Результати застосування Колектор каналів: маршрут збережено, спостереження відновлено. Груповий колектор: повторна перевірка завершилася невдало, відновлено попередні налаштування. Довідковий обліковий запис: збережено власний маршрут. ## Змінити маршрут, додавши етап перевірки 1. **Змінити маршрут групи**, оберіть тип і налаштування. 2. **Перевірити вибір**: які акаунти зміняться і в яких свій маршрут. 3. **Підготувати й перевірити** перевіряє нове підключення до Telegram і, де можливо, зовнішню IP. 4. **Застосувати перевірене підключення** й подивіться на кожен результат. Акаунти, що працювали, продовжать, неактивні такими й лишаться. Затримка — це час встановлення з'єднання з Telegram, зовнішня IP — те, що показав маршрут під час перевірки. Результати в акаунтів можуть відрізнятися. ## Використовуйте перекривний доступ **Чати, які бачать кілька акаунтів**, показують спільні джерела та їхнє охоплення. Канали й супергрупи можна експортувати одразу кількома акаунтами через **Експорт … акаунтами**. Особисті чати й звичайні групи — ні: номери повідомлень там свої в кожного акаунта. ## Експортувати групу як пакет **Експорт групи** дає один ZIP з підписаним експортом кожного акаунта й підписаним їх списком. У кожного свій відбиток для перевірки. Спільну хронологію, як і раніше, збираєте ви. Далі: [звіти](https://phishdestroy.io/tgwitness/uk/docs/reports/), [Case Board](https://phishdestroy.io/tgwitness/uk/docs/case-board/), [перевірка експорту](https://phishdestroy.io/tgwitness/uk/docs/exports/). --- # Telegram · Дізнайтеся, як працює система збереження доказів Canonical page: https://phishdestroy.io/tgwitness/uk/docs/concepts/ Простежте шлях повідомлення від моменту фіксації до контрольної точки. Змініть зразок запису, перерахуйте його ланцюжок SHA-256 і подивіться, що виявить збережена контрольна точка. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Повідомлення змінюються. Ваш запис того, що ви бачили, — ні, і перевірити це може будь-хто. Нижче два невеликі експерименти. Вигадані повідомлення, усе працює в браузері, у Telegram нічого не йде. ## Від експорту чату до перевіреного запису [Експорт Telegram Desktop](https://telegram.org/blog/export-and-more) зберігає видиму зараз історію в HTML чи JSON. TgWitness додає безперервний журнал змін, підписи на кожному записі й контрольні точки, з якими можуть звірятися інші. | Завдання | Експорт з Telegram Desktop | TgWitness | | --- | --- | --- | | Перегляд збережених розмов | HTML або JSON із вибраними мультимедійними файлами | Збережені чати, журнал із можливістю пошуку та офлайн-звіти | | Відстежуйте зміни з плином часу | Історія, доступна під час експорту | Старі версії, пізніші правки й видалення — усе збережено | | Перевірте файли після передачі | Стандартні файли експорту у форматі HTML/JSON не підписуються | Підписаний маніфест, підписані записи й запечатані звіти, перевірювані за довіреним ключем | | Порівняйте з попереднім збереженим станом | Зберігайте окрему копію для довідки або хеш-код | Підписані контрольні точки, окремий свідок та опціональні зовнішні мітки часу | Порівняння базується на [коді експорту Telegram Desktop](https://github.com/telegramdesktop/tdesktop/tree/768d47cda6c7f447c10a25d1f363279493a90ed7/Telegram/SourceFiles/export/output) станом на 2 листопада 2026 року. ## Одне повідомлення, три спостереження Нове повідомлення, правка й видалення стають трьома окремими записами. Правка не перезаписує перший, видалення його не стирає. 01 / ШЛЯХ ПОВІДОМЛЕННЯІлюстративна послідовність Telegram delivers an update to the collector, which appends a journal record. · Telegram · Колектор · Журнал · оновлення → · додати → ПЕРЕГЛЯД ПОТОЧНОГО ЧАТУ Повідомлення № 42 Повідомлення видалено Повідомлення зникло з вікна чату. ЖУРНАЛ СПОСТЕРЕЖЕНЬ 3 записи 1. 01 `message.new` Зустріч о 10:00 ✓ 2. 02 `message.edited` Зустріч о 11:00 ✓ 3. 03 `message.deleted` Повідомлення про видалення № 42 ✓ Усі три отримані спостереження залишаються в журналі. Спрощений шлях для одного вже обраного джерела. Оперативні записи також містять інформацію з реального журналу. Збір даних залежить від того, що може бачити користувач, та від того, що надає Telegram. ## Змінити запис. Простежте хеш. Кожен запис містить хеш попереднього. Контрольна точка, збережена деінде, фіксує довжину журналу й останній хеш. 02 / ПІСОЧНИЦЯ HASH-CHAINСправжній SHA-256 · зразки записів ЗАПИС 01**Повідомлення отримано**`h₁ = SHA-256(e₁)`Посилання на 64 нулі ЗАПИС 02**Зустріч о 11:00**`h₂ = SHA-256(e₂)`Містить h₁ ЗАПИС 03**Виявлено видалення**`h₃ = SHA-256(e₃)`Включає h₂ ЗБЕРЕЖЕНО В ІНШИХ ДЖЕРЕЛАХ**3 записи · заголовок `h₃`**Порівняйте цю фіксовану межу з наданим журналом. Зміна події призводить до зміни її хешу. Відновлення ланцюжка змінює його початок. Видалення кінця робить його коротшим за збережену контрольну точку. **Переглянути запис № 2 та повні хеші** Це точний JSON-файл у кодуванні UTF-8, хешований у цьому прикладі. Значення є вигаданими; дев’ять полів та серіалізація відповідають формату журналу. ``` ``` Хеш збереженого запису 2 `` Перерахований хеш запису 2 `` Ця тестова середа обчислює хеші, а не підписи. Справжній верифікатор також перевіряє підпис Ed25519, послідовність та посилання кожної події. Відновлення лише хешів не дозволяє створити дійсні підписи за допомогою довіреного ключа. ## Фактичні правила, у кількох рядках HASH + ПІДПИС h0 = 064 hi = hex(SHA-256(C(ei))) σi = Ed25519.Sign(sk, unhex(hi)) **C** — це дев'ять полів події у вигляді UTF-8 JSON: ключі за порядком, без зайвих пробілів, без ASCII-екранування, без NaN/нескінченності. `previous_hash` — це hi−1, h0 — 64 нулі, підписи покривають 32 сирі байти дайджесту. Поля: `seq`, `observed_at`, `source_at`, `kind`, `chat_id`, `message_id`, `actor_id`, `payload`, `previous_hash`. Повна специфікація: [кодування подій](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#event-canonicalization). ЗБЕРЕЖЕНА КОНТРОЛЬНА ТОЧКА Nexport ≥ Ncheckpoint hexport[Ncheckpoint] = Hcheckpoint Перевірте підпис контрольної точки за закріпленим ключем, потім порівняйте її з журналом. Пізніший експорт може бути довшим, але в точці має збігатися. ## Три запитання, три різні перевірки [01 / ЦІЛІСНІСТЬ**Чи змінився цей запис?** Хеші й підписи за ключем, якому ви довіряєте.](https://phishdestroy.io/tgwitness/uk/docs/exports/)[02 / БЕЗПЕРЕРВНІСТЬ**Що було збережено раніше?** Порівняйте експорт з контрольними точками, які зберіг свідок.](https://phishdestroy.io/tgwitness/uk/docs/witness/)[03 / РЕАЛІЗАЦІЯ**Чи надійшли ці тестові події?** Надішліть, змініть і видаліть тестові повідомлення й подивіться, що впіймав кожен акаунт.](https://phishdestroy.io/tgwitness/uk/docs/cases/) Підписи відповідають на питання «чи змінювали», контрольні точки — «чи збігається з тим, що було раніше», тестові повідомлення — «чи впіймали ми все». [Що доводить перевірка.](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope) Далі: [розслідування по всьому акаунту](https://phishdestroy.io/tgwitness/uk/docs/cases/) від початку до пакета для передачі. [«Export Clinic»: перегляньте контрольований експеримент на робочому столі](https://phishdestroy.io/tgwitness/uk/docs/export-clinic/). Порівняйте двохвилинний фільм, оригінальний запис та сім пар тестових експортних файлів. Розкрито інформацію про локальні зміни. --- # 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 з проханням про закритий канал, без деталей експлойту. --- # Telegram · Налаштування бота-свідка Canonical page: https://phishdestroy.io/tgwitness/uk/docs/witness/ Публікуйте підписані контрольні точки журналу у своєму каналі Telegram із окремим свідком, власним ключем та доступом до колектора лише для читання. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Окремий процес перевіряє ваш журнал і публікує підписані контрольні точки в канал. ## Два хости, два ключі підпису ХОСТИНГ / КОЛЕКТОР**Акаунт + журнал** Ключ підпису колектора сеансів Telegram Кінцева точка контрольної точки, доступна лише для читання ← запит на підписану відповідь → HOST B / WITNESS**Перевіряти + зберігати** Зафіксований відбиток колектора; окремий ключ підпису свідка Власний журнал + токен бота Witness → API бота Telegram →**Ваш канал · підписані публікації TGW1** Witness самостійно здійснює перевірки. Доступ колектора обмежений лише читанням. Публікація через бота використовує з’єднання та токен Witness; сесія облікового запису не надається Witness. 03 / РІШЕННЯ ЩОДО КОНТРОЛЬНИХ ПУНКТІВПриклади відповідей ОСТАННЄ ПРИЙНЯТЕ**120 записів**`head 9c7d…` НАСТУПНА ВІДПОВІДЬ**128 записів**`head a4f2…` Прийнято: кількість зростає, підпис перевірено, а ключ збігається. Свідок зберігає цю нову межу. Усі приклади відповідей базуються на припущенні про наявність дійсного підпису та закріпленого ключа. Хеші тут наведено у скороченому вигляді. Щоб переконатися, що весь старий префікс не змінився, порівняйте експорт зі збереженими контрольними точками. ## Підготуйте бота та канал Створіть бота через BotFather і дозвольте йому писати у ваш канал. Запускайте свідка деінде: інший хост, в ідеалі під керуванням іншої людини, вартує значно більше, ніж другий процес поруч зі збирачем. ## Три кроки в розділі «Додаткові функції» 1. **Доступ лише для читання.** **Доповнення → Незалежний свідок**, створіть токен і збережіть файл. Він читає контрольні точки й стан, більше нічого. 2. **Канал та інтервал.** Канал Telegram або вебхук Discord, плюс адреса збирача, доступна свідку. Збережіть файл налаштувань. 3. **Запуск.** Покладіть `witness.json`, `witness-token.txt` і `bot-token.txt` разом на хост свідка й виконайте: ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json ``` Дочекайтеся першого підписаного поста в каналі, потім збережіть відбиток свідка в надійному місці. Натомість Discord? Збережіть URL вебхука як `discord-webhook.txt`. Один свідок публікує в одне місце; довгі перевірки приходять у Discord файлом. ## Виберіть, як часто публікувати Публікація кожної перевірки дає регулярний зовнішній запис: кожні п'ять хвилин — це близько 288 постів на день на простір. У розширених налаштуваннях можна публікувати лише за змін чи проблем, використовувати проксі або власний Bot API. **Що саме підтверджує цей бот?** Він запитує в збирача підписану контрольну точку, перевіряє її за очікуваним ключем і веде власний підписаний журнал, зокрема пропущені й відхилені відповіді. Він перевіряє стан журналу, а не стежить за Telegram сам. Для цього проведіть контрольний тест доставки. ## Перегляньте докази пізніше Зберігайте журнал свідка, пости й відбитки. [Як звірити їх](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/#verify) з експортом збирача. --- # Чому саме «нульова довіра»: Taylor Wessing, д-р Цурхайде, д-р Шелінський Canonical page: https://phishdestroy.io/tgwitness/uk/docs/signed-export/ Приклад застосування моделі «нульової довіри»: відповідь щодо GDPR, підписана д-ром Патріком Цурхайде та д-ром Тобіасом Шелінскі з юридичної фірми Taylor Wessing, перевірена на відповідність власним документам, а також перевірюваній моделі, яка не залишала б місця для обману чи сумнівів. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) **Приклад із практики**Справжні документи · справжні підписи · хеші наведені нижче · результати можна відтворити в автономному режимі Приклад із практики, що ілюструє необхідність підходу «нульової довіри». Один запит щодо власних даних особи відповідно до статті 15 Загального регламенту про захист даних (GDPR), на який партнери провідної міжнародної юридичної фірми надали відповідь із використанням кваліфікованих підписів. Усі запевнення у відповіді доводилося приймати на віру: підпис, посади, «місяць ручної перевірки», захист третіх осіб, «будь-який суд погодиться». Після перевірки наданого файлу виявилося, що жодна з цих заяв не відповідає дійсності. На цій сторінці показано, до чого призвела довіра, і як модель, що піддається перевірці, не залишила б місця для обману чи сумнівів. 15 серпня 2025 року · лист[Д-р Тобіас Шелінський](https://www.taylorwessing.com/en/people/germany/hamburg/dr-tobias-schelinski)Партнер юридичної фірми «Taylor Wessing» · юрист-спеціаліст у галузі права інформаційних технологій 1 жовтня 2025 року · лист та додаток 1[Д-р Патрік Цурхайде, магістр права (LL.M.)](https://www.taylorwessing.com/de/people/germany/hamburg/patrick-vincent-zurheide)Salary Partner, Taylor Wessing, з 2025 року · ІТ, захист даних та судові спори у сфері технологій Інформація про посади взята з профілів компанії, на які наведено посилання. На цій сторінці не вказано, чи було обґрунтованим блокування облікового запису Steam. Тут показано, що міститься у наданому файлі та що про це йдеться у підписаних листах. Кожен рисунок можна перевірити, зіставивши його з файлами. **830 сторінок**у додатку до другого листа **36 секунд**від моменту створення до останньої зміни цього вкладення **905 672 символів,** які можна прочитати під чорними прямокутниками **2 підписи**про що йшлося у двох листах, по одному в кожному **Коротко кажучи.** Підпис вказує, хто надіслав файл. Він не може підтвердити, чи файл є повним, правильним або достовірним. Це можуть зробити лише перевірки байтів, і їх може виконати будь-хто. ## «Нульова довіра»: перевіряйте файл, а не відправника «Нульова довіра» означає, що нікому не слід вірити: ні компанії, ні посаді, ні підпису, ні навіть нам. Відповідь на запит про доступ має сама себе підтверджувати. Вона має дати відповідь на три запитання, а підпис не відповідає на жодне з них. **Копія готова?**Чи має заявник усе, що йому належить, і чи кожне упущення враховано та пояснено? **Текст залишився без змін?**Чи кожен запис відповідає тому, що було спочатку, і чи відображатимуться будь-які пізніші зміни? **Хто вирішив, що саме приховано?**Чи рішення про утримання було прийнято особою, яка мала на це право, і чи може хтось перевірити це згодом? Більшість юридичних спорів у ЄС залишаються закритими: угоди, укладені на умовах угоди про нерозголошення інформації (NDA), засекречені матеріали, рішення, які ніколи не оприлюднюються. Ми не маємо нічого проти цього. Ця справа відрізняється від інших, і, ймовірно, не тому, що те, що в ній сталося, є рідкісним. У ній немає ні угоди про нерозголошення інформації, ні судового рішення, тому її можна прочитати від початку до кінця: дуже простий закон — Загальний регламент про захист даних (GDPR); один запит щодо власних даних особи; те, що фактично було надано; та чорні прямокутники, які кожен може видалити. Унікальність цього дослідження полягає в тому, хто відповідав і як саме. Доктор Тобіас Шелінський та доктор Патрік Цурхайде є партнерами юридичної фірми «Taylor Wessing», як зазначає сама фірма [«європейський лідер у сфері юридичних послуг»](https://www.businesswire.com/news/home/20251217415857/en/Taylor-Wessing-Diversifies-Its-International-Strategy). Обидва мають науковий ступінь доктора; один із них є сертифікованим юристом-спеціалістом з інформаційно-технологічного права, інший — магістром права Абердинського університету. Вони витратили 106 днів на те, щоб не розглянути законний запит на доступ до даних. При цьому вони надали заявнику, щодо якого надійшло повідомлення, тексти скарг та облікові дані понад 1 800 інших осіб, серед яких можуть бути й неповнолітні, приховавши їх за чорними прямокутниками, які будь-хто може видалити. **Точка зору PhishDestroy.** Логін, тобто ім’я користувача, є суто особистими даними. Він використовується в різних сервісах, а обліковий запис, що існує вже роками, у більшості випадків пов’язаний із реальною особою, яку можна ідентифікувати за його допомогою. Якщо розглядати лише ті п’ятдесят фрагментів, що видно, ми вважаємо, що будь-який суд дійсно міг би бути введений в оману. Однак, маючи повну картину, хронологія та арифметичні розрахунки на цій сторінці чітко показують, що запит згідно з GDPR не було опрацьовано. Ні підпис, ні помилки в написанні імені не змінюють цього факту. ## Що дала довіра і як би вчинила модель Кожне твердження у відповіді наведено нижче у порівнянні з наданим файлом та з моделлю, яку можна перевірити і яка пропонується на цій сторінці. Докази щодо кожного рядка наведено далі. **Підпис** „Dieses Schreiben ist qualifiziert elektronisch signiert“ Тут вказано, хто надіслав листи. Під цим написом 905 672 символи залишаються читабельними під чорними прямокутниками. [Докази](https://phishdestroy.io/tgwitness/uk/docs/signed-export/#signature) Компанія підписує сольовий хеш кожного прихованого поля. Перевіряється вміст, а не відправник. **Відбір** Адвокати вирішують, що саме зможе прочитати заявник. 50 скарг, що залишилися доступними для перегляду, всі подані після блокування та надсилання запиту; 43 з них — це “Suspected Hijacker”. 1 944 було покрито. [Докази](https://phishdestroy.io/tgwitness/uk/docs/signed-export/#convenient) Правило, яке оголошується та підписується під час створення копії, при цьому враховується кожен утриманий запис, а вибір перевіряється уповноваженим органом. **«Місяць ручної перевірки»** „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ Файл обсягом 830 сторінок, створений за 36 секунд. Перший читабельний рядок у ньому — це гомофобне ображання, а скарги, які залишилися читабельними, суперечать змісту цього самого файлу. [Докази](https://phishdestroy.io/tgwitness/uk/docs/signed-export/#refuted) Нічиї слова про докладені зусилля не мають значення. Файл говорить сам за себе, і будь-хто може знайти в ньому суперечність. **Права третіх осіб** „soweit keine Rechte Dritter entgegenstehen“ Імена користувачів та тексти скарг понад 1 800 інших осіб, розміщені під чорними прямокутниками, які може прибрати будь-хто. [Докази](https://phishdestroy.io/tgwitness/uk/docs/signed-export/#under) Дані інших осіб ніколи не потрапляють до копії запитувача. Вони передаються у зашифрованому вигляді, розшифрувати який може лише уповноважений орган. **Копія даних** „Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ Відсутні дані про платежі, звернення до служби підтримки та записи, що лежать в основі цього блоку. Повні даними є лише скарги. [Докази](https://phishdestroy.io/tgwitness/uk/docs/signed-export/#inventory) У підписаному маніфесті перелічено, що входить до складу, та зазначено, чого немає. Жодна прогалина не може залишитися непоміченою. **«Кожен суд»** „Aus unserer Erfahrung wird jedes Gericht …“ П'ятдесят фрагментів можуть ввести в оману. У повному файлі видно, що запит не було оброблено. [Докази](https://phishdestroy.io/tgwitness/uk/docs/signed-export/#authority) Суд або регулюючий орган відкриває повний оригінал документа та звіряє кожне поле з тим, що підписала компанія. **Кожен рядок має однакову форму.** Запевнення, якому доводилося вірити, файл, що суперечить йому, та перевірка, яка зробила б це запевнення зайвим. У цій моделі немає чого приховувати й у чому сумніватися: заявник бачить те, що йому належить, орган влади бачить решту, а кожне поле відповідає тому, що підписала компанія. [Переглянути модель](https://phishdestroy.io/tgwitness/uk/docs/signed-export/#sealed) ## Докази, пункт за пунктом Кожен рядок наведеного вище порівняння ґрунтується на наведених нижче документах: двох підписаних листах та Додатку 1. Посилання на сторінки відповідають порядку сторінок у PDF-файлі, а кожну ілюстрацію можна відтворити в автономному режимі. ### Текст залишився під чорними прямокутниками. Ось так виглядає відповідь на простий запит про доступ, коли її надають провідні фахівці у цій галузі. Чорні прямокутники залишили видимим основний текст у файлі. Це дало змогу прочитати та порівняти обидві групи: 50 описів, що залишилися видимими, та 1 944, які були замальовані. ЛИСТПЕРЕДАНИЙ ФАЙЛ «Незалежно від деталей скарг» Кажуть, що вже сама ця цифра свідчить про неодноразові порушення угоди зі Steam. Д-р Шелінський · 15 серпня 2025 р. · с. 2 „Unabhängig von den Einzelheiten der Beschwerden …“ **50** описів залишатимуться видимими **у серпні–вересні 2025 року** **1,944**описи, які були приховані **Лютий 2021 р. — липень 2025 р.** 43 із 50 видимих описів мають мітки “Suspected Hijacker”. З-поміж 1 944 описів, що увійшли до огляду, 269 мають цю позначку. Додаток 1, с. 444–620. Ще один запис має порожнє поле опису: 50 + 1 944 + 1 = 1 995 рядків у наведеній таблиці. ### П’ятдесят скарг, зручних для адвоката У жовтневому листі вказано причину блокування: обліковий запис було заблоковано, оскільки „Used for Hijacking“ (Д-р Цурхайде, с. 8). З п’ятдесяти скарг, з якими заявнику було дозволено ознайомитися, у 43 міститься одна й та сама інформація: “Suspected Hijacker”. Усі п’ятдесят запитів було подано через кілька місяців після того, як обліковий запис було остаточно заблоковано, після подання запиту на доступ та після останнього входу в систему, зафіксованого в цьому ж файлі. У додатку 1, на сторінці 1, наведено `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)`. Акаунт було заблоковано 7 травня 2025 року. 9 травня 2025 року служба підтримки Steam відповіла на перший запит: блокування не було помилкою, воно було постійним, і запит було закрито. Запит на відновлення доступу надійшов 17 червня. Згідно з самими листами, на той час обліковий запис перебував у володінні третьої сторони: д-р Шелінський пише, що його було придбано у третьої сторони після 3 травня 2025 року (с. 2), а д-р Цургайде — що третя сторона здійснювала через нього платежі після 3 травня, останній з яких — 30 липня 2025 року (с. 1–2). У наданій таблиці скарг зазначено: **53**Серпень 2024 року **54**Вересень **70**Жовтень **79**Листопад **82**Грудень **92**Січень 2025 року **32**лютий **35**Березень **20**квітень **12**травень*заблоковано 7 травня , останній вхід — 23 травня* **1**Червень **7**Липень **47**Серпень **3**Вересень Текст скарги під чорним прямокутникомТекст скарги залишено у вигляді, придатному для читання Кількість скарг за місяць у Додатку 1, серпень 2024 — вересень 2025 р., підрахована на основі текстового шару файлу; повну історію див. у розділі [Перевірте самі](https://phishdestroy.io/tgwitness/uk/docs/signed-export/#verify). Після блокування 7 травня та останнього входу в систему 23 травня: одна скарга в червні, сім — у липні, а потім 47 — у серпні. 1. 3 травня 2025 року**З цієї дати, згідно з листами: третя сторона**Цей рахунок було «придбано у третьої сторони»: д-р Шелінський, с. 2 · «платежі третьої сторони»: д-р Цурхайде, с. 1 2. 7 травня 2025 року**Акаунт заблоковано**Steam 3. 9 травня 2025 року**Це не помилка, стан «Постійний»; заявка закрита**Служба підтримки Steam, перший запит 4. 23 травня 2025 року**Останній вхід**Додаток 1, стор. 1 5. 17 червня 2025 року**Запит на доступ**Д-р Цурхайде, с. 1 6. 29 липня 2025 року**Термін починається, «якщо взагалі»**Д-р Шелінський, с. 1 7. 30 липня 2025 року**Останній «платіж від третьої сторони»; дані, що відносяться виключно до заявника, починаючи з цього місця**Д-р Цурхайде, с. 2 8. Серпень 2025 року**47 скарг, усі доступні для перегляду**Додаток 1, с. 444–448 9. 15 серпня 2025 року**Припинення: 1 938 скарг, «незалежно від їхніх обставин»**Д-р Шелінський, с. 2 10. Вересень 2025 року**3 скарги, доступні для перегляду**Додаток 1, с. 444 11. 29 вересня 2025 року**«Дата звіту»**Додаток 1, стор. 1 12. 1 жовтня 2025 року**Відповідь: «цілий місяць», дані, очищені «вручну»**Д-р Цурхайде, с. 1 Доктор Цурхайде пише, що довелося використати весь місячний період і очистити дані вручну: „musste leider die volle Monatsfrist ausgeschöpft werden … manuell die Daten bereinigt werden mussten“ (с. 1). Три з тих скарг, які вдалося розібрати, датовані вереснем 2025 року, а сам звіт — 29 вересня. Вони були подані в останні тижні перед наданням відповіді, тоді як, за його словами, тривала очистка даних. > “This account just started acting shady overnight” > > Suspected Hijacker · Серпень 2025 р. · с. 446 > “Suddenly messaging people weird links probably stolen” > > Suspected Hijacker · Серпень 2025 р. · с. 448 > “Friend warned me to report this one” > > Suspected Hijacker · Серпень 2025 р. · с. 446 > “Everyone in voice chat agrees it's a stolen account” > > Suspected Hijacker · Серпень 2025 р. · с. 446 #### Цей самий файл суперечить їхнім твердженням Деякі з п’ятдесяти висувають твердження, які Anlage 1 може перевірити самостійно. У цьому файлі зберігаються дані про входи в обліковий запис та історія заходів безпеки. Обидві ці частини містяться в ньому; історія заходів безпеки знаходиться під чорним прямокутником. Залишити для читання · Suspected Hijacker · Серпень 2025 р. · с. 446 > “My friend can't log in, says someone changed the password” Історія безпеки · с. 830 · під чорним прямокутником**Остання зміна пароля: липень 2024 року** Це зробив не власник, як видно з цього ж файлу. У 2025 році пароль не змінювався. «Left» (доступно для читання) · серпень 2025 р. · с. 446, 448 > “This account just started acting shady overnight” > “Suddenly messaging people weird links probably stolen” Історія входів · стор. 1–119**Останній вхід: 23 травня 2025 року** Історія входів закінчується у травні 2025 року. У червні, липні, серпні та вересні не зафіксовано жодного входу. Акаунт був заблокований з 7 травня 2025 року; 9 травня служба підтримки Steam визнала цю блокування постійним. «Left» (доступно для читання) · серпень 2025 р. · с. 445, 448 > “Real person probably got locked out” > “My friend said they can't get into this account anymore” Історія безпеки · с. 830**У 2025 році змін у сфері безпеки не відбудеться** Останньою зміною, зафіксованою в історії безпеки, є зміна пароля, що відбулася в липні 2024 року. **Рецензія PhishDestroy.** Нецензурне слово на сторінці 444 потребувало перекладу. Ці скарги викладені англійською мовою, а відповідь на них міститься в тому ж файлі. Після місяця ручної перевірки текст став читабельним, а рядок, що суперечить скаргам, було виділено прямокутником. #### Як читали п’ятдесят Формат документа не є доказом того, хто саме написав скаргу. Саме на це суд зверне увагу, перш ніж прийняти скаргу до розгляду. | Перевірити | Залишилося для читання · 50 | Приховано · 1 944 | | --- | --- | --- | | Період | серпень–вересень 2025 року | лютий 2021 р. – липень 2025 р. | | “Suspected Hijacker” категорія | **86 % 43** із 50 | **13,**8 % (269 із 1 944) | | Опис містить кирилицю | **4 % 2** з 50 | **55,4 % 1** 077 із 1 944 | | Логін репортера: латинські літери + 3–5 цифр | **62 % 31** із 50 | **21,**6 % (420 із 1 944) | Кирилиця: принаймні один символ з цієї абетки. Формат логіна: латинські літери, за якими йдуть 3–5 цифр, і нічого більше. Усі 1 995 логінів репортерів, включаючи ті, що знаходяться поруч із 50 видимими текстами, охоплені та залишаються доступними для вилучення. Жоден логін репортера тут не наводиться. Чотири розбірливі тексти повторюються слово в слово у дев’яти записах; “Acting way off pretty sure someone else is using it” згадується тричі (с. 446, 447). Д-р Шелінський · 15 серпня 2025 р. · с. 2 > „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ «Незалежно від деталей скарг, сама їх кількість свідчить про те, що…» **Чи справді цей зміст не має значення для суду?** Д-р Цурхайде · 1 жовтня 2025 р. · с. 9 > „Aus unserer Erfahrung wird jedes Gericht die Sperrung … als rechtmäßig qualifizieren.“ «З нашого досвіду, будь-який суд визнає це обмеження… законним». **Чи охоплював його досвід усі суди? І чи погодилися б усі суди з таким способом обробки даних?** Ці два запитання поставив PhishDestroy. Ми не висловлюємо думки щодо того, яке рішення має ухвалити суд стосовно блокування. Ми стверджуємо, що суд повинен мати можливість ознайомитися з тим, що йому доручено врахувати. ### Що приховують від погляду чорні прямокутники У цих двох листах одна й та сама скарга розглядається з двох різних точок зору. Доктор Шелінський врахував усі ці скарги на користь заявника, „1.938 Mal“, незалежно від їхніх деталей (15 серпня 2025 р., с. 2). Потім д-р Цурхайде встановив межу на 30 липня 2025 року: лише з цієї дати „können wir … davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen“ (1 жовтня 2025 р., с. 2). Чорні прямокутники відповідають цій лінії: усі тексти скарг до 23 липня 2025 року, включаючи останню скаргу перед цією датою, приховані; усі скарги, починаючи з серпня, можна прочитати. **Рецензія від PhishDestroy.** До 30 липня 2025 року кількість скарг враховується на користь заявника як число і не розкривається йому як інформація, що не належить йому. У самому жовтневому листі наводяться такі аргументи: „zwischen 2019 und 2023“ (с. 7). Додаток 1 · сторінка 444 · перший читабельний рядок Offensive AvatarВересень 2025 року`p***r` Гомофобне образливе слово, яке тут замасковано. Це перший запис, який заявник зміг прочитати після місяця ручної перевірки. #### Що ховається під прямокутниками 1 148 скарг, що становить понад половину загальної кількості, подано як “Offensive Profile”. Жоден з них не залишився читабельним: у 1 147 текстове поле закрито, а в одного тексту немає взагалі. Якщо читати під прямокутниками, не входячи в систему, закриті описи знову й знову повертаються до одних і тих самих тем: | Тема | Охоплено | Зрозумілий | | --- | --- | --- | | Нацист, нацизм | **110** | 0 | | Ненависть, мова ненависті | **108** | 0 | | Расизм | **99** | 0 | | Україна, українці | **90** | 0 | | Русофобія | **84** | 0 | | Образа нації або росіян | **65** | 0 | | Пропаганда | **64** | 0 | | Етнічна образа на адресу українців | **50** | 0 | | Політика | **46** | 0 | 615 із 1 944 розглянутих описів торкаються принаймні однієї з цих тем; жоден із п’ятдесяти, придатних для читання, цього не робить. Довгі тексти також повторюються: 18 текстів, що містять вісім і більше слів, з’являються слово в слово у 48 рядках. Два з них — по чотири рази кожен: > “I made this account to report this user because he has stolen my account” > > Закриті · 4 ряди > “I created this account in order to expose this user because he robbed my account.” > > Закриті · 4 ряди Одним із п’ятдесяти текстів, що можна прочитати (с. 448), є вставлена сторінка профілю Steam, на якій згадано імена інших користувачів. Вона тут не наводиться. Прямокутники прикривали логіни всіх репортерів, але залишали цю сторінку читабельною. ### Заяви та надані документи Кожне з наведених нижче тверджень взято з підписаних листів. Кожен запис міститься в переданих ними документах. Д-р Шелінський · с. 2 ### «Сотні» щороку „In jedem Jahr, bis ins Jahr 2025 hinein, gab es demnach hunderte Beschwerden.“ **2021: 25 · 2022: 122** Річні показники наведені в наданій таблиці скарг. Повні щомісячні показники наведені в розділі [Перевірте самі](https://phishdestroy.io/tgwitness/uk/docs/signed-export/#verify). Д-р Цурхайде · с. 1 ### Цілий місяць, вимитий вручну „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ **36 секунд** Додаток 1 було створено о 19:58:05, а останнє оновлення відбулося о 19:58:41; він налічує 830 сторінок. Перша читабельна скарга, що міститься в ньому, стосується гомофобного образи. Д-р Шелінський · с. 3 ### Захист прав третіх осіб „soweit keine Rechte Dritter entgegenstehen“ **Залишилося 905 672 символів** Текст все ще можна розпізнати під 1 044 чорними прямокутниками, які його перекривають. Ці прямокутники також приховують історію заходів безпеки самого облікового запису (с. 830). Д-р Цурхайде · с. 7 ### «У період з 2019 по 2023 рік» „Über einen Zeitraum von mehreren Jahren, zwischen 2019 und 2023 …“ **Створено в серпні 2020 року** У додатку 1, на сторінці 1, вказано дату створення облікового запису: серпень 2020 року. Д-р Цурхайде · с. 9 ### Будь-який суд погодиться з цим „jedes Gericht … als rechtmäßig qualifizieren“ **Прогноз** У цьому реченні йдеться про те, що будь-який суд визнає блокування облікового запису Steam законним. У ньому не вказано жодного суду та не наведено жодного судового рішення. ### Що можна і чого не можна дізнатися з підпису Кваліфікований електронний підпис є переконливим доказом щодо особи відправника. Він не є доказом щодо змісту. Ці два питання слід перевіряти окремо. ### Підпис може свідчити про - хто підписав цей документ - що підписані байти не змінилися з моменту підписання ### Підпис не відображається - що експорт завершено - що під час редагування щось було вилучено - що викладені в ньому твердження є правдивими - щоб кожен прочитав його перед підписанням ТРИ ЧЕКИ · № ДОКУМЕНТА 42603633 · ДОДАТОК 1Офлайн 01 · ВІДПРАВНИК**Кваліфікований електронний підпис**`„qualifiziert elektronisch signiert“`Про це компанія повідомила на сторінці 9. 02 · ЧЕСНІСТЬ**SHA-256 з Додатку 1**`2bb927e2…4ff7d6af`Збігається із записаним хешем. 03 · ЗМІСТ**Текстовий шар Додатка 1**`pdftotext Anlage1.pdf -`905 672 символи, які можна прочитати в межах 1 044 прямокутників. Відправник: вказано. Цілісність: збігається. Вміст: порушено. Підпис дав відповідь лише на перше питання, а на решту — ні. Для перевірок 02 та 03 потрібні лише файл і стандартні інструменти. Перевірка 01 показує, хто надіслав файл. Лише перевірки 02 та 03 показують, що саме було надіслано. № документа 42603633 · сторінка 1Одна сторінка, два варіанти написання `Dr. Patrick Zurheide, LL.M. (Aberdeen)`Підписант `p.zurheode@*****wessing.com`Бланк з логотипом `p.zurheide@*****wessing.com`Публічний реєстр Назва написана правильно. А ось ім’я підписувача у бланку листа — ні. На сторінці 6 міститься „Die Antwortet lautet ja, in den dort genannten Grenzen.“ двічі, слово в слово, наприкінці розділів 1.5 та 1.6. На сторінці 3 дані надсилаються за допомогою „Anbei übersenden wie Ihnen …“. ### Запит, на який мав дати відповідь цей експорт За кожним підписом стоїть один запит на отримання власних даних. Закон, що регулює це питання, є коротким. РЕГЛАМЕНТ (ЄС) 2016/679 · ОФІЦІЙНИЙ ТЕКСТ Стаття 15, пункт 1 «Суб’єкт даних має право отримати від контролера підтвердження того, чи обробляються персональні дані, що стосуються його або її, а в разі підтвердження — отримати доступ до цих персональних даних…» Стаття 15, пункт 3 «Контролер повинен надати копію персональних даних, що обробляються». Стаття 12, пункт 3 «… без зайвої затримки і в будь-якому разі протягом одного місяця з моменту отримання запиту. У разі необхідності цей строк може бути продовжено ще на два місяці …» Джерело: [EUR-Lex](https://eur-lex.europa.eu/eli/reg/2016/679/oj) Автори листів знають про це правило. Лист доктора Цурхайде починається саме з цього: „nachfolgend erteilen wir Namens und in Vollmacht unserer Mandantin Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ (с. 1). За винятком одного згадування про права третіх осіб (д-р Шелінський, с. 3), у жодному з листів не наводиться положення, яке дозволяло б контролеру обмежувати доступ: ані ст. 12(5), ані ст. 23, ані німецький закон про захист даних (BDSG). Натомість у відповіді на запит було зазначено: 1. 15 серпня 2025 р. · д-р Шелінський · с. 1**Кінцевий термін, «якщо взагалі буде»** „Die Frist nach Art. 15 DSGVO hat, wenn überhaupt, erst … am 29. Juli 2025 begonnen“ 2. 15 серпня 2025 р. · д-р Шелінський · с. 2**Обліковий запис було закрито** „Hiermit kündigen wir daher Namens und in Vollmacht der Valve Corporation … mit sofortiger Wirkung.“ 3. 15 серпня 2025 р. · д-р Шелінський · с. 2**Доказ методом підрахунку: 1 938 скарг, незалежно від їхніх подробиць** „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ 4. 1 жовтня 2025 р. · д-р Цурхайде · с. 2**Дані обмежені періодом до 30 липня 2025 року** „… können wir erst ab diesem Zeitpunkt davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen.“ 5. 1 жовтня 2025 р. · д-р Цурхайде · с. 8**Решта — за умови, що** „Gerne beauskunften wir die restlichen (bzw. noch weitere) personenbezogene Daten, sobald Ihr Mandant uns nachvollziehbar darstellen kann …“ 6. 1 жовтня 2025 р. · д-р Цурхайде · с. 8**«Співучасники»** „… dass Ihr Mandant bzw. dessen Komplizen seine Phishing-Angriffe … in verschleierter Form fortsetzen will“ 7. 1 жовтня 2025 р. · д-р Цурхайде · с. 9**Чотири статті Кримінального кодексу** „… §§ 263, 263a, 202a, 303a StGB) einer strafrechtlichen Verfolgung zuzuführen.“ **Нічого з цього не передбачено у ст. 15.** Право на доступ не скасовується ні припиненням дії, ні прогнозами щодо судових рішень, ні кримінальним законодавством. Через 106 днів після подання запиту все залишалося саме так, як було зазначено. **Тлумачення PhishDestroy.** Лікарі посилаються на закон на сторінці 1, а потім пишуть так, ніби такого закону й не існує. ### У листі перелічено, які дані обробляє компанія Valve. У файлі ж більша частина цієї інформації не наведена. На сторінках 2–6 у жовтневому листі наводяться цитати з Політики конфіденційності Steam для опису персональних даних, які обробляє компанія Valve. Кожна зазначена категорія порівнюється нижче з Додатком 1. Додаток 1 складається з дванадцяти розділів: обліковий запис, профіль, історія імен, логіни, ключі продуктів, час гри, телефон, скарги, чат, пристрої Steam Guard, друзі та зміни в налаштуваннях безпеки. | Дані | Згадані в листі | У додатку 1 | | --- | --- | --- | | Транзакції та платежі | „Transaktions- und Zahlungsdaten“ · p. 2 „… Transaktionsdaten … für einen Zeitraum von bis zu zehn (10) Jahren aufbewahren muss“ · p. 6 | **Відсутній** | | Ремесла та місцевий ринок | „… Konsistenz des Gameplays oder Steam-Community-Marktes …“ · p. 6 | **Відсутній** | | Досягнення, прогрес у грі, ігрові предмети | „Ihre erspielten Errungenschaften … Ihren Spielfortschritt … Ihre im Spiel erhaltenen Gegenstände“ · p. 4 | **Відсутній** | | Право власності на гру | „… mindestens Ihr Eigentum am fraglichen Spiel“ · p. 4 | **Відсутні** · час гри та 100 натискань клавіш лише за один день | | Рівні, значки, колекційні картки | „Daten über die Nutzung des Steam-Clients und der Steam-Websites“ · p. 3 · items and market · pp. 4, 6 | **Відсутній** | | Публікації, коментарі, підписки | „… veröffentlichen, kommentieren oder denen Benutzer folgen“ · p. 3 „Message Boards, Foren und/oder Chatbereiche“ · p. 5 | **Відсутній** | | Чат | „Informationen, die Benutzer im Chat gesendet haben“ · p. 3 | 2 записи, висвітлені | | Запити до служби підтримки | „… wenn Benutzer Informationen oder Support von Valve anfordern“ · p. 3 | **Відсутні** · включаючи квиток за травень 2025 року, який підтвердив блокування | | Прив’язані облікові записи сторонніх сервісів | „… mit dem Konto eines Drittanbieters zu verknüpfen“ · p. 5 | **Відсутній** | | Записи за блоком | „Zum Entdecken von Verstößen erforderliche Informationen“ · p. 3 „… nach einer manuellen Prüfung durch einen Mitarbeiter der Valve Corporation“ · p. 7 | **Відсутній** · немає записів про перевірку, немає прив’язки пристрою, немає повідомлень про фішинг | **У листі наводяться дані. У вкладенні їх немає.** Платежі є основою висновків обох юристів щодо права власності, проте саме категорія платежів не вказана у файлі. #### Яка інформація міститься у файлі та за який період Періоди визначаються на основі дат у файлі, включаючи дати, позначені чорними прямокутниками. | Розділ | У додатку 1 | Період у файлі | | --- | --- | --- | | Основні дані облікового запису · електронна пошта, країна, ім’я користувача, Steam ID | Зрозумілий | Поточний стан | | Логіни | Дата та тип читаються; час, IP-адреса та ідентифікатор обладнання замазані | Жовтень 2023 р. – травень 2025 р. · обліковий запис існує з серпня 2020 р. | | Ігри | Ігри можна прочитати; дата та час останнього використання приховані | Грудень 2020 р. – травень 2025 р. | | Чат | 2 записи, висвітлені | Тільки вересень 2025 року | | Скарги щодо цього облікового запису | 1 995 рядків · 50 доступних для перегляду описів | лютий 2021 р. – вересень 2025 р. | | Друзі та блоки | 5 789 рядків · охоплено | лютий 2021 р. – вересень 2025 р. | | Пристрої Steam Guard · зареєстрований телефон · зміни в системі безпеки | Охоплено | Журнал безпеки: серпень 2020 р. – липень 2024 р. · 4 рядки | | Активація за допомогою ключа продукту | Охоплені клавіші | 100 рядків, одна дата: 13 березня 2025 року | **Схоже, що лише скарги наведені повністю.** Майже нічого іншого немає: логіни починаються з жовтня 2023 року, друзі — з лютого 2021 року, ключі продуктів — в один день, а цілі категорії, які є в магазинах Valve, відсутні. Категорії, від яких залежать власні рішення листа, — платежі та записи, що лежать в основі блоку, — у файлі взагалі відсутні. Список друзів містить 5 789 записів: 4 410 — «Заблоковані користувачі», 1 182 — «Друзі» та 200 — «Ті, хто надіслав запрошення», датовані періодом з 24 лютого 2021 року по 28 вересня 2025 року; 74 записи датовані після останнього входу в систему. На підставі цього файлу неможливо визначити, чи це поточний список зв’язків, чи повна історія, що включає видалені записи. Відповідь на питання щодо ст. 15(1) викликає ще три запитання. Інформація про одержувачів (пункт c) та джерело даних (пункт g) наведена лише у вигляді загального тексту страхового поліса, а не стосовно цього рахунку. Термін зберігання (пункт d) є цитатою з поліса без конкретних деталей. А в листі дані надсилаються „als Anlage 1 und 2“ (с. 3); тут розглядається лише Додаток 1. ### Компанія Valve вже перевірила, кому належить цей обліковий запис Цей обліковий запис було зареєстровано як обліковий запис партнера Steamworks з метою випуску гри. Цей процес передбачає сплату комісії Steam Direct у розмірі 100 доларів США, проходження податкової перевірки, надання банківських реквізитів для виплат та перевірку особи, яку проводить сама компанія Valve. Усе це є персональними даними, які обробляє Valve. Стаття 15 Загального регламенту про захист даних (GDPR) охоплює всі категорії оброблюваних персональних даних, а не лише ті, що перелічені в політиці конфіденційності. Жодна з них не зазначена в Додатку 1. Д-р Шелінський · с. 1 ### «Жодного доказу права власності» „… kein einziger Beleg für die Inhaberschaft (Verfügungsbefugnis) Ihres Mandanten für den Account …“ **Особа підтверджена компанією Valve** Перевірка партнера, відповідні документи та платіж у розмірі 100 доларів США знаходяться у клієнта, про якого йдеться в листі. Д-р Шелінський · с. 3 ### Від заявника вимагається надати підтвердження „… gefälschten ‚Utility Bill‘ …“ · „… tatsächlich alleiniger Inhaber des Accounts …“ **Докази не надано заявнику** Заявника просять підтвердити право власності, тоді як дані про право власності, перевірені самою компанією Valve, не включені до його копії, що надається для ознайомлення. ## Модель: ніхто не приймає рішення самостійно, нічого не можна обміняти Справа не в одній програмі. Справа в тому, хто приймає рішення. У цьому випадку двоє юристів вирішили, які саме п’ятдесят скарг мають значення, а решта — ні. Ніякого суду, ніякого регулятора. Деякі речі мають залишатися прихованими: логіни журналістів — це дані інших людей. Питання полягає в тому, хто приймає рішення і чи може хтось згодом перевірити це рішення. Чорний прямокутник не дає відповіді ні на одне, ні на інше, і його може видалити будь-хто. Два стандартні інструменти дають відповідь на обидва питання: хеш із солею в копії запитувача та оригінал, запечатаний за допомогою відкритого ключа наглядового органу або суду. СОЛОВАНЕ ЗОБОВ’ЯЗАННЯ · ОДНЕ НА КОЖНЕ ВИЛУЧЕНЕ ПОЛЕ c = SHA-256(salt ‖ value) Сол — це 16 випадкових байтів, які генеруються заново для кожного поля. У копії запитувача міститься `c` замість значення, під підписом компанії. Значення та його соль надсилаються у конверті, зашифрованому за допомогою відкритого ключа сертифікаційного центру за допомогою OpenPGP або X25519 та AES-GCM. Без приватного ключа сертифікаційного центру ніхто не може його відкрити, а компанія не може замінити значення, не порушивши підписаного нею зобов’язання. 1. Крок 1 · заявник**Передає копію та конверт** Підписаний примірник із зазначеними зобов’язаннями та опечатаний конверт надсилаються до наглядового органу або до суду. 2. Крок 2 · орган влади**Відкриває конверт і перераховує** Інспектор розшифровує дані за допомогою приватного ключа органу та перераховує SHA-256(соль ‖ значення) для кожного поля. Кожен результат повинен збігатися з зобов’язанням, яке підписала компанія. 3. Крок 3 · незалежний орган**Визначає, що насправді було захищено** Саме компетентний орган, а не компанія, ознайомлюється з усім, що було приховано — в даному випадку 1 944 тексти скарг та історію заходів безпеки — і вирішує, чи вимагали права третіх осіб приховування цієї інформації. ДОДАТОК 1 · СТОРІНКА 514 · ОДИН РЯДОК, ДВА СПОСОБИ ЙОГО ПРИХОВАТИУ режимі реального часу · у вашому браузері У комплекті · чорні прямокутникиТільки візуальне накладення Aspose.PDF for .NET 20.8 · page 514Текстовий шар + прямокутники Репортер: [логін · тут не публікується] Дата: 2024-03-28 Тип: Offensive Profile Текст: русофоб Зверху намальовані чорні прямокутники. Текст, що знаходиться під ними, залишається у файлі. Копія для заявника · зобов’язання з «солею»Підписано фірмою c = SHA-256(salt ‖ value)Завірено від імені органу влади Репортер: [не розголошується · зобов’язання] Дата: 2024-03-28 Тип: Offensive Profile Текст: [withheld · commitment] Конверт · RSA-OAEP-256 + AES-256-GCMдля відкритого ключа органу влади У копії містяться зобов’язання. Значення та солі знаходяться в конверті. 1. **1.** Заявник передає копію та конверт 2. **2.** Орган влади відкриває його та перераховує кожне зобов’язання 3. **3.** Орган влади вирішує, що саме не підлягає оприлюдненню Обидві панелі приховують ті самі два поля. Зчитайте вихідні байти, а потім виконайте перевірку, передбачену уповноваженим органом. Ліворуч: один рядок з Додатку 1 у тому вигляді, в якому він був наданий; текст скарги розміщений під чорним прямокутником на сторінці 514 і наведено без логіна репортера, у полі якого міститься заповнювач. Праворуч: той самий рядок із зашифрованими зобов’язаннями, значення яких зашифровано за допомогою ключа уповноваженого органу. Пара ключів генерується у вашому браузері для цієї демонстрації, а конверт — це той самий, який TgWitness використовує для зашифрованої доставки. Рішення на кроці 3 наведено як приклад. **Ніхто не приймає рішення самостійно**Компанія як і раніше пропонує, яку інформацію слід приховати. Це перевіряє особа, яка має повне уявлення про ситуацію та не зацікавлена у спорі. **Нічого не протікає**Запитувач не бачить даних інших осіб. «Солт» робить зобов’язання непридатним для підбору: без нього скаргу, що складається з одного слова, можна було б знайти шляхом хешування списку слів. **Нічого не можна обміняти**Кожне значення має відповідати зобов’язанням, які компанія взяла на себе. Якщо текст відрізняється або відсутній, перевірка не пройде. **Підпис має певне значення**Кваліфікований підпис під зобов’язаннями зобов’язує компанію дотримуватися всіх прихованих умов, а не лише того, що зазначено у супровідному листі. **Назви не мають значення**Перевірка має арифметичний характер. Для неї потрібні копія, конверт і ключ уповноваженого органу, а не чиїсь слова. Для цього не потрібна жодна нова інфраструктура. Німецькі наглядові органи вже оприлюднюють ключі OpenPGP: Федеральний уповноважений з питань захисту даних [вказує по одному для кожної одиниці](https://www.bfdi.bund.de/DE/Service/Kontakt/Schluessel/Schluessel-node.html), а також LfDI Баден-Вюртемберга [пропонує свій відкритий ключ для шифрування електронної пошти](https://www.baden-wuerttemberg.datenschutz.de/kontaktdaten-des-verantwortlichen/). Німецькі суди вже отримують позовні заяви через систему EGVP, яка [Шифрування «від кінця до кінця» базується на протоколі OSCI](https://egvp.justiz.de/behoerdenpostfach/Informationsmaterial_fuer_Behoerden_zu_BeBPo_und_eEB_V1_3_2.pdf). **Позиція PhishDestroy.** Хто надав адвокатам право вирішувати, що є важливим, а що ні? Адвокати не повинні приймати таке рішення. Усе має бути передано: не у вигляді чорних прямокутників, які будь-хто може видалити, а в запечатаному вигляді, доступ до якого має лише суд або регуляторний орган, щоб не залишалося місця для «помилок», «непорозумінь» або демонстрації лише того, що зручно. ## «Чесна» модель: повний набір даних, оголошене правило, ключ із відповідними повноваженнями Заявник одразу отримує все, що не є предметом суперечки. Те, що не надається, не відображається на кресленні й не приховується мовчанням. Воно надсилається у повному обсязі, підписане та зашифроване ключем органу, який має право приймати рішення щодо цього. | Питання | Що сталося | Модель «Чесність» | | --- | --- | --- | | Хто вирішує, що не виплачувати | Адвокат сторони у спорі | Правило, яке оголошується та підписується під час створення копії; його перевіряє уповноважений орган | | Що отримує заявник | Вибрані рядки; відсутні цілі категорії; межа, за якою немає жодного запису | Кожен запис, щодо якого немає суперечок, негайно | | Дані третіх осіб | Вкритий малюнками і досі зберігається у справі | Вилучено з примірника заявника; збережено в оригіналі для органу влади | | Відкладені деталі | Невідома кількість, невідомий зміст | Вказано у підписаному маніфесті; повний оригінал зашифровано ключем уповноваженого органу | | Доказ того, як було обрано копію | Існує лише тому, що редагування не вдалося | Вбудовано: правило, кількість, хеш оригіналу | | Спірні питання | Висновок, зроблений на підставі листа: «будь-який суд погодиться» | Це вирішує регуляторний орган або суд, які мають право їх відкривати | | Час | 106 днів | Експорт та доставка | | Роль адвоката | Визначає сферу застосування, тягар доказування та вирок | Веде судовий спір; не редагує дані заявника | Орган також не потребує довіри. Стаття 58(1)(e) GDPR уже надає наглядовому органу повноваження отримувати доступ до всіх персональних даних, які обробляє контролер. Модель лише передає їх у формі, яку можна перевірити одразу після отримання. **Причини, наведені в листах — сумніви щодо права власності, платежі від третіх осіб, скарги, підозри у фішингу — пояснюють, чому стаття 15 не була виконана. Вони не відповідають її вимогам.** Незалежно від підстав, результат один і той самий: заявник не отримав своїх даних, за малюнками були надані дані інших осіб, а правильність відбору можна було перевірити лише випадково. Доступ до даних є правом суб’єкта даних, а не предметом торгу в чужому спорі. ## Як TgWitness зберігає оригінали та забезпечує можливість перевірки копій TgWitness експортує переписки як докази. Його концепція ґрунтується на уроках, винесених із цієї справи: експортні дані не повинні викликати довіру лише через те, хто їх надає. Оригінальний зафіксований журнал зберігається. У копії для обміну в підписаному маніфесті фіксуються вибрані записи та поля, правила розкриття інформації та кількість виключених записів. Принцип «нульової довіри» поширюється на всіх, включаючи нас. Зберегти ### Збережіть оригінал Зберігайте повний запис журналу та відповідні підписи. Окремо ведіть контрольний запис, щоб у майбутньому можна було перевірити, чи не відбулася заміна або скорочення запису. Захист ### Зашифрувати доставку Зашифруйте архів за допомогою ключа одержувача або захистіть передачу паролем. Для розшифрування потрібен відповідний ключ або пароль. Розкрити інформацію ### Вкажіть пропуски Вкажіть мету та правила у підписаному маніфесті. Позначте мінімізовані записи, підрахуйте виключені записи та збережіть посилання на вихідний журнал. TgWitness вже запечатує повні оригінали для ключа одержувача, використовуючи конверт, показаний у наведеному вище прикладі, та позначає, яка інформація не розкривається. Верифікатор перевіряє підписи записів та посилання копії для спільного доступу на вихідний журнал; для перевірки прихованого вмісту за його оригінальним хешем необхідний збережений повний оригінал. У цьому випадку обґрунтовується необхідність використання зобов’язань із солюванням для кожного поля для авторитетного органу. | У додатку 1 | Стаття TgWitness | Зареєстрований чек | | --- | --- | --- | | Текст під чорними прямокутниками | Поля, доступ до яких обмежено, видалено з копії для спільного доступу; оригінал зберігається окремо | Вказані пропуски та хеш вихідного запису | | Видно 50 описів; загалом 1 944 | Підписані правила щодо розкриття інформації та кількість виключених записів | Визначена сфера дослідження та посилання на журнал, з якого взято джерело | | Вкладення у форматі PDF | Зашифрована передача захопленого архіву | Розшифрування з автентифікацією; підписи та хеші архівів | | Файл, ідентифікований за наведеним нижче SHA-256 | Хеші записів, підписи та збережені контрольні точки | Порівняння з раніше збереженим щоденником | ### Що має гарантувати це програмне забезпечення **Цілісність даних**Кожен запис перетворюється на хеш у ланцюжку та підписується за допомогою алгоритму Ed25519. Перевіряючий перераховує кожен запис, тому будь-яка зміна стає помітною. **Доставку можна перевірити**Архіви надсилаються у зашифрованому вигляді для їхнього одержувача; великі архіви надсилаються у вигляді зашифрованих частин із підписаним маніфестом, які збираються та перевіряються локально. **Дані інших людей залишаються недоступними**Копія спільного доступу за замовчуванням приховує дані та вказує, що саме було приховано. Розкриття прихованого значення на панелі підлягає аудиту. **Немає права на помилку**Перевірки носять арифметичний характер: файл, відбиток надійного ключа та збережена контрольна точка. Нічиїх слів не потрібно. **Тут немає місця для маніпуляцій**Зміни та видалення перетворюються на нові записи, скорочений журнал не відповідає збереженому контрольному пункту, а розкриття інформації ніколи не виглядає повним, якщо воно таким не є. Орфографічна помилка в імені не змінює дані, підписані програмним забезпеченням. Навіть якщо термін минув місяць тому, це не змінює вихідні записи. Будь-яка зміна порушує ланцюжок, і верифікатор про це повідомляє. Спробуйте обидва варіанти, наведені нижче. SHA-256 · У ВАШОМУ БРАУЗЕРІВідредагуйте будь-який із рядків З підписом · на фірмовому бланку`86582990a7b364adbd83071c9edb4774ed6e8ea50b80dca1ae426c3fa679a1d6` Публічний реєстр`17fae25500c51998112b146c76b21b04bf3d4034407f2f958bced7d6d6e928ba` **1** символ різниці**60** із 64 шістнадцяткових цифр відрізняються**128** із 256 бітів відрізняються Один символ різниці. Два відбитки пальців, що не пов’язані між собою. Хеш помітив ту саму літеру, яку пропустив процес підписання. Заголовок — це лише додаткові байти: він змінює «відбиток», але ніколи не змінює факти. ПІДПИСАНИЙ ЩОДЕННИК · СПРОЩЕНИЙІлюстративні записи ЗАПИС 1**17.06.2025 · access request**`adc396074b0f04…`= збережений хеш ЗАПИС 2**01.10.2025 · letterhead p.zurheode**`0b8eda5c2f43ae…`= збережений хеш ЗАПИС 3**01.10.2025 · Anlage 1 · 830 pages**`dbe2eef85bfb5a…`= збережений хеш Кожен запис містить «відбиток» попереднього запису. Зміна запису № 2 призводить до зміни його хешу та розриву зв’язку із записом № 3. Спрощено: кожен відбиток перекриває попередній відбиток та один рядок тексту. TgWitness обчислює хеш-суми дев’яти канонічних полів події, одним із яких є попередній хеш, і підписує кожен дайджест за допомогою алгоритму Ed25519. [Переглянути повний ланцюжок із контрольними точками](https://phishdestroy.io/tgwitness/uk/docs/concepts/) [Як працює обмін копіями в TgWitness](https://phishdestroy.io/tgwitness/uk/docs/handover/) · [Запечатаний конверт](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md#cryptographic-handoff) · [Сфера застосування та перевірки](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/) ## Перевірте це самі Будь-який регулятор, суд або аудитор, що має доступ до цих файлів, може повторити кожну перевірку, описану на цій сторінці, в автономному режимі. Публікуються лише зведені результати: логіни репортерів, ідентифікатори облікових записів та дані профілів тут не оприлюднюються. **Усі місяці: 2021–2025 роки** | Рік | Січень | лютий | Березень | квітень | травень | Червень | Липень | Серпень | Вересень | Жовтень | Листопад | Грудень | Разом | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 2021 | 0 | 2 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 0 | 1 | 20 | **25** | | 2022 | 10 | 7 | 43 | 9 | 2 | 7 | 2 | 11 | 7 | 6 | 5 | 13 | **122** | | 2023 | 111 | 48 | 156 | 59 | 52 | 53 | 66 | 52 | 73 | 44 | 53 | 58 | **825** | | 2024 | 69 | 58 | 111 | 36 | 33 | 46 | 83 | 53 | 54 | 70 | 79 | 82 | **774** | | 2025 | 92 | 32 | 35 | 20 | 12 | 1 | 7 | 47 | 3 | — | — | — | **249** | 0 означає, що в цьому експорті немає записів за цей місяць; — означає, що дата перевищує граничну дату вересня 2025 року. Загалом: **1 995**. **Усі категорії звітів у наведеній таблиці** | Тип записаного звіту | Усі записи | Зрозумілі описи | Описання, що охоплюються | | --- | --- | --- | --- | | Offensive Profile | 1,148 | 0 | 1,147 | | Suspected Hijacker | 312 | 43 | 269 | | Обман | 290 | 2 | 288 | | Offensive Persona Name | 87 | 1 | 86 | | Offensive Avatar | 57 | 3 | 54 | | Домагання | 46 | 1 | 45 | | Спам | 37 | 0 | 37 | | Спуфінг | 16 | 0 | 16 | | Автоматична модерація | 1 | 0 | 1 | | Шахрайство у сфері торгівлі | 1 | 0 | 1 | Цей Offensive Profile У загальну кількість входить один порожній опис. Загалом: 1 995 записів, 50 читабельних описів, 1 944 описів, що містять інформацію, 1 порожній опис. **Історія входів та безпеки** Додаток 1, сторінка 1: `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)` та `Date of Report: 09-29-2025`. В історії входів на сторінках 1–119 найсвіжіші записи розміщені першими; найновіші записи датуються травнем 2025 року, і пізніших записів немає. Сторінка 830, «Історія безпеки», прихована чорними прямокутниками. Остання зміна пароля відбулася в липні 2024 року; у 2025 році змін не зафіксовано. Дати, адреси та ідентифікатори з цих рядків не наводяться. ``` pdftotext -f 1 -l 1 Anlage1.pdf - # last logon, date of report pdftotext -f 830 -l 830 Anlage1.pdf - # security history ``` **Метадані PDF та декларації підписів** Метадані PDF: автор `Aspose.PDF for .NET 20.8`; створено 1 жовтня 2025 року о 19:58:05; змінено о 19:58:41, обидва за часом UTC+02:00. Ці два часові мітки — це **з інтервалом у 36 секунд**. На останній сторінці обох листів міститься застереження щодо електронного підпису: „Dieses Schreiben ist qualifiziert elektronisch signiert“. Перевірка підпису — це окрема процедура, відмінна від наведених тут перевірок змісту та редагування. **Відтворіть підрахунки та порівняйте хеші джерел** Скрипт підрахунку прикріплено до хешу «Anlage 1», наведеного нижче. Він відтворює рядки таблиці на сторінках 444–620 та об’єднує 118 комірок, які простягаються через межі сторінок. Видимість визначається перетином текстових полів із непрозорими чорними прямокутниками; єдиний порожній опис фіксується окремо. Для підрахунку символів кирилиці використовуються коди U+0400–U+052F. Для порівняння формату логіна використовується шаблон повного рядка `[A-Za-z]+[0-9]{3,5}`. Повтори підраховуються після нормалізації пробілів, видалених під час вилучення даних. Кількість слів у розглянутих описах у будь-якому разі відповідає кореням слів. Це описові показники, а не автоматичне виявлення спільного авторства чи наукової недобросовісності. Опціональні оцінки мови у файлі JSON базуються на локальній версії Lingua 2.2.0; короткі та неоднозначні тексти залишаються без класифікації. Під час перевірки 905 672 символів підраховуються всі символи, крім пробілів, обмежувальна рамка яких хоча б один раз перетинається з чорним прямокутником; 1 044 із 1 329 чорних прямокутників перекриваються з таким текстом. [Загальна кількість · JSON](https://phishdestroy.io/tgwitness/assets/signed-export-statistics.json?v=b84f21c8824d) · [Скрипт для підрахунку місцевих даних · Python](https://phishdestroy.github.io/TgWitness/assets/signed-export-audit.py) ``` python signed-export-audit.py Anlage1.pdf --output counts.json sha256sum Anlage1.pdf pdfinfo Anlage1.pdf | grep -E "Producer|CreationDate|ModDate" pdftotext -layout Anlage1.pdf - | less ``` Для роботи скрипта потрібні бібліотеки PyMuPDF та lingua-language-detector. Він не надсилає мережевих запитів і видає узагальнені дані, а не тексти скарг чи дані для входу. | Файл | SHA-256 | | --- | --- | | № документа 42603633 (д-р Цурхайде) | `de0fdcf6bfaccedc98d1670438bc7ca3330479096875e716dbb9678922b43ab9` | | № документа 42282474 (д-р Шелінський) | `b48e09c28ee40a46f1d404041751f718fb185d1eb774ddabb4373fdd53bbe2f1` | | Додаток 1 | `2bb927e2c42fdc2e3ad089ae302dd887c343f6798aba00fcfac279224ff7d6af` | **Урок для будь-якого експортного документа.** Юристи можуть підписувати експортні документи. Підпис вказує на те, хто його надіслав, а не на те, чи відповідає він дійсності. Істина — це те, що витримує перевірку, яку може провести будь-хто. ## Наша позиція **Позиція PhishDestroy.** Ми поважаємо закон і суди. Закон не є супротивником істини. Ті, хто його обходить, щоб уникнути дотримання, не є союзниками суду, а науковий ступінь не може слугувати для когось авторитетом. Ступінь доктора наук — це історичний факт: одне дослідження у вузькій теоретичній галузі, захищене один раз. Це не робить нікого юристом у сфері ІТ. Наскільки ми можемо судити, у заголовку немає нічого, що пояснювало б ці помилки: ані аргументи, наведені під підписом, ані неправильно написане ім’я, ані витік даних, які, як стверджувалося в самих листах, мали захищати. Пізніше обидва підписанти подали запити на видалення з пошукової видачі відповідно до ст. 17 (див. [повідомлення оператора](https://phishdestroy.io/tgwitness/uk/docs/reference/notice/)). Право на забуття не повинно стирати слідів професійної недбалості фахівця. І чи хтось взагалі перевіряє документи, що надсилаються з кваліфікованим підписом? Ці листи нагадують електронний лист до друга, а не документ, що має суспільне значення. «Нульова довіра» — до всіх. Гроші — це добре. Але продавати за них закони власної країни, на нашу думку, — не найкращий спосіб їх використання. Та ми не експерти. PhishDestroy не є стороною у спорі та не висловлює думки щодо обґрунтованості блокування облікового запису Steam. На цій сторінці не вказано особу, якої стосуються дані; ідентифікатори облікових записів, логіни, IP-адреси та персональні дані не наводяться. Тексти скарг наводяться без зазначення логінів авторів, включаючи тексти під чорними прямокутниками, які залишаються у текстовому шарі файлу. Листи: № документа 42282474, 15 серпня 2025 року (3 сторінки); Dok.-Nr. 42603633, 1 жовтня 2025 року (9 сторінок). Додаток: Anlage 1 (830 сторінок). Посилання на сторінки відповідають порядку сторінок у PDF-файлі. Англійські переклади німецьких цитат належать нам. [Повне досьє справи](https://phishdestroy.io/steam_dossier/taylor_wessing) · [106-денна справа щодо GDPR](https://github.com/phishdestroy/TgWitness/blob/main/docs/TAYLOR-WESSING-GDPR-FILE.md). --- # Telegram · Робота з архівом Canonical page: https://phishdestroy.io/tgwitness/uk/docs/archive/ Завантажуйте історію, шукайте збережені записи, переглядайте джерела штучного інтелекту та підключайте свої інструменти. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Знайдіть повідомлення. Перевірте джерело. Складіть справу. 01**Додайте історію** Завантажте минулі повідомлення ввімкнених джерел у простір. 02**Слідкуйте за джерелами** Шукайте, а потім відкривайте збережене повідомлення за кожним результатом. 03**Забезпечте чіткість передачі інформації** Ваш аналіз — в одному файлі, підписані докази — поруч. Зафіксовані записи, розпізнаний текст та висновки аналітиків чітко розмежовуються. ## Завантажити попередні повідомлення 1. **Джерела → Чати в охопленні**: перевірте ввімкнені чати й запустіть спостереження. 2. **Завантажити всю історію**. Береться список джерел у його поточному вигляді. 3. **Призупинити історію** / **Продовжити історію** — будь-коли. Після перезапуску продовжуйте вручну. 4. Перевірте результат за кожним джерелом і чергу завантажень, збережіть підписаний звіт про перебіг разом з експортом. Так заповнюється простір. Експорт одного чату в HTML/JSON — окрема операція. [Докладніше](https://phishdestroy.io/tgwitness/uk/docs/reference/history/). ## Спочатку здійсніть пошук, а потім вирішуйте щодо використання ШІ 1. **Журнал** шукає локально, з фільтрами за джерелом і часом. 2. Знайдіть фразу чи домен, відкрийте запис і його версії. 3. Для ШІ адміністратор налаштовує провайдера в **Інтеграціях**. Потім **Запитати архів**: оберіть чати й період, перегляньте **Дані для моделі** та зніміть позначки з того, що не має піти. 4. Перевірте цитати, збережіть відповідь як звіт і додайте свої нотатки. Пошуку ШІ не потрібен. Звіти зберігають джерела й правки окремо від підписаного журналу. [Налаштування провайдера](https://phishdestroy.io/tgwitness/uk/docs/reference/analysis/). ## Оберіть потрібний варіант підключення | Завдання | Відкрити | Налаштування | | --- | --- | --- | | Дати ШІ-клієнту читати вибрані чати | **Інтеграції → MCP** | [Встановити MCP, створити обмежений токен, підключити](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/) | | Розпізнавання тексту у збережених медіафайлах | Запис `media.saved` → **Розпізнати вкладення** | [Налаштувати локальний Docker-воркер](https://phishdestroy.io/tgwitness/uk/docs/reference/media-analysis/) | | Надсилайте події до n8n або SIEM | **Інтеграції → Вихідні веб-хуки** | [Додати отримувача, перевіряти HMAC, відсіювати дублі ID](https://phishdestroy.io/tgwitness/uk/docs/reference/webhooks/) | **Який токен доступу куди вводити?** Доступ до панелі — для людей. MCP має власні токени лише для читання, вебхуки — власний секрет HMAC. Сесія Telegram нікому з них не потрібна. [Надайте доступ до панелі](https://phishdestroy.io/tgwitness/uk/docs/access/) або [налаштуйте клієнт MCP](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/). ## Надайте джерела та висновки Покладіть звіт поруч із підписаним ZIP. Звіт — це ваше прочитання джерел, ZIP — те, що перевіряє отримувач. [Експорт та перевірка](https://phishdestroy.io/tgwitness/uk/docs/exports/) · [Проведення повного розслідування](https://phishdestroy.io/tgwitness/uk/docs/cases/) --- # Telegram · Поділитися справою Canonical page: https://phishdestroy.io/tgwitness/uk/docs/access/ Надайте рецензентам та аналітикам доступ до вибраних акаунтів і чатів із окремими правами доступу, обмеженнями сеансів та токенами, які можна скасувати. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Поділіться тим, що комусь потрібно. Решту тримайте під контролем. 01**Виберіть докази** Цілі простори або окремі чати. 02**Виберіть дії** Перегляд, експорт або лише потрібні операції. 03**Встановити обмеження** Особистий токен з терміном дії, лімітом сесій і правилами IP, якщо треба. Обсяг збору даних визначає, що саме записується. Обсяг доступу визначає, що саме користувач може бачити та робити. ## Надати комусь доступ 1. Як адміністратор відкрийте **Доступ**. 2. Назвіть доступ, оберіть простори й чати. 3. Рецензенту досить **Перегляду**. Для завантаження додайте **Експорт**. 4. Встановіть обмеження, а потім натисніть **«Створити доступ**». 5. Скопіюйте токен (показується один раз) і надішліть його особисто разом з адресою панелі. 6. Спершу перевірте, що він побачить, в окремій сесії браузера. ## Почніть з того, яку роботу їм потрібно виконати | Особа | Доступ | Результат | | --- | --- | --- | | Рецензент | Вибрані чати; тільки для перегляду | Читає чат, нічого не може змінити. | | Аналітик | Вибрані чати; перегляд та експорт | Читає й завантажує те, що потрібно для справи. | | Оператор | Вибрані цілі робочі простори; джерела та колекція | Вирішує, що спостерігати, запускає й зупиняє збирачі. | Це лише приклади, а не фіксовані ролі. Доступ, обмежений чатами, ніколи не отримує налаштувань акаунта й повних експортів журналу. Доступ до всіх просторів включає акаунти, додані пізніше. ## Ви можете змінити своє рішення в будь-який момент Змінюйте доступ будь-коли, зміни діють з наступного запиту. Завершіть одну сесію або відкличте все. Уже завантажені файли не повернути. Збір продовжує працювати. **Обмеження щодо сеансів та IP-адрес** Обмежте паралельні сесії та входи, задайте дату завершення, дозвольте IP чи підмережі або прив'яжіть до IP першого входу. Термін рахується за бездіяльністю, відкрита панель вважається активною. За проксі перевірте, яку IP клієнта бачить застосунок. **Головний ключ та журнал активності** Головний токен лишається в адміністратора. Виданий доступ не може керувати чужим доступом чи відкрити консоль адміністратора. Зміни доступу й сесії підписуються в журнал, без токенів. Адміністратор сервера, як і раніше, бачить усе. Усі сім прав і правила сесій: [довідник з доступу](https://phishdestroy.io/tgwitness/uk/docs/reference/access/). --- # Telegram · Забезпечте його безперебійну роботу Canonical page: https://phishdestroy.io/tgwitness/uk/docs/server/ Запустіть TgWitness на сервері з постійним сховищем даних, приватним доступом до панелі управління, резервним копіюванням та перевірками після перезапуску. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Тримайте збирач у роботі, а дані — в безпеці під час перезапусків. ## Оберіть спосіб запуску Нативно: [лаунчер](https://phishdestroy.io/tgwitness/uk/docs/start/) плюс шаблони служб у [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Docker, з папки проєкту: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` Панель слухає localhost:8787. Відкривайте локально або через SSH-тунель, з токеном із другої команди. ## Збережіть весь каталог даних Нативно: `data/live`. Docker: том `tgwitness-data`. Журнали, сесії й ключі мають зберігатися разом. Підписаний експорт — це доказ, а не резервна копія. 1. Спершу зупиніть збір. 2. Скопіюйте всю папку даних у надійне місце поза хостом. 3. Спробуйте відновити її на окремому встановленні, перш ніж їй довіряти. ## Перевірте після перезапуску Перевірте простір і ключ, підключення, джерела й те, що нові повідомлення надходять. TgWitness наздоганяє те, що ще зберігає Telegram, а не все, що сталося, поки він був вимкнений. «Здоровий» контейнер означає, що вебсервер відповідає. Чи працює збір, покажуть тестове повідомлення й свідок. ## Публікуйте лише те, що ви маєте намір опублікувати HTTPS, томи, оновлення й відновлення — у довіднику з розгортання. Що реально перевірено: [журнал перевірок](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/). --- # Telegram · З’ясуйте, що пішло не так Canonical page: https://phishdestroy.io/tgwitness/uk/docs/troubleshooting/ Перевіряйте доступ до панелі, з’єднання з Telegram, відсутні повідомлення, FloodWait та статус свідка, використовуючи відповідні сигнали для кожної проблеми. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Почніть із симптому й перевіряйте по одному. ## Панель запитує токен Потрібен токен панелі з файлу, який назвав лаунчер. Docker: `docker compose exec tgwitness cat /data/panel-token.txt`. Не код Telegram, не токен бота й не токен свідка. ## Telegram не підключається Запустіть перевірку підключення. На публічному проксі оберіть інший і збережіть. Перевірте тип проксі й формат секрету. Оновлення списків саме по собі маршрут не змінює. ## Є з'єднання, але нових повідомлень немає 1. Чи запущено спостереження, у тому просторі? 2. Чи вибрано джерело й чи бачить його цей акаунт? 3. Надішліть унікальне повідомлення в тестову групу й знайдіть його. 4. Пошукайте в журналі перерви або помилки Telegram. У тихому чаті просто немає нічого нового. Якщо важлива повнота, проведіть контрольний тест доставки. ## FloodWait або затримка після перезапуску FloodWait — це Telegram каже «повільніше». Перечекайте й зменште навантаження, перепідключення не допоможе. Після перезапуску TgWitness наздоганяє те, що ще є в Telegram; решта — прогалина, запишіть її. ## Бот налаштований, але нічого не публікує Чи запущено свідка, чи може бот писати в канал, чи доступні йому збирач і Bot API? Пошукайте в його журналі невдалі публікації. Опитування з боку збирача не означає, що пост пішов. ## Де знаходиться інтеграція з токенами GitHub? **У стадії планування. У розділі** «Додаткова інформація» описано запропонований робочий процес розгалуження та перевірки збірки. Наразі немає форми для отримання токена GitHub або автоматизованої перевірки відповідності запущеної інсталяції репозиторію. Дивіться [поточний стан функціоналу](https://phishdestroy.io/tgwitness/uk/docs/reference/features/). Повідомляєте про помилку? Версія, ОС, кроки й помилка без особистих даних. Ніколи не кладіть сесії, токени, особисті повідомлення чи папку даних у публічний issue. --- # Export Clinic Canonical page: https://phishdestroy.io/tgwitness/uk/docs/export-clinic/ Перегляньте експеримент з контрольованим експортом даних з Telegram Desktop, порівняйте сім тестових діалогів та ознайомтеся з оригінальним записом і відповідними файлами. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) У чаті написано «FAIL». На експортованій сторінці вказано «PASS». Простежте за змінами, порівняйте файли та з’ясуйте, як це сталося. У цьому експерименті використовуються тестові акаунти та заздалегідь запрограмовані діалоги. Програму Telegram Desktop було завантажено з офіційного джерела, і її виконуваний файл не зазнав жодних змін. Локальний помічник навмисно змінив окремі експортні файли. Простежте процес завантаження, входу в систему та експорту, а потім порівняйте переписку в Telegram зі зміненими файлами HTML та JSON. Цей експеримент демонструє, які елементи звичайного експорту можуть бути змінені та чому важливо вести облік процесу збору даних. **1:59,7 —** скорочена версія фільму**6:08,8 —** повний запис з оригінального джерела**7** пробних розмов ## Перегляньте експеримент [Завантажити фільм](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) 1:59,7 · Налаштування та повторювані кроки прискорено у 2–15 разів і позначено. Вхід у систему, перший експорт та вибрані порівняння виконуються з початковою швидкістю. Звуку немає. [Завантажити оригінальний файл у форматі MKV ↗](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) ## Порівняйте експортні дані тестів Ці уривки взяті із збережених та змінених файлів у форматі JSON. Оберіть тип розмови, порівняйте повідомлення, а потім завантажте повні пари експортованих даних, щоб самостійно переглянути HTML, JSON та вкладені зображення. ### «Експортна клініка» | Перевірка PDF-файлів 5 повідомлень · 2 зміни **ДО ВНЕСЕННЯ ЗМІН НА МІСЦЕВОМУ РІВНІ**Збережені вихідні байти ПЕРЕВІРКА ДОКУМЕНТА / СИНТЕТИЧНИЙ ТЕСТ РЕЗУЛЬТАТ: НЕВДАЧА Прихований текст під чорним прямокутником залишається доступним для виділення. Це результат, отриманий за допомогою скрипту для демонстраційного PDF-файлу, а не результат перевірки стороннього документа. d58d19814e1e07d5… **ПІСЛЯ ЗМІНИ МІСЦЕВОГО НАЗВАННЯ**Навмисно змінені байти ПЕРЕВІРКА ДОКУМЕНТА / СИНТЕТИЧНИЙ ТЕСТ РЕЗУЛЬТАТ: ПРОЙШОТО Усі конфіденційні фрагменти тексту було остаточно видалено. Це навмисно замінений демонстраційний результат. 83a0a37eb7110d51… result.json · повідомлення 1216 Зміст сцени, що відповідає сценарію. Висновок бота не є аналізом реального документа третьої сторони. Змінено повідомлення 1 із 2 **Порівняйте зображення, що міститься в цьому експорті** ![Зображення до локальної модифікації](https://phishdestroy.io/tgwitness/uk/docs/export-clinic/) ДО · збережені байти зображення ![Навмисно змінене зображення](https://phishdestroy.io/tgwitness/uk/docs/export-clinic/) ПІСЛЯ · зображення, навмисно замінене У цьому експорті даних бота не було включено вкладень. Цей архів зберігає це обмеження. JavaScript вимкнено. Порівняння ботів за замовчуванням та всі завантаження залишаються доступними. Завантажте архів із парами, щоб переглянути інші шість діалогів. ## Що показує це порівняння [Стандартна функція експорту](https://telegram.org/blog/export-and-more) в Telegram зберігає історію та вибрані мультимедійні файли як локальні файли. У цьому випадку користувач із правами на запис змінює ці файли, тоді як офіційний клієнт продовжує відображати оригінальний діалог. Завдяки цим парам файлів можна проаналізувати кожну зміну. 1. **Офіційний клієнт:** завантажте, увійдіть та перегляньте тестові діалоги. 2. **Вбудований експорт:** клієнт записує HTML, JSON та вибрані зображення. 3. **Виявлене втручання:** місцевий помічник навмисно змінює вибрані файли. 4. **Порівняння:** діалог та змінений експорт відображаються поруч. ### Записуйте дані одразу після їх збору Час підписання має значення. Підписання вже зміненого експорту фіксує саме цю змінену версію. TgWitness підключається до Telegram, фіксує вміст, доставлений на обліковий запис, а також підписує та пов’язує записи журналу під час збору даних. Одержувач може перевірити збережені записи та файли на відповідність цим підписам та незалежно збереженим контрольним точкам. У разі зовнішнього процесу збору даних [GitHub Actions](https://phishdestroy.io/tgwitness/uk/docs/capture/)запускає закріплений колектор TgWitness із новою сесією Telegram. GitHub засвідчує отриманий архів. Під час перевірки перевіряються затверджений робочий процес і версія колектора, дайджест архіву, журнал та вкладення. [Перевірка архіву TgWitness](https://phishdestroy.io/tgwitness/uk/docs/exports/#verify) · [Спробуйте змінити запис із підписом](https://phishdestroy.io/tgwitness/uk/docs/concepts/#chain) · [Виконати зчитування даних з GitHub](https://phishdestroy.io/tgwitness/uk/docs/capture/) ## Що насправді підтверджують криміналістичні інструменти «Export Clinic» наводить один конкретний приклад. Закономірність, яку він виявляє, не є характерною виключно для Telegram. У переважній більшості справ, які ми проаналізували — включаючи судові документи, обговорення справ та опубліковані аналітичні матеріали — «цифрові докази» мають однаковий формат: експорт даних із Telegram (файл у форматі HTML або JSON, іноді — запис екрану монітора, іноді — відео з iPhone, на якому показано перегляд сторінок профілів) у поєднанні з підписом експерта. Зазвичай це і є весь ланцюжок доказів. Експортні файли Telegram забезпечують знімок стану даних для їх перенесення. TgWitness додає запис про отримання, збережені спостереження та зміни, хеші файлів, підписи збирача та записи зовнішньої верифікації, доступні для обраного режиму. У сукупності це дозволяє одержувачу порівняти збережений матеріал із зафіксованим контекстом, часом та умовами збору. ### Інструменти є об’єктивними. Проблема полягає в тому, що люди вважають, ніби вони щось доводять. Ми безпосередньо працювали з UFED Cellebrite. Це чудове програмне забезпечення. Коли воно витягує дані з пристрою, обчислює хеші SHA-256 і формує підписаний звіт, воно точно підтверджує лише одне: *ці байти були на цьому пристрої на момент вилучення, і під час передачі нічого не змінилося.* Це правда. Це корисно. І це все, що це доводить. У ньому нічого не сказано про те, що було на пристрої до того, як правоохоронці до нього доторкнулися. У ньому нічого не сказано про те, чи відображають ці дані історичну реальність. Інструмент працює правильно. Інструмент не є свідком. Ми могли б взяти інструменти, спеціально розроблені для роботи з експортованими даними чатів Telegram — програми для перегляду, архівування, підготовки матеріалів для судових засідань — перевірити кожен із них на готових експортних файлах і скласти порівняльну таблицю. Але ми цього не робитимемо. Справа не в тому, який інструмент що виявляє. Жоден із них цього не може. Вони обробляють те, що міститься в експорті. Якщо експорт був сформований до того, як потрапив до них, вони точно відтворюють його структуру. Криптографічний підпис підтверджує цілісність даних, *починаючи з моменту підписання*. Він не дає жодних гарантій щодо того, що відбувалося до цього. Якщо вхідні дані були сформовані до вилучення, звіт є криптографічно бездоганним, але фактично неправдивим. Інструмент відображає обидва результати однаково. ### Прогалина у підзвітності Уявіть собі юрисдикцію, де криміналістичне обладнання закуповується через відкриті тендери — інформація про моделі, конфігурації та терміни закупівлі є у відкритому доступі. Де жоден закон не вимагає, щоб пристрої мали актуальну версію прошивки. Де експерти-свідки не несуть особистої кримінальної відповідальності перед судом за свої висновки. У Сполучених Штатах та Великій Британії судовий експерт несе особисту юридичну відповідальність за кожну дію, яку він здійснює щодо доказів. Саме ця відповідальність — а не програмне забезпечення — забезпечує функціонування ланцюга доказів. Якщо її усунути, той самий інструмент, що служить правосуддю, стане доступним для використання в будь-яких цілях, які вважатиме за доцільні власник ліцензії. **Технічна реалізація стану пристрою до виникнення припадку** Якщо суб’єкт дізнається про майбутній напад заздалегідь — семи днів цілком достатньо — панічні реакції є не лише контрпродуктивними, а й, у деяких юрисдикціях, окремо кваліфікуються як кримінальний злочин. Підготовлений суб’єкт, який має технічний доступ та ресурси, діє інакше: він створює певний стан пристрою. **Період оновлення прошивки.** Флагманські моделі Samsung Galaxy S Ultra та Z Fold — захист Knox, заблокований завантажувач. Проміжок часу між випуском патча безпеки та його доступністю для пристроїв у конкретному регіоні зазвичай становить місяць. Для щойно випущених моделей цей період у перші три-чотири місяці є значно довшим. Нам не відомі жодні законодавчі вимоги, які б зобов’язували користувачів встановлювати актуальну прошивку на особисті пристрої. **Інструменти для обслуговування.** Комерційне програмне забезпечення для обслуговування забезпечує доступ до пристрою на низькому рівні протягом цього проміжку часу, не активуючи при цьому індикатори втручання системи Knox, на які звертає увагу експерт-криміналіст. **Побудова хронології.** Повна резервна копія пристрою, розгорнута в емуляторі, управління часом за допомогою скриптів та ізоляція мережі дають змогу побудувати бажану хронологію подій: дзвінки, повідомлення, активність додатків, GPS-координати. **Місцезнаходження без впливу мобільного зв’язку.** Дані про рахунки за користування мобільним зв’язком можна незалежно перевірити — не торкайтеся їх. Натомість реєнуються підключення до громадських точок доступу Wi-Fi. MAC-адреси громадської інфраструктури систематично збираються та поширюються провідними технологічними корпораціями. На основі загальнодоступних даних можна скласти безперервний географічний ланцюг, що охоплює будь-який бажаний період. **Ротація облікових записів.** Повне видалення облікового запису Samsung займає приблизно сім днів. Створюється новий обліковий запис, відновлюється підготовлена резервна копія. Не виникає конфліктів цілісності системи, завантажувач залишається недоторканим, прапор втручання не спрацьовує. **Зокрема, Telegram.** На певних сімействах пристроїв база даних та кеш додатка — чати, мультимедійні файли, метадані сповіщень, шаблони активності — можуть бути замінені на рівні можливостей операційної системи без класичного root-доступу. Глибокий аналіз, проведений фахівцями на основі повного необробленого дампа, потенційно може виявити аномалії. Такий аналіз є дорогим, повільним і, за нашим досвідом, практично ніколи не вимагається в рамках стандартних процедур. ### Що вкинеш — те й отримаєш Підписаний звіт пов’язує витягнуті байти саме з цим записом. Історія пристрою за попередній період аналізується на основі записів за цей період. Наступний ланцюжок — експерти-свідки, які аналізують результати роботи інструменту, складають аналітичні висновки та підписують висновки — є настільки ж точним на кожному окремому етапі. Ніхто в цьому ланцюжку не бреше. Ніхто в цьому ланцюжку не доводить історичну правду. Кожен учасник точно повідомляє те, що отримав на попередньому етапі. Ступінь доктора наук є підтвердженням раніше проведених досліджень. Це не є свідченням поточної компетентності, і він не може зробити істинним твердження, яке неможливо перевірити математично. Ми пропонуємо інший стандарт: **довіряйте математиці, а не званню.** ### «Нульова довіра» як доказ У сфері інформаційної безпеки поняття «Zero Trust» означає, що жодному суб’єкту не довіряють за замовчуванням, незалежно від його посади чи повноважень — кожне твердження має бути незалежно перевірено. Ми пропонуємо застосовувати той самий принцип до цифрових доказів. Довіра є вразливим місцем. Якщо твердження неможливо перевірити незалежно та математично, воно є твердженням, що ґрунтується на довірі — а довіру можна зловживати, купити або вимусити. Що стосується саме доказів, експортованих із Telegram: не довіряйте нам, не довіряйте Telegram, не довіряйте аналітику, не довіряйте експерту-свідку. Перевірте розрахунки. Як це виглядає на практиці: атестації TgWitness посилаються на модель SLSA v1 рівня 3 — походження збірки, підписане інфраструктурою GitHub Actions, прив’язане до конкретного хешу коміту та запуску робочого процесу. Атестацію можна перевірити незалежно, не покладаючись на жодну особу, залучену до процесу збору. Це не усуває всіх припущень щодо довіри — це точно документує, які саме припущення залишаються і що вони собою являють. **Про експертів-свідків та фінансові стимули** Адвокат, який представляє одну зі сторін у спорі, водночас виступаючи в ролі нейтрального стороннього експерта в тому самому судовому процесі, причому розмір його винагороди залежить від результату справи його клієнта: це структурне протиріччя. Ми не висуваємо звинувачень щодо будь-якої конкретної особи. Ми запитуємо, чому така структура вважається прийнятною і чому її так рідко піддають аналізу. Стандартний контраргумент: *скільки їм коштуватиме брехня?* У юрисдикціях, де існує право на видалення даних та право на забуття, практичні витрати на притягнення експерта до відповідальності за дачу неправдивих свідчень зазвичай є дуже незначними. Ті, хто висловлює занепокоєння щодо неправильного висновку експерта, зазвичай отримують юридичні листи з вимогою припинити висловлювати такі занепокоєння. Цей процес є дорогим для особи, яка висловлює занепокоєння. Для експерта він не є дорогим. Ми не стверджуємо, що всі експерти-свідки є нечесними. Ми стверджуємо, що твердження «їм обійшлося б занадто дорого, щоб брехати» не є критерієм доказу. Це критерій довіри. А довіра — це вразливість. Суб’єкт, який бажає оскаржити засвідчення TgWitness, мав би зламати криптографічний підпис, переконати інфраструктуру підписання GitHub ретроактивно засвідчити те, чого вона ніколи не виконувала, і зробити це всупереч незмінній історії комітів — за присутності свідка. Якщо такі можливості існують і просто приховані за складністю роботи з програмним забезпеченням для роботи з PDF-файлами, ми щиро вітатимемо демонстрацію цього. Ми не стверджуємо, що наші інструменти кращі — у нас немає комерційного продукту, і ми не зацікавлені в його створенні. Ми помітили проблему: поширене припущення, що результати роботи криміналістичного програмного забезпечення дорівнюють історичній правді, а висновки експертів — доказу. Це припущення рідко піддається сумніву на технічному рівні під час судових розглядів, де це має найбільше значення. Цей експеримент є одним із контрольованих даних. Математика не має думки щодо звань. ## Завантажити матеріали Відео та ZIP-файли розміщені на [сайті phishdestroy.io](https://phishdestroy.io/). Оберіть файли, які ви хочете перевірити. Обидва ZIP-файли містять вибрані тестові дані та документацію. Інструмент для модифікації, вихідний код, конфігурація, облікові дані та сесії не включені. ### До та після експорту Сім тестових діалогів: HTML, JSON, вбудовані зображення та стандартні ресурси переглядача. Містить маніфест файлів та вибраний журнал змін. [Тестові файли для експорту · ZIP · 3,0 МБ ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-paired-files.zip) Немає відео. Немає інструменту для редагування. ### Відео + експорт тестових даних Повний оригінальний запис, двохвилинний відеоролик, пари експортованих файлів, пояснення, огляд метаданих, карта редагування та контрольні суми. [Відео + тестові файли для експорту · ZIP · 46,9 МБ ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-review-package.zip) Містить менший ZIP-файл. Не містить інструменту для редагування. **Що саме міститься у ZIP-файлі розміром 46,9 МБ?** - `video/ExportClinic_2026-11-03_12-50-40.mkv` — повний запис у первісному вигляді, 6:08,8. - `video/export-clinic-2min.mp4` — скорочена версія фільму, 1:59,7. - `data/export-clinic-paired-files.zip` — розпакуйте цей вкладений ZIP-файл, щоб переглянути `before/` та `modified/` папки. - `description/article-en.md` — пояснення та обмеження. - `verification/` — чотири файли у форматі JSON/Markdown, що охоплюють редагування карти, перевірку метаданих та огляд пакета. - `README.md` та `SHA256SUMS.txt` — читання інструкцій та контрольних сум файлів. У зовнішньому ZIP-архіві міститься десять файлів. Окремий повний файл у форматі MP4 не включено, оскільки оригінальний файл у форматі MKV уже містить повний запис. Стандартним `js/script.js` всередині кожного експортованого чату міститься незмінений HTML-переглядач Telegram. ### Окремі відеофайли - [Оригінальний файл у форматі MKV · 6:08,8 · 29,6 МБ](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) — вихідний запис, ідентичний до оригіналу на рівні байтів. - [Відкрити повний файл MP4 · 6:08,8 · 29,9 МБ](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-full.mp4) — конвертація у формат, сумісний з браузерами, без перекодування відео. - [Відкрити стислий файл MP4 · 1:59,7 · 14,3 МБ](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) — зміни швидкості відтворення позначені. [Завантажити контрольні суми](https://phishdestroy.io/tgwitness/assets/export-clinic/SHA256SUMS.txt)[Карта редагування відео](https://phishdestroy.io/tgwitness/assets/export-clinic/recording-manifest.json?v=42fbcde007f1)[Маніфест парних файлів](https://phishdestroy.io/tgwitness/assets/export-clinic/review-file-manifest.json?v=c725b2ecbe50)[Перегляд метаданих](https://phishdestroy.io/tgwitness/assets/export-clinic/original-metadata-notes.md)[Поточний посібник з роз'яснення та перевірки](https://phishdestroy.io/tgwitness/assets/export-clinic/article-en.md) У ZIP-файлі з оглядом, який можна завантажити, збережено оригінальний файл README та саму статтю. Поточне пояснення містить посібник зі збору та перевірки даних TgWitness. **Як було відтворено стан «до»:** це реконструйоване дерево папок у стані до змін. Змінені файли було відновлено байт за байтом із збережених резервних копій та зіставлено з їхніми записаними хешами. Незмінені ресурси переглядача було скопійовано з збереженого експорту. Маніфест файлів містить інформацію про надані версії. У семи діалогах налічується 45 записів повідомлень; 17 записів і 32 файли відрізняються. Кожна версія містить 340 файлів. Вкладення у форматі PDF не були відібрані під час експорту даних і відсутні в цих архівах. ## Деталі експерименту **Де відбулася ця зміна?** Місцевий помічник змінив файли, створені Telegram Desktop. Виконавчий файл офіційного клієнта та чати, що відображаються в Telegram, залишилися без змін. Порівняння показує оригінальні повідомлення поруч зі зміненим експортом. **Чи це повні експортовані дані з облікових записів?** Ні. Матеріали охоплюють сім власних тестових діалогів: особистий чат, чат із ботом, приватну групу, приватні та публічні супергрупи, а також приватні та публічні канали. Вони містять 45 записів повідомлень. До них не входять сторонні чати, контакти чи архів усього облікового запису. **Чи додані PDF-файли?** Ні. У записаних налаштуваннях експорту не враховано вкладені файли. У тестових повідомленнях та зображеннях згадується PDF-файл, але ці архіви не містять цього PDF-файлу. Ця відмінність відображена у файлах та описі. **Чи входить інструмент для модифікації до комплекту поставки?** До складу не входять жодні виконувані файли, вихідний код допоміжних програм, конфігурація перетворення, дані сеансів, облікові дані чи повні журнали роботи. Невеликі файли JavaScript, що містяться у спарених експортованих файлах, є незміненими стандартними ресурсами HTML-переглядача Telegram, ідентичність яких у обох версіях було перевірено. **Як перевірити завантажені файли?** Обчисліть SHA-256 для кожного файлу та порівняйте його з опублікованими контрольними сумами. Збіг значень підтверджує, що ви маєте саме ті байти, які було опубліковано. У маніфесті файлів вказано обидві версії для експорту; карта монтажу відео містить інформацію про скорочену версію фільму. Час запису визначається за годинником хоста. **Як TgWitness забезпечує можливість перевірки записів?** Колектор підписує записи під час отримання даних із Telegram. Архів містить журнал, хеші файлів та дані для перевірки. Зберігайте відбиток ключа та контрольну точку окремо, а потім звіряйте копію одержувача з ними. Функція «GitHub capture» додає перевірку затвердженого робочого процесу збору даних та його результатів. [Дотримуйтесь інструкцій щодо перевірки ↗](https://phishdestroy.io/tgwitness/uk/docs/exports/) Для цього експерименту було підготовлено сім діалогів. Запис, парні експортовані файли та журнал змін фіксують зміни у локальних файлах, описані вище. Експеримент із контрольованими локальними файлами · 3 листопада 2026 року Скопійовано повний SHA-256 --- # 56 329 повідомлення. Canonical page: https://phishdestroy.io/tgwitness/uk/docs/validation/ 56 329 повідомлень Telegram було експортовано під час двох вимірюваних циклів. Порівняйте кількість повідомлень, швидкість збору, час експорту та підписані архіви. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) TGWITNESS / РЕАЛЬНИЙ ЕКСПОРТ Записано. Експортовано. Два свіжих експорти з Telegram, з зазначенням часу від моменту збору даних до отримання готового архіву. Ознайомтеся з робочим простором, перегляньте статистику та завантажте зразок. [Ознайомтеся з демо-версією](https://phishdestroy.github.io/TgWitness/demo/?lang=en)[Завантажити зразок експорту](https://phishdestroy.github.io/TgWitness/demo/downloads/tgwitness-demo.zip) В інтерактивній демонстрації та прикладі використовуються вигадані повідомлення. Наведені нижче показники отримано під час реальних операцій експорту. TGW / 001 Збережений знімок екрана · не моніторинг у реальному часі Перевірено о 2026-11-06 18:37:38 UTC Перевірена редакція [92e539af](https://github.com/phishdestroy/TgWitness/commit/92e539af40d8368d198ff5e040f1d876f2c1310e) Текст + метадані · підписані архіви **56 329**Експортовані повідомлення **160.531**Повідомлення/с · найкраща серія збігів **2**Підписані експортні цикли **3**Перевірені сервери Сервер AWARP · 2 рахунки **27 030**Експортовані повідомлення **142.983**повідомлень/с Тільки самовивіз 189.043 s Повний експорт 211.647 s Сервер BWARP · 2 рахунки **29 299**Експортовані повідомлення **160.531**повідомлень/с Тільки самовивіз 182.513 s Повний експорт 206.650 s 01 / ## Виміряно на основі фактичного експорту. Один новий експорт на кожен сервер, з використанням двох облікових записів на кожному. Текст і метадані передаються через WARP; вкладення не враховуються. повідомлень/с Сервер A**142.983 повідомлень/с** Сервер B**160.531 повідомлень/с** Сервер C Не виміряно — Кількість повідомлень ÷ час збору. Підготовка, відбір та пакування не входять до цього проміжку часу. Кількість повідомлень ÷ загальний час експорту, включаючи підготовку та пакування. Для сервера C відсутня квитанція про виконання контрольного тесту збору даних. У жодному з прогонів не було повторно використаних записів або дублікатів ідентифікаторів. На сервері А у фоновому режимі також виконувалося читання з захищеного джерела. Паузи FloodWait дотримувалися: А — 4, Б — 3. **Точні виміри та хеш-коди архівів** | Сервер | Повідомлення | Тільки самовивіз | Повний експорт | | --- | --- | --- | --- | | Сервер A | 27 030 | 189.043 s **142.983 повідомлень/с** | 211.647 s **127.713 повідомлень/с** | | 2026-11-06T18:26:51.500Z → 2026-11-06T18:30:23.228Z SHA-256 `20e507fc68446680ed002fd486d0968a944ec0c71e02f937331ae2b19ab4cd66` | | | | | Сервер B | 29 299 | 182.513 s **160.531 повідомлень/с** | 206.650 s **141.781 повідомлень/с** | | 2026-11-06T18:25:40.419Z → 2026-11-06T18:29:07.173Z SHA-256 `824601b502762efaabb8ff9afdb1e8d7fff189862ef2cbc4d8d26d0d68c83e4c` | | | | Обидва архіви пройшли перевірку за допомогою закріпленого ключа колектора. 02 / ## Усі три, із чітко визначеним обсягом. На кожному сервері було перевірено цілісність журналів, права доступу до файлів, систему зберігання даних, мережеві маршрути та запущені процеси. A Перевірено ### Сервер A Збір та експорт 8 vCPU · 16 GiB · Ubuntu 24.04 Перевірені журнали 21 Події журналу 4 517 Контрольні пункти 147 Визначення еталонних значень для свіжих збірок, перевірка архівів та перевірка цілісності резервних копій. B Перевірено ### Сервер B Збір та експорт 8 vCPU · 16 GiB · Ubuntu 24.04 Перевірені журнали 21 Події журналу 1 993 Контрольні пункти 147 Визначення еталонних значень для свіжих збірок, перевірка архівів та перевірка цілісності резервних копій. C Перевірено ### Сервер C Панель та вкладена віртуальна машина 8 vCPU · 32 GiB · Ubuntu 24.04 Перевірені журнали 14 Події журналу 7 185 Контрольні пункти 973 Перевірено автентифікацію панелі, прив’язку до петлі зворотного зв’язку та вкладену віртуальну машину. На цьому сервері не проводилося тестування продуктивності збору даних. **Результати випробувань, обсяг робіт та технічні примітки** 03 / ## Проходи та прогалини — пліч-о-пліч. Останні результати за кожним тестовим випадком pytest, включаючи повторні запуски. Наведені нижче результати для автономних наборів тестів у браузері та наборів тестів «evidence» підраховуються окремо; вони не додаються до загального результату pytest. **1 585**Здано **3**Не вдалося **37**Пропущено Три тести браузера з фіксацією даних потребують пісочниці Chromium, яку ці контейнери не забезпечують; пісочниця залишається увімкненою. 37 випадків пропуску платформ підраховуються окремо від успішних проходжень. - Набори браузерів**102 прийнято** - Набори інтерфейсів**66 прийнято** - Комплекси доказів**15 прийнято** - Набори веб-сайтів**9 прийнято** - Додаткові апартаменти**13 прийнято** 04 / ## Обсяг цього знімка. 1. 01 ### Пісочниця браузера Три перевірки браузера очікують на середовище з пісочницею Chromium. 2. 02 ### Актуальність резервних копій 42 журнали резервного копіювання та 51 285 файлів пройшли перевірку цілісності. На момент створення знімка стан останнього резервного копіювання відставав від поточного збору даних на 3 507 подій. 3. 03 ### Покриття мережі 24 з 40 маршрутів пройшли перевірку. Решта 16 облікових записів залишилися відключеними, замість того щоб перейти на пряме з’єднання. 4. 04 ### Незалежний час Журнал свідків, що зберігся, пройшов перевірки на цілісність. Остання подія в ньому відбулася 6 листопада о 07:27 за UTC. 5. 05 ### Заходи безпеки У моделі безпеки описано захист ключів, захист облікових записів, надійне зберігання та механізми контролю доступу; відкриті висновки цього аудиту наведено у підписаному звіті. 6. 06 ### Перевірені сервери Ця сторінка присвячена трьом перевіреним серверам. 7. 07 ### Виміряне навантаження Два відкриті джерела, два окремі запуски, текст та метадані без завантаження вкладень. Сервер C працював без вимірювання швидкості збору даних. Кожен показник стосується відповідного зафіксованого навантаження. 05 / ## Запис із датою, що містить посилання на цифри. Дані вимірювань, отримані адміністраторами, підписані аудиторським ключем. Файл JSON містить лише узагальнені дані. Ідентифікаційні дані джерел та облікових записів, зміст повідомлень, облікові дані та приватні архіви не оприлюднюються. 1. Збережіть версію вихідного коду та перевірте встановлену версію. 2. Зібрати дані в нову робочу область, не зберігаючи жодних повторно використаних записів. 3. Вимірюйте інтервали збору даних та повного експорту окремо. 4. Перевірте архів за допомогою закріпленого ключа; збережіть його хеш-суму SHA-256. Перевірена версія `92e539af40d8-83e41104669e` [Завантажити дані ↓](https://phishdestroy.io/tgwitness/validation/snapshot.json) SIGNED AUDIT / ENGLISH ### Check the numbers. The English report includes the measured results, open findings and a reproducible signature check. [Read the report ↗](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md)[Signed statement ↓](https://phishdestroy.io/tgwitness/validation/audit/PROOF.json)[Measurements CSV ↓](https://phishdestroy.github.io/TgWitness/validation/audit/MEASUREMENTS.csv)[Python verifier ↓](https://phishdestroy.github.io/TgWitness/validation/audit/VERIFY.py)[File checksums ↓](https://phishdestroy.io/tgwitness/validation/audit/SHA256SUMS.txt) The signature binds the report and its measurements to the audit key; a change to any signed file fails VERIFY.py. The report records the completed audit at 19:08 UTC; the infrastructure snapshot above was taken earlier. **Зведення квитанцій про надходження коштів** Ці хеші ідентифікують збережені підписані квитанції про вимірювання; приватні оригінали зберігаються у відповідальних за обслуговування. - benchmark-1.json`66cdf2db25901ee1f780a0e2d14b9b84888dbe525bff73bae19819b217f95d0c` - benchmark-2.json`ad2978fe2a7563476da43293eaaf5f498ee12522f0ea3e401bc43205c64874d1` - test-totals.json`922cf87d9320b149f2fc6791fc05f98335ec0952f9258e6eaeff179aeef33bb1` - infra-summary.json`325d390ef752b15f44203f97348863e24f0f631fe88998d5e1f398a5311a9339` У кожному графіку вказано версію, обсяг роботи та середовище. Показник, який не було виміряно, позначено як відсутній. --- # TgWitness: Telegram Export, OSINT & Verification Canonical page: https://phishdestroy.io/tgwitness/docs/reference/overview/ Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads with their methods and revisions. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/llms.txt) Встановіть за допомогою однієї команди або запустіть на GitHub Actions. Ознайомтеся з варіантами розслідування, опублікованим масштабом та тим, що перевіряє архів. TgWitness — це експортер Telegram з відкритим кодом та робоче середовище для розслідувань. Встановіть його однією командою, підключіть обліковий запис, виберіть чати та експортуйте підписаний архів. Він також підтримує тимчасове збирання даних у GitHub Actions та продовження розслідувань із збереженими редагуваннями, спостереженнями за видаленням, пошуком та звітами. ## Почніть із завдання, яке у вас є | Ваше завдання | Найкоротший шлях | Що ви отримаєте | | --- | --- | --- | | Зберегти чат або обліковий запис | Встановити, підключити обліковий запис, вибрати обсяг експорту | Підписаний архів із вибраною історією, результатами збору даних та матеріалами верифікації | | Збирати у тимчасовому запуску | Скористайтеся функцією GitHub Actions для збору даних, авторизуйте нову сесію та виберіть область дії | Зашифрований архів із інформацією про походження робочого процесу на GitHub | | Відстежуйте зміни з плином часу | Забезпечити безперервну роботу спостереження за вибраними чатами | Збережені версії, повідомлення про видалення, вкладення та зафіксований обсяг охоплення | | Досліджуйте та діліться результатами | Здійсніть пошук в архіві, скористайтеся Case Board та налаштуйте звіт або копію для поширення | Висновки з посиланнями на джерела та перевірена передача даних, пристосована до потреб одержувача | ### Встановлення однією командою Інсталятор містить Python та залежності. Завантаження вихідного коду, Docker, провайдер штучного інтелекту та незалежний свідок є опціональними елементами, а не обов’язковими умовами для налаштування. Linux / macOS: ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` Windows, у PowerShell або командному рядку: ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Відкрийте панель, підключіть свій обліковий запис Telegram та виберіть обсяг збору даних. Встановлення само по собі не запускає збір даних. У посібнику з встановлення пояснюються питання локального доступу, серверів, оновлень та перевірки завантаженої збірки. Для тимчасового запуску дотримуйтесь інструкцій [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). Цей робочий процес вимагає створення форку на GitHub, авторизації та пароля до архіву. На сторінці capture пояснено ці кроки та зазначено час сеансу перед запуском. Завантажте та збережіть отриманий архів та матеріали для його верифікації. ## Додаткові налаштування, якщо це потрібно для виконання завдання Для експорту даних з одного чату необхідний обліковий запис та обрана область спостереження. Постійне спостереження, використання декількох облікових записів, проксі-сервери, правила щодо вкладень, оформлення звітів, доступ для рецензентів, зовнішні мітки часу та зовнішнє зберігання даних відповідають різним вимогам щодо розслідування та передачі даних. Налаштуйте ці функції, коли вони є актуальними. Обсяг, дозволи та мінімізовані копії для спільного доступу допомагають операторам обирати, що збирати та розкривати. Вказівки щодо юрисдикції та налаштування звітів фіксують обрану процедуру та етапи підготовки. Див. [експорт облікового запису](https://phishdestroy.io/tgwitness/uk/docs/reference/account-export/), [доступ](https://phishdestroy.io/tgwitness/uk/docs/reference/access/) та [конфігурацію звітів](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/). Додаток працює на обраному комп’ютері або сервері. Для базового збору даних не потрібні графічний процесор (GPU) чи велика мовна модель (LLM). Додаткові функції OCR, транскрипції та аналізу на основі штучного інтелекту мають свої власні вимоги до ресурсів. Розраховуйте масштаб розгортання з урахуванням частоти повідомлень, вкладень, історії, що зберігається, та кількості одночасних облікових записів. ## Зберегти запис, кому б він не допоміг Мета полягає у збереженні спостережуваного матеріалу, контексту та змін незалежно від того, чию позицію вони підтримують. Докази можуть суперечити власній версії подій, викладеній колектором. Збережіть вихідні спостереження, пропущені дані та аналітичні висновки у вигляді, що дозволяє їх ідентифікувати, щоб інша особа могла оцінити той самий матеріал. Логіка така: спостереження, видиме для облікового запису → підписаний журнал → експорт → верифікація отримувача. Збережені редагування додають версії. Видалені спостереження зберігають раніше зафіксований вміст. Записи про охоплення виявляють відомі переривання. Звіти та аналіз на основі штучного інтелекту посилаються на збережені джерела; інтерпретація не стає джерелом спостереження лише тому, що вона з’являється у підписаному звіті. | Перевірка достовірності | Що може встановити одержувач | | --- | --- | | Хеші файлів, підписи та ланцюжок журналів | Надані записи та файли відповідають очікуваному ключу та межам журналу | | Окремо збережений контрольний пункт або свідок | Архів відповідає раніше збереженому стану журналу | | Перевірена зовнішня мітка часу | Вказані байти існували на момент, позначений часовим штампом, за зазначених припущень щодо надійності | | Засвідчення збору даних з GitHub | Архів відповідає затвердженому робочому процесу, версії колектора та записаному дайджесту. | | Атестація Intel TDX | Цитата, стан платформи, очікувані показники ОС/додатків, актуальність та ідентифікатор колектора проходять налаштовані перевірки | У разі засвідченого збору затверджене, автентифіковане з’єднання колектора з Telegram та його вихідні дані прив’язані до перевіреного середовища виконання. Архів зберігає зафіксований вміст та контекст; звіти та аналіз посилаються на ці записи. Використовуйте етапи верифікації, специфічні для конкретного режиму, та надійні вхідні дані, наведені в [посібнику з довіри](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) та [форматі доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/). ## Опубліковані показники та виміряна продуктивність Наведені нижче результати описують різні навантаження та дати. Кількісні показники не є взаємозамінними: подія в журналі не обов’язково є унікальним повідомленням у Telegram. | Дата | Обсяг роботи | Опублікований результат | Що вимірювалося | | --- | --- | --- | --- | | 1 листопада 2026 року | Працюючий сервер, десять баз даних робочих просторів | Записи журналу 1,610,818; події 900,232 — нові повідомлення, 80,683 — редагування та 400,536 — видалення | Інвентар збережених журналів, доступний лише для читання | | 5 листопада 2026 року | Пошук серед 1,000,000 синтетичних повідомлень у чатах 200 | Індекс побудовано за 71 секунд; медіанний час пошуку на один запит становить 9–190 мс | Тест продуктивності локального пошуку | | 6 листопада 2026 року | Два свіжих реальних експорти з Telegram | Повідомлення 27,030 та 29,299; 56,329 у обох циклах | Два облікові записи на один прохід через WARP: текст та метадані, без завантаження вкладень | | 6 листопада 2026 року | Ті самі два експорти, включаючи підготовку та упаковку | 127.713 та 141.781 повідомлень на секунду | Виміряно швидкість повного експорту; обидва архіви перевірено за закріпленими ключами | [Запис верифікації](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/) надає перелік серверів, результати перевірок колекції в режимі реального часу та показники пошуку. [Експорт даних про продуктивність](https://phishdestroy.io/tgwitness/docs/validation/) публікує два реальні запуски, апаратне забезпечення, тривалість, хеші архівів та підписані файли вимірювань, кожен із яких містить записану версію та умови. [Кваліфікація публічної історії](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md) також фіксує **48 перевірених архівів із 3,598,381 записів** у списку вхідних даних із 50 джерел та 40 робочих просторів облікових записів. Джерело A з вісьмома обліковими записами отримало **768,007 записів історії за 1,117.082 секунд**, включаючи час очікування: **687.512 записів/секунду**, при відключеному завантаженні вкладень. Повна спроба, включаючи перевірку, зайняла 1,574.920 секунд. Ці вимірювання описують це навантаження, поряд із наведеними вище прикладами меншого обсягу свіжого експорту. ### Історія та тривалість тестування TgWitness розроблявся та тестувався протягом приблизно шести місяців. Спочатку були створені колектор, підписаний журнал та верифікатор; веб-панель та додаткові модулі були побудовані на їхній основі пізніше. Цей репозиторій було створено 29 жовтня 2026 року з метою публікації, і він почав існувати з існуючого коду, тому його вік не збігається з віком проєкту ([історією розробки](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history)). Сукупний обсяг виконаних випробувань становить близько 100 мільйонів, включаючи попередні запуски, збої, виправлення та повторну валідацію. Вибрані запуски, кожен із яких має власну версію, метод та результат, задокументовані у [датованих публічних вимірюваннях](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements). ## Точно зчитуйте стан можливостей Оцініть кожен робочий процес з огляду на його реалізацію, опубліковану збірку та записані тести. Наразі вихідний код позначений як попередній перегляд. Ця позначка версії співіснує з робочою колекцією, експортом даних, незалежною верифікацією та опублікованими вимірами масштабу. Функція попереднього перегляду та перевірений робочий процес можуть існувати в одній програмі; опишіть конкретну функцію та докази, що лежать в основі оцінки. Використовуйте [поточні можливості](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [функції та обмеження](https://phishdestroy.io/tgwitness/uk/docs/reference/features/), [перевірку](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/) та [журнал змін](https://phishdestroy.io/tgwitness/uk/docs/reference/changelog/) разом. При цитуванні результату вказуйте перевірену версію. Знімок вимірювання від 6 листопада також зберігає невдалі та пропущені тести; вони не вважаються успішними. ## Зрозумілі для людей та інструментів штучного інтелекту Веб-сайт містить стислий опис (`llms.txt`), повний посібник англійською мовою ( `llms-full.txt` та `llms-full.md`), а також версії сторінок у форматі Markdown. Це формати документації, а не вимоги до штучного інтелекту для запуску TgWitness. Опціональний доступ через командний рядок [MCP](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/) та дозволяє авторизованим інструментам зчитувати вибрані збережені записи. Вміст повідомлень залишається ненадійним вхідним даними. У підсумках слід посилатися на джерела, розрізняти спостережувані факти та висновки, а також зберігати невизначеність. Повнотекстовий пошук, OCR та результати роботи штучного інтелекту не змінюють оригінальні підписані спостереження. --- # Telegram · Швидкий старт Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/quickstart/ Усі способи встановлення та запуску TgWitness: пакет для Windows, Python, Docker та синтетична демонстраційна версія з першими перевірками. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Усі способи встановлення та запуску TgWitness: пакет для Windows, Python, Docker та синтетична демонстраційна версія з першими перевірками. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документація](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Початок роботи](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) **Англійська** · [Русский](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/QUICKSTART.md) · [Українська](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/QUICKSTART.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/QUICKSTART.md) · [Португальська (Бразилія)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/QUICKSTART.md) · [Türkçe](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/QUICKSTART.md) · [العربية](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/QUICKSTART.md) · [فارсі](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/QUICKSTART.md) · [урду](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/QUICKSTART.md) · [हिन्दी](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/QUICKSTART.md) · [Індонезійська](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/QUICKSTART.md) · [Tiếng Việt](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/QUICKSTART.md) · [简体中文](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/QUICKSTART.md) TgWitness — це автономний додаток для спостереження за групами та каналами Telegram, доступ до яких мають ваші акаунти. Він працює локально з власним каталогом даних. **Вперше на сайті?** [Ознайомтеся з демо-версією,](https://phishdestroy.io/tgwitness/uk/docs/reference/quickstart/#explore-the-interface) перш ніж підключити обліковий запис. [Оберіть посібник](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) щодо проксі-серверів, свідків, експорту або налаштування сервера. [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) (попередній перегляд) запускає процес збору даних у вашому власному форку GitHub замість локальної інсталяції. ## Встановити та запустити Інсталятор із покроковими інструкціями містить власний Python і перевіряє хеші пакетів та підписи версій перед інсталяцією. Повторний запуск оновлює існуючу інсталяцію. **Linux / macOS:** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` **Windows (PowerShell або командний рядок):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` На сервері Ubuntu запустіть програму з правами root, щоб встановити фонову службу; на настільному комп’ютері запустіть програму як звичайний користувач. У Ubuntu інсталятор виводить адресу панелі та ключ доступу; у macOS та Windows локальна панель відкривається у вашому браузері. Продовжуйте з розділу **Підключення до Telegram** нижче. [Розділ Встановлення, перевірка та оновлення](https://phishdestroy.io/tgwitness/uk/docs/reference/installation/) охоплює варіанти доступу до сервера, перевірку скрипта перед його запуском, оновлення та видалення. ### Інші методи Випуски на GitHub, вихідний код та Docker є альтернативами інсталятору. Портативні версії для завантаження стають доступними після публікації релізної збірки: | Хостинг | Нічого не встановлено | З джерела: Python 3.11+ | Docker: Engine/Desktop із Compose 2.20+ | | --- | --- | --- | --- | | Windows | Витягніть `TgWitness--windows-amd64-portable.zip` з GitHub Releases, двічі клацніть на `TgWitness.cmd` | Двічі клацніть на `Start.cmd` | Двічі клацніть на `scripts\Docker.cmd` | | Linux / macOS | — | `sh start.sh` | `sh scripts/docker-start.sh` | Для способів запуску з вихідного коду [завантажте та розпакуйте поточну гілку `main`](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip) або клонуйте репозиторій: ``` git clone https://github.com/phishdestroy/TgWitness.git cd TgWitness ``` `Start.cmd` пропонує встановити Python 3.12 для вашого користувача Windows, якщо відповідний Python не знайдено (через winget або підписаний інсталятор з python.org). `start.sh` виводить точну команду встановлення для вашого дистрибутива Linux або macOS, якщо Python відсутній. Перший запуск із вихідного коду автоматично створює `.venv` і встановлює залежності. Docker компілює додаток і запускає його у фоновому режимі; Python на хості не потрібний. Команди `scripts\Docker.cmd` та `scripts/docker-start.sh` виводять адресу панелі та токен, коли контейнер працює нормально. Відповідні команди Docker для кожного підтримуваного хоста: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` Відкрийте **http://127.0.0.1:8787**. Використовуйте токен, виведений допоміжною програмою Docker або другою командою Docker, або прочитайте **файл data/live/panel-token.txt** для портативної або вихідної інсталяції. Продовжуйте з розділу **«Підключити Telegram»** нижче. Нативні та Docker-інсталяції використовують окремі сховища; запуск Docker не імпортує існуючий нативний журнал. Для сервера [розгортання](https://phishdestroy.io/tgwitness/uk/docs/reference/deployment/) охоплює автоматичне налаштування HTTPS, перезапуск, публікацію зображень, оновлення та резервне копіювання. ## Ознайомтеся з інтерфейсом 1. Запустіть **файл TgWitness-Demo.cmd** у портативному пакеті, **scripts\Demo.cmd** у папці з вихідним кодом для Windows або `sh start.sh --demo` у Linux/macOS. Запуск з вихідного коду спочатку створює файл `.venv` та встановлює залежності. 2. Відкрити **http://127.0.0.1:8787**. 3. Локальна демоверсія автоматично відкриває зразок журналу. Для прямого локального доступу копія токена не потрібна. Демонстраційні повідомлення є вигаданими. У демонстраційному режимі неможливо підключити реальний обліковий запис Telegram. ## Підключити Telegram > [!ПОПЕРЕДЖЕННЯ] **Використовуйте спеціальні облікові записи.** Telegram може обмежити або назавжди заблокувати облікові записи за обсяги запитів, які він вважає надмірними, незалежно від клієнта. Підключайте облікові записи, підготовлені для спостереження, а не особисті чи цінні, та створюйте API-ідентифікатор / хеш на спеціальному обліковому записі. 1. Якщо запущено вбудовану демо-версію, зупиніть її та запустіть **Start.cmd** або `sh start.sh`. В іншому випадку залиште запущеною інсталяцію, яку було запущено вище. 2. Використовуйте токен панелі для входу. Відкриється новий робочий простір [для початкового налаштування](https://phishdestroy.io/tgwitness/uk/docs/reference/settings/). Оберіть **Просто завантажити**, **Стежити за чатами** або **Докази для справи**. 3. Перевірте налаштування з’єднання. За потреби налаштуйте власний проксі; налаштування з’єднання залишаються доступними після налаштування. 4. У **Connect Telegram** виберіть номер телефону, QR-код, файли облікового запису (TData, `.session`, StringSession, JSON-файл облікового запису) або повний ключ авторизації. За запитом введіть підтвердження Telegram, код та пароль двоступеневої аутентифікації. 5. Перевірте відображений обліковий запис, виберіть чати та перегляньте налаштування. Завершіть на останньому екрані. У разі вибору **Просто завантажити** **кнопка Почати експорт** запускає одноразовий експорт і відкриває вікно Експорти, щоб показати його хід; це не вмикає безперервне спостереження. Після налаштування пункт **Чати → Вибрати** змінює вибрані чати. **У розділі Налаштування** керують збиранням та файлами; **Додаткові інструменти → Джерела** надає детальний список джерел на стандартному або експертному рівні. [Посібник із панелі](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/) описує шість основних розділів та їхні контекстні елементи керування. **API ID + Hash** є необов’язковими: робоча область використовує свою збережену або імпортовану пару, або робочу пару з вбудованого пулу. Щоб використовувати власний додаток, вставте одну пару `API ID:API Hash` у поле API ID. У поле **Auth key** вставте всі 512 шістнадцяткових символів та виберіть наданий DC ID. User ID є необов’язковим і перевіряється, якщо введено. Повноваження API ідентифікують ваш додаток; вони самі по собі не надають авторизацію облікового запису. Приватні групи не потребують публічного імені користувача, але ваш обліковий запис повинен мати доступ. Для існуючих облікових записів див. [формати облікових записів та сесій](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/): панель підтримує Telethon StringSession, Telethon/Pyrogram SQLite, TData ZIP для одного облікового запису та JSON-файли підтримуваних облікових записів. Оберіть сесію та відповідний JSON-файл разом, натисніть **Перевірити файли**, а потім **Підключити обліковий запис**. Вхід за допомогою QR-коду також доступний із тими самими опціональними налаштуваннями API. TDLib, сесії ботів та списки облікових записів у форматі CSV/JSON не підтримуються. Для кількох облікових записів використовуйте **Облікові записи → Імпорт облікових записів** і виберіть підтримувані файли сесій. Супровідні JSON-файли зіставляються за базовим ім'ям файлу; кожен імпортований обліковий запис отримує власний робочий простір. Див. [масовий імпорт і групи облікових записів](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#bulk-import-and-account-groups). Щоб додати ще один обліковий запис, натисніть **+** поруч із селектором облікових записів або скористайтеся меню **Облікові записи → Додати обліковий запис**. Робочі простори мають окремі сесії, журнали, ключі, джерела та черги. Перемикання між видами не зупиняє роботу інших колекторів. Один і той самий обліковий запис Telegram не можна прив’язати до двох робочих просторів у цій інсталяції. Кількість робочих просторів не обмежена; вони використовують один процес, тому пропускна здатність залежить від потужності комп’ютера. Токен панелі в режимі реального часу захищає доступ до ваших авторизаційних даних Telegram та збережених матеріалів; він є окремим від облікових даних API Telegram. Автоматичний запис здійснюється лише для явно запущеної, локальної демоверсії, до якої здійснюється прямий доступ. Віддалена або проксі-демоверсія все ще використовує `data/demo/panel-token.txt`. ## Перегляд та експорт - **Журнал:** пошук та фільтрування спостережень за джерелом та типом події. - Виберіть подію, щоб переглянути її оригінальний запис, атрибуцію та збережені версії. - Деталі редагування показують доступний вміст до та після редагування. Деталі видалення показують останній зафіксований вміст, якщо такий є; невідомий учасник залишається невідомим. - **Експорт:** підписані файли у форматах ZIP, JSONL, CSV та офлайн-HTML. - **Повний експорт чату** (**Чати → Експортувати чат** або **Експорт → Зафіксувати чи експортувати один чат**): завантажте всю видиму історію одного чату у вигляді підписаного пакету з файлом `chat.json` (у стилі Telegram-export) та читабельного файлу `chat.html`. Приватні чати працюють, якщо обліковий запис є учасником. Це поточний знімок, а не реконструкція видалених або раніше відредагованих повідомлень. Перевірте копію за допомогою команди `python verify.py chat-export.zip --fingerprint TRUSTED_SHA256`. - **Контрольна точка:** межа підписаного журналу має залишатися поза межами колектора. - **Завантажити підписану квитанцію про виконання:** зберегти запис про програму/версію колектора. - **Підготовка запиту на отримання часової мітки:** підготуйте офлайн-запит до сервісу часових міток; дотримуйтесь інструкцій у файлі [TIMESTAMP.md](https://phishdestroy.io/tgwitness/uk/docs/reference/timestamp/) для отримання та перевірки відповіді. - **Перевірка журналу:** перевірка підписів подій та ланцюжків. Експорт у форматі ZIP також перевіряє мультимедійні файли. Підтримувані браузери зберігають великі експортні файли безпосередньо у вибраний файл. Інші браузери буферизують не більше 128 МіБ. Поки сервер працює, CLI для потокового передавання підтримує завантаження більших обсягів без буферизації всього відповідного потоку: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Для іншого робочого простору додайте `--profile ID`, скориставшись **меню Експорт → Ідентифікатор робочого простору**. Для віддаленого сервера додайте `--url https://your-server`. Ліміт передачі за замовчуванням становить 5 ГіБ; його можна змінити за допомогою `--max-mib`. Підписаний вміст ZIP-архіву має окремий ліміт перевірки в 4 ГіБ у розпакованому вигляді за замовчуванням (**пункт Додаткові інструменти → Параметри** дозволяє його збільшити; перевіряйте такі архіви за допомогою `verify.py --max-gib N`). Перевіряйте архів за допомогою надійної копії верифікатора, незалежно збереженого відбитка ключа та, як мінімум для підтвердження, кореневого сертифіката служби міток часу (`--tsa-ca`). ## Перевірте установку ``` python start.py --setup-only python start.py --check python start.py --check --json ``` `--check` перевіряє локальні залежності, підтримку підпису, сховище, конфігурацію ключів та адресу прослуховування. Він нічого не встановлює та не підключається до Telegram. Зайнятий порт може означати, що працює інший екземпляр. Скористайтеся іншим `--port` або спочатку зупиніть його. Програма запуску встановлюється в `.venv`. Допоміжні команди `python -m tgwitness...` повинні використовувати `.venv\Scripts\python.exe` у Windows або `.venv/bin/python` у Linux/macOS, якщо це середовище ще не активовано. ## Сесії, захист та експлуатація Закритий, узгоджений файл Telethon SQLite `.session` можна конвертувати локально за допомогою команди `python -m tgwitness.sessions account.session --out account.tgwitness-session`, а потім завантажити в розділі **Додаткові інструменти → Обліковий запис → Файли**. Також доступні прямий імпорт файлів та вхід за допомогою QR-коду. Формати входу, SOCKS5, HTTP CONNECT, MTProxy та зовнішні головні ключі див. у файлі [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/). **Призупинення спостереження** зупиняє збір даних. **Блокування** лише закриває доступ через браузер. Закриття вкладки не зупиняє процес збору даних. Зупинка процесу перериває збір; знімок історії не дозволяє відтворити всі пропущені редагування чи видалення. Дізнайтеся, [як працює збір даних](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/) у контексті політик подій, черг вкладень, ізоляції облікових записів та поведінки при перезапуску. Сесії та секретні дані шифруються. Вміст повідомлень, мультимедіа та експортовані дані вимагають шифрованого диска або тома. Перевіряйте підписи журналу за допомогою надійного ключа та зберігайте контрольні точки окремо. Переглядайте записи збору даних, зовнішні квитанції часу та підтвердження середовища для обраного режиму збору. Ознайомтеся з [файлом OPERATIONS.md](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/) щодо резервного копіювання/відновлення, [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/uk/docs/reference/deployment/) щодо розміщення, а також з [розділом deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) для прикладів використання. Встановлена панель також містить посібник з налаштування в автономному режимі за адресою `/guide.html`. Фактичні результати перевірки та існуючі обмеження зафіксовані у [файлах VERIFICATION.md](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/) та [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md). --- # Встановлення, перевірка та оновлення Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/installation/ Встановіть за допомогою однієї команди, перевіряйте підписи та хеші, оновлюйте та видаляйте інсталяцію. [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/quickstart/) ![Початок роботи](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Проєкт](https://github.com/phishdestroy/TgWitness/blob/main/README.md) · [Швидкий старт](https://phishdestroy.io/tgwitness/uk/docs/reference/quickstart/) · [Розгортання](https://phishdestroy.io/tgwitness/uk/docs/reference/deployment/) **На цій сторінці** - [Встановити однією командою](https://phishdestroy.io/tgwitness/uk/docs/reference/installation/#install-with-one-command) - [Де все працює](https://phishdestroy.io/tgwitness/uk/docs/reference/installation/#where-everything-runs) - [Налаштування повнотекстового пошуку](https://phishdestroy.io/tgwitness/uk/docs/reference/installation/#full-text-search-settings) - [Доступ через командний рядок](https://phishdestroy.io/tgwitness/uk/docs/reference/installation/#command-line-access) - [Перевірити перед запуском](https://phishdestroy.io/tgwitness/uk/docs/reference/installation/#verify-before-running) - [Оновлення існуючої інсталяції](https://phishdestroy.io/tgwitness/uk/docs/reference/installation/#update-an-existing-installation) - [Повсякденні команди в Ubuntu](https://phishdestroy.io/tgwitness/uk/docs/reference/installation/#everyday-commands-on-ubuntu) - [Видалити TgWitness](https://phishdestroy.io/tgwitness/uk/docs/reference/installation/#remove-tgwitness) ## Встановіть за допомогою однієї команди Офіційний сервіс завантаження проєкту, `get.destroy.tools`, надає інсталятор із покроковими інструкціями та його підписані файли випуску. Він містить приватне середовище виконання Python і перевіряє хеші пакетів та підписи випусків перед інсталяцією. Кожна публікація одночасно оновлює скрипти входу, хеші, підписи та інформацію про збірку; кожна збірка також має незмінний URL-адресу випуску. Оберіть інсталятор із покроковими вказівками для швидкого налаштування або скористайтеся [релізами на GitHub, вихідним кодом чи Docker](https://phishdestroy.io/tgwitness/uk/docs/reference/quickstart/) . Це підтримувані шляхи інсталяції для цього ж проєкту з відкритим кодом. Для розгортання, яке вимагає затвердження конкретної збірки перед виконанням, скористайтеся [функцією Перевірити перед запуском](https://phishdestroy.io/tgwitness/uk/docs/reference/installation/#verify-before-running) із незалежно збереженим відбитком ключа релізу та незмінним URL-адресою збірки. Оновлення служби завантаження не призводить до автоматичного оновлення встановленої панелі. **Linux / macOS (Bash):** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` На сервері Ubuntu запустіть програму з правами root, щоб встановити фоновий сервіс. На настільному комп’ютері запустіть програму як звичайний користувач. **Windows (PowerShell або командний рядок):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` У Windows адміністратор не потрібен. Дочірній процес PowerShell залишає ваш термінал відкритим із результатом. Python та залежності залишаються в інсталяційному пакеті. У Ubuntu виберіть **«Цей комп’ютер**», **«Тимчасове HTTPS-посилання**» або **«Власний домен**». Інсталятор виведе адресу панелі та ключ доступу. Для отримання тимчасового посилання відкрийте цю HTTPS-адресу у браузері та введіть ключ. У разі локального доступу до віддаленого сервера скористайтеся переадресацією SSH зі свого комп’ютера (`ssh -L 8787:127.0.0.1:8787 user@server`) та відкрийте `http://127.0.0.1:8787`. У macOS та Windows локальна панель відкривається у вашому браузері; залиште термінал увімкненим. Увійдіть у Telegram на панелі та виберіть, що збирати. Сама лише інсталяція не запускає збір даних із Telegram. ## Де все працює `get.destroy.tools` **Cloudflare Worker для обслуговування статичних завантажень**. У нього немає панелі TgWitness, сеансу Telegram або бази даних доказів користувачів. Він не підключений до VPS проекту. Додаток працює на тій машині, де ви виконуєте команду. | Встановлення | Програма | Дані | | --- | --- | --- | | Ubuntu з правами суперкористувача | `/opt/tgwitness` | Системна служба: `/var/lib/tgwitness-`; використовуйте `tgwitness paths` для точного шляху. | | Користувач Linux / macOS | `~/.local/share/tgwitness` | `data/live` у рамках цієї інсталяції. | | Користувач Windows | `%LOCALAPPDATA%\TgWitness` | `data\live` у рамках цієї інсталяції. | Налаштуйте `TGWITNESS_INSTALL_DIR` , щоб вибрати іншу папку. Встановлені версії та дані зберігаються окремо. Інсталятор не завантажує ваші акаунти, повідомлення чи ключі на сайт завантаження. Вибір тунелю Cloudflare направляє трафік панелі через Cloudflare; використання власного домену спрямовує трафік на ваш власний сервер. З параметром `TGWITNESS_TRUSTED_PROXIES` панель приймає єдиний запис `X-Forwarded-Proto: https` від довіреного проксі-сервера для встановлення безпечних файлів cookie завантаження. Кожна інсталяція містить **файли START-HERE.html** та **START-HERE.txt** із локальними шляхами, командами та посиланнями на репозиторій. Запустіть `tgwitness guide` , щоб відкрити посібник. У Windows використовуйте `& "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide` у PowerShell. ## Налаштування повнотекстового пошуку [Повнотекстовий пошук](https://phishdestroy.io/tgwitness/uk/docs/reference/search/) (попередній перегляд) не потребує налаштування. Його індекс формується у фоновому режимі після оновлення. | Змінна або команда | Ефект | | --- | --- | | `TGWITNESS_FULLTEXT=disk` | За замовчуванням: індекс зберігається в `search/fulltext.sqlite3` кожного робочого простору | | `TGWITNESS_FULLTEXT=memory` | Індексний файл відсутній; індекс перебудовується при кожному запуску | | `TGWITNESS_FULLTEXT=off` | Без індексу; лише пошук за точним текстом | | `tgwitness index status` | Стан індексу кожного робочого простору | | `tgwitness stop`, `tgwitness index rebuild`, `tgwitness start` | Перебудуйте кожен індекс із підписаного журналу | Вибір адміністратора в меню **«Журнал» → «Фільтри» → «Індекс пошуку»** має пріоритет над змінною для цього робочого простору. Команди знаходять каталог даних тієї інсталяції, в якій вони виконуються; в інших випадках додайте `--data-dir` шлях із `tgwitness paths`. Для повного українського словника (дані під ліцензією GPL-3.0) встановіть `pymorphy3-dicts-uk` у середовищі Python цієї інсталяції. ## Доступ через командний рядок [Командний рядок](https://phishdestroy.io/tgwitness/uk/docs/reference/cli/) (попередній перегляд) зчитує архів для скриптів та агентів. | Змінна | Ефект | | --- | --- | | `TGWITNESS_URL` | Адреса панелі для `tgwitness search`, `context`, `messages`, `stats` та `export`; за замовчуванням `http://127.0.0.1:8787` , коли встановлено токен | | `TGWITNESS_MCP_TOKEN` | Токен підключення до архіву з **Додаткові інструменти → Інтеграції → MCP**, спільний для клієнтів MCP; `--token-file` зчитує його з файлу замість цього | | `TGWITNESS_DATA` | Каталог даних читається безпосередньо, якщо не вказано `--data-dir`, URL-адреси або токена | ## Перевірте перед запуском Інсталятор вбудовує відкритий ключ релізу проєкту та перевіряє підписи SHA-256 і RSA на пакеті додатка та блоці залежностей перед їх інсталяцією. І Bash, і PowerShell зупиняються, якщо необхідна перевірка завершується невдало. Початковий скрипт доставляється через HTTPS і має власний відокремлений підпис; наведені нижче команди також дозволяють перевірити цей скрипт перед його виконанням. Публічний ключ випуску — [release-signing.pub](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/release-signing.pub). Його SHA-256: ``` 039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d ``` Збережіть цей відбиток із версії репозиторію, якій ви довіряєте. Контрольна сума з того самого сервера завантаження виявляє невідповідність; незалежний, перевірений відкритий ключ — це те, що підтверджує автентичність підпису релізу. Використовуйте новий порожній каталог для завантажень, необхідних для верифікації, наведені нижче. **Linux / macOS — запускайте в новому, порожньому каталозі для завантажень** (потрібні curl та OpenSSL): ``` curl -fSLO https://get.destroy.tools/install.sh && curl -fSLO https://get.destroy.tools/install.sh.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh && bash install.sh ``` Ланцюг `&&` ланцюг зупиняється перед виконанням, якщо завантаження, перевірка відбитка ключа або підпису закінчується невдачею. Якщо публікація відбувається між завантаженням скрипта та його підписом, завантажте обидва знову. Старі інсталятори зберігають незмінні URL-адреси пакетів. **Windows — перед запуском перевірте SHA-256:** ``` Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing Get-FileHash .\install.ps1 -Algorithm SHA256 Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt ``` Порівняйте хеш із `install.ps1` рядком. Для незалежної перевірки підпису використовуйте OpenSSL (наприклад, із Git Bash) та той самий відбиток відкритого ключа, що наведено вище: ``` curl -fSLO https://get.destroy.tools/install.ps1 && curl -fSLO https://get.destroy.tools/install.ps1.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 && powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1 ``` Сама система Windows перевіряє підписи пакетів за допомогою .NET і не потребує OpenSSL. Це відокремлені підписи RSA-3072 / SHA-256, а не Authenticode. [Маніфест](https://get.destroy.tools/manifest.json) містить версію програмного забезпечення, точний коміт Git, незмінний ідентифікатор випуску та SHA-256 кожного артефакту. Сторінка містить посилання на відповідне джерело. Маніфест і список контрольних сум також мають відокремлені підписи (`manifest.json.sig` та `SHA256SUMS.txt.sig`). ## Оновлення існуючої інсталяції **Нова публікація оновлює сайт завантаження; встановлені програми оновлюються, коли ви запускаєте інсталятор знову.** Не існує автоматичного оновлення або автоматичного перезапуску колекції, що працює. Поточний канал інсталятора — це **попередній перегляд**; він слідує за опублікованими, перевіреними збірками з `main`, коміт яких може бути новішим за останній пронумерований реліз на GitHub. Версія сторінки походить з `pyproject.toml`; її коміт та ідентифікатор збірки дозволяють розрізняти оновлення в межах однієї попередньої версії. Публікація відбувається автоматично після того, як саме це коміт пройде перевірку додатка та безпеки, а підписаний пакет буде автентифіковано, встановлено та перевірено на Ubuntu та Windows. Запити на злиття, що змінюють інсталятор, також двічі запускають `install.sh` та `install.ps1` на локальній копії сайту. Під час виконання перевірок або у разі їхньої невдачі ці самі команди продовжують встановлювати попередню перевірену збірку. Маніфест збірки показує, який коміт наразі доступний; сам номер версії може залишатися незмінним між оновленнями попереднього перегляду. Використовуйте ту саму папку інсталяції та того самого користувача ОС, що й раніше. Створіть резервну копію всього каталогу даних після зупинки збору даних; `tgwitness paths` що дозволяє його ідентифікувати. Підписаний експорт не є повною резервною копією інсталяції. **Встановлення з правами суперкористувача в Ubuntu за адресою `/opt/tgwitness`:** ``` curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start ``` Після успішної інсталяції: ``` /opt/tgwitness/bin/tgwitness restart /opt/tgwitness/bin/tgwitness status /opt/tgwitness/bin/tgwitness open ``` Для встановлення на Linux/macOS використовуйте оригінальний `TGWITNESS_INSTALL_DIR` або за замовчуванням і знову виконайте першу команду встановлення. Перед оновленням закрийте панель, що працює у фоновому режимі, а після цього запустіть її знову. Для налаштованої служби користувача Linux виконайте відповідну `tgwitness restart` команду. **Windows:** закрийте запущену панель, знову запустіть команду встановлення для Windows, а потім відкрийте `bin\tgwitness.cmd` у тій самій інсталяції. Інсталятор зберігає дані, сесії, налаштування доступу та ключі підпису. Він замінює запускач лише після того, як нове середовище пройде перевірки; у разі невдалої інсталяції попередній запускач залишається на місці. Зберігайте резервну копію, створену перед оновленням, на випадок змін формату зберігання. ## Повсякденні команди в Ubuntu | Команда | Результат | | --- | --- | | `tgwitness open` | Поточна URL-адреса панелі та ключ доступу. | | `tgwitness paths` | Точні шляхи до програм, даних та інструкцій. | | `tgwitness guide --print` | Інструкція з роботи в автономному режимі. | | `tgwitness status` / `tgwitness logs` | Журнали доступності / обслуговування. | | `tgwitness stop` / `tgwitness start` | Зупинка / відновлення роботи сервісу; збереження даних. | | `tgwitness token rotate` | Замініть ключ адміністратора та завершіть сесії браузера. | | `tgwitness tunnel off` | Вимкніть публічний швидкий тунель; залиште локальну панель. | | `tgwitness tunnel on` / `tgwitness tunnel restart` | Створити посилання на швидкий тунель / замінити його адресу. | Дивіться розділ [«Доступ»](https://phishdestroy.io/tgwitness/uk/docs/reference/access/) щодо токенів колег, сеансів та обмежень за IP-адресами, а також розділ [«Публікація інсталятора»](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/README.md#automatic-publication-from-github) щодо робочого процесу випуску з GitHub до Cloudflare. ## Видалити TgWitness Деінсталятора немає: потрібно зупинити роботу панелі та видалити її папки. Видалення папки з даними остаточно знищує журнали, ключі підпису, сесії Telegram та збережені файли. Перед цим: 1. Експортуйте те, що вам потрібно (**Експорт → Завантажити підписаний ZIP**), а відбиток ключа підпису та контрольні точки зберігайте поза цією машиною. Щоб зберегти саму робочу область, скопіюйте всю папку з даними, зупинивши збір даних. 2. Видаліть сервери, створені в меню **Більше інструментів → Додаткові → «Сервер 24/7»,** з розділу **Ваші сервери** або за допомогою команди `python -m tgwitness.cloud destroy`; провайдер продовжує виставляти рахунки за них, доки вони не будуть видалені. 3. Завершіть сесію кожного облікового запису в Telegram у **меню «Налаштування» → «Пристрої**». Видалення файлів не призводить до виходу з сесії на стороні Telegram. **Встановлення з правами суперкористувача в Ubuntu.** Зверніть увагу на папку з даними, зупиніть службу, а потім видаліть службу, папки та ярлик: ``` /opt/tgwitness/bin/tgwitness paths /opt/tgwitness/bin/tgwitness stop systemctl list-unit-files 'tgwitness-*' systemctl disable tgwitness- rm /etc/systemd/system/tgwitness-.service systemctl daemon-reload rm -rf /opt/tgwitness /var/lib/tgwitness- /usr/local/bin/tgwitness ``` **Встановлення для користувачів Linux або macOS.** Закрийте панель. Налаштована служба користувача Linux зупиняється за допомогою `systemctl --user disable --now tgwitness-`; його модуль знаходиться в `~/.config/systemd/user/`. Потім видаліть `~/.local/share/tgwitness` (або ваш `TGWITNESS_INSTALL_DIR`) та `~/.local/bin/tgwitness` ярлик. **Windows.** Закрийте панель і видаліть `%LOCALAPPDATA%\TgWitness` (або свій `TGWITNESS_INSTALL_DIR`). Інсталятор не додає жодних служб, запланованих завдань чи ярликів. --- # Telegram · Перше налаштування та параметри Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/settings/ Майстер налаштування, цілі, рівні інтерфейсу, маршрути підключення та налаштування, спільні для групи облікових записів. [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/quickstart/) ![Початок роботи](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Акаунти](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/) · [Зв’язок](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/) · [Доступ](https://phishdestroy.io/tgwitness/uk/docs/reference/access/) Відкриється нове робоче вікно `/first-run`. На першому екрані вас запитають, що ви хочете зробити: **«Просто завантажити**», **«Стежити за чатами**» або **«Докази для справи**». Вибір визначає мету та рівень інтерфейсу: «Простий» для «Просто завантажити», «Стандартний» — для інших двох варіантів. Рівень визначає, скільки полів відображається в кожній формі; кожна сторінка залишається в меню. **Додаткові параметри** на цьому ж екрані дозволяють явно встановити рівень, тему та часовий пояс; список мов знаходиться у заголовку майстра. Наступні екрани стосуються підключення, Telegram та чатів. Маршрути підключення залишаються згорнутими під час автоматичної перевірки та відкриваються, якщо вона завершується невдало. П’ятиступенева смуга прогресу повертає до завершених етапів. Кожна відповідь зберігається на сервері одразу після зміни, тому перезавантаження продовжує той самий крок. Останній екран містить перелік відповідей і дозволяє повернутися до будь-якої з них. Мова, часовий пояс IANA, тема та рівень зберігаються окремо для кожного оператора та робочого простору. За замовчуванням використовуються мова браузера, часовий пояс пристрою, системна тема та простий інтерфейс. Зміна мови не впливає на сесію панелі. Час у підписаному журналі ніколи не змінюється. `/settings` редагує ті самі записи, що й майстер. Пошук охоплює основні поля, параметри та розширені форми; приховане поле можна відкрити, не змінюючи рівень. Рівні впливають лише на те, що показано: права доступу сервер перевіряє сам. Розділ, усі налаштування якого вищі за вибраний рівень, однаково їх показує. Налаштування збору та перше підключення належать адміністраторові робочого простору. Сторінка налаштувань — це список. Картка облікового запису вгорі відкриває **Акаунт у Telegram**. Нижче кожен рядок називає розділ і поточне значення: **Які чати?** і **Підключення** у групі **Обліковий запис**; **Мета**, **Запис і файли**, **Захист запису** і **Сповіщення й зовнішня копія** у групі **Запис**; **Мова, час і вигляд** у групі **Панель**; експертні сторінки — у групі **Інші інструменти**. Поруч зі списком картка показує, чи ввімкнено рекомендовані значення, з основними значеннями та кнопкою **Скасувати останню зміну**, а **Останні зміни** перелічує останні правки. Розділ відкривається у вікні над списком і має власну адресу, наприклад `/settings/connection`. Стрілка «Назад», кнопка закриття, клавіша Escape, клік поза межами вікна та кнопка «Назад» у браузері повертають до списку. **Вибір Які чати?** зберігається за допомогою **функції Зберегти вибір чатів**; при закритті з незбереженими змінами спочатку з’являється запит. Збереження зберігає типи джерел , виключені чати, власні дії та налаштування нового чату з **Додаткові інструменти → Джерела → Область дії**; чат, обраний тут, вилучається зі списку виключених чатів і записується як вручну обране джерело. Кожна зміна відображає **кнопку Скасувати** протягом 20 секунд, і кожен запис у **Останніх змінах** можна скасувати пізніше. Скасування відновлює лише ті налаштування, які змінив цей запис, включаючи користувацькі обмеження розміру файлів. Якщо пізніша зміна торкнулася тих самих налаштувань, скасування відхиляється і нічого не змінюється. Скасування — це новий запис `settings.changed` у журналі. | Рівень | Поля | Бічна панель | | --- | --- | --- | | Просто | Тільки найнеобхідніше | Головна, Чати, Журнал, Експорт, Облікові записи та Налаштування | | Стандарт | Загальні налаштування з поясненнями | Додано розділи Дошка справ, Джерела, Доступ та Документація у розділі Інші інструменти | | Експерт | Усі поля, обмеження та технічні деталі | Також додано Карту системи, Топологію мережі, Додаткові функції, Запитати архів, Параметри, Обліковий запис, Системний журнал та Інтеграції у розділі Додаткові інструменти | Назви розділів залишаються незмінними на кожному рівні. Відкрийте Вигляд у нижній частині бічної панелі, щоб змінити рівень. У [довіднику панелі](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/) описано кожен розділ. ## Цілі | Мета | Колекція | Файли | Зовнішні сервіси | Адреса сервера | | --- | --- | --- | --- | --- | | Просто завантажити | Одноразовий експорт починається з екрана остаточного налаштування; безперервний збір залишається вимкненим | Фотографії розміром до 20 МБ | Часові мітки | Автоматично | | Підписка на чати | Безперервно | Фотографії та відео тривалістю до 60 секунд / розміром до 20 МБ | Часові мітки та сповіщення про проблеми | Автоматично | | Докази у справі | Безперервно | Усі файли розміром до 1 ГБ | Часові мітки, drand, сповіщення | Ні, приховати | Для збереження доказів рекомендується використовувати позасерверну копію, бота-свідка та перевірку коду. Адреси сховища та сповіщень спочатку потребують вказання пункту призначення. Функція, яка взаємодіє із зовнішнім сервісом, запитує дозвіл на запити поза межами Telegram; вимкнення цієї функції пропонує одночасно вимкнути мітки часу, сповіщення та позасерверну копію. Зміна цільового значення спочатку показує різницю, а зміни, внесені вручну, можна зберегти. Поле, яке відрізняється від цільового значення, позначається як **«Змінено вами»** і може бути відновлене. Ревізія налаштувань запобігає застосуванню переглянутої різниці замість зміни, внесеної в іншій вкладці. ## Зв’язок Доки тут не буде обрано маршрут, у новій робочій області використовується **Автоматичний MTProxy · загальнодоступні списки** з опцією **Приховати адресу** ([безпека з’єднання](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/)). Вибір опції **Автоматично,** наведений нижче, є окремим етапом налаштування. **Automatic** спочатку пробує WARP, потім публічні сервери MTProxy, а потім — пряме з’єднання, причому останнє — лише тоді, коли адреса сервера може бути показана. Automatic та WARP можуть встановлювати компоненти з перевіркою хеш-сум та реєструвати сервер у Cloudflare; без такої згоди Automatic пропускає WARP. WARP використовує існуючий менеджер wgcf/wireproxy та локальний SOCKS5- порт; таблиця маршрутизації системи не змінюється. **Масове імпортування** запитує маршрут до того, як будь-яка сесія досягне Telegram: WARP (за замовчуванням), публічний MTProxy або прямий. Перевірка сесії використовує той самий тип маршруту, і кожен імпортований обліковий запис отримує власний тунель WARP перед першим входом у систему. Ваш власний проксі-сервер приймає `tg://proxy`, `socks5://`, `http://` та `https://`. Сертифікат HTTPS- проксі перевіряється перед тим, як до нього надсилаються облікові дані. Перевірка з’єднання дійсна протягом п’яти хвилин і прив’язана до маршруту, політики та відповідей майстра; зміна будь-якого з цих параметрів вимагає нової перевірки. Можна **продовжити без перевірки**, але це не замінює вхід у Telegram. Обраний маршрут перевіряється повторно у фоновому режимі, а функція «Автоматично» знову запускає свій ланцюжок після втрати з’єднання. Коли жоден публічний проксі не відповідає, лічильник стає червоним із позначкою WARP та діями повторної перевірки. ## Групи облікових записів Акаунти в групі використовують спільні налаштування. Відкрийте **«Акаунти» → «Групи та спільні налаштування» → «Спільні налаштування**» або **«Налаштування групи**» на сторінці налаштувань акаунта. Група спільно використовує мету, збережені файли, часові мітки, drand, сповіщення про проблеми, зовнішню копію, запити поза Telegram, режим IP, перелік елементів для запису, графік повторної перевірки, правила сповіщень, налаштування звітів, параметри та маршрут з’єднання. Адреси для сповіщень, облікові дані проксі та дані для входу зберігаються окремо для кожного облікового запису, так само як і запуск та призупинення збору даних. - Кожен учасник підписується на групу. У налаштуваннях можна встановити значення 🔗 **З групи** або ✏️ **Власне значення**; **Повернути значення групи** — повертає попереднє значення. - Зміна містить перелік облікових записів, яких вона стосується (**стосується 2 з 3 облікових записів**), і запитує кожен обліковий запис окремо перед заміною власного значення. Облікові записи, для яких галочка не встановлена, зберігають свої значення. - Параметр, яким група не ділиться, залишається у стані **«Не поділено»: кожен обліковий запис зберігає своє власне значення,** доки ви не натиснете **«Поділитися цим значенням**». - **Копіювання налаштувань з одного облікового запису** призводить до того, що значення вибраного облікового запису стають значеннями групи. - Акаунту, перенесеному до групи, ставиться запитання: **«Прийняти налаштування групи?».** Якщо ні, він зберігає свої власні налаштування, позначені ✏️. Акаунти, додані пізніше, починають із налаштувань групи. - Акаунт-спостерігач зберігає свій IP-режим, доки його не буде призупинено. Кожна зміна фіксується у підписаному журналі головної робочої області та кожного учасника, до якого вона доходить. Видалення групи зберігає її акаунти та їхні поточні значення. Сторінка групи `/groups/` показує учасників, те, що потребує уваги, та чати, які бачать кілька облікових записів. Див. [групи облікових записів](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#bulk-import-and-account-groups). ## Існуючі робочі простори У робочій області, де відкрито сеанс або раніше було завершено налаштування, майстер не відображається. Його значення не замінюються ціллю під час завантаження сторінки. Приховування поля не відключає цю функцію та не видаляє його значення. **Відкриття першої настройки** в розділі «Налаштування» знову показує ті самі екрани; їх завершення не запускає новий експорт чи спостереження, про що з’являється відповідне повідомлення, а змінений вибір чату зберігається лише після натискання кнопки **Зберегти вибір чату**. Оцінка розміру та часу охоплює до трьох вибраних чатів і до 20 повідомлень з кожного. Це лише приблизні дані: вони не враховують обмеження Telegram, швидкість конкретного сервера або файли в кожному чаті. --- # Telegram · Формати облікових записів та сеансів Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/ Увійдіть за допомогою телефону, QR-коду або ключа автентифікації, імпортуйте сесії з Telethon, Pyrogram або Telegram Desktop та керуйте кількома обліковими записами. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Translation coverage: this edition includes material from the English original. Увійдіть за допомогою телефону, QR-коду або ключа автентифікації, імпортуйте сесії з Telethon, Pyrogram або Telegram Desktop та керуйте кількома обліковими записами. [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/quickstart/) ![Початок роботи](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) TgWitness входить у систему як облі**ковий запис користувача Telegram** (а не як бот) через MTProto, використовуючи Telethon. Кожен обліковий запис розміщується у власному робочому **просторі** (який у API та інструментах командного рядка називається *«workspace*») із власною сесією, джерелами, журналом та ключем підпису. Файли сеансів, рядки сеансів та ключі автентифікації є **засобами авторизації облікового запису**: той, хто володіє ними, може діяти від імені цього облікового запису. Вони не містять історії повідомлень. > [!ПОПЕРЕДЖЕННЯ] **Використовуйте спеціальні облікові записи.** Telegram обмежує та може назавжди заблокувати облікові записи за обсяги запитів, які вважає надмірними, незалежно від клієнта чи мети, і документує ці обмеження лише частково. Підключайте облікові записи, підготовлені для спостереження, а не особисті чи інші цінні облікові записи, та створюйте API-ідентифікатор / API-хеш на спеціальному обліковому записі. - [Короткий огляд](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#at-a-glance) - [Перш ніж почати: ідентифікатор API та хеш API](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#before-you-start-api-id-and-api-hash) - [Номер телефону](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#phone-number) · [QR-код](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#qr-code) · [Ключ автентифікації + ідентифікатор DC](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#auth-key--dc-id) - [Файли облікових записів](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#account-files): [Telethon .session](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#telethon-session) · [Pyrogram .session](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#pyrogram-session) · [Пара «сесія + JSON»](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#session--json-pair) · [TData](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#telegram-desktop-tdata) · [StringSession](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#telethon-stringsession) · [Ключ автентифікації та DC в одному рядку](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#auth-key-and-dc-in-one-line) · [JSON-файл облікового запису](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#account-json) - [Визначте, що у вас є](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#identify-what-you-have) · [Непідтримувані формати](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#unsupported-formats) - [Кілька облікових записів](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#multiple-accounts) · [Забезпечення безпеки файлів облікових записів](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#keeping-account-files-safe) · [Усунення несправностей](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#troubleshooting) ## Короткий огляд | Що у вас є | Вкладка «**Додати обліковий запис**» | Вам також знадобиться | | --- | --- | --- | | Номер телефону та доступ до кодів входу | **Телефон** | Пароль 2FA, якщо функція увімкнена | | Telegram відкрито на іншому пристрої | **QR-код** | Пароль 2FA, якщо функція увімкнена | | Файл `.session` (Telethon або Pyrogram) | **Файли** | Додатковий супровідний файл JSON для налаштувань додатка | | `.session` + `.json` з однаковою назвою | **Файли** (виберіть обидва) | Зазвичай нічого іншого | | Папка «`tdata`» у Telegram Desktop | **Файли** (у форматі ZIP) | Локальний пароль для настільного комп’ютера, якщо такий встановлено | | StringSession для Telethon (текст, `.txt`, `.tgwitness-session`) | **Файли** | Окремої пари API не потрібно | | Ключ автентифікації та DC в одному рядку: `<512 hex>:<1–5>` | **Файли** (вставлений текст або текстовий файл) | Окремої пари API не потрібно | | `.json` із сесією або ключем автентифікації | **Файли** | Окремої пари API не потрібно | | Ключ автентифікації (512 шестнадцяткових символів) та його номер DC | **Ключ автентифікації** | Опціональний ідентифікатор користувача | TgWitness розпізнає файли за їхнім **вмістом**, а не за іменами. Перейменування файлу ніколи не призводить до його конвертації. ## Перш ніж почати: ідентифікатор API та хеш API Ви можете увійти, не створюючи додатка Telegram API. Якщо жодна пара не введена, не імпортована або не збережена в робочому просторі, TgWitness вибирає пару зі свого вбудованого пулу з 50 публічних пар API (`tgwitness/api_pool.py`), надаючи перевагу Telegram Desktop для нового входу та спочатку використовуючи збережену пару; решта варіантів перемішуються. Якщо Telegram відхиляє пару (`API_ID_INVALID`, `API_ID_PUBLISHED_FLOOD`, `UPDATE_APP_TO_LOGIN`), випробовується наступна, до восьми на один вхід; відхилені пари пропускаються до перезапуску. Пара, яка здійснила вхід, зберігається разом з обліковим записом і використовується для нього повторно. Вбудовані пари є загальнодоступними: вони опубліковані у відкритому вихідному коді клієнтів та бібліотек Telegram. **Ідентифікатор API** та **хеш API** ідентифікують додаток для Telegram і не надають доступу до даних облікового запису. Для входу використовується власна система авторизації облікового запису: код входу та пароль 2FA, або сесія, в якій обліковий запис уже авторизовано. У кожному `observation.started` запис містить назву використаної пари, тому вбудована пара задокументована для суду так само, як і ваша власна. Замість цього ви можете ввести власну пару на сайті my.telegram.org. З досвіду проекту, нова особиста пара призводить до виходу з більшості облікових записів, тому використовуйте її лише тоді, коли справа вимагає вашого власного додатка: створіть її за допомогою спеціального облікового запису та введіть її до початку збору даних (кроки наведено нижче). У полях з відсутніми даними про з’єднання використовується детермінована пара пристрій/ОС із вбудованих каталогів [opentele2 2.0.0](https://github.com/DedInc/opentele2/tree/7e973bc71cd7a714ad13ac703c0895a90d36a735): Desktop `2040`, Android `6`, Android X `21724`, iOS `10840`, macOS `2834` та Web `2496`. Ідентифікатор збірки з вихідного коду для Android `4` також використовує каталог Android, як зазначено в [BuildVars Telegram для Android](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java). Для Web за замовчуванням використовується A; імпортований суфікс версії додатка `K` або мовний пакет `macos` обирає K, а версія `0.7.0` обирає Webogram. Невідомі ідентифікатори додатків зберігають значення за замовчуванням Telethon. Імпортовані поля завжди мають пріоритет, включаючи старішу версію додатка та порожній мовний пакет. Каталог ніколи не змінює ідентифікатор API/хеш. Його знімок версії перевіряється явно, а не отримується під час входу. Збережений профіль залишається стабільним після оновлень. `account.getAuthorizations` повідомляє про збережені метадані авторизації Telegram; це не є повторенням кожного нового `initConnection`. Порівняйте його з фактично надісланим профілем. Підключення існуючої авторизації не перевіряє відповідний хеш API: `initConnection` надсилає ідентифікатор API, тоді як хеш використовується у запитах на вхід. Після авторизації за допомогою нового телефону або QR-коду TgWitness запитує конфігурацію, найближчий центр обробки даних, статус підключення, мови (якщо мовний пакет не порожній), оновлення додатка та оновлення умов надання послуг з інтервалом між запитами 0.3–1.5 секунди. Оновлення статусу на короткий час позначає обліковий запис як активний. Ця послідовність виконується один раз після завершення входу, а не під час імпорту, повторного підключення чи перезапуску. Спочатку зберігається авторизація; невдалий запит зупиняє послідовність без повторної спроби або скасування входу. Результати записуються як `account.initialized` із зазначенням назв помилок, а не тіл відповідей. Обмеження щодо облікових записів визначаються власними політиками Telegram. Для `tdesktop` , якщо `tz_offset` відсутній, використовується локальне зміщення UTC сервера, округлене до 900 секунд за допомогою алгоритму [opentele2](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/fingerprint.rs) (MIT; ліцензія в `tgwitness/client_profiles.LICENSE` ). Воно оновлюється при кожному підключенні, щоб відображати зміни, пов’язані з переходом на літній час. Імпортований `tz_offset` має пріоритет на кожній платформі та зберігається точно, включаючи нуль. Інші записи `initConnection.params` зберігаються. Форма входу через HTTP приймає числове значення часового поясу, повернуте під час імпорту файлу; булеві значення, дроби та зміщення поза межами підтримуваного діапазону відхиляються. Прямі маршрути, SOCKS5 та HTTP CONNECT використовують протокол Telethon `ConnectionTcpObfuscated` (зашифрований скорочений MTProto). HTTPS CONNECT зберігає TLS до проксі та використовує той самий зашифрований транспорт усередині тунелю. MTProxy зберігає необхідний випадковий проміжний транспорт та обробку секретних даних. Перемикання маршрутів застосовує ті самі параметри. Зашифрування змінює структуру пакетів; воно не приховує обліковий запис або метадані клієнта від Telegram і не означає імунітету до обмежень. Після підключення авторизованого клієнта TgWitness перевіряє конфігурацію, найближчий центр обробки даних, поточну авторизацію, переглянуту базову версію рівня, мови, оновлення додатків та оновлення умов надання послуг. Ці діагностичні перевірки виконуються один раз для кожного екземпляра клієнта, перед початком збору даних, і відображаються у деталях з’єднання разом із часом їх виконання. У записі ` `account.connection_checked`` зберігається результат без хеш-значень сеансів, IP-адрес, токенів або хеш-значень API. Вони ніколи не приймають умови використання та не встановлюють оновлення. Помилка запиту або стан `FloodWait` зупиняють подальші запити; відсутній результат залишається невідомим. Локальні перевірки все одно можуть повідомляти про свої результати, тоді як мережеві перевірки пропускаються. Якщо увімкнено [режим Вибрані чати](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#strict-chosen-chats), поточна авторизація не запитується, і ця перевірка відображається як пропущена. Після входу в систему та під час кожного нового підключення TgWitness зчитує налаштування щодо контенту для дорослих у обліковому записі. Якщо цей параметр вимкнено, а Telegram дозволяє його змінити, TgWitness вмикає його, щоб контент, який Telegram позначає як конфіденційний (18+), зберігався, та записує значення параметра `account.content_settings`. Цей параметр належить обліковому запису та застосовується в усіх додатках Telegram. У режимі «Вибрані чати» він залишається незмінним; увімкніть цей режим перед входом у систему. Одночасні запити на відновлення з’єднання в одній робочій області використовують спільний клієнт і очікують завершення встановлення з’єднання. У разі невдалої або скасованої спроби наступний запит отримує можливість повторити спробу. Якщо під час встановлення з’єднання збережені облікові дані, клієнт або стан авторизації змінюються, попередня спроба припиняється, замість того щоб повідомити про готовність з’єднання. Діагностика FloodWait зберігає метод TL, що завершився невдачею, будь-які обгортки Takeout/range, запит сервера на очікування та ефективний кінцевий термін у `telegram.backoff`. Деталі з’єднання показують метод та кінцевий термін, коли запити призупинені. Діагностика включає лічильники викликів клієнта за кожним методом з моменту створення цього клієнта; вони окремо підраховують вкладене визначення однорангових вузлів, але не враховують пакети або внутрішні спроби повторного виклику Telethon. Поточні лічильники також доступні як `collector.rpc_activity` у API стану. Аргументи запиту, імена користувачів, хеші доступу або текст винятків не включаються. Остання діагностика та повний термін зберігаються після перезапуску. Раніше очікування без запису методу не можна приписати ретроспективно. Див. [export limits](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-LIMITS.md) для огляду джерел та розмежування між виявленням та отриманням історії. `official_app=True` або `False` — це прапор поточної авторизації Telegram. Жодне з цих значень не визначає, чи є обліковий запис обмеженим, надійним або перебуває під спостереженням. Існуючі знімки `account.devices` у режимі доказів залишаються історією всіх підключених пристроїв; діагностика з’єднання зберігає лише опис поточного пристрою. Перед підключенням попередні перевірки порівнюють платформу API, мовний пакет, формати пристрою/ОС та версії додатка, локаль мобільної системи та фактичний рівень схеми Telethon із базовим каталогом, що пройшов перевірку. Попередження з’являються у журналі сервера та метаданих статусу облікового запису; вони ніколи не замінюють імпортовані значення та не змінюють рівень схеми. Відмінність рівнів є сигналом для перевірки сумісності; власний статус підключення облікового запису показує, чи все працює. Telegram визначає обмеження зі свого боку, незалежно від того, який профіль клієнта використовується. Статус від’єднаного облікового запису використовує збережений профіль замість створення нового опису пристрою. Щоб замість цього використовувати власний додаток: 1. Відкрийте [my.telegram.org](https://my.telegram.org) і увійдіть, вказавши будь-який номер телефону, який належить вам. Код надходить у додаток Telegram, а не у вигляді SMS. 2. Виберіть **інструменти для розробки API**. 3. Створити заявку: будь-яка назва та коротка назва (5–32 літери), платформа — **«Настільний ПК**». Поля «URL» та «Опис» можна залишити порожніми. 4. Скопіюйте **App api_id** (число) та **App api_hash** (32 шестнадцяткові символи). У панелі під формою входу вказано **«API ID + Hash**». Ви можете ввести одну пару `api_id:api_hash` у **поле «API ID**», і обидва поля заповняться автоматично. Одну пару можна використовувати для всіх ваших облікових записів. Після успішного входу дані зберігаються у зашифрованому вигляді виключно в цьому робочому просторі й ніколи не надсилаються назад до браузера. Задіяно три різні типи облікових даних: | Секрет | Відкрити | Де це знаходиться | | --- | --- | --- | | Токен панелі | Веб-панель TgWitness | `panel-token.txt` у каталозі даних або `TGWITNESS_TOKEN` | | Ідентифікатор API + хеш | Нічого окремо; ідентифікує додаток | Вбудована пара, імпортовані налаштування або ваш власний додаток на my.telegram.org | | Авторизація облікового запису | Акаунт у Telegram | Створюється шляхом входу через телефон/QR-код або імпортується як сесія | Якщо для доступу до Telegram потрібно використовувати проксі-сервер, спочатку налаштуйте його в меню **Додаткові інструменти → Обліковий запис → Налаштування → Налаштування з’єднання → Змінити маршрут з’єднання**. ## Номер телефону 1. Відкрийте **Більше інструментів → Обліковий запис**, вкладку **Телефон** і введіть номер у міжнародному форматі, наприклад, `+44 7700 900123`. Пробіли та тире видаляються автоматично. 2. Натисніть **«Продовжити**». Поля «API ID» та «Хеш» можна залишити порожніми. 3. Введіть код, який надсилає Telegram, зазвичай у додаток Telegram; Telegram вирішує, чи надсилати SMS. 4. Якщо для облікового запису налаштовано двоступеневу аутентифікацію, введіть цей пароль. Це не токен панелі і не код доступу до пристрою. 5. Перевірте ідентифікатор облікового запису, що відображається після входу, а потім виберіть джерела. Коди входу та пароль 2FA ніколи не записуються на диск. ## QR-код Використовуйте цю функцію, коли обліковий запис уже ввійшов у систему на телефоні або іншому комп’ютері. 1. Вкладка **«QR-код»** → **Показати QR-код**. Поля «API ID» та «Хеш» можна залишити порожніми. 2. На пристрої, на якому ви увійшли: **Налаштування → Пристрої → Підключити настільний пристрій**, відскануйте код та підтвердіть. 3. Введіть пароль 2FA у TgWitness, якщо Telegram його вимагає. Зображення QR-коду генерується локально. Термін дії кодів обмежений; натисніть **«Створити інший QR-код»,** щоб спробувати ще раз. Блокування панелі, перехід до іншого робочого простору або початок нової сесії входу скасовує код, що очікує на використання. ## Ключ автентифікації + ідентифікатор DC Ключ авторизації (Auth Key) — це необроблений 256-байтовий код авторизації, що лежить в основі кожного сеансу Telegram, записаний у вигляді **512 шістнадцяткових символів** разом із номером центру обробки даних **DC 1–5**. 1. Вкладка **«Ключ авторизації**». Вставте повний ключ; скорочений ключ, що містить `…`, не працюватиме. 2. Виберіть DC-ідентифікатор, наданий разом із ключем. 3. За бажанням введіть **ідентифікатор користувача**. У такому разі TgWitness відмовить у підключенні, якщо Telegram повідомить про інший обліковий запис. 4. **Акаунт у** Press **Connect**. Ключ авторизації (512 символів) — це не хеш API (32 символи). Цей самий ключ також можна імпортувати у форматі JSON, див. [JSON-файл облікового запису](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#account-json). ## Файли облікових записів Open **Add account → Files** and select up to **four files belonging to one account**, **8 MiB** in total, press **Check files**, then **Connect account**. Choosing files or pasting session text sends nothing; **Check files** sends them to your TgWitness server, which reads them without signing in and shows the session it found. Форми **Files**, **Auth key** та масового імпорту показують попередження про паралельні сесії перед підключенням. За замовчуванням імпортовані авторизації використовуються повторно. Залишайте оригінальний клієнт закритим, поки його ключ використовується тут. **Files** та **Auth key** також пропонують **Створити незалежну авторизацію**, описану нижче. Масовий імпорт все ще використовує прямий режим. Вхід за допомогою телефону та інтерактивного QR-коду створює окремі авторизації. Заголовок попередження залишається видимим у формі імпорту; його повне пояснення відкривається автоматично після введення файлів або рядка ключа/сесії. Його можна згорнути після прочитання, щоб на телефоні залишалися доступними елементи керування вибором файлів та підключенням. [Підтверджене розгортання](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/) (Phala Cloud, Intel TDX) не здійснює збір даних за імпортованим ключем. У цьому випадку **файли** та **ключ авторизації** пов’язуються лише за умови вибору **опції Створити незалежну авторизацію**; масовий імпорт не підтримується. Вхід за номером телефону та QR-кодом працює як зазвичай. - Файли конвертуються **в оперативній пам’яті** на вашому сервері TgWitness. Завантажені дані не зберігаються, архіви ZIP не розпаковуються на диск, і не відбувається звернення до жодних зовнішніх сервісів. - Отримані дані потім перевіряються за допомогою Telegram. Якщо у файлі вказано ідентифікатор користувача, він повинен збігатися з даними облікового запису, які надає Telegram. - Файли, що описують різні облікові записи або різні облікові дані API, відхиляються, замість того, щоб вибрати один із них. - **Поле Пароль або Текст сесії** містить локальне поле пароля TData, поле для вставлення StringSession та функцію **Читати файли без входу** (заповнює форму без звернення до Telegram). Вставлення StringSession очищає вибрані файли, а вибір файлів очищає вставлений текст, тому перевірка та підключення використовують останній вибір. Після зміни пароля натисніть **Перевірити файли** ще раз. ### Створити незалежну авторизацію Виберіть **Створити незалежну авторизацію** перед підключенням імпортованих файлів або авторизаційного ключа. TgWitness короткочасно підключає імпортованого донора, використовує його для затвердження QR-токену входу нового клієнта та відключає донора одразу після затвердження. Новий клієнт має власний ключ авторизації та окремо обраний профіль для настільного комп’ютера . Надані донором облікові дані API та профіль пристрою використовуються лише для підключення донора. Жодна існуюча авторизація не виходить із системи та не скасовується. **Під час виконання цього кроку оригінальний клієнт донора має залишатися повністю закритим.** Початкове з’єднання все ще використовує скопійований ключ, тому цей режим не може усунути ризик паралельного використання. Після встановлення нового авторизованого з’єднання власник може знову відкрити оригінальний клієнт і користуватися обома одночасно. Інтерактивний вхід **за допомогою QR-коду** дозволяє оригінальному клієнту затвердити вхід без копіювання або підключення свого ключа на цьому етапі. **Не виходите з системи та не закривайте сеанс донора.** Коли сеанс, який затвердив вхід за QR-кодом, завершується, Telegram також завершує сеанс, який він затвердив; під час тестування в реальному часі нова авторизація припинилася протягом секунди після виходу донора з системи. Функція імпорту реєструє сеанс донора (`session_origin.approved_by`: пристрій, ID API та час створення). У списку сеансів вона позначається як **Завершити сеанс** — відхиляється, а опції **Завершити всі інші сеанси** та **Зробити цей сеанс єдиним** залишають донора у системі. Якщо Telegram вимагає двофакторної аутентифікації (2FA), цей режим використовує `twoFA` дані з вибраного JSON-файлу, якщо він є, або запитує пароль. У разі відхилення імпортованого пароля відбувається повернення до форми введення пароля. Паролі не зберігаються. Ключ-кандидат зберігається у зашифрованому вигляді в `independent_login.enc`, включаючи зміни під час міграції між дата-центрами. Після перерви виберіть того самого донора та цю опцію, щоб відновити збережений кандидатний ключ. Донор перевіряється `help.getAppConfig` перед затвердженням; заблокований обліковий запис зупиняється на цьому етапі. Якщо Telegram відхиляє донора перед затвердженням входу, незатверджений кандидат-ключ відкидається, і імпорт можна розпочати знову. Інший донор замінює збереженого кандидата лише тоді, коли Telegram повідомляє, що цей кандидат не ввійшов у систему; кандидат, який увійшов у систему або очікує на свій пароль 2FA, зберігається. Робоча область залишається зарезервованою для цього облікового запису; невдале завершення не призводить до видалення нової робочої області. Збережіть її каталог даних та ключ сховища. Остаточні облікові дані та `account.authorized` запис у журналі містять метод імпорту, формати вхідних даних та ідентифікатор API донора, без ключа або пароля донора. 5 листопада 2026 року спеціальний обліковий запис пройшов перевірки в режимі реального часу з донорами Telethon, Pyrogram та TData: завершення 2-факторної автентифікації (2FA), унікальні нові ключі авторизації, одночасний доступ донора та нового клієнта, а також читання публічного каналу. У випадку з Telethon також було відновлено збережений варіант після переривання на етапі введення пароля. Кожна нова авторизація завершувала шість запитів на ініціалізацію після входу, а її підписаний журнал перевірявся. Початкова сесія залишалася придатною для використання у всіх чотирьох наданих форматах. База даних помилок [RPC Telegram](https://core.telegram.org/api/errors.json) пов’язує `FRESH_CHANGE_ADMINS_FORBIDDEN` зі зміною адміністраторів, `FRESH_CHANGE_PHONE_FORBIDDEN` зі зміною номера телефону, а `FRESH_RESET_AUTHORISATION_FORBIDDEN` з скасуванням інших сесій, зміною їхнього терміну дії або реєстрацією пароля-ключа. `SESSION_TOO_FRESH_*` та `PASSWORD_TOO_FRESH_*` стосуються передачі права власності та виведення доходів або подарунків. Це не операції збору даних; новий вхід у систему не означає загальної 24-годинної заборони на читання. Експорт може окремо повертати `TAKEOUT_INIT_DELAY_*`. TgWitness зберігає паузи, запрошені сервером, і не повторює прийняття токенів автоматично, а також не скасовує сесії для обходу обмежень. **Більше інструментів → Обліковий запис → Безпека облікового запису → Сесії цього облікового запису → Завершити всі інші сесії** викликає `auth.resetAuthorizations` на запит оператора та записує `account.all_other_sessions_terminated` із кількістю сесій до та після. Telegram приймає це від сесії, яка була увійшла протягом 24 годин. Коли цей робочий простір входить за допомогою QR-коду з імпортованої сесії, сесія, яка її затвердила, залишається увійденною: TgWitness по черзі завершує інші за допомогою `account.resetAuthorization` та записує `kept_approving_session`. **Якщо це єдина сесія**, то програма зупиняється з цієї причини і не змінює пароль. **Зробіть так, щоб ця сесія** виконувала те саме для ключа, створеного під час входу з цього робочого простору, а потім увімкніть двоступеневий пароль, якщо обліковий запис його не має. Панель показує цей пароль один раз; TgWitness зберігає його у сховищі робочого простору лише до цього моменту. Журнал фіксує `session.exclusive_from`. Якщо Telegram пізніше відобразить іншу сесію, журнал фіксує `session.exclusive_ended` , а панель видає попередження. Верифікатор виводить обидва записи. **Зробіть цю сесію єдиною, коли Telegram дозволяє виконувати** одну й ту саму дію за таймером. Ця опція з’являється в **розділі Сесії цього облікового запису** для ключа, створеного в цьому робочому просторі, і записується як `session.exclusive_automatic`. Під час спостереження колектор кожні п’ять хвилин перевіряє, чи минуло 24 годин з моменту запису `account.authorized` для цього ключа — до цього Telegram відповідає `FRESH_RESET_AUTHORISATION_FORBIDDEN` — а потім виконує ту саму операцію один раз. Успіх записується як `session.exclusive_from`, як і при натисканні кнопки вручну. Відмова реєструється один раз як `session.exclusive_postponed` із зазначенням причини Telegram, і колектор повторює спробу із зростаючою затримкою до шести годин. Режим тільки для читання тут не діє: завершення сеансів є дією, пов’язаною з безпекою облікового запису, а не дією у чаті. Двоступеневий пароль, згенерований під час автоматичного запуску, зберігається у сховищі робочого простору, зашифрований ключем робочого простору, ще до того, як Telegram його встановлює. Панель один раз отримує його з `POST /api/account/sessions/only/password`, після чого він видаляється, і відображає його в тому самому діалоговому вікні, що й під час ручного запуску, коли ви відкриваєте **Сесії цього облікового запису**. На сторінці підключення зазначається, що пароль очікує на введення. Він ніколи не потрапляє до журналу і зберігається після перезапуску, доки не буде показаний. Під час спостереження також повідомляється про нові сесії: коли до списку сесій Telegram додається новий запис, запис `account.sessions` фіксує його під `added`, а панель видає сповіщення із зазначенням пристрою, додатка та країни з цього знімка. ### Зонд-свідок **Більше інструментів → Обліковий запис → Безпека облікового запису → Свідок** перевіряє, чи отримує інший клієнт оновлення цього облікового запису. Додайте другий робочий простір, увійдіть у нього з іншим обліковим записом Telegram та власним сесійним ключем, створіть приватну групу з обома обліковими записами, потім виберіть цю групу як **Чат для перевірки**та другий робочий простір як **Робочий простір свідка** і увімкніть перевірку. Для обох облікових записів потрібно вимкнути **режим Тільки для читання**, а робочий простір свідка повинен перебувати в режимі спостереження. Під час спостереження цей робочий простір надсилає `probe::` у групу кожні 60–120 секунд та фіксує `probe.sent`. Свідок відповідає `ack::` та фіксує `probe.seen` і `probe.ack_sent`. Підтвердження (ack), яке надходить у цю сесію як оперативне оновлення протягом 20 секунд, фіксується як `probe.acked`. В іншому випадку робочий простір зчитує останню історію групи. Підтвердження , знайдене там, але не доставлене в режимі реального часу, записується як `coverage.gap` з причиною `probe_ack_missed_live`: панель генерує сповіщення та позначає прийом події як невдалий, доки пізніше не надійде підтвердження в режимі реального часу (`connection.restored`, причина `probe_ack_live`). Відсутність підтвердження записується як `probe.unanswered`; переривання з’єднання під час очікування або нечитабельна історія — як `probe.inconclusive`. Режим тільки для читання, обмеження Telegram та паузи FloodWait записуються один раз як `probe.skipped`. ### Телемарафон `.session` | | | | --- | --- | | Що це таке | База даних SQLite, яку створюють інструменти на базі Telethon, наприклад `my_account.session` | | Визнано | Таблиці `sessions` (разом із `dc_id`, `server_address`, `port`, `auth_key`) та `version` = 7 або 8 | | Вимоги | Рівно один рядок авторизованої сесії; закрита, повна база даних | Спочатку закрийте програму, яка створила файл. Якщо поруч із ним є файл `my_account.session-journal` або `my_account.session-wal`, це означає, що база даних не завершена: відкрийте та повністю закрийте оригінальний клієнт. Видалення цих супутніх файлів може призвести до пошкодження копії. ### Pyrogram `.session` | | | | --- | --- | | Що це таке | База даних SQLite, яку створюють інструменти на основі Pyrogram | | Визнано | Таблиця `sessions` з `dc_id`, `auth_key`, `test_mode`, `user_id`, `is_bot`; `version` = 2 або 3 | | Вимоги | Допускається лише одна авторизована сесія **користувача** в робочій мережі. Сесії ботів та тестових DC відхиляються. | Під час входу збережений ідентифікатор користувача перевіряється у Telegram. ### Пара «сесія + JSON» Дані часто розповсюджуються у вигляді двох файлів з однаковою назвою, наприклад `447700900123.session` та `447700900123.json`. Виберіть **обидва** одночасно. - На основі JSON TgWitness використовує `app_id`/`api_id` та `app_hash`/`api_hash`, тому вам зазвичай не потрібно вводити облікові дані API. - Профіль з’єднання використовує `device_model` (псевдонім `device`), `system_version` (псевдонім `sdk`), `app_version`, `lang_code`, `system_lang_code` (псевдонім `system_lang_pack`), `lang_pack` та опціональний `tz_offset` (секунди від UTC, від -43200 до 50400). Вказані поля мають пріоритет над згенерованими значеннями за замовчуванням та мовою панелі/браузера . Суперечливі псевдоніми відхиляються. Визначений профіль зберігається у зашифрованих облікових даних робочої області та повторно використовується після перезапуску, включаючи версію додатка. - `phone`, налаштування проксі та токени пристроїв **ігноруються**. `twoFA` доступний лише для читання, коли **Створити незалежну авторизацію** обрано; прямий імпорт ігнорує його. - JSON-файл без підтримуваного поля авторизації є лише метаданими. Додайте файл сесії або продовжуйте вхід за допомогою телефону чи QR-коду. JSON-файл, що містить підтримувану сесію або авторизаційний ключ, може авторизуватися самостійно; див. [Account JSON](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#account-json). ### Telegram Desktop (TData) TData — це папка `tdata` у програмі Telegram Desktop (кросплатформовий додаток з desktop.telegram.org). | Система | Стандартне розташування `tdata` | | --- | --- | | Windows | `%APPDATA%\Telegram Desktop\tdata` (портативний Telegram: поруч із `Telegram.exe`) | | Linux | `~/.local/share/TelegramDesktop/tdata` | | macOS | `~/Library/Application Support/Telegram Desktop/tdata` | Щоб імпортувати його: > **Попередження про паралельну сесію.** Прямий імпорт TData повторно використовує ключ авторизації Telegram Desktop. Не використовуйте цей ключ одночасно в Desktop та TgWitness. Telegram може анулювати авторизацію за допомогою `AUTH_KEY_DUPLICATED`, що зробить обидві копії непридатними для використання до нового входу в систему. > > > > Повністю закрийте Desktop, включаючи його процес у системному лотку, і тримайте цю копію закритою, поки TgWitness використовує імпортовану сесію. **Закрийте програму, не виходите з системи та не скасовуйте сесію:** скасування також робить імпортовану копію недійсною. Якщо вам потрібно, щоб обидва клієнти працювали, виберіть **Створити незалежну авторизацію** і тримайте Desktop закритим, доки не відбудеться успішний новий вхід, або увійдіть у TgWitness за допомогою телефону чи QR-коду. Рекомендується використовувати окремий обліковий запис, але це не робить клоновані ключі безпечними для паралельного використання. > > > > Це також стосується імпортованих `.session` файли, текст StringSession та HEX-код ключа авторизації. Інші клієнти з власними, незалежно створеними авторизаціями, можуть залишатися у системі. Дивіться [документацію Telegram щодо AUTH_KEY_DUPLICATED](https://core.telegram.org/api/errors#406-not-acceptable). 1. Повністю закрийте Telegram Desktop. 2. Створіть ZIP-архів, що містить **лише** ці два елементи з `tdata`: - `key_datas` - 16-символьний файл із розширенням «`s`», що знаходиться поруч, зазвичай «`D877F783D5D3EF8Cs`» Стиснення всієї папки разом із кешем мультимедіа зазвичай перевищує обмеження (512 записів, 32 МіБ у розпакованому вигляді). 3. Виберіть ZIP-файл у розділі **«Файли**». Якщо у Telegram Desktop встановлено **локальний пароль**, спочатку введіть його у полі **«Пароль» або «Текст сеансу**». Це не пароль 2FA. Підтримується: один обліковий запис на архів, сучасне сховище `key_datas`/`key_data0`/`key_data1`, локальний пароль. Не підтримується: папки з кількома обліковими записами, що ввійшли в систему, старі версії десктопного додатка, ZIP-архіви, захищені паролем, та окремий нативний додаток для macOS «Telegram для macOS». ### Telethon StringSession Один рядок тексту, який зазвичай починається з `1` і має довжину близько 350 символів. Завантажте його як файл `.txt` або `.tgwitness-session` (максимум 4 Кбайт) або вставте його в поле **«Пароль» або «Текст сеансу**». Приймаються лише рядки у форматі Telethon; рядки у форматах Pyrogram та TDLib мають інші формати. ### Ключ автентифікації та DC в одному рядку Списки облікових записів часто містять необроблені дані авторизації у форматі `<512 hexadecimal characters>:`, наприклад, `a1b2…ef:5`. Вставте цей рядок у поле **Пароль або Текст сеансу**, завантажте його як текстовий файл або введіть у поле `session` [JSON](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#account-json)-файлу облікового запису. TgWitness прив’язує DC 1–5 до тих самих виробничих адрес, що й при імпорті JSON-файлу `auth_key` + `dc_id`, та повідомляє формат як **Auth key HEX та DC**. Будь-який інший номер DC або довжина ключа відхиляються. ### JSON-файл облікового запису Один об’єкт JSON, розміром не більше **64 Кбайт**, у файлі з розширенням **`.json`**. | Поле (псевдоніми) | Значення | | --- | --- | | `api_id` (`app_id`) | Ідентифікатор додатка — додатне число | | `api_hash` (`app_hash`) | Хеш додатка, 32 шестнадцяткові символи | | `string_session` (`session_string`, `session_str`; застарілий `session`) | Текст Telethon StringSession або `<512 hexadecimal characters>:`, а не ім’я файлу | | `auth_key` (`auth_key_hex`) + `dc_id` | Повний ключ автентифікації довжиною 512 символів та DC 1–5 | | `user_id` (`id`) | Необов’язково; перевіряється у Telegram перед збереженням авторизації | | `device_model` (`device`) | Опис пристрою підключення | | `system_version` (`sdk`) | Версія ОС, з якою встановлено з’єднання | | `app_version` | Версія додатка, надіслана до Telegram | | `lang_code`, `system_lang_code` (`system_lang_pack`), `lang_pack` | Мова клієнта, мова системи та мовний пакет клієнта; допускається порожнє значення `lang_pack` | | `tz_offset` | Необов’язкове зміщення від UTC у секундах, що надсилається у полі `initConnection.params`; цілочисельний або десятковий цілочисельний рядок | Якщо присутні як псевдонім, так і основна назва, вони повинні збігатися. Явні поля сесії Telethon мають пріоритет над загальним блобом `session` в іншому форматі. Якщо обидва містять впізнавані сесії Telethon, вони повинні описувати одну й ту саму авторизацію. Без явного поля `session` має бути дійсною Telethon StringSession або ключем авторизації та DC у форматі `<512 hexadecimal characters>:`. Приклади: ``` { "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" } ``` ``` { "api_id": 1234567, "api_hash": "0123456789abcdef0123456789abcdef", "auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS", "dc_id": 2, "user_id": 123456789 } ``` У першому прикладі заповнюються лише облікові дані API; увійдіть за допомогою телефону або QR-коду, або додайте файл сеансу. Масові списки (масив JSON з обліковими записами) не приймаються. ## Визначте, що у вас є | Ви бачите | Це | Використання | | --- | --- | --- | | `*.session`; при відкритті у текстовому редакторі у верхній частині відображається `SQLite format 3` | Telethon або Pyrogram SQLite | **Файли** (виявляються автоматично) | | Папка «`tdata`», що містить «`key_datas`» | Telegram Desktop TData | Стиснути два файли у ZIP, потім **«Файли»** | | Один рядок тексту, що починається з `1`, приблизно 350 символів | Telethon StringSession | **Файли** | | Один рядок тексту `512 characters 0-9a-f`, потім `:` та цифра 1–5 | Ключ автентифікації та DC | **Файли**, **код доступу до скриньки або текст сеансу** | | `*.json` з `app_id`/`app_hash` | Супровідні метадані | **Файли** разом із сесією | | `*.json` з `auth_key` або `string_session` | JSON-файл облікового запису | **Файли** | | 512 символів `0-9a-f` | Ключ автентифікації | **Ключ автентифікації** | | 32 символи `0-9a-f` | Хеш API | **Ідентифікатор API + хеш** | | `td.binlog` або `db.sqlite` із додатка TDLib | Хранилище TDLib | Не підтримується | | `123456789:AA…` | Токен бота | Не підтримується | ## Непідтримувані формати | Формат | Альтернатива | | --- | --- | | Сховище TDLib (`td.binlog`) та експорт даних TDLib | Увійдіть за допомогою телефону або QR-коду | | **Строки** сеансів Pyrogram | Використовуйте файл Pyrogram `.session` або телефон/QR-код | | TData з кількома обліковими записами, що ввійшли в систему | Вийдіть з інших облікових записів у Telegram Desktop або використовуйте власний файл сеансу кожного облікового запису | | Токени ботів | Не підтримується: TgWitness здійснює спостереження як обліковий запис користувача | | Списки багатьох акаунтів у форматі CSV/JSON | Імпортуйте підтримувані файли сесій через **Облікові записи → Імпорт облікових записів** або увійдіть за номером телефону / QR-кодом в окремих робочих просторах | | Test-DC або сесії ботів | Використовуйте робочий обліковий запис користувача | ## Кілька облікових записів Натисніть **+** поруч із селектором облікового запису або відкрийте **Більше інструментів → Обліковий запис → Налаштування → Налаштування з’єднання → Робочі простори**, введіть назву та увійдіть. - Необмежена кількість робочих просторів, включаючи основний. Кожен має власну сесію, проксі- маршрут, джерела, політику збору даних, журнал, ключ підпису, контрольні точки та експортні файли. - Перемикання між робочими просторами не призупиняє роботу інших. - Журнал залишається прив’язаним до облікового запису, з якого його було створено. Для входу з іншого облікового запису потрібно створити інший робочий простір, а один обліковий запис не можна прив’язати до двох робочих просторів. - Токен головної панелі керує всіма робочими просторами. [Наданий доступ](https://phishdestroy.io/tgwitness/uk/docs/reference/access/) дозволяє обмежити доступ інших користувачів до вибраних акаунтів та чатів із окремими правами доступу та обмеженнями сеансів. - **Функція «Акаунти»** перейменовує робочу область та видаляє додану робочу область разом із її сесією, журналом, джерелами та ключем підпису. Головну робочу область неможливо видалити з панелі. ### Масовий імпорт і групи акаунтів Скористайтеся **меню «Акаунти» → «Імпортувати акаунти»**, щоб додати кілька акаунтів, зіставити файли за базовим іменем та переглянути результати входу для кожного з них. Кожен акаунт отримує власний робочий простір. Група об’єднує пов’язані акаунти, не об’єднуючи їхні сесії, ключі чи докази. Натиснувши **«Відкрити групу»** у розділі **«Акаунти»,** ви перейдете на її сторінку за адресою `/groups/`: - **Облікові записи:** маршрут підключення кожного учасника, спостереження та останнє повідомлення, з функціями «Запустити**все»** та **«Призупинити все**». - **Потребує уваги:** акаунти, з яких вийшли, які недоступні або мають проблеми з підключенням, введенням даних, джерелом чи медіафайлами; кожне ім’я веде до відповідної картки. - **У чатах, які переглядають кілька облікових записів, відображаються:** спільні джерела, облікові записи, що їх переглядають, та перерви в періоді спостереження за робочим простором (до семи днів). **Експорт із N обліковими записами** розподіляє експорт каналу або супергрупи між ними та підписує один архів. - **Експорт групи:** один елемент ZIP, у якому міститься підписаний експорт кожного облікового запису під `accounts/` та `manifest.json` переліком їхніх SHA-256 та відбитків ключів, підписаних головним робочим простором у `manifest.signature.json`. Перевіряйте архів кожного облікового запису окремо за допомогою `python -m tgwitness.verify` та перевіряйте його за допомогою надійного відбитка цього облікового запису. Учасники використовують спільні налаштування групи; кожен обліковий запис може зберігати власні значення. Дивіться [розділ «Спільні налаштування»](https://phishdestroy.io/tgwitness/uk/docs/reference/settings/#account-groups), [посібник з імпорту та груп](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Accounts.md#import-accounts-and-share-settings) та [панель управління пулом MTProxy](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md#pool-dashboard-and-custom-sources). ## Вийти **Додаткові інструменти → Обліковий запис → Вийти з Telegram** (з призупиненим спостереженням) надсилає Telegram запит на завершення сеансу, тому він також зникає з розділу **Налаштування → Пристрої** облікового запису та видаляє сеанс із сховища робочого простору. Журнал, джерела, налаштування та ключ підпису залишаються, а журнал фіксує вихід. Робоча область все ще належить своєму обліковому запису: лише цей обліковий запис може знову підключитися до неї. Якщо Telegram не відповідає, сесія все одно видаляється тут, і панель повідомляє про це; завершіть її в Telegram у розділі **Налаштування → Пристрої**. ## Коли Telegram завершує сеанс Якщо Telegram заблокує, заморозить або вийде з облікового запису, або завершить сеанс з іншого пристрою, у журналі фіксуються причина, помилка Telegram, маршрут та центр обробки даних. Стан облікового запису відображається **у звіті про втрату облікового запису**: підписаний файл у форматі JSON із записами журналу за 24 години до втрати, а саме: підключення, маршрути, сеанси, повідомлення облікового запису та прогалини у покритті, кожне з яких має хеш журналу та підпис. Перевірте це за допомогою `python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP`; експорт доказів містить повний ланцюжок хеш-кодів. Заблокований обліковий запис також виявляється під час підключення та спостереження, а його дії з відправлення та приєднання вимикаються. ## Забезпечення безпеки файлів облікових записів - Ставтеся до кожного `.session`, TData ZIP, StringSession, Auth Key та JSON-файлу облікового запису як до пароля. TgWitness зберігає імпортовані дані авторизації у своєму зашифрованому сховищі; ви можете пізніше видалити оригінальні файли. - Не використовуйте одну й ту саму авторизацію одночасно у двох програмах. Telegram може її скасувати (`AUTH_KEY_DUPLICATED`), і обидві копії перестануть працювати. - Сесія, термін дії якої закінчився або яка була скасована, не може бути відновлена шляхом конвертації. Увійдіть знову. ## Усунення несправностей | Повідомлення або ознака | Що робити | | --- | --- | | *Неможливо прочитати цю сесію. Закрийте оригінальний клієнт…* | Файл SQLite відкритий або незавершений (додатковий файл `-journal`/`-wal`). Належним чином закрийте вихідну програму та скопіюйте файл ще раз. | | *Підтримувані схеми Telethon SQLite: 7 та 8* / *Pyrogram … 2 та 3* | Файл було створено за допомогою дуже старої або невідомої версії бібліотеки. Замість цього увійдіть за допомогою телефону/QR-коду. | | *Підтримуються лише авторизовані сесії користувачів у виробничому середовищі* | Файл Pyrogram належить боту або тестовій мережі. | | *Архів TData перевищує 512 записів або 32 МіБ* | У ZIP-файлі мають бути лише файли `key_datas` та `D877F783D5D3EF8Cs`, а не вся папка. | | *Неможливо розшифрувати TData. Перевірте локальний пароль на робочому столі* | Введіть локальний пароль Telegram Desktop у полі **«Пароль» або «Текст сеансу**». | | *Імпортуйте по одному обліковому запису TData за раз* | У Telegram Desktop було кілька облікових записів; див. розділ [«Непідтримувані формати](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#unsupported-formats)». | | *Вибрані файли містять опис різних облікових записів або облікових даних API* | Вибирайте файли лише з одного облікового запису. | | *JSON не містить жодних облікових даних або авторизаційних даних для підтримуваних API* | Перевірте назви полів у [JSON-файлі облікового запису](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#account-json). | | *Лише метадані API* | У JSON немає сесії. Додайте файл `.session` або скористайтеся номером телефону/QR-кодом. | | *HEX-код авторизаційного ключа повинен містити всі 512 шістнадцяткових символів* | Ключ є урізаним або містить `…`. | | Ідентифікатор облікового запису не збігається з імпортованим обліковим записом | Ідентифікатор користувача у файлі відрізняється від того, що вказує Telegram; файл належить іншому обліковому запису. | | Цей обліковий запис уже належить іншому робочому простору | Відкрийте цю робочу область замість того, щоб додавати обліковий запис двічі. | | Підключено, але у списку чатів у розділі **Додаткові інструменти → Джерела** відсутня приватна група. | Перевірте членство. Вибірник перевіряє перші 1,000 діалогів; збільште обмеження в розділі **Додаткові інструменти → Параметри**. | | Помилка підключення через проксі | Перевірте режим маршрутизації та IP. Автоматичний MTProxy пробує інший робочий запис. «Hide the address» очікує; «Direct» як крайній захід може встановити з’єднання безпосередньо після налаштованої затримки. Див. [режими маршрутизації](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/#ip-modes). | Див. також: [підключення та безпека](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/) проксі-серверів і шифрування, а також [як відбувається збір](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/) даних після входу в систему. --- # Telegram · Доступ та дозволи Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/access/ Надавайте доступ до облікових записів та чатів з обмеженим обсягом повноважень, обирайте права доступу, обмежуйте сеанси та IP-адреси, а також скасовуйте доступ. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Надавайте доступ до облікових записів та чатів з обмеженим обсягом повноважень, обирайте права доступу, обмежуйте сеанси та IP-адреси, а також скасовуйте доступ. [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/quickstart/) ![Початок роботи](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) Надайте рецензенту доступ до одного чату, аналітику — дозвіл на експорт справи, а оператору — контроль над обраними акаунтами. Кожна особа отримує власний токен. Головний токен панелі залишається у адміністратора. [Налаштування облікового запису](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/) · [Маршрути підключення](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/) · [Модель безпеки](https://phishdestroy.io/tgwitness/uk/docs/reference/security/) ## Дві сфери застосування, дві різні посади **Обсяг збору даних** визначає, що саме записує обліковий запис: вибрані чати, папку Telegram або весь обліковий запис. **Обсяг доступу** визначає, які з цих записаних облікових записів та чатів може переглядати та використовувати інша особа. Надання доступу не означає приєднання до чату Telegram, початок збору даних або надання дозволів на доступ до облікового запису Telegram. Доступ може відкривати вибрані робочі простори, вибрані чати в них, усі робочі простори або кожен обліковий запис у [групі облікових записів](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#bulk-import-and-account-groups). Доступ **до всіх робочих просторів, включно з тими, що будуть додані пізніше**, також поширюється на майбутні облікові записи. Груповий доступ також поширюється на облікові записи, додані до цієї групи пізніше. Явно вибирайте робочі простори, коли справа має обмежуватися лише ними. ## Надати комусь доступ 1. Увійдіть як головний адміністратор і відкрийте **Додаткові інструменти → Доступ**. 2. У розділі **«Надати комусь доступ**» введіть ім’я, яке ви зможете впізнати в журналі. 3. Виберіть робочі простори та, за потреби, окремі чати. 4. Виберіть, що ця особа може робити. Опція **«Переглянути»** завжди включена. 5. Налаштуйте термін дії, обмеження на входи/сесії та дозволені адреси відповідно до потреб. 6. Натисніть **«Створити доступ**». Скопіюйте токен зараз: він відображається лише один раз. 7. Надішліть адресу панелі та токен у приватному повідомленні. Одержувач вводить цей токен на звичайній сторінці входу; йому не потрібен ваш основний токен панелі чи сесія Telegram. Відкрийте панель із виданим токеном в окремій сесії браузера та перевірте доступні чати та дозволені дії, перш ніж передати його. Імена доступу залишаються у зашифрованому локальному сховищі та розшифровуються через панель адміністратора. Імена опускаються у нових записах аудиту доступу та створення робочих просторів; існуючі підписані записи зберігають свої оригінальні поля. ## Виберіть права доступу Для публічної демонстрації, що містить лише текст, використовуйте **«Публічну вітрину»** замість звичайного доступу рецензента. Вона показує явно вибрані публічні канали, збережені редагування та видалення, а також підписану статистику, при цьому поля автора замальовані, а файли закриті на межі API. [Створіть та перевірте вітрину](https://phishdestroy.io/tgwitness/uk/docs/reference/showcase/). | Дозвіл | Що це дозволяє | | --- | --- | | `view` | Переглядайте дозволені чати, збережені повідомлення, профілі, файли та відфільтровані записи журналу. Завжди включено. | | `export` | Дозволено експортувати історію чатів та досьє. Для експорту доказів з усього робочого простору необхідний доступ до всього робочого простору. | | `sources` | Управління джерелами, знімками екрана та збереженням профілів. Доступ, обмежений чатами, діє лише для дозволених чатів; функції пошуку джерел та налаштування сфери дії для всього облікового запису залишаються недоступними. | | `collect` | Запустити або зупинити колектор. Потрібен доступ до всього робочого простору, оскільки збір даних впливає на обліковий запис. | | `interact` | Виконуйте підтримувані дії в Telegram у межах наданого доступу. При обмеженому доступі до чату неможливо використовувати попередній перегляд посилань для всього облікового запису. | | `settings` | Змінюйте налаштування збору даних, часові мітки, сповіщення, зовнішні копії та параметри. Потрібен доступ до всього робочого простору. | | `account` | Увійдіть або вийдіть із Telegram та керуйте маршрутами з’єднання. Потрібен доступ до всього робочого простору. | | `board.read` | Читайте нотатки на дошці справ лише в межах дозволеного робочого простору та чатів. | | `board.write` | Додавайте закладки, виділення, фрагменти, коментарі та статуси «відкрито»/«переглянуто». Також потрібна функція ``board.read``. | | `board.manage` | Керуйте колекціями, остаточними статусами команди та картками інших учасників. Також потрібні права на читання/запис у дошці. | Лише головний адміністратор може завантажити ключ відновлення позасайтової репліки. Делегований доступ до `settings` або `account` не надає цього ключа. Права доступу та їхній обсяг перевіряються одночасно. Встановлення галочки біля права доступу не відкриває інші чати та не розблоковує операції на рівні робочого простору для доступу, обмеженого одним чатом. Для паралельного експорту доступ повинен охоплювати експортований чат у кожному вибраному обліковому записі. Наданий доступ не дозволяє створювати нові доступи, керувати сесіями інших користувачів або відкривати консоль адміністратора. ### Три корисні налаштування | Особа | Сфера застосування | Дозволи | | --- | --- | --- | | Рецензент | Записані чати з однієї справи | `view` | | Аналітик, який готує передачу справ | Чати для розслідування та експорту | `view`, `export`; додайте `interact` лише в тому випадку, якщо їм потрібно діяти через Telegram | | Оператор збору даних | Вибрані цілі робочі простори | `view`, `sources`, `collect`; додавайте `settings` або `account` лише за потреби | Початкові налаштування форми доступу також включають «Дошку справ»: рецензент може читати, аналітик може читати та писати, а оператор може керувати нею. Налаштування залишаються редагованими, а існуючі права доступу не розширюються автоматично. Див. [«Дошку справ»](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/) для інформації про успадковані обсяги чатів та конфіденційність експорту. ## Обмеження та сесії | Налаштування | Як це працює | | --- | --- | | Паралельні сесії | Обмежте кількість одночасних сеансів до 1–100. При досягненні межі відхиліть наступний вхід або завершіть найстаріший сеанс. | | Доступний вхід у систему | Обмежте кількість успішних використань токена для запуску сеансів. Існуючі сеанси не завершуються лише через те, що було використано останній дозволений вхід. | | Дійсно до | Абсолютний термін дії доступу. Користувач із простроченим доступом не може увійти в систему або продовжувати надсилати запити. | | Протоколи без активності | Тайм-аут неактивності сесії — від 5 хвилин до 30 днів. Успішні запити подовжують цей час; відкрита панель може підтримувати свою активність за допомогою періодичних запитів. | | Дозволені адреси | Дозвольте використання конкретних IP-адрес або підмереж CIDR. Залиште поле порожнім, щоб дозволити будь-яку адресу, якщо не ввімкнено прив’язку до першого входу. | | Прив’язати до першого входу | Після першого успішного входу система фіксує дозволену адресу для цього доступу. | IP-адреса — це адреса клієнта, яку бачить додаток. Якщо ви перебуваєте за зворотним проксі-сервером або тунелем, перш ніж покладатися на правила, пов’язані з IP-адресами, перевірте адресу, вказану в **розділі «Відкриті сесії**»: інакше може здатися, що кілька користувачів використовують одну й ту саму адресу проксі-сервера. ## Змінити або скасувати доступ Відредагуйте запис у **розділі «Наданий доступ»**, щоб змінити його сферу дії, дозволи або обмеження. Зміни сфери дії та дозволів перевіряються під час наступних запитів, зокрема запитів із сеансів, що вже відкриті. Скасування доступу припиняє відповідні сеанси та робить виданий токен непридатним для використання. **Функція «Відкриті сеанси»** також дозволяє адміністратору завершити окремий сеанс без скасування всього доступу. Збережені копії експорту зберігають інформацію про їхнього творця, робочу область, область чату та необхідні дозволи. Користувач із наданим доступом може переглядати або завантажувати власні копії лише доти, доки ці дозволи залишаються чинними; копії, що містять Case Board, також вимагають дозволу `board.read`. Адміністратор може отримати всі копії. Старіші копії без цих метаданих та групові пакети доступні лише адміністратору. Квитки на завантаження та підготовлені файлові відповіді повторно перевіряють доступ після підготовки файлу, перед надсиланням його байтів. Кожен користувач, включаючи адміністратора, може мати десять квитків на завантаження в стані очікування на кожну робочу область; загальний ліміт для робочої області становить 1,000. Квитки втрачають чинність через 120 секунд і призначені для одноразового використання. Скасування не дозволяє відкликати файли, які хтось уже завантажив. Вихід із системи, блокування панелі або завершення сеансу не зупиняють роботу колектора. ## Що бачить адміністратор Рецензенти та аналітики отримують інформацію про хід збору даних без кінцевих точок проксі, діагностики пулу, шляхів до серверів або необроблених помилок з’єднання. Для діагностики з’єднання потрібен дозвіл `account` для всього робочого простору. Для читання сповіщень, копіювання поза майданчиком та налаштування параметрів потрібен дозвіл `settings`. Повні рядки браузера User-Agent не зберігаються в сеансах доступу. Оновлення також видаляє їх із кешу сеансів, що підлягає зміні. Журнал процесів панелі маскує літерали IP-адрес, облікові дані URL та секрети з мітками. Локальні журнали служб та раніше підписані записи журналу не перезаписуються. Правила доступу та підписані записи входу все ще використовують адресу клієнта. ### Замінити головний ключ Скористайтеся **меню Додаткові інструменти → Доступ → Мої обмеження → Перевидавати ключ адміністратора** або запустіть команду `tgwitness token rotate` з керованої інсталяції під час роботи панелі. Усі існуючі сесії браузера завершуються, включаючи сесії, відкриті за допомогою токенів колег. Браузер, що надсилає запит, отримує нову сесію; збережіть новий ключ адміністратора, перш ніж приховати його. Видані токени колег залишаються дійсними, доки їх окремо не скасовано. Інсталяція, що використовує `TGWITNESS_TOKEN`, повинна змінити це налаштування середовища та перезапуститися. ### Межі запитів та проксі-серверів API допускає до 600 запитів на хвилину на клієнта та групу облікових даних: panel, archive/MCP або witness. Періоди очікування після автентифікації для цих груп є окремими. Десять відхилених спроб автентифікації протягом хвилини запускають експоненціальний період очікування, від однієї секунди до п’яти хвилин. Невдала спроба після закінчення періоду очікування збільшує його тривалість; десять хвилин без невдалих спроб скидають ескалацію. У разі відхилення повертається код HTTP 429 та `Retry-After` . Обмеження зберігаються в пам’яті та є спільними для всіх робочих просторів у одному процесі панелі; перезапуск очищає їх. Кількість потоків у реальному часі обмежена чотирма на кожен токен носія та 32 для процесу панелі. Відкриття потоку також витрачає ліміт запитів до API. Тіла запитів мають 60-секундний термін отримання, скорочений до 10 секунд для входу, демо-доступу, API архіву та шляхів witness-head, або до 8 секунд для транспорту MCP. Кожна програма дозволяє чотири незавершені тіла на адресу клієнта, із загальними обмеженнями у 32 та 64 МіБ зарезервованих квот маршруту. Запити без тіл не споживають ці слоти. Надмірно великі тіла повертають 413, тіла з перевищенням часу очікування повертають 408, а перевищення пропускної здатності клієнта повертає 429 з `Retry-After: 1`. У разі вичерпання загальної ємності тіла повертається код 503 із `Retry-After`. Переадресовані заголовки IP ігноруються, якщо фактичний TCP-партнер не належить до `TGWITNESS_TRUSTED_PROXIES` (IP-адреси, розділені комами, або CIDR). Встановіть `TGWITNESS_PROXY_HEADER` на `x-forwarded-for` або `cf-connecting-ip`. XFF проходить від найближчого проксі до першого ненадійного партнера. Неправильно сформовані або дубльовані метадані надійних адрес відхиляються, тому вони не можуть успадкувати проксі-адресу з білого списку . Керуваний швидкий тунель довіряє локальному коннектору Cloudflare; налаштування у власному домені довіряє локальному Caddy. Прямі розгортання за замовчуванням не довіряють жодному проксі-серверу. Якщо ви запускаєте Uvicorn самостійно, вимкніть обробку заголовків проксі, щоб ця межа отримувала фактичний вузол. `TGWITNESS_PANEL_ALLOWED_IPS` обмежує доступ до панелі, у тому числі адміністратора, лише переліченими IP-адресами або CIDR-діапазонами. Проба маршрутизаційної ідентичності інсталятора залишається публічною і не повертає даних облікового запису. Включіть необхідний локальний адміністративний маршрут перед увімкненням списку дозволених. Посібник **START-HERE** для керованої інсталяції містить інструкції щодо конфігурації служби та відновлення. Селектор запиту API `ws` повинен ідентифікувати робочу область у шляху запиту; невідомі, невідповідні та дубльовані селектори відхиляються з кодом 404. Скрипти та стилі панелі містять метадані цілісності SHA-384. Карта імпорту також охоплює локально імпортовані модулі JS у браузерах, що підтримують цілісність import-map. Динамічно згенерована мовна відповідь є окремою. Ці перевірки виявляють заміну ресурсів відносно доставленої сторінки; сама сторінка та її хеші походять із сервера панелі, тому захистіть цей сервер та його шлях доставки. **Журнал з моменту запуску** поєднує журнали процесів із записами активності з кожного робочого простору: входи, відмови, зміни маршруту та дії оператора. Це консоль у пам’яті для поточного процесу, а не постійна копія кожного повідомлення. Події, що повторюються часто, залишаються в журналі, а не заповнюють консоль. Надання, зміна та скасування доступу, а також початок або закінчення сеансів також створюють підписані записи в журналі `access.*`. Токени не включаються до цих записів. Видані токени та облікові дані сеансів зберігаються у вигляді хеш-значень у зашифрованому сховищі. Очікуючий вхід за QR-кодом належить до сеансу панелі, який його ініціював. Завершення або скасування цієї сесії, або ротація основного токена панелі скасовує її очікуючий QR- клієнт на сервері. Це також застосовується, коли браузер не може надіслати власний запит на скасування. Ротація токена також скасовує QR-входи, розпочаті безпосередньо за допомогою основного токена панелі. QR-запит, що очікує на іншу операцію, перевіряє доступ ще раз перед початком. Завершені авторизації в Telegram та очікувані входи, розпочаті іншою сесією панелі, зберігаються. ****Головний адміністратор та межа довіри**** Токен головної панелі залишається необмеженим. Вхід у браузері за його допомогою створює сесії, які підпадають під обмеження сесій, налаштовані адміністратором. Скрипти, що надсилають головний токен безпосередньо, зберігають повний доступ і не враховуються як сесії браузера. Це контроль доступу на рівні додатка в рамках однієї інсталяції. Усі робочі простори використовують один серверний процес; це не є ізоляцією від адміністратора хосту. Зберігайте головний токен, сесії Telegram, ключі підпису та каталог даних у таємниці. Токен-свідок — це окрема контрольна точка/посвідчення працездатності, а не токен доступу до панелі. --- # Telegram · Підключення, проксі-сервери та захист даних Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/connection/ Аутентифікація, автоматичні пули проксі-серверів, режими IP, політика резервного переходу, зовнішні запити та зберігання секретних даних. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Аутентифікація, автоматичні пули проксі-серверів, режими IP, політика резервного переходу, зовнішні запити та зберігання секретних даних. [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) Цей документ описує поведінку TgWitness0.9.3 та її обмеження. Аутентифікація, доступ до джерел, мережеве з’єднання та повнота збору даних — це окремі стани. Щодо кроків входу, форматів файлів та роботи з кількома обліковими записами, почніть з розділу [Облікові записи та формати сеансів](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/). Щодо політик подій та поведінки при перезапуску, див. розділ [Як працює збір даних](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/). ## Покрокове налаштування з’єднання У розділі **Додаткові інструменти → Обліковий запис → Маршрут з’єднання** адміністратор може вибрати **«Цей обліковий** запис», **Група облікових записів**або **Усі облікові записи**, а потім вибрати маршрут. **У вікні Перегляд вибору** відображається список облікових записів, яких це стосується. **Функція Підготувати та перевірити** дозволяє протестувати запропонований маршрут без зміни збереженого. **Функція Застосувати перевірене з’єднання** підтверджує попередній перегляд, призупиняє спостереження, якщо це необхідно, зберігає маршрут і відновлює спостереження, яке вже виконувалося. Збір даних ніколи не розпочинається в обліковому записі, який раніше перебував у неактивному стані. Завантаження історії залишаються призупиненими та можуть бути відновлені окремо. Перед перемиканням призупиніть активні експорті. Зміни в групі за замовчуванням зберігають облікові записи з їхнім власним маршрутом. Скасуйте цю опцію лише тоді, коли у попередньому перегляді відображаються саме ті зміни, які ви плануєте. Додаток повідомляє про результат для кожного облікового запису окремо; це не транзакція типу «все або нічого» між базами даних. У разі невдалого перемикання для цього облікового запису відновлюються попередні налаштування. Неможливість відновлення відображається явно. Термін дії попереднього перегляду закінчується через десять хвилин, а зміни в налаштуваннях з’єднання або членстві в групі вимагають нової перевірки. Функція «Apply» повторно використовує успішний результат попередньої перевірки протягом 90 секунд, якщо маршрут, режим та політика залишаються незмінними. У керованому тунелі повинен і надалі працювати той самий процес. Старіші результати, змінені процеси тунелю та автоматичні маршрути пулу MTProxy перевіряються повторно. Підписаний запис додатка зберігає початковий час перевірки та фіксує повторне використання й його вік. Кожна попередня перевірка закриває свій тимчасовий неавтентифікований клієнт; колектор підключається, використовуючи власну авторизовану сесію. | Маршрут | Що управляє TgWitness | | --- | --- | | Прямий | Підключення з хосту; VPN зовнішнього хосту не виявлено та не застосовується. | | VPN | Один профіль WireGuard із повним тунелем на кожен обліковий запис, що виконується локальним процесом SOCKS5 у просторі користувача. Жодних мережевих інтерфейсів чи драйверів не встановлено. | | Мій проксі-сервер | Повноваження SOCKS5, HTTP CONNECT або MTProxy. У поля SOCKS5/HTTP можна ввести URL-адресу. При виборі декількох облікових записів цей введений проксі-сервер використовується для всіх них. | | Публічний MTProto | Існуючий пул призначає маршрути Telegram. Зовнішні запити відключені, доки в розширених налаштуваннях не буде налаштовано окремий відповідний проксі-сервер. | | WARP | Окремий локальний тунель для кожного вибраного облікового запису, з реєстрацією WARP та профілем WireGuard, що зберігається у сховищі цього облікового запису. | Перевірка поточного маршруту використовує новий неавтентифікований транспорт Telegram, а не сесію облікового запису. Вона відкриває транспортне з’єднання через маршрут до центру обробки даних облікового запису та здійснює один цикл передачі даних MTProto без автентифікації (`req_pq_multi`); при цьому не створюється ключ авторизації та не використовується обліковий запис. Зафіксована затримка — це час з’єднання плюс час обміну даними, і перевірка реєструє обидві частини окремо. Для маршрутів, що підтримують HTTP, також надсилається запит HTTPS-трасування Cloudflare через цей маршрут і відображає вказані вихідну IP-адресу, країну, стан WARP та час перевірки. Підготовка WARP завершується невдало, якщо трасування не повідомляє про активний стан WARP. Ці попередні перевірки повідомляють про зв’язність маршруту та спостережуваний вихід. Перегляньте записані дані через результати збору та верифікації архіву. Сам по собі запущений локальний процес не є успішною перевіркою виходу. Панель обчислює ковзну середню за останніми п’ятьма перевірками. Маршрут вважається **повільним,** коли середнє значення перевищує 5 секунд або три перевірки поспіль перевищують це значення, а **недоступним —** після двох невдалих перевірок поспіль; `network.slow_route` та `network.route_recovered` записує зміни. У разі повільного маршруту WARP функ**ція Re-roll WARP** перезапускає тунель облікового запису через інші кінцеві точки Cloudflare WARP, зберігає найшвидший варіант і фіксує `network.warp_rerolled` з часами до та після; **New WARP identity** реєструє новий пристрій WARP і зберігає його лише тоді, коли він швидший. Адреса локального проксі-сервера, обліковий запис Telegram та його сесія залишаються незмінними; з’єднання Telegram відновлюються через перезапущений тунель. Повільний маршрут WARP перезапускається автоматично не частіше ніж раз на 30 хвилин; коли це не допомагає, подальші перезапуски очікують на втручання оператора. ### Портативні WARP та WireGuard Це неофіційна інтеграція WARP **** з використанням [wgcf 2.3.1](https://github.com/ViRb3/wgcf/releases/tag/v2.3.1) та [wireproxy 1.1.3](https://github.com/windtf/wireproxy/releases/tag/v1.1.3). Адміністратор явно погоджується на налаштування перед першим завантаженням або реєстрацією в WARP. Ці з’єднання для налаштування встановлюються безпосередньо з GitHub та Cloudflare і розкривають IP-адресу пристрою. Трафік звичайного облікового запису зберігає існуючий маршрут до запуску програми. Cloudflare обирає вихідну адресу та країну; окремі тунелі можуть використовувати одну вихідну адресу. Ця функція не підтримує вибір країни, періодичну ротацію IP-адрес та загальний для хосту VPN-kill-switch. Підтримувані версії допоміжних програм для завантаження: Linux та macOS x86-64/ARM64, а також Windows x86-64. Артефакти перевіряються на відповідність хешам SHA-256, що містяться у перевіреному вихідному коді, а кешовані виконувані файли перевіряються ще раз перед запуском. Жодна допоміжна програма не додається до PATH, не встановлюється як системна служба та не має загальнодоступного прослуховувача. Усі файли знаходяться у каталозі `portable-routes/` робочої області та у зашифрованих записах сховища. Для прослуховувача з петлевим підключенням SOCKS5 потрібні незалежно згенеровані облікові дані. Приватні профілі та облікові дані облікового запису WARP шифруються за допомогою існуючого сховища робочого простору. Під час роботи допоміжній програмі потрібен конфігураційний файл у вигляді відкритого тексту, доступний лише власнику; він видаляється при звичайному завершенні роботи. Збій хоста може залишити цей файл у папці даних, доступній лише власнику. Це не шифрує диск і не захищає від його адміністратора. Супервізор закриває тунель, якщо батьківський канал панелі зникає. Тунель, що зазнав збою, ніколи не вмикає прямий резервний варіант. Перезапуск панелі відновлює вибраний тунель; невдалі запуски повторюються з обмеженою затримкою. **Зупинити тунель** також призупиняє спостереження та зберігає стан зупинки. **Запустити тунель** запускає тунель; відновити спостереження окремо, коли будете готові. Завантажені профілі WireGuard повинні містити один інтерфейс та один пір, повні маршрути IPv4 та IPv6, а також не містити хуків, включень, підстановок змінних середовища чи додаткових слухачів. Адреси публічних кінцевих точок визначаються та фіксуються перед запуском. Використовуйте зовнішній VPN або шлюз SOCKS5 для OpenVPN/IPsec та приватних кінцевих точок. ## Методи автентифікації **Ідентифікатор API та хеш API ідентифікують додаток; вони не замінюють дані для входу в обліковий запис.** У TgWitness їх використання є необов’язковим. Пріоритет: спочатку пара, введена у форму, потім — з імпортованого JSON-файлу облікового запису, потім — пара, збережена в робочій області, а потім — вбудований пул із 50 публічних пар, які перевіряються у випадковому порядку з автоматичною ротацією, коли Telegram відхиляє одну з них. Лише пара Telegram Desktop (2040) надсилається разом із відповідним описом клієнта Telegram Desktop. Вашу власну пару з Інструментів розробки API на [my.telegram.org](https://my.telegram.org) можна використовувати з усіма вашими обліковими записами; кожен обліковий запис все одно має власну авторизацію. | Метод | Вимоги | Підтримка TgWitness | | --- | --- | --- | | Номер телефону, код, опціональна двофакторна аутентифікація (2FA) | Доступ до облікового запису; пара API — необов’язкова | Вхід у панель | | HEX-код автентифікації + DC-ідентифікатор | Повний ключ довжиною 512 символів та DC 1–5 | Вкладка **«Ключ** прямої **авторизації»**; опціональний ідентифікатор користувача перевіряється перед збереженням авторизації | | Telethon StringSession | Дійсний рядок сеансу | Вхід у панель | | Telethon SQLite `.session` | Закритий, послідовний текст | Пряме імпортування схем із панелі 7/8; опціональний офлайн-інтерфейс командного рядка (CLI) | | Pyrogram SQLite `.session` | Закрита виробнича сесія користувача | Пряме імпортування схем із панелі 2/3 | | Telegram Desktop TData ZIP | Один сучасний обліковий запис; локальний пароль, якщо обліковий запис захищений | Перетворення в оперативній пам’яті з перевіркою контрольних сум та дешифрування | | JSON-файл облікового запису | Підтримувані поля API/сесії/ключа | Метадані самі по собі заповнюють облікові дані API; все одно потрібен вхід за допомогою сесії/ключа або номера телефону/QR-коду | | Вхід за QR-кодом | Підтвердження від офіційного додатка Telegram | Локальне генерування QR-кодів, термін дії/повторна спроба, опціональна двофакторна аутентифікація (2FA) | | TDLib / Pyrogram StringSession | Інші формати, специфічні для бібліотек | Не підтримується | | Токен бота | Бот із власною моделлю доступу та оновлення | Цей збирач даних не використовує цей інструмент | Telegram обирає спосіб доставки коду, зокрема, чи надсилати SMS. Хеш API не може відновити скасовану сесію або замінити забутий пароль 2. TgWitness не зберігає коди входу або пароль Telegram 2 на диску. Для приватного джерела обліковий запис повинен уже мати доступ. Ім’я користувача групи не потрібне. Проксі або імпорт сеансу не надають ані членства, ані прав адміністратора. Налаштування чату визначають, чи бачать учасники історію до моменту їхнього приєднання. ## Імпортувати файл сеансу Telethon Telethon SQLite, Pyrogram SQLite та Telegram Desktop TData використовують різні формати. Панель розпізнає та конвертує підтримувані структури; перейменування файлу не є конвертацією. Виберіть одну сесію та відповідний файл JSON у розділі **Файли**, натисніть **Перевірити файли**, а потім **Підключити обліковий запис**. Допускається до чотирьох відповідних файлів загальним обсягом до 8 МіБ. Детальніше про [обмеження форматів](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/) TData/JSON див. тут. Функція відновлення пароля відсутня. Вхід за допомогою телефону/двофакторної аутентифікації (2FA) або QR-коду створює окрему авторизацію. Додатковий шлях командного рядка, доступний лише для Telethon, залишається у використанні: 1. Зупиніть роботу клієнта, який використовує оригінальну сесію, і створіть її точну копію. Конвертер відхиляє файли з незавершеним WAL/журналом. Належним чином закрийте оригінальний клієнт, замість того щоб видаляти ці файли, щоб обійти перевірку. 2. У середовищі TgWitness виконайте: ``` python -m tgwitness.sessions account.session --out account.tgwitness-session ``` 1. У розділі **«Додати обліковий запис**»**→ «Файли**» завантажте результат або вставте його рядок і продовжуйте. 2. Перевірте відображений числовий ідентифікатор облікового запису, виберіть джерела та розпочніть спостереження. **Перетворений файл є незашифрованим секретом доступу до облікового запису.** Зберігайте його в захищеному сховищі та ніколи не заносьте його у репозиторій і не надсилайте стороннім сервісам конвертації. TgWitness зберігає авторизовану сесію у своєму зашифрованому сховищі. Копіювання сесії не створює окремої авторизації: не запускайте одночасно клієнти з клонованими ключами авторизації та не розраховуйте на незалежну доставку оновлень. Конвертація передає авторизацію, а не оригінальні повідомлення, кеш об’єкта чи постійний курсор оновлення. Вона не забезпечує відновлення оновлень після перезапуску процесу. ## MTProto, Telethon та проксі-сервери MTProto — це протокол Telegram. Telethon — це клієнтська бібліотека на Python, яку використовує TgWitness. MTProxy — це транспортний проксі-сервер Telegram; SOCKS5 та HTTP CONNECT забезпечують загальні тунелі. Жоден із них не замінює аутентифікацію облікового запису. Збережіть маршрут для кожного робочого простору в розділі **Додаткові інструменти → Обліковий запис → Налаштування → Налаштування з’єднання → Змінити маршрут з’єднання** перед входом у систему. Для нових робочих просторів за замовчуванням встановлено **Автоматичний MTProxy · публічні списки** з опцією **Приховати адресу**. Існуючі робочі простори, які явно використовували режим Прямий, зберігають режим, що це дозволяє. Файли читаються через з’єднання, окремі від того, що використовується для читання повідомлень, як це роблять офіційні додатки. У власному центрі обробки даних облікового запису ключ авторизації цього облікового запису використовується повторно для нового сеансу MTProto; для іншого центру обробки даних створюється один ключ, який авторизується під час підключення облікового запису і зберігається лише в пам’яті. Кожне з’єднання для роботи з файлами використовує той самий маршрут, що й обліковий запис. Їхня кількість на кожен центр обробки даних обмежується в **меню Параметри → Продуктивність → Кількість з’єднань для файлів на один центр обробки даних Telegram**; значення 0 означає, що файли читаються лише через основне з’єднання облікового запису. Одночасно може бути встановлено не більше п’яти з’єднань Telegram для всіх облікових записів в рамках однієї інсталяції. ## Режими IP Маршрут визначає тип з’єднання. Режим IP, а саме **налаштування захисту IP** у розділі «Акаунт» панелі управління, визначає, коли адреса сервера може бути розкрита. Ці налаштування не встановлюють VPN і не перенаправляють весь трафік пристрою. | Режим | Telegram | Зовнішні запити | | --- | --- | --- | | Приховати адресу (`hide`) | Використовуйте проксі-сервер; якщо жоден не працює, зачекайте. Прямого альтернативного варіанту немає. | Вимагає SOCKS5/HTTP; відхиляє запити без відповідного проксі-сервера. | | Direct — як крайній захід (`fallback`) | Автоматичний MTProxy може використовувати Direct після налаштованої затримки, а потім повернутися до робочого проксі-сервера. | Бажано використовувати налаштований зовнішній проксі-сервер або маршрут SOCKS5/HTTP облікового запису; в іншому випадку допускається використання Direct. | | Сервер, розташований за тунелем або VPN (`tunnel`) | Дозволено використання прямих маршрутів та негайного автоматичного переходу на резервний пул. | Прямий доступ дозволено, якщо не налаштовано відповідний проксі-сервер. | Режим тунелю або VPN передбачає, що ви керуєте цією мережею окремо. Без діючого тунелю адресати можуть бачити власну адресу сервера. Обирайте режим відповідно до вашої фактичної мережі, а не за назвою опції. ### Оберіть шлях | Маршрут | Налаштування | Межі | | --- | --- | --- | | Автоматичний MTProxy | Вбудовані списки або каталог операторів | Підтримує робочий маршрут Telegram; прямий резервний варіант залежить від режиму IP | | Прямий | Режим тунелю або VPN | Telethon використовує мережевий маршрут хоста | | SOCKS5 | Хост, порт, опціонально — ім’я користувача/пароль | python-socks, увімкнено віддалений DNS-адресат | | HTTP CONNECT | Хост, порт, опціонально — ім’я користувача/пароль | Простий HTTP CONNECT; TLS до самого проксі-сервера не реалізовано | | MTProxy | Хост, порт, секрет | Експериментальний формат передачі Telethon; 32 шестнадцяткові цифри або `dd` + 32 шестнадцяткові цифри | Фальшиві секретні ключі TLS `ee` відхиляються. Нормалізація в Telethon 1.45 може видаляти префікс та домен, але це не реалізує функцію Fake TLS. Вставте `tg://proxy?server=…&port=…&secret=…` або `https://t.me/proxy?server=…&port=…&secret=…` та виберіть **«Заповнити поля з посилання**». Це перевіряє та заповнює поля без підключення чи збереження; перегляньте та збережіть маршрут окремо. Поля для ручного введення залишаються доступними. Див. [проксі-посилання Telegram](https://core.telegram.org/api/links#proxy-links). ### Публічні проксі-сервери, що надаються вашою інсталяцією Вбудований список об’єднує сім джерел: [SoliSpirit/mtproto](https://github.com/SoliSpirit/mtproto), [zakky8/mtproto-proxy-pro](https://github.com/zakky8/mtproto-proxy-pro), [kort0881/telegram-proxy-collector](https://github.com/kort0881/telegram-proxy-collector), [3yed-61/MTP-Collector](https://github.com/3yed-61/MTP-Collector), [Therealwh/MTPproxyLIST](https://github.com/Therealwh/MTPproxyLIST), [KhodeJav/telegram-proxy-collector](https://github.com/KhodeJav/telegram-proxy-collector) та [tgmtproxy/telegram-mtproto-proxy-list](https://github.com/tgmtproxy/telegram-mtproto-proxy-list). У комплекті міститься знімок із даними про кінцеві точки, інформацією про джерела та датами завантаження. Ці списки є вхідними даними; на основі наведених нижче перевірок підключення визначається, які проксі-сервери будуть використовуватися. **Автоматичний MTProxy** перевіряє зв’язок із транспортом Telegram, підтримує робочий проксі-сервер і перемикається на інший у разі його збою. Робочі простори віддають перевагу різним проксі-серверам, коли доступно достатньо робочих записів; проксі-сервери можуть спільно використовувати вихідну адресу. Проксі-сервери, що зазнали збою, відпочивають перед черговою спробою. Якщо жоден не працює, режим IP визначає, чи збір даних повинен чекати, чи можна використовувати пряме з’єднання. Зміна проксі-серверів не змінює обліковий запис і не стирає його журнал. Вибір маршрутів та зміни фіксуються у підписаному журналі. Поки автоматичні маршрути активні, списки оновлюються щогодини, а перевірки трафіку виконуються за замовчуванням кожні десять хвилин. Ці інтервали можна налаштувати. **Оновлення публічних списків** вимагає оновлення; сам перегляд списку не змінює збережений ручний маршрут. **Трафік Telegram та HTTPS-запити використовують різні маршрути.** Завантаження списків використовують окреме HTTPS-з’єднання та наданий маршрут зовнішніх запитів. «`TGWITNESS_PROXY_FEED_PROXY`» явно замінює цей маршрут проксі-сервером HTTP/SOCKS5; обидва варіанти колектора Compose перенаправляють його. Фоновий пул слідує за основною робочою областю. Жодних сесій Telegram, облікових даних API, токенів панелі чи токенів ботів не надсилається постачальникам даних. Назви постачальників, дати знімків та маршрут завантаження вказані в розділі **«Звідки походить список**». MTProxy передає лише трафік Telegram. HTTP-операції робочого простору, такі як мітки часу, сповіщення, позасайтові копії та перевірки джерел, використовують окремий SOCKS5/HTTP-проксі, якщо він налаштований, а потім — маршрут SOCKS5/HTTP облікового запису. Без жодного з них функція «Приховати адресу» відхиляє запит; інші режими дозволяють прямий доступ. Зовнішні запити можна вимкнути. Явно налаштований проксі для завантаження стрічки залишається окремим переопределением оператора. Незалежна служба свідків зберігає власний маршрут. Для приватних сервісів, що управляються оператором, існуюче налаштування серверного середовища `TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1` дозволяє приватні адреси призначення та зберігає визначення імені хосту на стороні проксі. Його неможливо ввімкнути з панелі. Режим «лише публічні» відхиляє адреси призначення у форматі `.onion` перед запитом до публічного резолвера; сервіси Tor onion вимагають явного налаштування приватних адрес призначення та відповідного проксі. Ця поведінка DNS застосовується до зовнішніх HTTP-операцій, а не до транспортного протоколу Telegram. Cloudflare надає документацію щодо [кінцевої точки DNS у](https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/) [форматі](https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/) [JSON](https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/). ****Параметри автоматичного пулу**** У розділі **Додаткові інструменти → Параметри → Автоматичний MTProxy** налаштуйте поріг відмови, час очікування, заплановану ротацію, спільне використання проксі та допустиму затримку переходу на резервний варіант. | Контроль | За замовчуванням | | --- | --- | | Відключення перед заміною | 3 протягом 10 хвилин | | Кількість проксі-серверів, які перевіряються під час кожної спроби з’єднання | 3 | | Перший / максимальний час очікування після збою | 10 хвилин / 6 годин | | Запланована ротація | Вимкнено; увімкнути у разі збою | | Кількість облікових записів на один проксі-сервер | 0: надавайте перевагу окремим записам, об’єднуйте їх за потреби. Встановіть 1, щоб очікувати на ексклюзивний запис. | | Затримка перед дозволеним прямим переходом на резервний варіант | Протоколи 10; Функція приховування адреси все ще відмовляється працювати | | Оновлення стрічки / перевірки передачі даних | Протоколи 60 / 10; значення основної робочої області застосовуються до спільного пулу | Різні проксі-сервери можуть використовувати одну вихідну адресу. Обмеження Telegram застосовуються на кожному маршруті. Щоб замінити публічний список на власний каталог операторів, налаштуйте наведені нижче параметри заміщення. Це повністю вимикає зовнішні підписки, навіть якщо масив `proxies` порожній. Скопіюйте [порожній каталог у папку](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proxies.config.example)`proxy-config/proxies.json` та додайте свої розгорнуті публічні кінцеві точки: ``` {"format": "tgwitness-proxy-catalog-v1", "proxies": [ {"id": "project-eu", "label": "Project EU", "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"} ]} ``` Приклади значень необхідно замінити. Допускається до 32 різних записів. Автентифікований список повертає мітки/хости/порти без спільних секретів; вибір одного з них зберігає його облікові дані у сховищі робочого простору. Доступність залишається неперевіреною до проведення явного тесту транспорту. У разі неправильно сформованого каталогу залишається можливість ручної конфігурації. Запуск у нативній середовищі: вкажіть `TGWITNESS_PROXY_CATALOG` як місцевий шлях до файлу JSON. Docker: ``` docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build ``` Накладка монтує каталог `proxy-config` у режимі «тільки для читання»; файли повинні бути доступні для читання контейнером з UID 10001. Цей каталог виключено з Git, контексту збірки Docker та архівів вихідного коду. Цей каталог налаштовує облікові записи для збору даних; [бот-свідок](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/) використовує власний маршрут HTTP/SOCKS5, а не MTProxy. Прямий резервний варіант регулюється режимом IP, описаним вище. Призупиніть спостереження перед зміною маршруту. Збереження розриває з’єднання зі старими клієнтами та скасовує незавершений вхід; новий клієнт використовує збережений маршрут. Прив’язка журналу/сесії до облікового запису зберігається. Налаштування замінюють попередній маршрут: під час редагування введіть облікові дані проксі-сервера заново. Реквізити облікових даних шифруються за алгоритмом `network.enc`. API не повертає ім’я користувача, пароль або секретний ключ. Підписані записи містять тип маршруту та інформацію про наявність реквізитів облікових даних, виключаючи кінцеву точку та секретні ключі. Оператор може бачити кінцеву точку на панелі. Поля з секретними даними очищаються після збереження, блокування або перемикання робочих просторів. **Функція «Перевірити з’єднання з Telegram»**, доступна також до входу в систему, відкриває та закриває тимчасове неавторизоване з’єднання з Telegram через маршрут. Вона не звертається до веб-сайту для перевірки IP-адреси. Успішне виконання функції підтверджує наявність транспортного з’єднання, але не означає доступ до груп, повну доставку повідомлень або анонімність. Проксі застосовується до з’єднань клієнта Telegram, включаючи завантаження медіафайлів із серверів Telegram DC. Браузер, pip, SSH та інструменти TSA, що запускаються вручну, мають окремі маршрути. Ім’я хосту проксі може вирішуватися локально. `rdns` впливає на імена хостів призначення; Telegram часто надає числові IP-адреси DC. SOCKS5 та звичайний HTTP CONNECT самі по собі не шифрують облікові дані проксі-сервера або тунель клієнт-проксі. MTProto окремо захищає трафік Telegram. Використовуйте відповідний захищений канал для з’єднання з проксі-сервером у ненадійній мережі. Приватні групи — це хмарні чати, захищені MTProto під час передачі; Секретні чати з наскрізним шифруванням — це окремий тип чату, який реєструється [модулем Секретний чат](https://phishdestroy.io/tgwitness/uk/docs/reference/secret-chats/). ## Шифрування та підписи | Рівень | Реалізовано | Відповідальність оператора | | --- | --- | --- | | Трафік Telegram | Telethon MTProto | Довіра до платформи, маршрут та доступність | | Веб-панель | Токен-носій, петлеве підключення за замовчуванням, обмеження на кількість запитів | HTTPS або SSH-тунель для віддаленого доступу | | Секрети | Fernet для облікових даних API, сеансів, облікових даних проксі-серверів та приватного ключа для підпису | Захистіть ключ дешифрування та хост, на якому працює програма | | Ключ сховища | Локальний ключ або зовнішній головний ключ для нової інсталяції | Окреме захищене сховище та резервне копіювання ключів | | Повідомлення та вкладення | Зберігання даних додатка у вигляді відкритого тексту | Зашифрований диск/том | | ZIP/JSONL/CSV/HTML | Перевірка цілісності, відсутність шифрування вмісту | Захист експортованих копій та передач | | Походження та час | Підписаний журнал, підтвердження обробки, інструменти RFC 3161 | Довірений ключ, незалежні контрольні точки/TSA та процедура зберігання | **Захист сховища** в обліковому записі відображає ці стани. Токен панелі є секретом доступу, а не паролем шифрування. Він надає адміністраторський доступ; [видані токени](https://phishdestroy.io/tgwitness/uk/docs/reference/access/) можуть бути обмежені обліковими записами та чатами. Робочі простори використовують спільний хост-процес і не є ізольованими орендарями. BitLocker, LUKS, FileVault або керований зашифрований том можуть захистити сховище в рамках відповідних моделей загроз. Адміністратор розблокованої машини, що працює, все одно може читати дані. У плануванні сховища слід враховувати файли SQLite WAL/SHM, мультимедіа, тимчасові експортовані дані, обмінну пам’ять, резервні копії та завантажені з браузера файли. Том Docker не шифрується лише тому, що це том. ## Зовнішній головний ключ Для **нової** інсталяції розмістіть головний ключ поза каталогом даних. Це не призведе до автоматичного перенесення існуючого сховища локальних ключів. Підготуйте каталог ключів, доступ до якого має лише ідентифікатор служби, а потім виконайте: ``` python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key python -m tgwitness --data-dir /private/observations/new-case ``` PowerShell із використанням встановленого середовища проекту: ``` python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key $env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key' python -m tgwitness --data-dir E:\PrivateData\new-case ``` У Docker підключіть файл у режимі «тільки для читання» поза межами `/data`, наприклад, у `/run/secrets/tgwitness-master.key`, і встановіть змінну середовища на цей шлях. UID служби повинен мати права на читання цього файлу. Передавайте шлях, а не байти ключа, через файли середовища/конфігурації. Кожен робочий простір отримує випадковий публічний солт та власний ключ Fernet, отриманий за допомогою HKDF-SHA256. `vault.external.json` зберігає метадані виведення, а не головний ключ. Відсутність або неправильність ключа призводить до збою запуску без його автоматичної заміни. Зберігайте як метадані солта, так і головний ключ для відновлення. Усі робочі середовища походять від одного головного ключа; його компрометація впливає на всю інсталяцію. Процес, що виконується, може розшифровувати секретні дані. Це не HSM і не KDF на основі пароля. Довільні паролі, створені людиною, не приймаються замість випадкового ключа. Зберігайте існуючий ключ для існуючих інсталяцій доти, доки не буде здійснено та перевірено цілеспрямовану міграцію. Видалення `vault.key` або заміна головного ключа може призвести до втрати доступу до сесій/ключів підпису. Зберігайте зашифровані резервні копії та ключі окремо та перевіряйте можливість відновлення в ізольованому екземплярі. --- # Telegram · Впровадження Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/deployment/ Запускайте TgWitness як службу на Windows, Linux, macOS або в Docker, через HTTPS, із резервним копіюванням та оновленнями. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Запускайте TgWitness як службу на Windows, Linux, macOS або в Docker, через HTTPS, із резервним копіюванням та оновленнями. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документація](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Розгортання та відновлення](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) **Англійська** · [Русский](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/DEPLOYMENT.md) · [Українська](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/DEPLOYMENT.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/DEPLOYMENT.md) · [Португальська (Бразилія)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/DEPLOYMENT.md) · [Türkçe](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/DEPLOYMENT.md) · [العربية](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/DEPLOYMENT.md) · [فارсі](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/DEPLOYMENT.md) · [урду](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/DEPLOYMENT.md) · [हिन्दी](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/DEPLOYMENT.md) · [Індонезійська](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/DEPLOYMENT.md) · [Tiếng Việt](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/DEPLOYMENT.md) · [简体中文](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/DEPLOYMENT.md) ## Оберіть варіант встановлення Для отримання портативного пакета розпакуйте файл `TgWitness--windows-amd64-portable.zip` з GitHub Releases. Для інших методів завантажте та розпакуйте ZIP-архів з вихідним кодом або клонуйте репозиторій, а потім виконайте наступну команду з каталогу проєкту: | Встановлення | Початок | Працює у фоновому режимі? | | --- | --- | --- | | Портативний пакет для Windows | `TgWitness.cmd` | Ні; залиште вікно відкритим. | | Вбудована у Windows | `Start.cmd` | Ні; для роботи у фоновому режимі використовуйте додаткове завдання входу в систему. | | Вбудована підтримка Linux/macOS | `sh start.sh` | Ні; для роботи у фоновому режимі використовуйте systemd/launchd. | | Docker на будь-якому підтримуваному хості | `docker compose up -d --build --wait` | Так, поки працює демон Docker. | | Допоміжний інструмент для Docker у Windows | `scripts\Docker.cmd` | Так; допоміжна програма очікує на стан працездатності веб-сервера. | | Допоміжний інструмент для Docker на Linux/macOS | `sh scripts/docker-start.sh` | Так; допоміжна програма очікує на стан працездатності веб-сервера. | Щодо хмарного сервера, який має бути доступним для перевірки третьою стороною — створеного за допомогою API провайдера, без SSH, доступ до якого здійснюється виключно через Cloudflare Tunnel — див. [розділ «Розгортання з високим рівнем надійності](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/)». Вбудований запуск створює приватний файл `.venv` та встановлює закріплені залежності. Docker компілює їх усередині образу, не потребуючи Python на хості. Для первинного налаштування потрібен доступ до Інтернету. Якщо Python 3.11+ не знайдено, `Start.cmd` запитує до встановлення Python 3.12 для поточного користувача Windows (winget, інакше — інсталятор з python.org після перевірки підпису Python Software Foundation); він ніколи не вимагає прав адміністратора. Docker та служби ОС залишаються обов’язковими вимогами. Нативні та портативні інсталяції використовують `data/live` у своїй папці. Docker використовує том із назвою `tgwitness-data`, розташований за адресою `/data`. Це окремі інсталяції, доки ви свідомо не перенесете весь каталог даних. Не очікуйте, що новий контейнер Docker автоматично виявить нативні облікові записи. ## Вимоги до встановлення Для нативна інсталяція потрібні Python 3.11 або новішої версії з `venv` та `ensurepip`, доступ до Інтернету для інсталяції першої залежності, а також каталог проєкту з правом запису для `.venv`. Для панелі, що входить до комплекту, не потрібні Node.js чи фронтенд-збірка. Запустіть програму-запускач зі свого звичайного облікового запису в ОС; TgWitness не вимагає прав адміністратора/root. - **Windows:** `Start.cmd` перевіряє `py -3`, потім `python`, потім стандартні папки для кожного користувача та папку «Program Files», і вимагає версії 3.11 або пізнішої. Якщо жодна з них не працює, пропонується автоматична інсталяція для кожного користувача, описана вище. `py -3 start.py` також працює. Портативний пакет взагалі не потребує Python. - **Linux:** `start.sh` перевіряє `python3.13`, `python3.12`, `python3.11`, `python3` та `python` і виводить команду встановлення для apt, dnf, pacman, zypper, apk або Homebrew, якщо жодна з них не підходить. Для встановлення в Debian/Ubuntu може знадобитися пакет `python3-venv`, що відповідає обраному інтерпретатору. Стару версію Python, встановлену за замовчуванням у дистрибутиві, необхідно замінити або доповнити Python 3.11+. - **macOS:** встановіть актуальну дистрибуцію Python 3.11+; не вважайте, що інтерпретатор, наданий ОС, відповідає вимогам. Використовуйте файл `python3 start.py` із каталогу проєкту. - **Docker:** використовуйте Docker Engine/Desktop із Compose v2.20 або новішою версією. Docker Desktop повинен використовувати контейнери Linux у Windows. Контейнер встановлює свої власні залежності Python; на хості не потрібно окремо встановлювати Python. ## Локальний комп’ютер Використовуйте `Start.cmd` у Windows або `sh start.sh` у Linux/macOS. `scripts\Setup.cmd` або `sh start.sh --setup-only` готує середовище. Програма запуску встановлює залежності під час першого використання; подальші запуски використовують уже готове середовище. Для налаштування та збору даних Telegram потрібен доступ до Інтернету, але перегляд існуючих записів та створення експортних файлів працюють в автономному режимі. Після налаштування запустіть `python start.py --check`, щоб перевірити локальні залежності, Ed25519, сховище, конфігурацію ключів та адресу прослуховування без запуску колектора. Використовуйте `--json` для структурованого виводу. Передайте потрібні `--data-dir`, `--host` та `--port`. Ця перевірка не встановлює пакети, не створює журнал і не підключається до Telegram; вона не є перевіркою цілісності чи повноти охоплення. Під час запуску окремо перевіряються існуючі журнали. `python start.py --help` також дозволяє уникнути інсталяції. Після запуску start.py виконайте допоміжні команди з `.venv\Scripts\python.exe` у Windows або `.venv/bin/python` у Linux/macOS, або спочатку активуйте це середовище. Наведені нижче приклади `python -m ...` передбачають, що середовище вже активне. ``` python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787 ``` Змінні середовища: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE вибирає режим зовнішнього ключа для нової інсталяції; див. [Зовнішній головний ключ](https://phishdestroy.io/tgwitness/uk/docs/reference/security/#external-master-key). TGWITNESS_TOKEN, якщо вказано, має містити щонайменше 24 символів; використовуйте криптографічно випадкове значення. Без нього програма генерує 256-бітний випадковий токен у файлі panel-token.txt. Перезапис із середовища не змінює цей файл. Перезапустіть систему, щоб оновити облікові дані. Каталог даних може належати лише одному процесу. Міжплатформова блокування файлів ОС запобігає випадковим одночасним операціям запису. Використовуйте один робочий процес Uvicorn. Панель може керувати будь-якою кількістю робочих просторів, з додатковими каталогами робочих просторів у профілях profiles//. Для окремих екземплярів служби використовуйте окремі каталоги та порти. Файли WAL SQLite мають зберігатися у локальному постійному сховищі, а не в мережевій файловій системі. Не використовуйте один том для декількох реплік. ## Портативний пакет для Windows Кожен реліз на GitHub містить `TgWitness--windows-amd64-portable.zip` та його `.sha256`. Він містить офіційне вбудовуване середовище виконання Python 3.12 з python.org (контрольна сума зафіксована в `tools/build_portable.py`), TgWitness та його зафіксовані залежності, а також три програми запуску: | Файл | Мета | | --- | --- | | `TgWitness.cmd` | Запустіть панель; додаткові параметри передаються, наприклад, `TgWitness.cmd --port 8790` | | `TgWitness-Demo.cmd` | Запустіть синтетичну демонстрацію за посиланням `data\demo` | | `TgWitness-Check.cmd` | Виконайте перевірку готовності, не запускаючи програму | Закріплений російський морфологічний словник та профілі кольорів у форматі PDF включені до пакету для офлайн-використання. Упаковка допускає лише відомі шляхи до файлів у каталогах залежностей `data`; наявність несподіваних файлів у цих каталогах призводить до збою збірки. Розпакуйте весь архів у папку з правами на запис, наприклад `Documents\TgWitness`; не запускайте програму зсередини ZIP-архіву або з папки «Program Files». Середовище виконання використовує ізольований шлях до модулів, тому інші інсталяції Python та `PYTHONPATH` не впливають на нього. Дані зберігаються у папці `data` цього пакету. Для оновлення зупиніть TgWitness, розпакуйте нову версію в нову папку та скопіюйте туди папку `data`. Створіть його самостійно на 64-бітній Windows із Python 3.12: ``` python tools/build_portable.py ``` ## Контейнер ``` docker compose up -d --build --wait ``` Це створює іменований постійний том для /data. Веб-порт прив’язано до 127.0.0.1:8787. Процес працює під UID 10001 із обмеженими правами, кореневою файловою системою тільки для читання та каталогами /data та /tmp, доступними для запису. `--wait` перевіряє працездатність веб-сервера перед поверненням; авторизація та доставка Telegram відображаються на панелі. Надані допоміжні програми використовують 180-секундний тайм-аут готовності після збірки. Початкове завантаження залежностей може тривати довше. Обидва базові файли Compose використовують назву проєкту `tgwitness`, тому розпакування нового релізу в інший каталог не призведе до автоматичного вибору нового тома даних. Залишайте активним лише одне розгортання для цього проєкту. Для незалежних інсталяцій використовуйте унікальний `docker compose -p NAME ...` та інший порт хосту, і зберігайте обидва під час оновлень. Для старішого розгортання, що використовує іншу назву проєкту, продовжуйте використовувати його оригінальну назву разом із `-p`; `docker compose ls` перелічує існуючі проєкти. Скопіюйте `deploy/env.example` до `.env` та змініть `TGWITNESS_PORT`, щоб використовувати інший порт зворотного зв’язку. Наприклад, `TGWITNESS_PORT=8788` відкриває доступ до панелі за адресою `http://127.0.0.1:8788`; контейнер як і раніше прослуховує порт 8787. `.env` ігнорується Git. Отримати початковий токен: ``` docker compose exec tgwitness cat /data/panel-token.txt ``` Корисні команди: ``` docker compose ps docker compose logs --tail 100 -f docker compose stop docker compose up -d --wait ``` `restart: unless-stopped` перезапускає колектор після збою або перезапуску демона Docker. На сервері під управлінням Linux увімкніть Docker під час завантаження за допомогою менеджера служб вашого дистрибутива, зазвичай `sudo systemctl enable --now docker`. У Windows/macOS увімкніть параметр «запускати під час входу» у Docker Desktop. Вихід із системи, перехід у режим сну або зупинка демона Docker можуть перервати збір даних. Явно зупинений контейнер залишається зупиненим, доки ви його знову не запустите. У наведеному прикладі конфігурації обсяг тома /tmp обмежено 512 Мб. Механізм експорту замість цього використовує папку ``temporary-exports/`` кожного робочого простору на постійному томі /data. Зарезервуйте там місце для одночасних експортів, зростання журналу/WAL, мультимедіа та резервних копій. Програма запуску використовує файл `deploy/constraints.txt` для фіксації відповідних версій залежностей середовища виконання. Сервери Docker та сервери з високим рівнем безпеки встановлюються на основі файлів deploy/requirements.lock та deploy/build.lock за допомогою команди pip --require-hashes: кожен файл пакета повинен відповідати SHA-256, зафіксованому у коміті, тому файл, замінений на PyPI або дзеркалі, відхиляється. Пакеті, які поставляються лише у вигляді вихідного коду (jieba, pyaes), компілюються з використанням setuptools, зафіксованих у файлі deploy/build.lock (опція `--no-build-isolation`) за допомогою запускача, портативного компілятора для Windows та файлу Dockerfile, тож pip не створює окремого, незафіксованого середовища компіляції. Базовий образ Python та пакети операційної системи все ще потребують незалежної кваліфікації випуску. Не використовуйте команду `docker compose down -v`, якщо ви не маєте наміру знищити журнал та ключі. Звіт про стан контейнера відображає доступність веб-сервера, а не успішність збору даних Telegram. Перевіряйте стан колектора панелі, сигнал активності, помилки та події покриття. ### Профіль незалежного свідка Опціональний сервіс `witness` запускає [незалежного свідка](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/) у власному контейнері, з власним ключем та журналом у томі `witness-data` і лише токеном свідка, доступним лише для читання, для колектора. Створіть токен у панелі в розділі **Більше інструментів → Додаткові → Незалежний свідок**, додайте його разом із токеном бота та каналом до файлу `.env`, а потім запустіть профіль: ``` docker compose --profile witness up -d # deploy/compose/compose.image.yaml: same flag docker compose logs witness # witness key fingerprint ``` Сервіс підключається до колектора в мережі Compose за адресою `http://tgwitness:8787` (`TGWITNESS_WITNESS_COLLECTOR` замінює її, наприклад, `/profiles/` для іншого робочого простору). Для свідка на окремому сервері, яким керує хтось інший, використовуйте `deploy/compose/compose.witness.yaml` , встановивши для `TGWITNESS_WITNESS_COLLECTOR` HTTPS-адресу колектора; цей файл містить лише свідка. ## Встановити опублікований образ Скопіюйте `deploy/env.example` у `.env`. Встановіть `TGWITNESS_IMAGE` на опубліковану версію, використовуючи шлях до репозиторію **з малими літерами**, наприклад: ``` TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3 TGWITNESS_PORT=8787 ``` Запустіть цей файл окремо, замість `compose.yaml`: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt ``` На хості не потрібні збірка з вихідного коду, Python чи компілятор. Процес випуску орієнтований на контейнери Linux AMD64 та ARM64, включаючи віртуальну машину Linux у Docker Desktop. Використовуйте тег версії або `ghcr.io/owner/repository@sha256:...` із підсумку робочого процесу. Не налаштовано переміщення тегу `latest` або автоматичне оновлення додатка. Образ та варіанти вихідного коду використовують один і той самий том даних, якщо назви їхніх проєктів збігаються. ## Автоматичне ввімкнення HTTPS на сервері Використовуйте сервер із Docker, домен, який ви контролюєте, та постійне локальне сховище. Направте записи A/AAAA домену на сервер; публікуйте AAAA лише в тому випадку, якщо до нього досягає IPv6. Дозвольте вхідний трафік по TCP 80 та 443, а також вихідний трафік DNS/HTTPS для видачі сертифікатів. Ці порти не повинні бути зайняті іншими службами. Скопіюйте `deploy/env.example` у `.env` та вкажіть ім’я хосту без схеми та шляху: ``` TGWITNESS_DOMAIN=watch.your-domain.org ``` Запустіть збірку вихідного коду з накладенням HTTPS: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt ``` ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait ``` Для опублікованого зображення замість цього використовуйте `deploy/compose/compose.image.yaml` як перший файл. Збережіть обидва аргументи `-f` для подальших команд status, logs, update та stop. Caddy отримує та поновлює сертифікат, перенаправляє HTTP на HTTPS та пересилає запити до колектора у приватній мережі Compose. Стан сертифіката зберігається у власному постійному томі. Порт прямого хосту колектора залишається лише для локального з’єднання. Надана конфігурація Caddy не вмикає реєстрацію доступу. Відкрийте `https://watch.your-domain.org` та введіть токен панелі. Перевірка готовності охоплює контейнери; видача сертифікатів та зовнішня доступність залежать від DNS та брандмауера. Якщо HTTPS не готовий, перевірте DNS, правила брандмауера та: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy ``` Наданий образ Caddy відповідає тегу `2-alpine`. Виконання команди pull оновлює цей образ; якщо вам потрібні фіксовані версії інфраструктури, закріпіть перевірений дайджест у вашому розгортанні. ## Оновлення та резервні копії Зберігайте назву проєкту Compose та обсяг даних під час оновлень. Спочатку зупиніть колектор і створіть повну резервну копію. Для розгортання за замовчуванням на основі вихідного коду: ``` docker compose stop docker compose cp tgwitness:/data ../tgwitness-backup-before-update ``` Кожного разу використовуйте нове місце для резервного копіювання, поза межами репозиторію, та захищайте його як матеріал, що вимагає доступу до облікового запису. Наведений приклад шляху є ілюстративним; використовуйте своє власне місце для резервного копіювання. Скопіюйте весь каталог, включаючи приховані файли, усі робочі простори, ключі, журнали та мультимедійні файли. Окремо створіть резервну копію головного ключа зовнішнього сховища, якщо він налаштований. ZIP-архів з доказами не є резервною копією програми, яку можна відновити. Для HTTPS також збережіть томи Caddy, якщо вам потрібно зберегти стан його сертифіката/облікового запису. Для розгортання з вихідного коду завантажте файли нової версії та виконайте: ``` docker compose up -d --build --wait ``` Для розгортання образу змініть `TGWITNESS_IMAGE` на бажану версію, а потім виконайте: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait ``` Використовуйте файли Compose вашої інсталяції також для наведених вище команд stop/copy. Збережіть `.env`, власні налаштування та ту саму назву проєкту. `down` зберігає іменовані томи; **`down -v` видаляє їх**. Не копіюйте `.venv` між операційними системами або версіями Python. Для оновлення з вихідного коду зупиніть TgWitness, створіть резервну копію всього каталогу даних , замініть вихідні файли та запустіть `python start.py --setup-only` перед запуском програми. Перевіряйте доступ до панелі, ідентичність облікового запису, стан спостережень та охоплення після оновлення. Після перезапуску TgWitness відновлює збережену позицію оновлення Telegram та запитує оновлення, пропущені під час оновлення. Для відкату може знадобитися резервна копія, створена до оновлення, якщо майбутня версія змінить формати зберігання. ## Віддалений сервер Забезпечте, щоб сервіс працював у режимі loopback та використовував SSH-тунель, або завершуйте HTTPS на зворотному проксі. Базовий файл Compose доступний лише локально; опціональний оверлей `deploy/compose/compose.https.yaml` надає Caddy для налаштованого домену. Не допускайте появи токена носія в URL-адресах та журналах проксі-сервера. Зворотний проксі-сервер повинен обмежувати розмір запитів та частоту з’єднань. Не відкривайте доступ до простого HTTP в Інтернеті. Приклади для systemd, завдання входу в систему Windows, агента користувача macOS та Caddy наведено у [папці deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Перегляньте та адаптуйте їхні шляхи перед встановленням. Це лише шаблони, а не локально виконувані налаштування платформи. Звичайний запускач не реєструє жодних фонових служб чи завдань. У Windows безвіконний запуск `pythonw.exe` зберігає діагностичні дані запуску/сервера у файлі `logs/server.log` у каталозі даних (5 МіБ на файл, дві чергові резервні копії). Запуск у консолі зберігає консольні журнали. Реєстрація доступу по HTTP вимкнена в обох режимах. Захищайте журнали разом із каталогом даних та перевіряйте їх перед тим, як надавати доступ. ## Перезапуск та прогалини Останній запитуваний стан спостереження зберігається. Якщо спостереження було активним, під час запуску програма намагається відновити з’єднання та продовжити моніторинг вибраних джерел. Ручна пауза скасовує цю дію. Невдалий перезапуск фіксується та відображається на панелі. TgWitness зберігає позицію оновлення Telegram для облікового запису та для кожного каналу (pts, qts, seq та date) у сховищі робочого простору та відновлює її під час наступного запуску. Потім клієнт запитує оновлення, пропущені під час зупинки процесу, а періодична повторна перевірка відновлює пропущені повідомлення та фіксує збережені, які Telegram більше не повертає. Діалоги перезавантажуються під час запуску. При кожному запуску фіксуються попередня головка журналу, межа офлайн-режиму та позиція оновлення, з якої відбулося відновлення. Монітор перевіряє підключення кожні 10 секунд і додає сигнал активності щохвилини (**Більше інструментів → Параметри → Запис активності кожні**). Втрати з’єднання та періоди мовчання фіксуються як прогалини в покритті із зазначенням причини. Знімки історії зберігаються як окремі спостереження поточної історії поруч із записами в режимі реального часу. Черга мультимедіа зберігається в базі даних SQLite кожного робочого простору. Повідомлення та його завдання фіксуються атомарно. Перервані завдання відновлюються для повторної спроби під час запуску. Кожне завантаження має базовий тайм-аут у 120 секунд плюс час, необхідний для завантаження файлу розміром 256 КіБ/с, а також 1–2,000 MiB на тип вкладення; час очікування, швидкість та кількість спроб налаштуються в розділі **Додаткові інструменти → Параметри**. Колектор пропускає файли, розмір яких невідомий. Призупинення зберігає роботи в черзі. Повторна спроба використовує оригінальний спостережуваний дескриптор файлу, а не останню версію повідомлення, яке було відредаговано згодом. Тимчасові збої мають обмежену кількість спроб; паузи FloodWait для медіа зберігаються після перезапуску. Відновлення медіа є окремим від відновлення оновлень Telegram і не може відтворити зниклі файли. ## Резервне копіювання, відновлення та ємність `tgwitness backup FOLDER` копіює каталог даних, поки панель продовжує працювати: спочатку контрольні точки, потім файли SQLite через API онлайн-резервного копіювання, а потім ключі, мультимедіа та профілі, тому жодна скопійована контрольна точка не є новішою за скопійований журнал. У файлі `backup-manifest.json` перелічено SHA-256 кожного файлу та заголовки журналів. Для відновлення зупиніть TgWitness і замініть весь каталог даних цією папкою. Під час наступного запуску фіксується, що журнал було відновлено зі старішої копії. Цей запис порівнює журнал із заголовком, що зберігається в `TGWITNESS_STATE_DIR` — папці поза каталогом даних: том `tgwitness-state` у Compose, `/var/lib/tgwitness-state` у модулях systemd, а в інших випадках — у локальній папці стану користувача . Без папки стану з правом запису відновлення не виявляється, про що один раз повідомляється у журналі. Якщо ця команда відсутня, зупиніть процес перед копіюванням **усього каталогу даних**, включаючи файли vault.key, signing.enc, credentials.enc, файли бази даних SQLite та WAL, мультимедіа, токен, контрольні точки, а також усі підкаталоги profiles/. Відновіть повну копію, коли служба призначення зупинена. Відсутність ключів сховища або невідповідність ключів підпису призведе до збою запуску; не слід перегенерувати ключі для примусового доступу. Зберігайте секретні резервні копії у зашифрованому вигляді з контролем доступу. ZIP-архіви з доказами є портативними артефактами для перегляду, а не резервними копіями додатків чи сеансів Telegram. Автоматичного видалення після закінчення терміну зберігання не відбувається. Заплануйте місце на диску для всіх повідомлень, необроблених метаданих, мультимедіа, тимчасових експортів та резервних копій. Запуск верифікації та експорту записів потоку замість завантаження всього журналу. Експорт фіксує знімок стану на момент зчитування, тоді як нові записи WAL можуть продовжуватися; тривалі експорти можуть зберігати сторінки WAL, тому ємність диска все ще має значення. Розмір ZIP-архівів обмежено 4 ГіБ у нестисненому вигляді, щоб відповідати налаштуванню за замовчуванням незалежного верифікатора; **Більше інструментів → Параметри → Найбільший підписаний ZIP** підвищує обмеження, і такі архіви перевіряються за допомогою `verify.py --max-gib N`. Інші формати не мають обмеження на кількість подій. Підтримувані браузери передають фрагменти відповіді у потоковому режимі до файлу, обраного користувачем. Інші браузери буферизують не більше 128 МіБ і направляють більші передачі до автентифікованого CLI: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Використовуйте `--profile ID` з **меню «Експорт» → «Ідентифікатор робочого простору»** для іншого робочого простору, `--format zip|jsonl|csv|html`, `--url https://your-server` для віддаленого сервера або `--max-mib`, щоб змінити обмеження на передачу даних у 5 ГіБ. Простий HTTP дозволено лише для петлевого з’єднання. Токени передаються в заголовках, перенаправлення відхиляються, існуючі файли не перезаписуються, а незавершені завантаження не публікуються як завершені файли. Якщо TGWITNESS_TOKEN замінює згенерований токен, використовуйте окремо захищений файл, що містить це активне значення: файл panel-token.txt не перезаписується при заміщенні. SHA-256 команди є лише контрольною сумою передачі; незалежно перевірте підписаний ZIP-файл. Панель відображає медіафайли в черзі/з помилками, найстаріші медіафайли в очікуванні, вільне місце на диску, паузи у запитах до Telegram та джерела, доступ до яких не підтверджено. Ці діагностичні дані не є повноцінним монітором доставки «від кінця до кінця». Робочі простори використовують спільний процес; обліковий запис із великим трафіком може все одно впливати на інші. Залишаються окремі робочі процеси, зберігання/ротація, відновлення стійких оновлень та повна кваліфікація розгортання. Доступ до панелі з обмеженим обсягом повноважень задокументовано у розділі [«Доступ та дозволи»](https://phishdestroy.io/tgwitness/uk/docs/reference/access/); незалежні контрольні точки висвітлено у [посібнику для свідків](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/). Детальні інструкції: [підключення/безпека](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/) та [режими роботи](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/). --- # Phala / Intel TDX · Розгортання з високим рівнем безпеки Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/ Захищений сервер, що працює цілодобово без вихідних, на Hetzner або Phala Cloud, шлюз DNS та перевірки, які може повторити третя сторона. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Захищений сервер, що працює цілодобово без вихідних, на Hetzner або Phala Cloud, шлюз DNS та перевірки, які може повторити третя сторона. [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) Розгортання з високим рівнем надійності додає незалежні перевірки середовища збору даних до верифікації архіву. Рецензент запитує записи про розгортання та доступ, що зберігаються у хмарного провайдера та Cloudflare, а розгортання Intel TDX додає апаратну атестацію середовища колектора. Звичайне використання локальних середовищ та Docker залишається без змін. Ніщо тут не працює, доки ви не розгорнете систему за допомогою `python -m tgwitness.cloud`, а колектор зчитує дані зі свого хоста лише тоді, коли розгортання встановлює `TGWITNESS_ASSURANCE`. Блок-схема · Оператор → Сервер, брандмауер без правил вхідного трафіку (API-інтерфейс провайдера); Оператор → Тунель і DNS (API Cloudflare); Сервер, брандмауер без правил вхідного трафіку → Тунель і DNS (тільки вихідні повідомлення); Сервер, брандмауер без правил вхідного трафіку → Ключ підпису, створений на сервері; Verifier, токени тільки для читання → Журнал провайдера та брандмауер; Verifier, токени тільки для читання → Адреса тунельного коннектора та вхідний трафік; Verifier, токени тільки для читання → Підписана заява /api/assurance; Verifier, токени тільки для читання → ЗIP-архів доказів · Оператор · Verifier, токени тількидля читання · Сервер, брандмауер безправил вхідного трафіку · Журнал провайдера табрандмауер · Адреса тунельногоконнектора та вхіднийтрафік · Підписана заява/api/assurance · ЗIP-архів доказів · Тунель і DNS · Ключ підпису, створений насервері · API-інтерфейс провайдера · API Cloudflare · тільки вихідні повідомлення **Діаграма у вигляді тексту** 1. Оператор → Сервер, брандмауер без правил вхідного трафіку (API-інтерфейс провайдера) 2. Оператор → Тунель і DNS (API Cloudflare) 3. Сервер, брандмауер без правил вхідного трафіку → Тунель і DNS (тільки вихідні повідомлення) 4. Сервер, брандмауер без правил вхідного трафіку → Ключ підпису, створений на сервері 5. Verifier, токени тільки для читання → Журнал провайдера та брандмауер 6. Verifier, токени тільки для читання → Адреса тунельного коннектора та вхідний трафік 7. Verifier, токени тільки для читання → Підписана заява /api/assurance 8. Verifier, токени тільки для читання → ЗIP-архів доказів **На цій сторінці** - [Що може перевірити верифікатор](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#what-a-verifier-can-check) - [Провайдери](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#providers) - [Конфіденційна віртуальна машина на Phala Cloud (Intel TDX)](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) - [Перед початком роботи](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#before-you-start) - [З панелі](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#from-the-panel) - [Швидкий тунель без домену](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#quick-tunnel-without-a-domain) - [Розгортання](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#deploy) - [Налагодження розгортання та блокування](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#debug-deployment-and-lock) - [Видалити розгортання](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#remove-a-deployment) - [Будь-який сервер (самосертифікований)](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#any-server-self-attested) - [Перевірити](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#verify) - [Звіт про передачу доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#report-for-evidence-handover) - [Cloudflare як зовнішній свідок](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#cloudflare-as-an-outside-witness) - [Зчитування результату розгортання](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#reading-the-deployment-result) ## Що може перевіряти верифікатор | Заява | Як це перевіряється | Веде | | --- | --- | --- | | Сервер було створено за допомогою API провайдера у відомий час | Об’єкт «Сервер» та його створення у власному журналі провайдера | Провайдер | | Ніхто не використовував шляхи доступу провайдера | Журнал запитів консолі, відновлення, скидання пароля, перебудови, ISO, образів, резервних копій | Провайдер | | Ніщо не могло підключитися до нього | Брандмауер провайдера не має правил вхідного трафіку; SSH приховано з моменту першого запуску | Провайдер (брандмауер), хост (SSH) | | До панелі можна отримати доступ лише через тунель | Вхідний тунель перенаправляє трафік виключно на панель; коннектор працює з адреси сервера | Cloudflare | | Саме це програмне забезпечення працює | Підписаний хеш дерева вихідного коду колектора дорівнює копії розгорнутого коміту | Collector, перевірено за допомогою Git | | Ключ підпису було створено на цьому сервері | Ключ підписує повідомлення, в якому вказано ідентифікатор сервера провайдера та хеш отриманого ним файлу cloud-init | Collector, перевірений провайдером | | Журнал належить цьому ключу та серверу | Кожен процес, що запускається в доказі ZIP, містить показники хосту для цього сервера | Докази ZIP | | Ключ Telegram було створено під час завіреного запуску | `account.authorized` фіксує `key_origin: "created"` | Докази ZIP | Колектор фіксує стан SSH, сесії, історію входу та інформацію про завантаження у підписаних записах process-start та `host.state`. На звичайній віртуальній машині це локальні записи інвентаризації, які рецензент порівнює з незалежними записами провайдера. Наведене нижче розгортання Intel TDX додатково перевіряє вимірювання, що базуються на апаратному забезпеченні. Засвідчене розгортання не збирає дані за імпортованим сесійним ключем. Увійдіть за допомогою телефону або QR-коду, або скористайтеся сесійним файлом для незалежного входу: у будь-якому разі ключ авторизації Telegram створюється всередині засвідченого запуску, журнал фіксує `key_origin: "created"`, а команда `python -m tgwitness.cloud verify` проходить перевірку `account_key`. Журнал з імпортованим ключем не проходить цю перевірку. ## Провайдери | `--provider` | Повноваження | Доступ Verifier лише для читання | Журнал провайдера для верифікатора | Зберігається для | | --- | --- | --- | --- | --- | | `hetzner` | `HCLOUD_TOKEN` | Токен для читання того самого проєкту | Дії сервера та брандмауера | Поки ці ресурси існують | | `digitalocean` | `DIGITALOCEAN_TOKEN` | Особистий токен доступу тільки для читання | Дії Droplet | Поки Droplet існує | | `linode` | `LINODE_TOKEN` | `linodes`, `firewall`, `events` області, доступні лише для читання | Події облікового запису, версії правил брандмауера | 90 днів | | `vultr` | `VULTR_API_KEY` | Користувач із доступом на читання та `activity_logs` дозволом | Журнал активності облікового запису (метод, шлях, виконавець) | 30 днів, а з підпискою на журнал аудиту — ще довше | | `aws` | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` | `ec2:DescribeInstances`, `ec2:DescribeSecurityGroups`, `cloudtrail:LookupEvents` | Історія подій CloudTrail | 90 днів | | `phala` | `PHALA_CLOUD_API_KEY` | Ключ API цього ж робочого простору | Версії додатків та операції з CVM: зміни конфігурації та середовища Docker Compose, перезапуски, оновлення ОС | Поки додаток існує | | `generic` | немає | немає | none: **самозасвідчений** | – | Для кожної справи використовуйте окремий проєкт, команду, обліковий запис або підобліковий запис: тоді доступ верифікатора «тільки для читання» показуватиме лише це розгортання. Повноваження зчитуються з `--provider-token-file` або з наведеної вище змінної, ніколи — з командного рядка. Для AWS у файлі вказується `ACCESS_KEY_ID SECRET_ACCESS_KEY [SESSION_TOKEN]`; регіон — це `--location`. У кожному звіті вказано обсяг записів кожного провайдера. Коротко: Hetzner реєструє запити консолі; консоль відновлення DigitalOcean, Lish/Glish від Linode та веб- консоль Vultr не реєструються як такі, тому root блокується під час першого завантаження, а для входу в консоль потрібно скинути пароль або змінити параметри завантаження, що реєструється. Vultr повертає адресу консолі будь-якому ключу, який може читати екземпляр; ані запис, ані звіт її не зберігають. ## Конфіденційна віртуальна машина на Phala Cloud (Intel TDX) При цьому `--provider phala` колектор працює у конфіденційній віртуальній машині Intel TDX на [Phala Cloud](https://phala.com/), якою керує dstack. Хост та персонал Phala не можуть читати її пам’ять, а процесор підписує підтвердження того, що саме запустила машина. Верифікатор не покладається лише на слова Phala: `tgwitness.tdx` самостійно перевіряє кожне підтвердження, аж до закріпленого кореневого сертифікату Intel SGX Root CA, порівнюючи його зі списками відкликаних сертифікатів Intel та підписаними даними платформи Intel, і відхиляє машини, які можна налагоджувати або мігрувати. | Створення звіту | Що він показує | | --- | --- | | `tdx_binding` | Атестація охоплює підписану заяву збирача та випадкове значення цього запиту | | `tdx_quote` | Intel гарантує достовірність сертифікації; вона вважається успішною лише тоді, коли Intel оцінює платформу як актуальну | | `tdx_compose_hash` | RTMR3, відтворений із журналу подій dstack, вимірює кількість повідомлень, складених у додатку, про які повідомляє колектор | | `tdx_compose` | Цей код байт за байтом збігається з тим, що генерує розгорнутий комміт: вихідні файли прив’язані за хешем, обидва зображення — за дайджестом, іншого коду немає | | `tdx_identity` | Атестація надходить від розгорнутого додатка та екземпляра, з використанням ключів із KMS Phala та зашифрованого диска | | `tdx_os` | MRTD та RTMR0-2 дорівнюють значенням, які верифікатор обчислює на основі образу ОС dstack, опублікованого Dstack-TEE, визначеного за хешем образу ОС, який повідомляє CVM, а також на основі таблиць ACPI, які QEMU формує для конфігурації віртуальної машини: прошивка, ядро, initrd, командний рядок із хешем кореневої файлової системи, пам’ять, віртуальні процесори та пристрої. Образ для розробки не проходить перевірку | Образ ОС (близько 180 МБ, з яких зберігається 21 МБ) завантажується один раз із [Dstack-TEE/meta-dstack](https://github.com/Dstack-TEE/meta-dstack/releases) у `dstack-images` поруч із записом; `--tdx-image FOLDER` використовує іншу папку або розпакований образ, `--tdx-image none` пропускає порівняння. Вимірювання виконується за допомогою `dstack-mr` та модуля `qemu-acpi` з Dstack-TEE/dstack. Приватні регресії вимірювань порівнюють власний ACPI- вихід QEMU та збережену цитату Phala Cloud; для кваліфікації в режимі реального часу також потрібен опублікований образ. `--tdx-measurements` як і раніше порівнює MRTD та RTMR0-2 , надані у форматі JSON. Кожен запуск колектора, зафіксований у журналі, супроводжується таким підтвердженням, тому `verify --evidence` перевіряє кожен запуск та образ ОС, з якого він завантажився. Версії додатків Phala та операції CVM слугують журналом постачальника: зміна конфігурації Docker Compose після розгортання призводить до відхилення звіту, а перезапуски зазначаються для перевірки. У панелі виберіть **Конфіденційна віртуальна машина · Phala Cloud** у розділі **Додаткові інструменти → Додатки → «Сервер 24/7»** та вставте ключ API Phala Cloud; швидкий тунель працює так само, як на Hetzner. З командного рядка: ``` python -m tgwitness.cloud deploy --provider phala --name case-1 --server-type tdx.small \ --ref v0.8.0 --repository https://github.com/phishdestroy/TgWitness --quick-tunnel \ --provider-token-file phala-key.txt python -m tgwitness.cloud verify --record deployments/case-1/deployment.json \ --provider-token-file phala-key.txt --cloud-init deployments/case-1/docker-compose.yaml \ --source CHECKOUT_OF_COMMIT --fingerprint COLLECTOR_FINGERPRINT --report certificate.md python -m tgwitness.cloud check-report --report certificate.pdf --verifier-fingerprint VERIFIER_KEY ``` `--tdx-collateral` зчитує сертифікати та списки відкликаних сертифікатів Intel із файлу, а не завантажує їх із сайту Intel. Шлюз DNS тут недоступний: у Phala немає брандмауера провайдера для вихідного трафіку. Команда `verify --source` створює еталонний інсталятор на основі вашого копіювання коду, який запускає код із цього копіювання на цьому комп’ютері. У разі розгортання з репозиторію, відмінного від офіційного, команда `verify` відмовляє у виконанні, якщо ви не вкажете також параметр `--trust-source`; робіть це лише для копіювання коду, з яким ви вже ознайомилися. ### Офлайн-перевірка за допомогою verify.py Одержувач без облікового запису Phala перевіряє цитати за допомогою автономного верифікатора в автономному режимі: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_FINGERPRINT python verify.py phala-tdx-attestation.json ``` Для кожного запису `process.started` в архіві доказів, а також для підписаної заяви колектора (в тому числі всередині запису розгортання або опублікованого запису засвідчення), `verify.py` перевіряє підпис ECDSA P-256 цього запису за допомогою свого ключа засвідчення, а також підпис звіту анклаву, що наводить цитату, за допомогою сертифіката PCK, щоб переконатися, що цей звіт вказує ключ засвідчення (SHA-256 ключа та даних автентифікації QE), що він походить з анклаву цитування TDX компанії Intel у виробничому режимі, а також ланцюг сертифікатів PCK → Intel SGX PCK Platform або Processor CA → Intel SGX Root CA, SHA-256 якого зафіксовано у `verify.py`. Програма відхиляє TD, що підлягають налагодженню або міграції, перевіряє, чи REPORTDATA є SHA-512 початкового запису (ключ журналу, запуск, дерево джерел, хост) або підписаного твердження, та виводить MRTD, RTMR0-3 та REPORTDATA. Колектор також зберігає супутню інформацію Intel (TCB Info, QE Identity, списки відкликань та їхні ланцюги емітентів) разом із кожним запитом, коли служба Intel надає відповідь. За допомогою цього `verify.py` перевіряє підписи та списки відкликань Intel і обчислює стан TCB станом на час запису або станом на дату видачі супутньої інформації, якщо вона пізніша. Без цього результат виглядає так: «Статус TCB не перевірено (у архіві немає супутніх даних)». Який код виконувала віртуальна машина (показники RTMR3, образ ОС за MRTD та RTMR0–2), журнал провайдера та поточний рейтинг Intel залишаються предметом перевірки за допомогою команди `python -m tgwitness.cloud verify`; отже, офлайн-перевірка позначає завірений цикл збору даних як частковий і сама по собі не досягає рівня `sealed` або профілю `attested`. ### Сертифікат підтвердження Під час розгортання Phala `verify --report certificate.md` також записує сертифікат: автономний файл `certificate.html` та файл формату A4 `certificate.pdf` із висновком, ланцюгом довіри від кореневого сертифіката Intel до ключа колектора, порівнянням зі звичайними серверами та серверами з високим рівнем безпеки, результатами вимірювань поряд із значеннями, обчисленими на основі опублікованого образу, інформацією про те, хто гарантує кожну частину, ланцюгом сертифікатів Intel, кожним перевіреним елементом, журналом провайдера та інструкцією щодо повторення перевірки. Звіт у форматі JSON залишається офіційним документом; сторінки відображають його. Звіт має цифрову печатку у вигляді підписів та міток часу у файлі `certificate.seal.json` та сусідніх файлах `.tsq`/`.tsr`: | Печатка | Що це додає | | --- | --- | | Кваліфікований електронний часовий штамп, `http://tsa.belgium.be/connect` | Часовий штамп RFC 3161 на точних байтах `certificate.json` від кваліфікованого постачальника довірчих послуг федерального уряду Бельгії (FPS Policy and Support, BOSA). Ця організація вказана як кваліфікована служба маркування часом зі статусом «надано» у бельгійському списку довірених суб’єктів ЄС; кореневий сертифікат (Belgium Root CA6) та записи списку, станом на версію, опубліковану 20 жовтня 2026 року, зафіксовані у `tgwitness/tsa_roots.py`. Відповідно до статті 41 Регламенту (ЄС) № 910/2014 такий часовий штамп вважається точним щодо дати та часу, а також щодо цілісності даних у кожній державі-члені ЄС | | Часовий штамп RFC 3161, FreeTSA | Другий, незалежний часовий штамп | | Підпис верифікатора | Ed25519 над рядком, що містить SHA-256 звіту та кожну мітку часу, з використанням власного ключа верифікатора (`--sign-with FOLDER`, за замовчуванням `~/.tgwitness/verifier`); PDF-файл містить підпис, створений тим самим ключем | `--timestamp URL` (повторюваний) обирає інші органи, `--timestamp none` — жодного, `--sign-with none` залишає печатку непідписаною. `check-report` перевіряє хеш звіту, підпис верифікатора, кожен часовий штамп щодо довіреного кореня та його кваліфікований статус, а також підпис PDF-файлу. Юридична сила кваліфікованого часового штампа за межами ЄС, а також звіту в цілому, визначається судом або органом влади, який його отримує; печатка вказує, коли звіт існував і що він не зазнав змін. Атестація базується на модулі TDX та мікрокоді Intel, а також на фізичній цілісності шини пам’яті. Той, хто контролює додаток в обліковому записі Phala, може розгорнути інший компоуз; він з’являється як нова ревізія з новим хешем компоузу. Хост контролює джерело часу машини та мережу. Розгортання, перевірка за допомогою `--evidence`, перезапуски, порівняння образів ОС, запечатаний сертифікат та знищення були виконані безпосередньо на Phala Cloud; див. [запуск від 4 листопада 2026 року](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/#live-phala-cloud-deployment--4-november-2026). 9 листопада було здійснено розгортання з активного облікового запису Telegram; під час одного запуску використовувався сесійний ключ, створений усередині віртуальної машини. Див. [запуск з активного облікового запису](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/#phala-cloud-with-live-telegram-account--9-november-2026) та [ключ, створений у віртуальній машині](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/#session-key-created-inside-the-tdx-vm--9-november-2026). ## Перш ніж почати 1. Зона Cloudflare, її ідентифікатор облікового запису та токен API з правами **«Cloudflare Tunnel Edit**», **«Zone Read»** і **«DNS Edit»**, наданий за допомогою `--cloudflare-token-file` або `CLOUDFLARE_API_TOKEN`. Для верифікатора: **«Cloudflare Tunnel Read**», **«DNS Read»** та, для журналу аудиту, **«Account Settings Read**». Без домену [швидкий тунель](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#quick-tunnel-without-a-domain) не потребує нічого з цього. 2. Повноваження провайдера з правом запису до виділеного проєкту; `lock` використовує те саме: - Hetzner: токен API з правами на читання та запис; - DigitalOcean: особистий токен доступу з правом запису; - Linode: особистий токен доступу з `linodes`, `firewall` та `events` областями доступу для читання/запису; - Vultr: ключ API виділеного облікового запису або субоблікового запису; - AWS: дозволено використовувати облікові дані IAM `ec2:DescribeVpcs`, `ec2:DescribeImages`, `ec2:CreateSecurityGroup`, `ec2:AuthorizeSecurityGroupIngress`, `ec2:RunInstances`, `ec2:CreateTags`, `ec2:DescribeInstances`, `ec2:DescribeSecurityGroupRules` та `ec2:RevokeSecurityGroupIngress`. 3. Коміт, який потрібно виконати. Тег релізу одноразово розпізнається як відповідний коміт за допомогою `git ls-remote`; сервер завжди отримує лише 40-символьний коміт. ## З панелі На вашому комп’ютері в меню **Більше інструментів → Додатки → «Сервер 24/7»** виконується той самий `deploy` для Hetzner у три кроки: виберіть Європу або США, вставте токен Hetzner (читання та запис), а потім перегляньте тип сервера, місячну ціну, адресу та версію, які панель знайшла за цим токеном. Нічого не створюється, доки ви не підтвердите. Панель показує кожен крок так, як його повідомляє `deploy` , а потім — адресу, токен панелі та відбиток ключа підпису. Без домену сервер отримує [швидкий тунель](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#quick-tunnel-without-a-domain) ; у розділі **Ваші сервери → Знайти поточну адресу можна знову перевірити її** після перезапуску. Щоб отримати фіксовану адресу під власним доменом, відкрийте **Додатково · Ваш власний домен** і додайте токен Cloudflare (підготовлене посилання вибирає Зона читання, Редагування DNS та Редагування тунелю Cloudflare). Токени передаються з кожною запитом із вкладки браузера до TgWitness на тому самому комп’ютері і ніде не записуються; запис розгортання, відредагований файл cloud-init, токен панелі та, для швидкого тунелю, ключ адреси зберігаються в `deployments/NAME` всередині каталогу даних. Панель надає доступ до цього лише головному адміністратору через пряме з’єднання з петлею зворотного зв’язку (`127.0.0.1`, без проксі-серверів чи заголовків тунелю); панель, до якої звертаються через мережу, замість цього показує команди . Версія за замовчуванням відповідає тегу релізу панелі, що працює, який визначається через API GitHub. Місцезнаходження, тип сервера та ціна надходять з API Hetzner: `cpx22` якщо така пропонуються, інакше — найдешевший тип x86 з щонайменше 2 ГБ пам’яті. ## Швидкий тунель без домену `--quick-tunnel` замінює `--zone`, `--cloudflare-account` та `--panel-host`; не використовується жоден обліковий запис або токен Cloudflare: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --quick-tunnel --provider-token-file hetzner.token ``` На сервері cloudflared відкриває [швидкий тунель](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) до панелі: випадкова `https://….trycloudflare.com` адреса, яка змінюється щоразу, коли cloudflared або сервер перезапускається. Невеликий сервіс на сервері публікує кожну адресу у випадковій темі ntfy.sh , підписану (HMAC-SHA256) ключем, який зберігається лише у каталозі розгортання (`address-key.txt`), і повторює це кожні три години, оскільки ntfy.sh зберігає публікації протягом 12. `deploy` та **«Знайти поточну адресу»** приймають лише підписані публікації, тому підроблена публікація не може перенаправити вас та ваш токен панелі на чужу адресу. Тема міститься у записі та опублікованому cloud-init: кожен, хто має доступ до них, може прочитати поточну адресу, яка все одно вимагає введення токена панелі. Сервер у жодному разі не відкриває вхідний порт. Верифікатор не має ключа адреси, і будь-хто, хто читає тему, може публікувати в ній повідомлення. Тому колектор також публікує саму адресу, підписану власним ключем Ed25519, а `verify` бере найновіше повідомлення, підписане ключем колектора, у записі розгортання; повідомлення впорядковуються за часом, коли ntfy.sh їх отримав, а не за часом, який вони вказують. Колектор, створений до цієї зміни, нічого не підписує, і `verify` потім бере найновіше повідомлення та вказує це під час перевірки `statement`; підроблене повідомлення може лише призвести до провалу цієї перевірки, оскільки адреса все одно має відповісти ключем колектора. Скільки це коштує: жоден обліковий запис Cloudflare не веде обліку швидкого тунелю, тому `verify` повідомляє, що тунель, коннектор та перевірка DNS недоступні, і результат у кращому разі є `incomplete` (у хмарі Phala Cloud перевірка проходить успішно: коннектор працює всередині вимірюваного compose); записи провайдера, брандмауер, підписана заява, вимірювання хосту та порівняння інсталяторів перевіряються як зазвичай. Для порівняння байтів з еталонним інсталятором потрібен розгорнутий комміт, який вже знає `--quick-tunnel`; чек-аут версії 0.7.0 збирає інсталятор домену та повідомляє про різницю. Cloudflare пропонує швидкі тунелі для тестування, дозволяє 200 запитів у режимі реального часу та не підтримує Server-Sent Events, тому оновлення панелі в режимі реального часу (версії після 0.7.0) можуть не надходити через тунель, і сторінку доведеться перезавантажити; ця частина ще не перевірена. У випадку, коли рішення має бути стабільним, використовуйте власний домен. ## Розгортання Спочатку перегляньте все, що буде надіслано. `plan` не надсилає запитів до провайдера чи Cloudflare: ``` python -m tgwitness.cloud plan --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org ``` Потім виконайте розгортання з тими самими параметрами та обліковими даними: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org \ --witness-host case-witness.example.org \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` Типи серверів для початку: `cpx22` (Hetzner), `s-1vcpu-2gb` (DigitalOcean), `g6-standard-1` (Linode), `vc2-1c-2gb` (Vultr), `t3.small` (AWS). `--location` та `--image` за замовчуванням для кожного провайдера — Ubuntu 24.04 у європейському регіоні. `--repository` приймає коміт з іншого репозиторію Git за протоколом https без вказівки облікових даних в URL (за замовчуванням `https://github.com/phishdestroy/TgWitness.git`). `deploy` також приймає `--out` для іншого каталогу розгортання (за замовчуванням `deployments/NAME`; каталог, у якому вже знаходиться розгортання, відхиляється) та `--wait`, час у хвилинах, протягом якого слід чекати на підписану заяву колектора: від 1 до 240, за замовчуванням 20, або 60 для `generic`. Команда: 1. створює тунель Cloudflare, вхідний трафік якого перенаправляє ім’я хосту панелі на саму панель, а також, якщо вказано, ім’я хосту свідка на `/api/witness/head` і `/api/assurance` тільки; 2. створює проксі-записи CNAME для цих імен хостів, відхиляючи імена, які вже існують; 3. створює брандмауер-провайдер без правил вхідного трафіку та сервер за ним без SSH-ключа, без резервних копій, без консольного агента та з cloud-init, який маскує SSH, блокує root, встановлює `cloudflared`, завантажує саме цей комміт, перевіряє його та запускає TgWitness як захищену службу systemd; 4. очікує на підписану заяву колектора та перевіряє, чи вказано в ній цей сервер та хеш цього файлу cloud-init. `deployments/case-2026-11/` Потім містить: | Файл | Зміст | Поділитися? | | --- | --- | --- | | `deployment.json` | Ідентифікатори, хеші, здійснені виклики API (метод, шлях, статус) та перше підписане твердження | Так, за допомогою верифікатора | | `cloud-init.redacted.yaml` | Точний код cloud-init, у якому два секретні параметри замінено на `REDACTED` | Так | | `panel-token.txt` | Токен панелі | Ні | Кореневий пароль провайдера, токен тунелю та токен панелі ніколи не записуються `deployment.json`. Опублікуйте відбиток колектора, наведений у кінці, через канал, яким ви не керуєте самостійно, наприклад, через канал свідків або у повідомленні одержувачу. Увійдіть у Telegram за адресою `https://case.example.org` за допомогою токена панелі, як зазначено в [посібнику з налаштування облікового запису](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/). Дії панелі записуються у підписаному журналі; це не сесії SSH. [Свідок](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/) може запитувати `https://case-witness.example.org`. SSH відсутній: якщо запуск не вдається, колектор ніколи не відповідає. Видаліть сервер і розгорніть його знову або скористайтеся розгортанням для налагодження, щоб знайти причину. ### Секрети в даних користувача Cloud-init містить два секретні ключі: токен панелі та токен тунелю Cloudflare. Ключ підпису серед них немає; він створюється на сервері. Hetzner, DigitalOcean та Linode не повертають дані користувачів через свої API. Vultr повертає їх будь-якому ключу, який може читати інстанцію, а EC2 — через `DescribeInstanceAttribute`. Для AWS надайте верифікатору лише три дії з таблиці, ніколи `ec2:Describe*`. Для Vultr припускайте, що ключ верифікатора може зчитувати обидва токенів. Токен тунелю дозволяє запустити другий коннектор: `verify` повідомляє про будь-який коннектор, що не знаходиться на сервері, і заяви колектора не можна підробити таким чином, оскільки кожна з них підписується новим викликом. З `--quick-tunnel` другим секретом є ключ адреси: хто б його не прочитав, може опублікувати фальшиву адресу, яку панель прийме. У публічній заяві збирача не вказуються адреса сервера та джерела логінів; обидві ці інформації залишаються у підписаному журналі. ## Налагодження розгортання та блокування `--debug-ssh-key KEY --debug-ssh-from 198.51.100.4` зберігає SSH для одного ключа з однієї адреси або невеликої мережі, максимум /24 для IPv4 або /48 для IPv6. `KEY` вже зареєстрований у провайдера: ім’я або ID SSH-ключа в проєкті Hetzner, ID або відбиток SSH-ключа в команді DigitalOcean, ім’я користувача Linode, SSH-ключі якого додано до профілю root, ID SSH-ключа в обліковому записі Vultr або ім’я пари ключів EC2 у регіоні. Ці параметри не застосовуються до `generic`. Таке розгортання реєструється як `debug` і **ніколи не** позначається як «високого рівня безпеки». Коли ви закінчите, виконайте `sudo tgwitness-lock` як останню команду останнього сеансу SSH, а потім: ``` python -m tgwitness.cloud lock --record deployments/case-2026-11/deployment.json --provider-token-file hetzner.token ``` Брандмауер втрачає всі правила вхідного трафіку. Звіти показують, коли SSH було дозволено, а коли його було закрито; це вікно залишається видимим. ## Видалити розгортання `destroy` Видаляє сервер та його брандмауер, знайдені за міткою розгортання, щоб розгортання, яке завершилося невдачею на півдорозі, також було видалено, а потім — записи DNS, що вказують на його тунель, та сам тунель. Журнал сервера та ключ підпису видаляються разом із ним: спочатку експортуйте докази. Запис залишається, позначений `removed`, із API-викликами видалення. ``` python -m tgwitness.cloud destroy --record deployments/case-2026-11/deployment.json --confirm case-2026-11 \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` Видалення через API реалізовано для Hetzner. Для інших провайдерів `destroy` перед видаленням будь-чого зупиняється та вказує мітку для видалення в консолі провайдера. Ручно встановлений сервер (`generic`) втрачає лише свій тунель та записи DNS. Швидке розгортання тунелю не потребує токену Cloudflare: його тунель закінчується на сервері, а публікації з ntfy.sh втрачають чинність протягом 12 годин. ## Будь-який сервер (самосертифікований) `--provider generic` призначений для сервера, придбаного або встановленого вручну. `deploy` створює тунель та DNS, записує `install.sh` (приватний) та `install.redacted.sh` (для публікації), а потім очікує. Скопіюйте `install.sh` на щойно встановлений сервер Ubuntu 24.04 і запустіть його там: ``` sudo bash install.sh ``` Він фіксує стан хоста в тому вигляді, яким він був (логіни, акаунти, `authorized_keys`, сокети прослуховування, сервіси, заплановані завдання, пакети), встановлює коміт, увімкне брандмауер хосту, видалить себе, замаскує SSH та завершить сесію. Звіт щодо такого сервера є, у кращому разі, **САМОПІДТВЕРДЖЕНИМ**: той, хто запустив інсталятор, мав права root до цього, і жодних записів про провайдера немає у розпорядженні верифікатора. Це все ж краще, ніж нез’ясований сервер: інвентар, хеш інсталятора та кожен наступний вхід підписані. ## Перевірити Верифікатору потрібні `deployment.json`опублікований інсталятор, облікові дані лише для читання та, в ідеалі, копію коміту й доказ ZIP: ``` git clone -c core.autocrlf=false https://github.com/phishdestroy/TgWitness.git checkout git -C checkout checkout 0123456789abcdef0123456789abcdef01234567 python -m tgwitness.cloud verify --record deployment.json \ --provider-token-file read-only.token --cloudflare-token-file cloudflare-read.token \ --fingerprint COLLECTOR_FINGERPRINT --cloud-init cloud-init.redacted.yaml \ --source checkout --evidence tgwitness-evidence.zip --report report.md ``` Усі дані про провайдера та параметри Cloudflare запитуються верифікатором у цей момент; запис надає лише ідентифікатори, щодо яких слід зробити запит. Код виходу дорівнює 0 для **PASS**, 1 для **FAIL** та 2 для **REVIEW**, **INCOMPLETE** або **SELF-ATTESTED**. `--fingerprint` повинен надходити з незалежного каналу; без нього ключ порівнюється лише із записом оператора. `python verify.py` все одно перевіряє самі докази ZIP, як описано в розділі [«Докази](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/)». Дії провайдера класифікуються: створення та запуск протягом 30 хвилин після створення проходять перевірку; консоль, відновлення, скидання пароля, перебудова, ISO, образи, знімки, резервні копії, Systems Manager, EC2 Instance Connect та відкриття брандмауера — не проходять перевірку; дії з живленням та все непередбачуване позначаються для перевірки. Невідома дія ніколи не проходить непоміченою. ## Звіт про передачу доказів `--report report.md` створює звіт у форматі Markdown і `report.json` поруч із ним: 1. результат, відбиток ключа колектора, розгортання, провайдер, коміт, сервер, брандмауер, тунель; 2. кожен запит із зазначенням його статусу та джерела (API провайдера, API Cloudflare, звіт колектора, журнал доказів); 3. журнал провайдера з оцінкою кожної дії та, якщо провайдер це фіксує, виконавцем дії; 4. кінцеві точки Cloudflare, що містять з’єднання тунелю, конфігурацію та журнал аудиту; 5. підписана заява колекціонера; 6. що охоплює звіт, а що виходить за межі його сфери застосування; 7. команди для відтворення цього, а також SHA-256 кожного файлу, який було надано. Передайте звіт, `report.json`, `deployment.json`, опублікований інсталятор та докази ZIP. Складіть звіт якомога раніше: журнали провайдерів зберігаються протягом обмеженого періоду. ## Cloudflare як зовнішній свідок Усе це є необов’язковим. Без облікового запису Cloudflare сервер все одно працює, і два з цих варіантів працюють сьогодні: | Що | Що він показує | У TgWitness | | --- | --- | --- | | Швидкий тунель або тунель вашого домену | До панелі можна отримати доступ лише через тунель | Майстер налаштування сервера, див. вище | | ретранслятор drand `drand.cloudflare.com` | записи після раунду drand є новішими за нього: щоденник велося по ходу подій | режим доказів, **більше свідків**, без облікового запису ([формат](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)) | | Повідомлення про стан тунелю | коли тунель не працював, електронною поштою або через веб-хук від Cloudflare | Налаштуйте їх у панелі управління Cloudflare | | DNS-шлюз (`--gateway-dns`або **Cloudflare Gateway DNS** у майстрі) | кожен домен, який сервер перевіряв, відповідь на який надавала Cloudflare через TLS; брандмауер Hetzner не дозволяє DNS-запитам досягати нічого іншого; чи може політика шлюзу переписати відповіді | Hetzner, безкоштовний тарифний план Zero Trust, без домену; `verify` перевіряє брандмауер, місцезнаходження, ведення журналів, політики, запити сервера та журнал аудиту; режим «evidence» копіює журнал у щоденник | | Шлюз із клієнтом Cloudflare One на сервері — вихідний брандмауер, що пропускає лише трафік через Cloudflare | кожен з’єднання, встановлене сервером, а не лише DNS | ще не створено | | Доступ перед панеллю | хто та коли увійшов до панелі | не реалізовано: потрібно мати власний домен | | Реєстрація SSH-команд | кожна команда в сеансі налагодження | ще не створено | Logpush, який зберігає власну копію Cloudflare в R2, є функцією для корпоративних клієнтів: у рамках безкоштовного тарифного плану Cloudflare відповідає `logpush is not enabled for this account`. Журнал шлюзу зберігається там 24 години, тому режим доказів копіює його в підписаний журнал (**журнал Cloudflare Gateway із DNS-запитами цього сервера** — токен лише для читання з доступом «Account Analytics Read»). `--gateway-location ID` (разом з `--gateway-dns`) використовує існуюче розташування шлюзу DNS, визначене його 32-символьним ідентифікатором, замість того, щоб створювати нове; команда `destroy` залишає його без змін. Без плану «Zero Trust» обліковий запис має одне DNS-розташування. Коли Cloudflare відхиляє інше, сервер використовує існуюче, а його запити розрізняються за адресою; цей фільтр також потребує доступу до персональних даних за принципом «Zero Trust», і `destroy` залишає спільне розташування. Один запит до журналу охоплює не більше трьох годин, тому копіювання та `verify` читання даних за день у тригодинних вікнах. DNS-шлюз охоплює системний резолвер. DNS через HTTPS на порту 443 до іншого резолвера, а також з’єднання з адресами, які ніде не шукаються (наприклад, у дата-центрах Telegram), не фіксуються у його журналі. Cloudflare не має доступу до шифрованих даних Telegram, інших пристроїв, пов’язаних з обліковим записом Telegram (список пристроїв у режимі «evidence mode» фіксує їх з боку Telegram) або гіпервізора провайдера. ## Перегляд результатів розгортання Для звичайної віртуальної машини провайдер контролює інфраструктуру хоста, а локальний інвентар перевіряється разом із записами провайдера. Для Intel TDX верифікатор додатково перевіряє характеристики апаратного забезпечення, прив’язку колектора, компоновку та вимірювання ОС. Ознайомтеся з окремими результатами, щоб дізнатися, які перевірки пройшли успішно або були недоступні. Історія налаштувань брандмауера залежить від провайдера; Linode зберігає версії правил. Запис [Validation](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/) містить перелік протестованих розгортань та решти активних перевірок, а [Verification scope](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope) пов’язує ці перевірки середовища з отриманням архівів та їхньою цілісністю. --- # Telegram · Посібник з панелей Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/panel/ Кожен екран панелі: чати, щоденник, джерела, експорт, додаткові функції, режими захисту та перевірка коду. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Translation coverage: this edition includes material from the English original. Кожен екран панелі: чати, щоденник, джерела, експорт, додаткові функції, режими захисту та перевірка коду. [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/quickstart/) ![Початок роботи](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Перше налаштування та параметри](https://phishdestroy.io/tgwitness/uk/docs/reference/settings/) · [Акаунти](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/) · [Експорт та перевірка](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/) · [Звіти про справи](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/) Що робить кожен екран, що він записує у підписаний журнал і де знаходиться детальний посібник. Панель відображає по одному робочому простору: один обліковий запис Telegram із власними джерелами, журналом та ключем підпису. Селектор облікових записів у верхній панелі перемикає робочі простори. Адреса містить робочий простір (`?ws=…`); доки адреса, селектор та завантажений обліковий запис не збігаються, дії залишаються заблокованими. Використовуйте методи порівняння колекцій , щоб вибрати між спостереженням у реальному часі, повним історією, експортом даних з нових облікових записів/чатів та передачею збережених записів. На сторінці Експорт над елементами керування завантаженням розміщено те саме порівняння. **На цій сторінці** - [Знайдіть свій шлях](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#find-your-way) - [Почніть звідси](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#start-here) - [Чати](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#chats) - [Журнал](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#journal) - [Джерела](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#sources) - [Експорт](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#exports) - [Налаштування, облікові записи та підключення](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#settings-accounts-and-connection) - [Додатки](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#extras) - [Режими захисту](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#protection-modes) - [Інші інструменти](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#more-tools) ## Орієнтуйтеся Бічна панель об’єднує шість щоденних розділів: **Головна**, **Чати**, **Журнал**, **Експорт**, **Облікові записи** та **Налаштування**. Розділи, доступ до яких вам заборонено, пропускаються. **Додаткові інструменти** містять інструменти для розслідування та адміністрування. Відкрийте **Зовнішній вигляд** у нижній частині бічної панелі, щоб змінити мову, тему, часовий пояс або рівень інтерфейсу: | Рівень | Розділи на бічній панелі | | --- | --- | | Просто | Щоденні розділи | | Стандарт | Також Case Board, Sources, Access та Documentation у розділі More tools | | Експерт | Також Карта системи, Топологія мережі, Додаткові функції, Запитати архів, Параметри, Обліковий запис, Системний журнал та Інтеграції у розділі Додаткові інструменти | Назви розділів залишаються незмінними на кожному рівні. Рівень лише приховує розділи. Прихована функція продовжує працювати, а сервер самостійно перевіряє кожен дозвіл. Рівень, мова, тема та часовий пояс зберігаються окремо для кожного оператора та робочого простору; див. [налаштування](https://phishdestroy.io/tgwitness/uk/docs/reference/settings/). Скористайтеся **функцією Перейти до розділу** у верхній частині бічної панелі (Ctrl+K або ⌘K на Mac), щоб знайти чат, параметр або запис журналу за `#number`. Клавіші зі стрілками переміщують, Enter відкриває, Esc закриває. У верхній панелі знаходяться: - **Сповіщення**: проблеми та зміни в чатах, виявлені з журналу. Функція **«Позначити все як прочитане»** обнуляє лічильник, а **«Правила сповіщень»** відкриває налаштування правил. Надсилання сповіщень у Telegram, Discord або на електронну пошту налаштовується в меню [«Додатково» → «Сповіщення](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#notifications)». - Меню стану колекції з керуванням запуском/паузою, налаштуваннями з’єднання та діагностикою працездатності Telegram, прийому подій, джерел та черги вкладень. На вузькому екрані відкрийте його за допомогою піктограми активності. - **«Lock**»: закриває панель у цьому браузері. Колекція продовжує працювати на сервері. Версія та режим захисту знаходяться в **розділі Зовнішній вигляд**; див. [режими захисту](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#protection-modes). Після входу в систему відкривається сторінка **Головна**; явне посилання відкриває потрібний екран. Рецензент у межах чату відкриває **сторінку «Чати**». Адреси `/home`, `/case-board`, `/pseudo-secret` та `/network-topology` також відкривають відповідні екрани. Невідомі адреси сторінок повертають код HTTP 404 із пропозиціями схожих сторінок. Демо-робоча область містить вигадані повідомлення і ніколи не підключається до Telegram. Дії, які могли б змінити реальну робочу область, там не допускаються. [Карта системи](https://github.com/phishdestroy/TgWitness/blob/main/docs/SYSTEM-MAP.md) показує маршрути облікових записів цієї інсталяції, стан проксі, кінцеві точки сокетів, зашифровані сховища, служби доказів та спостережувані мережеві запити. Виберіть обліковий запис, щоб переглянути його шлях. Доступні, але вимкнені служби залишаються видимими. ## Почніть звідси Огляд очищає графік та зведену інформацію для конкретного облікового запису під час переходу між обліковими записами або повторного входу. Завантаження, невдалі спроби зчитування та період без збережених записів мають окремі стани. **Функція Повторити** повторює невдалу спробу зчитування; якщо сервер вимагає очікування, з’являється час наступної спроби. У разі невдалого оновлення зберігаються останні успішні дані для цього ж робочого простору, і вони позначаються часом останнього оновлення. Для кожного підключеного облікового запису окремо відображаються **показник активності колектора** та **час останньої отриманої події** . Перший показник відображає активність колектора; другий — час останнього отриманого оновлення Telegram. У разі відсутності активності джерела другий показник може залишатися незмінним, поки колектор продовжує працювати. Відкрийте меню «Статус збору даних» для діагностики підключення, прийому даних, джерела та вкладень. Choose a task. **Export my account** downloads what the account can read now. **Follow an investigation** records new messages, observed edits and deletion notices from the chats you choose. While observation is paused, Chats, Journal and Sources show the setup card: connect the account, choose sources, start observation. With the goal **Evidence for a case**, or in the Witnessed, Case preparation, GitHub-verified or Maximum [protection mode](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#protection-modes), starting observation first reads Telegram's session list (not while **Strict: read only the chosen chats** is on). If other sessions are signed in, the panel names their number and offers **Start anyway** or **Open Sessions of this account**. Other goals and modes start without that question. The goal question stays on this page until you answer or skip it. A new workspace opens the [first setup](https://phishdestroy.io/tgwitness/uk/docs/reference/settings/) instead. ## Чати Збережені розмови, за замовчуванням доступні лише для перегляду. Рядки чату відображають стан завантаження, завантаження файлів, що очікують на виконання або завершилися невдало, початкове завантаження історії та обмеження, повернуті в метаданих діалогу Telegram. Втрачений або непідтверджений стан доступу не означає заборону на вміст. Відкрийте **Фільтри,** щоб вибрати ці стани або відсортувати за чергою файлів; вибір зберігається в URL-адресі при перезавантаженні сторінки. Фільтр **Повторити** знаходить початкові завантаження чату, що очікують на виконання після помилки. Їхній значок показує тип помилки та, під час збору, час наступної спроби. На головній сторінці підсумовується, скільки завантажень потребують повторної спроби. Призупинене збирання зберігає завдання до моменту відновлення. In **Simple** mode Home also shows **Can be handed to a court: yes** or **no · missing: …**. Yes means timestamps are on with an RFC 3161 authority and that authority recently returned a timestamp that validated against its root certificate; each export asks for a new one for its last record. The line names the missing item otherwise. It does not check the signing key: the recipient confirms its fingerprint, received separately, and runs `verify.py` with `--tsa-ca` and the authority's root certificate. A Bitcoin proof, a witness post or an attested collection run can also meet the minimum there but are not counted here. У журнальних записах із збереженими вкладеннями вказано тип, назву та розмір у байтах. У нових результатах завантаження також зберігаються тип медіафайлу та тривалість, якщо Telegram надає цю інформацію. Старі підписані записи залишаються без змін; відсутні метадані не відновлюються. - Шукайте у списку за іменем або ID. Збігаються кілька слів у будь-якому порядку, включаючи ім’я та частину ID разом. Кнопка **+** відкриває меню **Додати чат або канал** (додає або видаляє чати, за якими ви стежите), **Відкрити посилання Telegram** та **Псевдосекрет · Почати чат**. Функція **Відкрити посилання Telegram** приймає ім’я користувача або посилання на запрошення та зберігає попередній перегляд у журналі; пошук @ім’я_користувача або посилання t.me без збігу пропонує те саме. Команда **Приєднатися / відкрити та спостерігати** приєднує вас до чату та додає його до ваших джерел; відкриття бота надсилає йому команду `/start`. - Псевдосекретні чати відображаються в тому самому списку — зеленим кольором із значком замка — і відкриваються в режимі «Псевдосекретний». Коли спостереження вимкнено, у списку відображається один запис **«Спостереження поза** мережею» із кнопкою **Почати спостереження**. - Швидкі фільтри — це вкладки, розташовані в одному рядку: **Усі**, **Псевдо-секретні**, **Пріоритет**, **Зміни** (збережені редагування або повідомлення про видалення) та **Потребує уваги** (втрачений або непідтверджений доступ, повідомлення, яких не знайдено під час повторної перевірки, помилки з мультимедіа, повторні спроби з історії або обмеження Telegram). Вкладки, на яких немає вмісту, приховані. Підрахунки враховують фільтр пошуку та типу; швидкий фільтр замінює фільтр стану. Ці налаштування зберігаються в URL-адресі під час перезавантаження та навігації за допомогою кнопок «Назад»/«Вперед». **Потребує уваги** не позначає повідомлення як видалене. Тип, стан та користувацьке сортування залишаються видимими у вигляді знімних карток, коли **розділ Фільтри** згорнуто. - У великих списках одночасно відображається 80 збігів; **кнопка Показати більше** додає наступні 80. Відкритий чат і виділений рядок залишаються доступними, коли вони відповідають критеріям пошуку, навіть поза межами цього набору. Лічильник показує кількість відображених чатів із загальної кількості збігів. Пошук охоплює весь список, включаючи чати, які ще не відображалися. - З вікна пошуку клавіша **↓** переміщує до першого результату, **↑** — до останнього відображеного результату, а **клавіша Enter** відкриває перший збіг. У списку клавіші **↑/↓** та **Home/End** переміщують фокус; **клавіша Enter** відкриває чат, на якому встановлено фокус. **Клавіша Escape** повертає до вікна пошуку, де повторне натискання очищає запит. **Кнопка Очистити фільтри** скидає список, не змінюючи колекцію чи відкритий чат. - Заголовок чату показує лічильники **видалено, текст збережено**, **видалено перед збереженням** і **не знайдено під час повторної перевірки**. Кожен лічильник — кнопка, що залишає лише ці повідомлення; повторне натискання знову показує всі. Позначки **Видалено** та **Не знайдено при повторній перевірці** на повідомленні відкривають пояснення з часом і тим, що було зафіксовано. Список чатів і сповіщення використовують ті самі визначення. Видалене повідомлення виділено червоним і зберігає записаний текст; змінене повідомлення зберігає всі збережені версії. - **Пошук збережених повідомлень** здійснюється у всьому збереженому чаті, включаючи попередні текстові версії. Фільтри видалених, відредагованих повідомлень, мультимедіа та авторів також охоплюють весь збережений чат. Повідомлення **Не знайдено при повторній перевірці** не пов’язане з отриманими повідомленнями про видалення. Пошук не запитує повідомлення з Telegram; скористайтеся **функцією Завантажити історію,** щоб отримати більше даних. Збіг у попередній версії відкриває збережені версії з посиланнями на журнал. **Відображена версія** ідентифікує запис, використаний для повідомлення, та його закладку; відповідь із пізнішої історії не може замінити новіше редагування, що відбувається в реальному часі на екрані. - Між повідомленнями чат показує два види позначок прогалин. **Номери повідомлень не враховуються** перелічує номери, для яких у журналі немає запису, — лише в каналах і супергрупах: інші чати мають спільну нумерацію акаунта, тож стрибок номерів там нічого не каже про сам чат. **Прогалини в охопленні** позначає період між записаною перервою та наступним записаним відновленням, із причиною, якщо вона є в журналі. Позначки видно, коли показано всі повідомлення, і вони ховаються, поки ввімкнено фільтр повідомлень. - **Звіт про збірку** Натискання над повідомленнями відкриває «Report Studio» із вибраним цим чатом. Та сама кнопка на картці автора вибирає чат і цього автора. Обидві дії змінюють лише чернетку; перед експортом її слід зберегти. - Натискання на ім’я автора відкриває картку користувача поруч із повідомленнями: збережений профіль, біографія, фотографії профілю, подарунки, посилання, кількість повідомлень та хронологія активності з її записами у щоденнику, а також опції **Оновити профіль** та **Створити звіт**. **Кнопка Закрити**, клавіша Esc або інший чат закривають картку; чат залишається на своєму місці. **Ритм** у картці підраховує збережені повідомлення автора в цьому чаті за UTC: активні дні, починається після 6 годин мовчання, медіанний час відповіді іншому учаснику протягом 24 годин, найдовша серія послідовних повідомлень, частка повідомлень, надісланих між 00:00 та 06:00, а також теплова карта «день тижня × година». - **Вибрати** над повідомленнями вмикає вибір повідомлень: натискайте повідомлення, щоб позначити їх, із Shift — щоб позначити діапазон, або скористайтеся **Вибрати показані**, а потім **Створити звіт**. Конструктор звітів відкриється із заповненим полем **Вибрані повідомлення**. Звіт охоплює записи цих повідомлень (спостереження, редагування, повідомлення про видалення), що пройшли інші фільтри; фільтр за автором виключає повідомлення про видалення, які не мають відправника. Можна вибрати до 1000 повідомлень; мітка в конструкторі прибирає одне повідомлення, а поруч можна додати цілі чати. Відсутні номери повідомлень показуються лише для чатів, вибраних повністю. - **Історія завантаження** відображає останні 100, 250 або 500 повідомлень у цьому вікні та в журналі. Цю функцію можна знайти в меню **Дії в чаті** поруч із налаштуваннями запису, режимом «Тільки для читання» та елементами керування маскуванням секретних даних. Меню закривається клавішею Escape або клацанням поза ним. Під час завантаження попередніх повідомлень поточна позиція читання зберігається. Якщо запит або сторінка змінюються під час обробки запиту Telegram, завершене завантаження оновлює збережений журнал, не замінюючи нове вікно перегляду. У разі невдалого автоматичного завантаження з’являється опція **Спробувати ще раз**. Щоб завантажити всі увімкнені джерела, скористайтеся [меню Джерела → Повна історія](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#sources). - **Функція «Експорт чату»** завантажує всю видиму історію у вигляді підписаного `chat.json` та `chat.html`. Кілька підключених облікових записів можуть розділити роботу: кожен завантажує свій діапазон номерів повідомлень і підписує свою частину, а обліковий запис, який запускає експорт, підписує архів. Див. [«Експорт одного чату](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md)». - **У розділі «People»** перелічені всі, у кого є збережені повідомлення в цьому чаті. Профілі користувачів за замовчуванням вимкнені, оскільки містять особисті дані про третіх осіб. Коли вони увімкнені для чату, профіль показує ім’я та історію імен користувачів, позначки Telegram, хеші аватарів, активність, хто кому відповідає, інші спостережувані чати, а також згадані гаманці, телефони, імена користувачів та посилання. Кожен факт має відповідний запис. **Експорт профілів** зберігає підписаний файл, за бажанням у форматі з паролем ZIP; вимкнення профілів призводить до видалення файлу профілю. Див. [профілі користувачів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#people-profiles). - **Функція «Зібрати всіх авторів** на одній вкладці» запитує у Telegram профіль, біографію, фотографії профілю, подарунки та посилання з біографії всіх, чиї повідомлення збережені в чаті. У каналі або супергрупі інші підключені акаунти можуть брати участь у цій роботі. Кожен обраний акаунт резервується для збору, враховує користувачів повністю та зв’язується з автором через одне з його збережених повідомлень. Акаунт, зайнятий іншим завданням, не зачіпається і приєднується, щойно звільниться. Автор, до якого не вдається зв’язатися, повертається до власного акаунта чату. Хід виконання показує відсоток, час, що залишився, та частку кожного акаунта; **кнопка Пауза** звільняє акаунти. Кожен збережений запис містить ім’я акаунта, який його прочитав, а журнал фіксує, коли кожен акаунт приєднався та вийшов. - **Функція «Зберегти профіль» тепер** створює знімок чату або профілю бота: опис, учасників, посилання для запрошення, команди бота. ### Тільки для читання, надсилання та секрети Два перемикачі над повідомленнями захищають обліковий запис і користувача: - **Режим «Тільки для читання»** увімкнено під час відкриття чату. Вимкніть його, щоб надсилати повідомлення або натискати кнопки бота . Кожна дія супроводжується запитом **«Надіслати як @account?**» або **«Натиснути цю кнопку бота як @account?»**, що повідомляє вас про те, що учасники чату бачать це і що це потрапляє до підписаного журналу. **Опція «Не запитувати знову протягом 10 хвилин у цьому чаті»** тимчасово пропускає це запитання. Функція надсилання вимкнена для цілі **«Докази у справі**» — як у панелі, так і в API. - **Функція «Mask secrets»** приховує дані, що виглядають як пароль, код входу, ключ API або хеш, токен бота, рядок сеансу, приватний ключ, JWT або номер платіжної картки (номери карток перевіряються за допомогою суми Луна). **Функція «Show»** розкриває одне значення; це розкриття фіксується в журналі. Вимкнення маскування для цього браузера також фіксується. Змінюється лише відображення: оригінальні записи та всі експортовані дані зберігають повний текст. ### Зберегти вибрані повідомлення у вигляді зображень У хмарному чаті виберіть **«Вибрати**», позначте повідомлення, а потім виберіть **«Зберегти як зображення**». Щоб зберегти весь чат, виберіть **Зберегти чат як зображення** у меню інструментів чату; ця функція завантажує до 2 000 останніх збережених повідомлень і повідомляє, якщо старіші повідомлення не включено. У попередньому перегляді доступні стилі **Світлий**, **Темний** та **Класичний**; використовуйте кнопки «Попереднє» та «Наступне» для довших знімків. **Завантаження підписаного ZIP-файлу** зберігає кожну сторінку у форматі PNG разом із `pages.sig.json` та `README.txt` ([підписані зображення чату](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#signed-chat-images)). Можна вибрати до 50 повідомлень, і всі вони мають залишатися у завантаженому вікні чату . Панель запропонує вам зменшити надто великий вибір, замість того щоб мовчки вилучити повідомлення. Кожна сторінка закінчується блоком автентичності: у ньому вказані номери записів у журналі, чат, час візуалізації, відбиток ключа робочого простору, `verify.py` команда для цієї сторінки та QR-код із чатом, ключем і часом візуалізації. Для підписання потрібний дозвіл на експорт , і це додає `export.image_attested` запис до журналу. Зображення містить збережений текст, ім’я автора, номер повідомлення, час за UTC, номер відповіді, позначки вкладень та збережений статус редагування/видалення. У ньому використовується останній збережений текст із зазначенням кількості збережених версій; вміст вкладень, вбудовані кнопки, реакції та попередні версії тексту не відображаються. Довге повідомлення продовжується на наступній сторінці із зазначенням його номера та кількості частин. Кожна сторінка ідентифікується як відтворена із збережених повідомлень. Файл PNG є візуальним уривком; використовуйте архів та його верифікатор під час передачі підписаних записів та вкладень. Візуалізація відбувається у браузері без надсилання запиту до Telegram; для підписання до панелі надсилаються лише SHA-256 кожної сторінки та номери записів. Існуючий механізм маскування захищає текст, імена авторів та назви вкладень. У попередньому перегляді зберігається знімок екрана до моменту його закриття, а потім він очищується при блокуванні панелі або зміні робочого простору чи чату. Підписаний щоденник та вибір звітів залишаються без змін. Дивіться [описи випадків](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/) для повного експорту звітів. ### Пересилати повідомлення Вимкніть **режим Тільки для читання** для чату, а потім виберіть **Переслати** під повідомленням або **виберіть** і позначте до 100 повідомлень, а потім натисніть **Переслати**. Оберіть адресата за назвою: у списку містяться збережені чати та чати Telegram цього облікового запису, куди можна надсилати повідомлення (групи, приватні чати, боти та канали, адміністратором яких він є). Панель запитує підтвердження, після чого здійснює пересилання безпосередньо через Telegram із дотриманням частоти надсилання повідомлень цього облікового запису. Запит та його результат фіксуються у підписаних записах журналу, де вказуються чат-джерело, номери повідомлень та пункт призначення. Копії зберігаються у пункті призначення лише тоді, коли цей чат перебуває під спостереженням. Чат, який забороняє пересилання, повертає відмову, і нічого не надсилається. ### Переслати чат у канал або групу The main administrator can open a saved cloud chat and choose **Forward chat** from its tools menu. Choose **New channel**, **New group**, or **Existing channel or group**. New destinations are private. For an existing destination, **Choose a chat** lists the account's groups and the channels it administers; search by name. The destination must allow this account to post. Forum destinations are not supported. Перед переглядом попереднього перегляду призупиніть спостереження або інше активне завдання облікового запису та увімкніть дії Telegram. Облікові записи, доступні лише для читання, та мета «Докази**у справі»** блокують передачу даних. **У режимі попереднього перегляду** зчитується доступна історія Telegram та перевіряється адресат. У цьому режимі не створюється адресат і не надсилаються повідомлення. **Натискання кнопки Почати** запускає передачу; термін дії попереднього перегляду закінчується через десять хвилин. У кожній робочій області може бути активна лише одна передача. Передача зчитує історію Telegram від найстарішого до найновішого повідомлення, аж до останнього повідомлення, яке відображається у попередньому перегляді. Вона не обмежується повідомленнями, які вже збережені в TgWitness. Повідомлення, що надходять за межі цього діапазону, виключаються. Вбудована функція пересилання зберігає доступну в Telegram інформацію про автора та мультимедіа без завантаження та відправлення копій. Альбоми, що знаходяться в межах цього діапазону, залишаються разом. Повідомлення про надходження повідомлень не відображаються. Відповіді, структура тем, реакції, редагування та видалені або недоступні повідомлення не відтворюються. Секретні чати не входять до цього робочого процесу. Захист вмісту Telegram та обмеження на публікацію залишаються в силі. На панелі відображаються підтверджені відправлення, пропуски, стан та час наступної дозволеної спроби. Сервісні повідомлення та індивідуально захищені повідомлення пропускаються із зазначенням причини. Інтервали між повідомленнями та погодинні обмеження для облікового запису застосовуються до кожного повідомлення; альбом очікує, доки не настане час його зарезервованих слотів. Паузи FloodWait та slow-mode оновлюють загальний RPC-таймер відстрочки для облікового запису. Існуючі стандартні налаштування регулювання для облікового запису залишаються незмінними. **Пауза** призупиняє процес між запитами; **Скасувати** зупиняє решту роботи, не видаляючи вже надіслані повідомлення та не знищуючи створений пункт призначення. Запит, що перебуває в процесі обробки, може завершитися до того, як будь-яка з цих дій набуде чинності. Закриття діалогового вікна не скасовує завдання. Після перезапуску процесу незавершені завдання вимагають явного підтвердження **Продовжити**. Втрачена або неповна відповідь на відправлення призупиняє завдання для перевірки: перевірте пункт призначення перед продовженням. Повторна спроба зберігає випадкові ідентифікатори Telegram та підтверджені лічильники; це не є гарантією безстрокової дедуплікації з боку Telegram. Невідомий результат створення не може бути відновлений автоматично: перевірте Telegram та скасуйте старе завдання перед початком нової передачі до створеного пункту призначення, якщо такий існує. Якщо збереження завдання або відповідного запису в журналі не вдалося, робочий процес відновлює останній збережений стан і звільняє обліковий запис. Повідомлення або створення, яке, можливо, вже надійшло до Telegram, залишається позначеним для перевірки. Слід повторити невдалий запуск або продовжити виконання після того, як пам’ять знову стане доступною; підтверджений прогрес просувається лише разом із відповідним записом у журналі. Підписано `interaction.forward.*` записи в журналі фіксують межу, пункт призначення, підтверджені ідентифікатори повідомлень джерела/пункту призначення та пропуски. Вони документують передачу; вони не замінюють оригінальні підписані спостереження та експортовані дані. ## Журнал Усі записи, підписані робочим простором, розташовані в порядку від найновішого до найстарішого. - **У розділі «Огляд»** підраховуються переглянуті повідомлення, зафіксовані редагування, повідомлення про видалення та вибрані джерела. - **Хронологія подій** — фільтрує за типом події (усі, редагування, видалення, реакції, членство, охоплення), за текстом та за джерелом. **Завантажити попередні події** — повернення на попередню сторінку. - Відкрийте запис, щоб переглянути його деталі, хеш та корисне навантаження. **Посилання на цей запис** — це адреса, яка відкриває саме цей запис. Можливі секретні дані маскуються в цьому попередньому перегляді; експортовані файли зберігають оригінальні дані. - Журнал є лише для додавання: у панелі немає функцій редагування чи видалення записів. Перевірте це за допомогою **«Експорт» → «Перевірити журнал»** або `python -m tgwitness.verify`; див. [експорт та перевірку](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/). ## Джерела Які розмови записує ця робоча область і що з них зберігається. Зміни стосуються майбутньої активності; збережені записи залишаються. **Функція «Оновити список чатів»** зчитує чати та папки облікового запису. Вона не завантажує повідомлення. ### Сфера застосування - **Що фіксує цей обліковий запис** : **Вибрані чати** (лише ті чати, які ви додаєте), **Папка Telegram** (одна з папок облікового запису, включаючи чати, додані до неї пізніше) або **Весь обліковий запис** (усі чати, а також кожен новий чат, групу, приватний чат або бота, щойно вони з’являються). **Режим розслідування** призначений для виділеного облікового запису: він фіксує усе, що бачить цей обліковий запис, його власні повідомлення та натискання кнопок, а також одразу зберігає профіль кожного нового чату та попередні видимі повідомлення. На зображенні [спеціальний посібник з облікових записів](https://phishdestroy.io/tgwitness/docs/dedicated-account/) пояснюється, чому ніколи не слід використовувати свій основний обліковий запис. - **Режим Суворий: читати лише вибрані чати** (опція «Тільки вибрані чати», за замовчуванням вимкнена) зупиняє читання сервісних сповіщень Telegram, списку сеансів та попередніх повідомлень у чаті, якщо ця опція увімкнена, не впливає на налаштування конфіденційного вмісту та пропускає оновлення щодо телефонних дзвінків. Див. [Суворий режим для вибраних чатів](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#strict-chosen-chats). - **Типи джерел** обмежують режими «папка» та «весь обліковий запис» каналами, групами, приватними чатами та ботами. **«Власні дії»** додають власні повідомлення облікового запису, редагування та натискання клавіш під час відповіді. - **Коли з’являється новий чат або бот**: збережіть його профіль та до обраної кількості його останніх видимих повідомлень. - **Вибрані чати** позначено як рекомендовані. Функція **Скинути зміни** повертає форму до збереженого стану, доки ви не натиснете **Зберегти стан**. [Псевдо-секретний](https://phishdestroy.io/tgwitness/uk/docs/reference/secret-chats/) — це вбудований інтерфейс «Секретного чату», який активується для кожного облікового запису після встановлення відповідного протокольного модуля одним натисканням кнопки. Хмарне спостереження та історія використовують власні налаштування. Нічого не записується, поки TgWitness не працює; після перезапуску він фіксує лише те, що Telegram ще повертає, і в звіті відображається пробіл. Чати, що виходять за межі списку чатів (1 000 діалогів, якщо не змінено в параметрах), додаються, коли вони наступного разу стають активними. Кнопки вбудованого бота, натиснуті в іншому додатку, невидимі; відповідь бота записується. ### Чати, що входять до сфери застосування Фільтруйте за статусом (**Увімкнено**, **Призупинено**, **Пріоритет**, **Виключено**, **Непідтверджений доступ**, **Ігнорується**) та типом, а потім виконуйте дії з вибраного: увімкнути, призупинити, позначити або зняти пріоритет, виключити з області дії або видалити. Іконка статусу показує лише стан; дії знаходяться в меню кожного рядка з описом їхнього призначення. Призупинення та виключення вимагають підтвердження, у тому числі й у масовому режимі. При видаленні джерела потрібно вказати його назву, після чого видаляються профілі його учасників ; збережені записи залишаються у журналі. Джерело, яке не відображається у списку чатів облікового запису, — це **отримання оновлень, що не входять до списку чатів**, коли записи продовжують надходити; в іншому випадку — **доступ не підтверджено**. **Доступні чати** додає чати з **Додати вибрані** або **Додати всі знайдені**. ### Повна історія Завантажує доступну історію кожного увімкненого джерела в розділи «Чати» та «Журнал». Хід роботи зберігається після перезапуску; вкладення відповідають вашим налаштуванням мультимедіа. Дивіться [історію джерела](https://phishdestroy.io/tgwitness/uk/docs/reference/history/). ### Запис - **Виберіть, які зміни зберегти**: нові повідомлення, редагування, повідомлення про видалення, видимі реакції, приєднання та виходи. Пресет змінює форму; **«Зберегти налаштування запису»** застосовує його. Повторне ввімкнення категорії не відновлює пропущені події. - **Зберігати медіафайли, якщо вони доступні**: завантажуйте вкладення розміром до певного значення на файл, встановлюйте для кожного типу від 1 до 2 000 МіБ та обмежуйте тривалість відео в секундах (0 означає відсутність обмеження). Результат кожної спроби завантаження фіксується. - **Перевірка**: пріоритетні чати перевіряються кожні кілька хвилин, інші — рідко, завдяки чому обліковий запис не перевищує обмеження Telegram щодо FloodWait. Значення 0 вимикає групу. Позначте пріоритетні чати зірочкою у списку; кількість чатів за один прохід та пауза між ними вказані в параметрах. Див. [колекцію](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/). - Смуга збереження показує, чи відповідають ці налаштування рекомендованим. Кнопка **Повернутися до рекомендованих** вводить рекомендовані значення; кнопка **Зберегти налаштування запису** застосовує їх, а кнопка **Скинути зміни** відновлює збережені налаштування. ## Експорт **«Завантаження»** готує файли; **«Звіт про збірку»** визначає вигляд звітів. | Що | Використовуйте його для | Посібник | | --- | --- | --- | | Експорт облікового запису | Актуальний знімок того, що обліковий запис може переглядати зараз | [Експорт облікового запису](https://phishdestroy.io/tgwitness/uk/docs/reference/account-export/) | | Поділитися копією | Скорочена версія готового експорту облікового запису | [Розкриття інформації](https://phishdestroy.io/tgwitness/uk/docs/reference/account-export/#prepare-a-disclosure-for-a-lawyer-or-another-recipient) | | Підписано ZIP | Журнал, звіти, вкладення та інструменти верифікації у межах фіксованої межі журналу | [Експорт та перевірка](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/) | | Звіти у форматах HTML, PDF, JSON | Запечатаний звіт, доступний для читання | [Звіти про справи](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/) | | JSONL, CSV | Оригінальні записи з підписами; електронна таблиця, безпечна для формул | [Експорт та перевірка](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/) | | Витяг із протоколу передачі | Тільки ті чати, періоди та люди, які потрібні одержувачу | [Докази](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#investigation-handoff) | | Експорт чату | Один чат із підписом `chat.json` та `chat.html` | [Експортувати один чат](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md) | - **Шифрування вищезазначених завантажених файлів за допомогою пароля** (12 символів або більше) створює файл у форматі AES-256 ZIP, який відкривається програмами 7-Zip або WinRAR. Підписаний файл усередині залишається незмінним. Пароль не зберігається. - Коли сесійний ключ цього робочого простору було імпортовано, діалогові вікна експорту облікового запису та чату повідомляють про це в одному рядку: копії цього ключа можуть існувати поза списком сесій Telegram. У цьому ж рядку пропонується **опція Створити незалежну авторизацію**, яка відкриває сторінку входу з вибраною цією опцією. Див. розділ [Облікові записи](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#create-an-independent-authorization). - Експорт чату, який завершився невдало або був скасований, зберігає діапазон, який було збережено. Функція **Захопити або експортувати один чат** пропонує опції **Продовжити експорт** та **Почати спочатку**; див. [Експорт одного чату](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md). - У розділі «Експорт чату» під заголовком **Завантажити прочитані на даний момент повідомлення** зберігається ZIP-архів, сторінки якого підписуються під час запису; рядок під ним показує кількість підписаних повідомлень. - **Підготовлені експортовані дані** містять до 20 файлів загальним розміром до 2 ГіБ, а також найновіший файл, для повторного завантаження; кожен файл має свій SHA-256-хаш, який одержувач може перевірити. У назві кожної картки вказано, що міститься у файлі: **Підписаний архів** (повний журнал та кількість записів у ньому), **Звіт**, **Записи журналу** або **Витяг із передачі справи**, назва та ідентифікатор справи, а також набір даних, на основі яких було створено звіт (чати, вибрані повідомлення, дати). **Функція Показати** звужує список до одного типу, якщо він містить більше одного. - Якщо браузер відхиляє діалогове вікно збереження, панель переходить до звичайного завантаження. - **Ваша ідентифікація для підписання** показує відбиток ключа. **Функції «Зберегти контрольну точку**» та «Завантажити**підписане підтвердження виконання»** дають вам записи, які можна зберігати поза межами колектора. Функція «Підготувати **запит на часовий штамп»** формує запит за стандартом RFC 3161 без звернення до будь-якої служби. ## Налаштування, акаунти та підключення - **Налаштування**: мета, підключення, що записувати та інтерфейс. Дивіться розділ [«Перше налаштування та параметри](https://phishdestroy.io/tgwitness/uk/docs/reference/settings/)». - **Акаунти**: кожна робоча область із своїм станом, джерелами, подіями та чергою вкладень. Фільтруйте за категоріями **«Потребує уваги**», **«Збирання»**, **«Офлайн» або «Призупинено»** чи **«Не підключено»**, призупиняйте або відновлюйте вибірку, імпортуйте файли акаунтів масово та керуйте групами. Див. розділ [«Акаунти](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/)». - **Обліковий запис**: вхід та маршрут з’єднання цього облікового запису. Прямий, профіль WireGuard, ваш власний проксі-сервер, публічний пул MTProto або WARP; підготуйте та перевірте маршрут, а потім застосуйте його до цього облікового запису, групи або всіх облікових записів. Див. [з’єднання та проксі-сервери](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/) та [проксі-сервери](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md). **Безпека облікового запису → Сесії цього облікового запису** відображає сесії Telegram, завершує одну або всі з них, а також — для ключа, створеного в цьому робочому просторі, — пропонує **Зробити цю єдиною сесією, коли Telegram це дозволяє**, що повторює цю дію через 24 годин, які вимагає Telegram, та показує двоступеневий пароль, який встановлюється одноразово. Див. [Безпека облікового запису](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#create-an-independent-authorization). **Безпека облікового запису → Тест свідка** використовує другий робочий простір для перевірки того, чи ця сесія отримує оновлення в режимі реального часу; див. [witness probe](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#witness-probe). При масовій паузі та відновленні підтверджений вибір зберігається в тій сесії, де він був відкритий. Елементи керування залишаються неактивними, доки триває підтвердження або виконання; зміна робочих просторів або блокування панелі скасовує решту команд. Після виконання панель оновлює стан рахунків. Неуспішний запит фіксується як збій запиту, оскільки сервер, можливо, вже застосував команду. Команди не повторюються автоматично. ## Додаткові функції Необов’язково: для початку збору даних достатньо одного облікового запису та джерел. Налаштування відкриваються лише для тієї опції, яку ви вибрали, і нічого не підключається автоматично. Картка **«Рівень захисту»** у верхній частині екрана показує [режим захисту](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#protection-modes). | Картка | Що це додає | Посібник | | --- | --- | --- | | Зберігання та дисковий простір | Резервні копії, переміщення старих файлів у хмару, копія доказів, яку неможливо видалити | [Зберігання даних](https://phishdestroy.io/tgwitness/uk/docs/reference/storage/) | | Мета та рівень захисту | Рекомендовані налаштування для вашої мети та двох шкал | [нижче](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#goal-and-protection-level) | | Сповіщення | Проблеми, змінені повідомлення та щоденний звіт; ваш власний бот-контролер | [нижче](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#notifications) | | Докази та резервні копії | Часові мітки, додаткові свідки та зашифрована зовнішня копія | [нижче](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#evidence-and-backups) | | Сервер працює цілодобово без перерв | Хмарний сервер без SSH, який створюється та видаляється з панелі управління | [Високий рівень безпеки](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#from-the-panel) | | Незалежний свідок | Підписані перевірки, опубліковані у вашому каналі Telegram або на Discord | [Свідок](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/) | | Перевірка коду | Порівнює запущену програму з публічним комітом на GitHub | [нижче](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#code-check) | ### Мета та рівень захисту Чотири запитання: 1. **Для чого це потрібно?** Для особистого обліку, розслідування або як докази у справі. 2. **Скільки ви будете відстежувати?** Кілька чатів (до приблизно 50), багато чатів (до приблизно 500) або цілі акаунти. Це встановлює обмеження списку чатів до 1 000, 3 000 або 20 000. 3. **Фотографії та файли?** Тільки текст, фотографії та короткі медіафайли (фотографії до 20 МБ, відео до 100 МБ) або все (відео та документи розміром до 1 ГБ кожен). У режимі «Все з повними акаунтами» також зберігається 4 ГіБ вільного місця на диску. 4. **Де це працюватиме?** На цьому комп’ютері або на сервері, що постійно працює. У списку пропозицій наведено незалежні часові мітки, drand та список пристроїв Telegram, для кожного з яких є рядок із описом того, що він додає. Часові мітки створюються кожні 60, 30 або 10 хвилин для особистого запису, розслідування або доказів; drand та список пристроїв потребують часових міток. **Застосовуйте** зміни лише до цих елементів, політики щодо вкладень та двох вищезазначених параметрів. Кожна зміна є записом у журналі, а також `setup.applied`. Повідомлення, позасайтова копія, сервер, шлюзовий DNS, перевірка коду та свідок пропонуються як наступні кроки з власними формами. Дві шкали обчислюються на основі встановлених параметрів, а не на основі мети: | Масштаб | Пункти | | --- | --- | | Достовірність | Підписаний журнал 1, мітки часу 3, drand 1, список пристроїв 1, перевірка відповідності коду 1, опитування свідків 1, завірений сервер 2, журнал DNS шлюзу 1 | | Надійність | Постійно активний сервер — 3, зовнішня копія — 3, Object Lock — 1, сповіщення про проблеми — 1 | **Максимум** 80% і більше — «читається», 50% — **«високий»**, 25% — **«помірний»**, нижче — **«базовий**». Наразі надійність визначається за наявністю постійно активного сервера, як зазначено у відповіді на питання 4, до перевірки будь-якого сервера. ### Сповіщення Сповіщення надсилаються через Apprise у Telegram, Discord, Slack, ntfy, електронну пошту, Matrix та понад 100 інших сервісів. Оберіть сервіс, заповніть одне або два поля та надішліть тестове повідомлення, або вставте адреси Apprise безпосередньо. - **Проблеми**: диск майже заповнений, вихід з облікового запису, помилки збору, копіювання або час-мітки; нова сесія, увійшла в обліковий запис з пристроєм, списками додатків та країн Telegram; код входу або новий вхід, про який Telegram повідомляє під час спостереження; а також інша сесія після **налаштування Зробити цю сесію єдиною**. На закритому сервері відкритий порт SSH або вхід у систему також є проблемою. - **Зміни**: видалені, відредаговані та відсутні повідомлення в спостережуваних чатах, згруповані в одне сповіщення за кожну перевірку (щохвилини, якщо не змінено в налаштуваннях). - **Виконані завдання**: історія, експорт та резервні копії. - **Збіги зі списками спостереження**: збіги зі списками спостереження, для яких налаштовано надсилання сповіщень. - **Щоденний звіт** о вибраній годині за серверним часом. У сповіщеннях вказуються назви чатів та кількість повідомлень. Витяги з повідомлень за замовчуванням вимкнені; якщо вони увімкнені, текст повідомлень залишає цей пристрій. **Ваш операторський бот** — це ваш власний бот, створений за допомогою @BotFather, який відповідає `/status` та `/stats`, а також, за бажанням, `/pause`, `/resume` та `/copy`. Користуватися ним можуть лише зазначені чати та ідентифікатори користувачів Telegram; текст розмови залишається у робочому просторі. Використовуйте окремого бота, якщо інший додаток уже отримує його команди. Див. розділи [«Сповіщення»](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Notifications.md) та [«Бот-оператор](https://phishdestroy.io/tgwitness/uk/docs/reference/storage/#operator-bot-and-completion-notices)». ### Докази та резервні копії - **Незалежні мітки часу** надсилають лише SHA-256 кожного підписаного контрольного пункту до служб міток часу RFC 3161 та календарів OpenTimestamps кожні 5–1,440 хвилин. Одержувачу потрібен такий сторонній час як мінімум для підтвердження. **Anchor зараз** виконує цикл. Див. [мітки часу](https://phishdestroy.io/tgwitness/uk/docs/reference/timestamp/). - **Інші свідчення**, кожне з яких неактивне, доки його не виберуть: найновіший раунд drand, список Telegram зареєстрованих пристроїв без IP-адрес та журнал Cloudflare Gateway із DNS-запитами сервера. Див. [додаткові записи](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices). - **Зашифрована резервна** копія журналу, файлів, контрольних точок та експортованих чатів зберігається у сховищі, сумісному з S3 (Wasabi, Amazon S3, Backblaze B2, Cloudflare R2, MinIO). Усе спочатку шифрується на цій машині. **Завантажте ключ шифрування** та зберігайте його окремо: без нього копію неможливо прочитати. Функція «Блокування об’єктів» у режимі «Управління» або «Відповідність вимогам» запобігає видаленню об’єктів протягом заданої кількості днів. Див. [«Зовнішня копія](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Off-site-Copy.md)». ### Перевірка коду Перевіряє, чи встановлена програма відповідає опублікованій версії. 1. Введіть репозиторій GitHub (офіційний вже вказано) та тег, гілку або коміт. 2. **Функція «Check now»** запитує API GitHub через маршрут цього робочого простору для зовнішніх запитів список файлів цього коміту. Вона порівнює ідентифікатор git-блобу кожного виміряного програмного файлу з комітом. Результат перевірки в Windows із перетвореними кінцівками рядків все одно збігається. 3. У результаті відображається список змінених, додаткових та відсутніх файлів (до 50 кожного типу), який зберігається як запис `source.checked` запис у журналі. Результат вважається актуальним лише доти, доки файли запущеної програми не зміняться: перевірте ще раз після оновлення. Токен не потрібен, і працюють лише публічні репозиторії; чати та облікові дані не завантажуються. Збіг ідентифікує код на диску. Це не є апаратним підтвердженням; для цього див. [Phala Cloud](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx). ## Режими захисту Перемикач поруч із номером версії показує обраний режим та скільки з 18 рівнів захисту активні, наприклад `🟠 Witnessed 9/18`. **Змінити режим можна** в **«Додаткові налаштування» → «Рівень захисту» —** там відкривається меню вибору. Режим визначає ціль та перелічує те, чого ще бракує; запис, підписання та збережені налаштування однакові в усіх режимах. | Режим | Для | Додано | | --- | --- | --- | | 🟢 Просто | Спостереження за чатом та збереження його копії | Чати, щоденник та експорт чатів; підписання відбувається у фоновому режимі | | 🟡 Підписано | Звіти надсилаються на платформу, хостинг-провайдера або службу з питань зловживань | Підписаний архів, перевірка журналу, контрольні точки, витяг з передачі справ | | 🟠 Засвідчено | Випадки, коли хтось може стверджувати, що запис було змінено | Незалежний свідок, що публікує підписані заголовки журналу | | 🔴 Готовий до використання в суді | Докази для адвоката, поліції або суду | Часові мітки, зашифрована зовнішня копія, деталі справи у звітах | | 🟣 Перевірено GitHub | Записи, програмне забезпечення яких має бути доступним для перевірки будь-ким | Перевірка коду та фіксація дій GitHub Actions | | ⚫ Максимум | Справи з високими ставками проти фінансово потужного супротивника | Захищений сервер, що працює 24/7, прихована IP-адреса, усі 18 рівнів захисту | Рівні: кожен запис підписаний і приєднаний до ланцюга; підписана квитанція про виконання; вкладення, збережені за допомогою SHA-256; підписані контрольні точки; повторні перевірки; сповіщення про проблеми; доступ свідка лише для читання; перевірка свідком за розкладом; часові мітки RFC 3161; квитанції OpenTimestamps; перевірена остання часова мітка; зашифрована зовнішня копія; деталі справи у звітах; перевірка відповідності коду ; Telegram ніколи не бачить IP-адресу цього пристрою; зовнішні запити через проксі; Object Lock на копії; запечатаний сервер із записами провайдера. У вимкненому шарі є **пункт «Налаштування»**, який відкриває відповідну форму. Вибір нижчого режиму вимагає підтвердження і нічого не видаляє. ## Інші інструменти **Додаткові функції → Незалежний запис**: підключіть окремий браузер або записний пристрій AyuGram, закріпіть його ключ підпису, виберіть параметри запису, запустіть/призупиніть запис, робіть знімки екрана та завантажуйте перевірені підписані архіви. Кожен записний пристрій має власний ручний вхід, маршрут, журнал та ключ. Обидва з’єднання спочатку вимкнені. Дивіться англійську [інструкцію з незалежного запису](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md). - **Зверніться до архіву**: шукайте збережені спостереження, переглядайте джерела, а потім вирішуйте, чи надсилати їх до моделі штучного інтелекту. Дивіться [аналіз архіву](https://phishdestroy.io/tgwitness/uk/docs/reference/analysis/) та [локальне розпізнавання тексту й транскрипцію](https://phishdestroy.io/tgwitness/uk/docs/reference/media-analysis/). - **Параметри**: обмеження та темп збору даних, повторні перевірки, завантаження, профілі, сповіщення та експорт. Пошук за назвою, відображення **«Тільки змінених** значень» та підготовка значень за замовчуванням у вигляді чернетки за допомогою **функ**ції **«Відновити значення за замовчуванням…». Функція «Зберегти параметри»** застосовує ці значення з наступного використання, а кожна зміна фіксується у журналі. - **Доступ**: окремі токени для рецензентів, аналітиків та операторів, обмежені обраними робочими просторами, чатами та правами. Див. розділ [«Доступ](https://phishdestroy.io/tgwitness/uk/docs/reference/access/)». - **Системний журнал** : що робив цей процес з моменту запуску (підключення, зміни проксі, входи, відмови, зміни налаштувань) із прихованими IP-адресами. **Функція «Слідкувати за новими рядками»** залишає найновіший рядок у полі зору. Повідомлення зберігаються лише в журналі. - **Інтеграції**: постачальник штучного інтелекту, з’єднання [MCP лише для читання](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/) та [підписані вебхуки](https://phishdestroy.io/tgwitness/uk/docs/reference/webhooks/). - **Case Board** — приватні нотатки команди, закладки та фрагменти поруч із доказами. Див. [Case Board](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/). - **Документація**: панель [режиму розслідування](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md). Під час запису задокументованої сесії вона переміщується на головну бічну панель. - **GitHub Actions фіксують дані** в розділі «Експорти»: один чат, зафіксований з вашого форку. Див. [запечатаний знімок](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). --- # Telegram · Як відбувається збір даних Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/collection/ Обсяг спостереження, оновлення в режимі реального часу, повторні перевірки, вкладення, власні дії та значення пропусків — запис за записом. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Translation coverage: this edition includes material from the English original. Обсяг спостереження, оновлення в режимі реального часу, повторні перевірки, вкладення, власні дії та значення пропусків — запис за записом. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документація](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Колекція](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![Збірка](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69) TgWitness фіксує те, що спостерігає підключений акаунт Telegram. Моніторинг у реальному часі зберігає повідомлення, зафіксовані редагування, сповіщення про видалення та вкладення разом із часом спостереження та контекстом джерела. Історія переглядів, повторних перевірок та доступні записи журналу адміністратора додають до цього запису окремо ідентифіковані спостереження. **На цій сторінці** - [Від входу в систему до журналу](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#from-login-to-a-journal) - [Обсяг спостереження: вибрані чати, папка або весь акаунт](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account) - [Сфера застосування та вибір подій](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#scope-and-event-selection) - [Власні дії](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#own-actions) - [Режим розслідування: приєднання до команд та спілкування з ботами](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots) - [Рівні повторної перевірки](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#recheck-tiers) - [Історія повідомлень та атрибуція](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#message-history-and-attribution) - [Знімки історії](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#history-snapshots) - [Обробка вкладень](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#attachment-handling) - [Призупинити, заблокувати, відключити та перезапустити](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#pause-lock-disconnect-and-restart) - [Ізоляція та верифікація облікових записів](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#account-isolation-and-verification) ## Від входу в систему до журналу Щодо фотографій та файлів, що самознищуються, див. [Медіа, що самознищуються](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md). Тут пояснюються пріоритетний робочий процес, збережені та недоступні результати, а також обмеження блокування підтвердження прочитання в API-колекторі. Блок-схема · Авторизація облікового запису користувача → Виберіть доступні групи та канали; Виберіть доступні групи та канали → Зберегти налаштування подій та вкладень; Зберегти налаштування подій та вкладень → Почати спостереження; Почати спостереження → Отримуйте оновлення від активного клієнта; Отримуйте оновлення від активного клієнта → Дотримуватися політики щодо джерел та подій; Дотримуватися політики щодо джерел та подій → Додати підписане спостереження; Додати підписане спостереження → Переглянути або експортувати журнал; Додати підписане спостереження → Обробка будь-яких вкладень у черзі; Обробка будь-яких вкладень у черзі → Додайте результат завантаження · Авторизація обліковогозапису користувача · Виберіть доступнігрупи та канали · Зберегти налаштуванняподій та вкладень · Почати спостереження · Отримуйте оновленнявід активного клієнта · Дотримуватися політикищодо джерел та подій · Додати підписанеспостереження · Переглянути абоекспортувати журнал · Обробка будь-якихвкладень у черзі · Додайте результатзавантаження **Діаграма у вигляді тексту** 1. Авторизація облікового запису користувача → Виберіть доступні групи та канали 2. Виберіть доступні групи та канали → Зберегти налаштування подій та вкладень 3. Зберегти налаштування подій та вкладень → Почати спостереження 4. Почати спостереження → Отримуйте оновлення від активного клієнта 5. Отримуйте оновлення від активного клієнта → Дотримуватися політики щодо джерел та подій 6. Дотримуватися політики щодо джерел та подій → Додати підписане спостереження 7. Додати підписане спостереження → Переглянути або експортувати журнал 8. Додати підписане спостереження → Обробка будь-яких вкладень у черзі 9. Обробка будь-яких вкладень у черзі → Додайте результат завантаження Авторизація, доступ до джерела, запущений колектор та повна доставка — це різні питання. Успішний вхід у систему не надає доступу до всіх груп. Доставку відстежують окремо: записи про охоплення, відновлення прогалин в оновленнях та повторні перевірки показують, що саме надійшло. ## Обсяг спостереження: вибрані чати, папка або весь акаунт **Більше інструментів → Джерела → Область застосування** визначає, які чати реєструє робоча область. Нове налаштування починається з пункту **Вибрати чати**. Існуючі збережені налаштування залишаються без змін. При виборі опції **Усі чати** у майстрі налаштування з’являється запит на підтвердження, якщо завантажений список містить більше 50 чатів; оцінка розміру залишається окремою операцією, що базується на вибірці. | Режим | Записи | Нові чати | | --- | --- | --- | | Вибрані чати (за замовчуванням) | Лише ті чати, які ви додаєте вручну | Ніколи не додається автоматично | | Папка Telegram | Чати в одній із папок облікового запису: чати, включені за назвою, а також категорії папки (контакти, неконтакти, групи, канали, боти), за вирахуванням виключених чатів та, якщо це зазначено в папці, архівних чатів | Відповідні чати додаються, щойно вони стають активними; чати, які ви додаєте до папки в Telegram, додаються протягом години | | Весь опис | Кожен чат, який бачить цей акаунт | Кожен новий чат, група, приватний чат або бот додається в той самий момент, коли надходить його перше оновлення | - **Типи джерел** (канали, групи, приватні чати, боти) обмежують роботу в режимах «папка» та «весь акаунт». Вибрані чати можуть бути будь-якого типу, включаючи приватні чати та ботів; типи джерел ніколи не блокують чат, доданий вручну. Вимкнений тип, виключення або перехід до вибраних чатів зупиняють автоматично додані джерела одразу після збереження, до того, як список джерел буде перераховано, а також у разі, коли Telegram недоступний: їхні нові повідомлення, історія спілкування, історія нових чатів, налаштування контактів та спостереження за профілями. - **Чати, додані вручну,** залишаються записаними в режимах «папка» та «весь обліковий запис», навіть якщо вони знаходяться поза межами папки; їх можна зупинити лише *за допомогою функцій Виключити*, *Видалити* або призупинення. Чати, додані *автоматично*, слідують за папкою: той, що виходить за її межі, призупиняється під час наступного перерахунку. - **Виключені чати** ніколи не записуються, у будь-якому режимі. У режимах «Папка» та «Весь обліковий запис» вибір опцій *Виключити* та *Видалити* у джерелі додає чат до цього списку, щоб система не додавала його знову. Якщо знову вибрати чат вручну (у розділі «Джерела», у списку «Чати» або в меню «Налаштування» → **Які чати?**), він буде вилучений зі списку. Список вміщує до 5 000 чатів; якщо їх кількість перевищує цю межу, *команда Видалити* не спрацьовує, і замість цього чат можна призупинити. - **Власні дії** (увімкнено за замовчуванням): повідомлення, які надсилає цей обліковий запис, його редагування та натискання клавіш на клавіатурі для відповіді. Якщо функція вимкнена, вихідні повідомлення та редагування пропускаються. - При переході до папки або всього облікового запису з’являється запит на підтвердження: ці режими записують приватні чати та повідомлення третіх осіб і призначені виключно для спеціального облікового запису. Підтвердження та кожна зміна області дії фіксуються у записах типу `scope.changed`. На обліковому записі, налаштованому як основний, форма вибору області дії та функція «Дослідження» відхиляють вибір папки або всього облікового запису, як це робить функція «Старт»; їх можна використовувати лише для одноразового копіювання без запису. - Чати, додані за допомогою scope, відображаються як джерела з позначкою *auto* і записуються як `scope.applied` (на початку та щогодини) або `source.discovered` (новий чат під час спостереження). Повернення до вибраних чатів одразу призупиняє всі автоматично додані джерела, без повторного зчитування списку чатів облікового запису. Виключений чат перестає записуватися, щойно область застосування збережено, а його джерело призупиняється навіть тоді, коли Telegram не повертає список чатів. Під час спостереження збереження області застосування застосовує її знову, навіть якщо значення не змінилися. Сфера застосування цих режимів: - **У Секретних чатах** використовується вбудована [інтеграція Pseudo-secret](https://phishdestroy.io/tgwitness/uk/docs/reference/secret-chats/), з модулем протоколу, встановленим через панель управління, та перемикачем увімкнення для кожного облікового запису. Хмарний архів та функція «Takeout» використовують окремий шлях збору даних. - **Періоди офлайн-роботи.** Після перезапуску TgWitness відновлює збережену позицію оновлення, запитує у Telegram про пропущені оновлення та повторно перевіряє чати. Telegram зберігає обмежений обсяг накопичених даних, тому після тривалого збою звіти та `verify.py` вказують залишковий інтервал як прогалину (див. [покриття](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)). - Спочатку відображаються лише перші 1,000 діалогів (обмеження налаштовується в розділі **Додаткові інструменти → Параметри**); старіші чати додаються, коли вони знову стають активними. Рання історія доданого чату не завантажується — зробіть знімок історії або повний експорт чату, коли це буде потрібно. - Умови папок, що постійно змінюються (приховані, прочитані), не застосовуються: такі чати залишаються під спостереженням. - Натискання **вбудованих (з зворотним викликом) кнопок бота** в іншому додатку є невидимими для другої сесії; відповідь або редагування бота фіксуються. Натискання клавіш під час відповіді надходять як вихідні повідомлення та позначаються як `button_press`. - Чим більше чатів, тим більше запитів. Telegram обмежує акаунти за обсягом, який вважає надмірним, що є ще однією причиною використовувати спеціальні акаунти. ### Ретельно відібрані чати **Strict: read only the chosen chats** appears under **Chosen chats** and is off by default. It is meant for a permission that covers the chosen chats only. While it is on: - Повідомлення служби Telegram (777000) не читаються: ні на початку, ні в кінці спостереження, а також не щохвилини під час спостереження. Записи `session.security_baseline` та `account.security_event` не записуються. - The account's session list is not read: not when observation starts or stops (the panel's question about other sessions for **Evidence for a case** and the evidence protection modes is skipped too), not every two minutes while observing, not when a connection opens, and not by the connection check, whose *Current authorization* entry is shown as skipped. The two-step verification status used by the takeover check is not read either. So `account.sessions`, `session.concurrent_at_start` and `session.takeover_risk` are not written, and a session ended from another device is not reported as `session_revoked_externally`. - Хоча це єдина сесія для цього облікового запису (**встановіть цю сесію як єдину** або її автоматичну версію), список сесій все одно зчитується кожні дві хвилини під час спостереження та при відкритті з’єднання, тому при появі іншої сесії фіксується значення `session.exclusive_ended`. 777000 залишається непрочитаним у цей період, хоча запис ``session.exclusive_from`` свідчить, що повідомлення про вхід у Telegram продовжують реєструватися. - Повідомлення про видалення порівнюються з результатами перевірки сеансу лише в тому випадку, якщо така перевірка відбулася протягом останніх 10 хвилин (якщо це єдиний сеанс або після відкриття **сторінки Сеанси цього облікового запису**). В іншому випадку, якщо остання перевірка прав не показала, що цей обліковий запис не міг видалити повідомлення (що ніколи не трапляється у приватних чатах та звичайних групах), з’являється таке повідомлення: *Невідомо, хто його видалив: це міг зробити сам цей обліковий запис, з іншої сесії або з іншого пристрою.* - Якщо сесійний ключ було імпортовано, у журналі немає даних про час входу в цю сесію, доки не буде зчитано список сесій (наприклад, у розділі **Сесії цього облікового запису**). До цього моменту під час експорту чатів та **автоматичного** експорту облікових записів використовується звичайна сесія замість Takeout із причиною `session_age_unknown`. - Увімкнення чату не призводить до зчитування його попередніх повідомлень. Якщо цей перемикач вимкнено, кожен увімкнений чат (у розділі «Джерела», у «Чатів», приєднавшись з панелі або у майстрі налаштування) отримує один базовий знімок (`baseline`) своїх останніх повідомлень, до кількості, вказаної в **Додаткові інструменти → Параметри → Найбільший знімок історії** (за замовчуванням 500), під час наступного запуску спостереження. Знімок, час отримання якого настає під час увімкнення цього перемикача, ігнорується. У чаті, до якого приєдналися з панелі, останні повідомлення також не зчитуються як у новому чаті (лічильник **Коли з’являється новий чат або бот**, за замовчуванням 100), а відкриття обраного чату без збережених повідомлень у розділі «Чати» не завантажує останні 100 повідомлень автоматично. **Завантаження історії** та знімків, які ви запускаєте самостійно, все одно дозволяє переглянути історію. - Налаштування щодо конфіденційного вмісту облікового запису не зчитується і не змінюється. Якщо перемикач відсутній, вхід у систему та кожне нове підключення вмикають його, коли він вимкнений, і Telegram дозволяє змінити це налаштування (`account.content_settings`); це налаштування належить обліковому запису і діє в усіх додатках Telegram. Вміст, який Telegram позначає як конфіденційний, може залишатися прихованим. - Оновлення, пов’язані з телефонними дзвінками, не записуються як `account.phone_call`. - При зупинці спостереження записується лише відбиток сесійного ключа; список сесій та 777000 не зчитуються. Це не обмежує обсяг даних, які надсилає Telegram: оновлення всіх чатів як і раніше надходять у цю сесію, а записуються лише вибрані чати. Список чатів облікового запису (аж до **чатів, прочитаних зі списку облікового запису**) та його папки як і раніше зчитуються під час запуску, а також під час збереження області дії під час спостереження, щоб знайти вибрані чати. Повідомлення про видалення без чату (`deletion.unscoped`) все одно записуються: вони містять лише ідентифікатори повідомлень і можуть належати до обраного приватного чату або звичайної групи. Перевірка замороженого облікового запису (`help.getAppConfig`), інші перевірки з’єднання та функції, які ви вмикаєте самостійно (автоматичне завершення інших сесій, перевірка свідків, псевдо-секретні чати, **«Сесії цього облікового запису**» та список підключених пристроїв Telegram у розділі **«Більше «Свідки»**, який зчитує список сесій при кожному проходженні мітки часу та який відстежує виконання цілей **«Стежити за чатами**» та **«Докази для справи»**) продовжують працювати. Увімкніть цю функцію перед входом у систему; інакше під час самого входу система перевіряє поточний рівень авторизації та вмикає відображення конфіденційного вмісту. Кожна зміна фіксується у підписаному записі `scope.changed`, а `observation.started` містить значення, що відповідає `scope.strict`. Перехід до папки або до всього облікового запису вимикає цю функцію. ## Сфера застосування та вибір подій Кожна робоча область має власні джерела. TgWitness не приєднується до груп, не приймає запрошення та не перелічує всіх учасників автоматично. Джерела вже мають бути доступними для облікового запису. Під час запуску колектор перевіряє вибрані джерела на відповідність видимим діалоговим вікнам облікового запису; перевіряються перші 1,000 діалогових вікон, якщо у розділі **Більше інструментів → Параметри → Чати, зчитані зі списку облікового запису** не вказано інше. Відсутнє джерело позначається як **доступ не підтверджено**, а не як таке, що видалило вас. | Налаштування | Збирає | Наслідки у разі вимкнення | | --- | --- | --- | | Нові повідомлення | Звичайні надіслані повідомлення | У разі пізніших редагувань/видалень може не бути раніше збереженого тексту для порівняння. | | Редагування | Надано відредаговані версії повідомлень | Проміжні зміни згодом не відтворюються. | | Видалення | Повідомлення про видалення в межах певного діапазону та повідомлення на рівні облікового запису без обмеження діапазону | Повідомлення про видалення не додаються до журналу. | | Реакції | Надані знімки реакцій | Окремі оновлення щодо реакції не додаються. | | Членство | Надсилання повідомлень про послуги для членів та оновлень для учасників | Ці спостереження щодо членства не додаються. | Налаштування застосовуються до всіх вибраних джерел у робочому просторі. Збережіть форму, щоб застосувати зміни; зміни фіксуються із підписаними значеннями «до» та «після». Вимкнення категорії не призводить до видалення попередніх записів. Повторне ввімкнення не відновлює пропущені оновлення. Операційні записи та інші події, пов’язані з роботою групи, залишаються окремими від цих параметрів. Повідомлення служби членства можуть створювати записи повідомлень, коли функція членства увімкнена, навіть якщо звичайне фіксування нових повідомлень вимкнено. Зафіксовані об’єкти Telegram зберігають вбудовані метадані; параметр не є правилом редагування. **Видалення у приватних чатах та звичайних групах** надходять у вигляді ідентифікаторів повідомлень без вказівки чату. Ці чати використовують одну послідовність ідентифікаторів повідомлень для всього облікового запису, тому коли повідомлення з цим ідентифікатором було збережено раніше, його чат відомий: видалення фіксується в цьому чаті з поясненням способу видалення у полі `chat_resolution`. Ідентифікатори, які ніколи не зберігалися, залишаються **видаленням без контексту** з явно невизначеним чатом. Це сповіщення про видалення в Telegram, які зберігаються навіть тоді, коли їхній чат ще не можна встановити. Схема сповіщення містить ідентифікатори; журнал додає час отримання та будь-який збережений контекст повідомлення, включаючи `deleted_message_was_outgoing`. Доступні записи журналу адміністратора надають окреме джерело дії, виконавця та час джерела. ## Власні дії Повідомлення, надіслані з обстежуваного облікового запису, позначаються як `outgoing`. Щодо редагування вихідного повідомлення зазначається, що в приватних чатах та групах його може редагувати лише автор, тоді як дописи в каналах можуть редагувати інші адміністратори. Коли вихідне повідомлення повторює текст кнопки з останньої збереженої клавіатури відповідей у цьому чаті, воно має позначку «`button_press`» із посиланням на запис цієї клавіатури. Виключення власних дій також поширюється на фонові перепровірки та автоматичну історію нових чатів. Пропущені вихідні повідомлення зміщують позицію перепровірки вперед, щоб вони не могли блокувати пізніші вхідні повідомлення. Явні дії на панелі та знімки історії, запитувані вручну, залишаються записаними. ## Режим розслідування: приєднання до команд та спілкування з ботами **Більше інструментів → Джерела → Область дії → Режим розслідування** готує область дії для спеціального облікового запису, який приєднується до командних чатів, запускає ботів та пише їм: весь обліковий запис, кожен тип джерела, власні дії, а також для кожного чату чи бота, що з’являється, — його профіль та останні 200-ти видимих повідомлень. Перегляньте форму та натисніть **«Зберегти область** дії»; перехід до всього облікового запису вимагає звичайного підтвердження. - **Кнопки.** Кнопки під повідомленням зберігаються разом із ним і відображаються в **чатах**: посилання, веб- додатки, посилання для входу, текст для копіювання, дані для зворотного дзвінка, вбудовані запити, запити на номер телефону або місцезнаходження. Посилання відображаються у вигляді тексту й ніколи не відкриваються панеллю. Коли бот змінює лише кнопки (нове посилання для оплати), це вважається новою версією повідомлення як під час оперативних оновлень, так і під час повторної перевірки. - **Нові чати та боти.** У режимах «У папці» та «Весь обліковий запис», **коли з’являється новий чат або бот**, дані зберігаються одразу після їх появи: - його профіль у вигляді запису `source.profile`: опис бота та команди, текст «Про» користувача, групи чи каналу, учасники, пов’язаний чат та посилання на запрошення, якщо Telegram його надає; - його останні видимі повідомлення (до 1 000) у вигляді знімка історії з позначкою `new_chat`: попередні повідомлення у груповому чаті, до якого щойно приєдналися, або те, що сказав бот до того, як система спостереження зафіксувала цей чат. Повідомлення, які вже збережено в режимі реального часу, не повторюються. Нововибрані чати використовують ці налаштування після застосування сфери дії, включаючи чати, які вже є у списку діалогів облікового запису. Початкове завантаження профілю та історії відбувається одночасно для не більше ніж трьох чатів; операції щодо одного й того самого чату виконуються послідовно. Кожен етап обробки історії/профілю використовує налаштований час очікування операції, тому завислі запити звільняють відповідний робочий процес. Історія зберігається до опціонального зчитування профілю; невдача зчитування профілю не заважає збереженню історії. Етапи, що завершилися невдачею, повторюються через 5 секунд, з подвоєнням часу очікування до максимум 5 хвилин без задіяння робочого процесу під час затримки. Ідентифікатори в очікуванні, терміни повторних спроб та завершені етапи зберігаються локально. Після перезапуску відновлюються лише незавершені етапи; повторна спроба завантаження профілю не повторює вже завершене читання історії. Джерела, вимкнені до настання їхньої черги, пропускаються. У загальному огляді активні, очікувані та повторювані завантаження чатів відображаються окремо від завантажень вкладень. FloodWait призупиняє цю роботу, яка відновлюється згодом; збої фіксуються, а запис чату в режимі реального часу продовжується. Сюди входять очікування під час визначення ідентичності нового чату: завдання щодо профілю/історії, що очікує на виконання, зберігається для повторної спроби, а існуюче триваліше очікування на рівні облікового запису не скорочується. Робочі процеси спільно використовують це очікування; паралельність не обходить обмеження на запити Telegram. - **Профілі за запитом.** **Чати → Профіль → Зберегти профіль тепер** зберігає поточний профіль будь-якого джерела; найновіший профіль відображається над повідомленнями. - **Знімки стану чату (попередній перегляд).** Стан поза потоком повідомлень змінюється без повідомлення: зняття фіксації будь-якого повідомлення не залишає сліду на рівні повідомлення, адміністратор втрачає права, подарунок приховується, конвертується, оновлюється або повертається. Під час спостереження кожне увімкнене джерело періодично зчитується та зберігається як підписаний `chat.state` запис: заголовок, імена користувачів, опис, кількість учасників та адміністраторів, пов’язаний чат, уповільнений режим, ідентифікатори закріплених повідомлень (до 100), адміністратори з їхніми правами та званнями, а також подарунки, що відображаються на каналах та у профілях користувачів (до 100). У кожному записі перелічено відмінності від попереднього знімка: змінені поля з значеннями «до» та «після», закріплені повідомлення, додані або видалені, адміністратори та подарунки, додані, змінені або більше не вказані у списку. - Частина, яку Telegram відмовляється надати (наприклад, список адміністраторів каналу для учасника, який не є адміністратором), вказується в `errors`; її попереднє значення зберігається та вказане у `carried_forward`, і ніколи не позначається як видалений. - Запис, єдиними змінами в якому є кількість, а також перевірка, що не виявила змін, посилається на останній повний стан із `state_seq` та накопичувальним `state_overrides`. Повний стан записується щонайменше кожні сім днів та щоразу, коли змінюється щось, окрім кількості. - `parts_complete` позначає обмежені списки. Для додавання потрібен повний попередній список, для видалення — повний поточний список, а явні порожні значення фіксують очищення запису. - **Більше інструментів → Параметри → Стан чату** дозволяє встановити інтервал (за замовчуванням — 12 годин, 0 вимикає створення знімків ), паузу між джерелами, які частини читаються, а також чи фіксуються перевірки, що не виявили змін. `FLOOD_WAIT` та `FLOOD_PREMIUM_WAIT` зупиняє решту запитів на знімки, зберігає будь-який триваліший термін дії для всього облікового запису та залишає перерваний чат придатним для повторної спроби після закінчення цього очікування. - **Невидиме.** Кнопки в тексті (зворотні виклики), натиснуті в іншому додатку Telegram, спливаюче вікно або посилання, яким бот відповідає на таке натискання, а також посилання-запрошення, використані в іншому додатку, не надходять до TgWitness. Те, що бот надсилає або редагує згодом, фіксується. ### Дія з панелі **У розділі «Чати»** тепер доступний міні-клієнт, що використовує обліковий запис Telegram обраного робочого простору: - Напишіть повідомлення простим текстом або виберіть **«Відповісти»** під збереженим повідомленням. Повернуте вихідне повідомлення записується навіть тоді, коли сфера дії не охоплює вихідні оновлення. - Натисніть **кнопку «Press»** під поточним кнопкою зворотного виклику або текстовою кнопкою. Сервер знову отримує повідомлення та відхиляє дію, якщо текст на клавіатурі відрізняється від збереженої версії. Квитанції зворотного виклику зберігають спливаючий текст Telegram, прапорець сповіщення та URL-адресу; відповідь також відображається під розмовою. URL-адреси залишаються текстом, який можна виділити, і не відкриваються автоматично. - Натисніть **+** → **Відкрити посилання Telegram**, введіть `@username`, публічне посилання `https://t.me/name`, `https://t.me/+invite` / `joinchat/invite` або посилання на бота з `?start=parameter`, а потім натисніть **Зберегти попередній перегляд**. Оригінальне посилання та попередній перегляд Telegram підписуються перед приєднанням. **Приєднання / відкриття та спостереження**: після цього відбувається приєднання до групи/каналу або відкриття профілю користувача/бота, додавання чату як активного джерела та надсилання команді бота `/start`, включаючи його параметр запуску. Запит на приєднання, що очікує на затвердження адміністратора, реєструється як «у процесі», а не як членство. Увімкніть **Почати спостереження**, щоб фіксувати вхідні відповіді в режимі реального часу. Дії панелі працюють, коли спостереження призупинено; після цього панель зберігає свої безпосередні відповіді, а спостереження в режимі реального часу фіксує решту розмови. Новододані джерела використовують налаштований профіль/історію під час виконання спостереження. Коли джерело призупинено, увімкніть його в **Додаткові інструменти → Джерела** перед надсиланням або натисканням його кнопок. `interaction.preview`, `interaction.requested` та `interaction.result` — це звичайні підписані події журналу, що включаються в експорт доказів. Запити ідентифікують обліковий запис, повідомлення/кнопку або запис попереднього перегляду, а також вказують, чи працював модуль спостереження. Квитанції розрізняють успіх, відмову, очікування затвердження та невідомий результат. Перерваний запит міг надійти до Telegram: перевірте чат перед початком нової дії. Повторне використання ідентифікатора запиту дозволяє отримати його збережене підтвердження без повторення дії, у тому числі після перезапуску. Панель зберігає ідентифікатор після неоднозначної відповіді на ту саму дію протягом поточної сесії сторінки. Вона також зберігає цей ідентифікатор, коли оновлення екрана не вдається після успішної дії: підтвердження залишається видимим, і повторне натискання дозволяє його отримати. RPC-виклики зворотного виклику та приєднання мають одну спробу виконання; операції читання з можливістю повторення зберігають налаштовану політику повторних спроб. Перемикання чатів негайно очищає чернетку та адресата відповіді й вимикає надсилання до завантаження нової розмови. Цей міні-клієнт підтримує текстові кнопки та кнопки зворотного виклику. Кнопки міні-додатків мають функцію **Відкрити міні-додаток**, яка запускає додаток в ізольованому браузері ([міні-додатки](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md)). Для входу, запитів щодо номера телефону та місцезнаходження, платежів, вбудованих запитів та вкладень як і раніше потрібен клієнт Telegram; метадані збережених кнопок залишаються видимими. У нових елементах керування використовується англійський текст. ## Перевірте рівні ще раз Повторні перевірки знову запитують Telegram про пропущені повідомлення, редагування та повідомлення, які він більше не повертає. Джерела, позначені зірочкою, є **пріоритетними** й за замовчуванням перевіряються кожні 15 хвилин; усі інші джерела — кожні 6 годин. Вибрані чати спочатку є пріоритетними джерелами, а чати, додані через папку або весь обліковий запис, — звичайними. За один прохід перевіряється не більше 30 джерел, а решта чекає до наступної хвилини; після повторного підключення пріоритетні джерела перевіряються першими. Обидва інтервали налаштовуються в меню **Додаткові інструменти → Джерела → Запис → Повторна перевірка** (значення 0 вимикає рівень) і записуються як `recheck.changed`. Пропущені повідомлення завантажуються вгору від місця, де зупинився попередній прохід, максимум — **Більше інструментів → Параметри → Відновлені пропущені повідомлення за чатом і проходом** (за замовчуванням — 1,000). Тому після тривалої зупинки повторна перевірка заповнює весь пробіл, навіть якщо спочатку були збережені поточні повідомлення, новіші за цей пробіл. Чат, який ще наздоганяє, перевіряється знову через наступну хвилину, замість того щоб чекати на його інтервал рівня; `recheck.completed` показує `continues_after`, доки це не завершиться. Порівняння охоплюють текст повідомлень, об’єкти, клавіатурні введення (включно з видаленням) та вміст/ідентифікацію вкладень. Сама по собі зміна хеш-кодів доступу до файлів або посилань на файли не вважається редагуванням, так само як і те, що Telegram заповнює самостійно: завантаження попереднього перегляду посилання, перегляди історій, платні медіа, розблоковані цим обліковим записом, отримання рахунку-фактури. Кожна збережена версія в чатах містить посилання на повний запис у журналі, включаючи метадані медіафайлів. ## Історія повідомлень та їхнє походження Припустимо, що система збору даних фіксує «Зустріч о 10:00», згодом бачить «Зустріч о 11:00», а потім отримує повідомлення про видалення. Вона додає три окремі записи. Оригінальний текст залишається, редагування є окремою версією, а повідомлення фіксує, що було зафіксовано видалення. Якщо збір даних розпочався після зникнення першої версії, цей текст недоступний. Якщо під час перебування процесу в автономному режимі відбулося кілька редагувань, зберегти можна лише ті версії, які були зафіксовані пізніше. Повідомлення про видалення не дозволяє відновити вміст, який ніколи не був зафіксований. Запис поєднує кілька джерел: | Джерело | Збережена інформація | | --- | --- | | Повідомлення в режимі реального часу або оновлення редагування | Ідентифікатор повідомлення, метадані відправника, версія, що була зафіксована, час отримання та вказана дата повідомлення/редагування у Telegram. | | Повідомлення про видалення в режимі реального часу | Вказані ідентифікатори повідомлень, час отримання, необроблене повідомлення та посилання на раніше збережений вміст. | | Доступний журнал адміністратора | Дія, виконавець, дата джерела та наданий вміст повідомлення, прочитані обліковим записом із необхідними правами. | | Взаємодія з панеллю | Запитана дія та її зафіксований результат під обраним обліковим записом. | | Перевірити ще раз | Поточна відповідь Telegram у порівнянні з раніше збереженим повідомленням. | `observed_at` — це час, коли запис було зроблено за годинником колектора, і збільшується на `seq`. Записи, записані під час обробки оновлення в режимі реального часу, також містять `received_at`, час, коли оновлення надійшло до колектора, та `processing_delay_ms`, час від отримання до запису; оновлення, що утримуються під час початку спостереження, обробляються в порядку надходження раніше за пізніші. `source_at` зберігає дату джерела, якщо ця подія її надає. Спостереження за зсувом годинника телеграми, записи про розрив годинника та [зовнішні перевірки часу](https://phishdestroy.io/tgwitness/uk/docs/reference/timestamp/) забезпечують відповідний контекст часових даних. Поля звичайного повідомлення про сповіщення описують це сповіщення; записи журналу адміністратора та взаємодії зберігають власні атрибути. ## Знімки історії Знімок запитує останні видимі повідомлення з увімкненого джерела, максимум 500 на запит. Результати позначаються як спостереження в історії. Ручні знімки виконуються паралельно зі спостереженням. Повторні спостереження зберігаються як окремі записи. Увімкнення джерела також супроводжується створенням одного базового (`baseline`) знімка цього джерела, якщо не ввімкнено опцію[Тільки вибрані чати](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#strict-chosen-chats). Створення знімків припиняється, якщо джерело вимкнено під час читання. Відповіді повинні належати до запитаного чату та містити суто спадаючі додатні ідентифікатори повідомлень, що знаходяться нижче запитуваної межі. Недійсна відповідь перериває створення знімка до того, як це повідомлення буде збережено; вже збережені повідомлення залишаються у підписаному журналі разом із записом про переривання. Знімки відповідають політиці щодо вкладень, але залишаються окремими від перемикань під час реального часу. Вони не відтворюють видалені повідомлення або пропущені проміжні версії. Ви можете запросити знімок під час паузи; будь-які вкладення, що знаходяться в черзі, очікують до початку спостереження та запуску модуля завантаження. Завантаження **Історії** — окреме завдання з виключним доступом: воно послідовно читає вибрані джерела та завантажує вкладення з їхньої черги, не запускаючи моніторинг. Пауза звільняє обліковий запис; відновлення продовжує збережений запуск. Фільтри дат, мови й відповідей для кількох вільних облікових записів описано в розділі [«Розподілений експорт чату»](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md). ## Обробка вкладень Завантаження вкладень увімкнено за замовчуванням і призупиняється, якщо вільного місця на диску менше 1 ГіБ. Колектор виконує спостереження за повідомленнями та завантаження одночасно. Задача зберігає оригінальний дескриптор медіафайлу та політику розміру, тому вкладення, яке було відредаговано пізніше, не замінюється без попередження. Завантаження виконуються після захоплення повідомлення. Завершене завантаження створює запис `media.saved` із його SHA-256 та кількістю байтів. Пропущені, невдалі, повторені та перервані операції мають окремі результати; файл вважається збереженим, коли існує його запис `media.saved` . Завершений файл також повинен відповідати кількості байтів у оригінальному дескрипторі спостережуваного вкладення. Коротка або несподівано довга відповідь не реєструється як збережений медіафайл. Файл та відповідний запис у папці записуються на диск до того, як буде записано значення `media.saved`. Якщо попередній процес колектора завершився без упорядкованого зупинення, під час наступного запуску зчитуються всі файли, які під час того циклу були зафіксовані як збережені. Файл, який відсутній або байти якого відрізняються від записаного SHA-256, отримує запис `media.missing_after_restart`, його завантаження знову ставиться в чергу, а байти, що відрізняються, переміщуються до папки `media-damaged/`. Файли, переміщені до зовнішнього сховища, не зчитуються. У межах одного робочого простору паралельні завдання в черзі, що стосуються одного й того самого представлення вкладення, очікують на активну передачу, а потім повторно перевіряють збережені байти перед повторним використанням. Кожне завдання зберігає власний результат із знаком та посилання на попередній запис про збережений файл. Скасування завдання, що очікує, не скасовує активну передачу; якщо ця передача завершиться невдало або буде скасована, наступне завдання може спробувати ще раз. Різні вкладення можуть завантажуватися одночасно. Завдання з однаковим обліковим записом, представленням, очікуваним розміром та дією запису залишаються у черзі, поки виконується одне відповідне завдання. Вони не займають слоти для завантаження, тому завантаження інших файлів може розпочатися навіть тоді, коли на початку черги є багато копій одного повільного файлу. Завершення спроби активує чергу. Пріоритетні смуги, збережені затримки повторних спроб та історія власності залишаються чинними; кожне спостереження отримує власний результат. Експорт через чат також використовує механізм активної передачі для повторного представлення файлів у тому самому каталозі експорту. Кожне повідомлення зберігає посилання на вкладене, і для його повторного використання необхідно виконати нову перевірку розміру та SHA-256. Різні файли можна перевіряти паралельно без утримання загальної блокування передачі. Тимчасові шляхи завантаження та копіювання є унікальними для кожної операції; у разі скасування операція очікує завершення роботи будь-якого активного локального засобу читання файлів перед очищенням. Індекс файлів експорту серіалізує лише доступ до метаданих, а не хешування файлів чи їх завантаження. Зчитування хеш-значень на сервері для різних вкладень також виконується паралельно, використовуючи три слоти запитів на файли клієнта разом із завантаженням байтів. При повторному зчитуванні одного й того самого представлення використовується лише повний кешований результат. Зчитування файлів не завантажує звичайну чергу запитів; збережені терміни FloodWait перевіряються знову, коли запит отримує слот. Обмеження встановлюються **для кожного типу**: фотографії, відео, GIF-файли та анімації, кругові відеозвернення, голосові повідомлення, музика та аудіо, стікери та файли. Кожен тип можна вимкнути, і для нього встановлено власне обмеження розміру від 1 до 2 000 МіБ; нові робочі простори починаються з 20 МіБ для фотографій, 100 МіБ для відео, 50 МіБ для файлів, аудіо та круглих відео, 20 МіБ для голосових повідомлень та GIF-файлів і 5 Мб для стікерів. У нових робочих просторах GIF-файли та стікери залишаються вимкненими, доки їх не увімкнуть. У робочих просторах із політиками, збереженими до введення обмежень за типами, усі типи залишаються увімкненими та зберігають єдине обмеження для кожного типу. *Максимальний розмір файлу* встановлюється для всіх типів одночасно. Вимкнений тип створює запис `media.skipped`; файли невідомого розміру або файли, що перевищують обмеження, не завантажуються. Великі файли отримують додатковий час завантаження, що залежить від їхнього розміру та базової швидкості 256 КіБ/с. Задачі зберігаються після перезапуску, але посилання, термін дії яких закінчився, втрачений доступ або видалені файли все одно можуть перешкоджати відновленню. Завдання, що перебувають у стані очікування, зберігають встановлений для них ліміт, тому підвищення ліміту застосовується лише до нових файлів. Вимкнення типу або зниження його ліміту також пропускає файли, що перебувають у стані очікування та виключені з цього типу, для кожного з яких створюється запис `media.skipped`; вимкнення завантажень призупиняє чергу доти, доки їх знову не увімкнуть. ## Призупинення, блокування, відключення та перезапуск | Дія або стан | Ефект | | --- | --- | | Перейти до робочого простору | Змінює вигляд панелі; інші колектори зберігають свій стан. | | Заблокувати панель або закрити вкладку | Сервер та спостереження продовжують працювати. | | Призупинити спостереження | Припиняє роботу цього збирача та зберігає в черзі вкладені файли. | | Вимкнути джерело | Припиняє подальший запис у заданому діапазоні; завдання з обробки мультимедіа, що знаходяться в черзі, очікують, поки функція вимкнена. | | Видалити джерело | Він ігнорує це джерело та видаляє профілі його користувачів; вже збережені записи залишаються у журналі, до якого можна лише додавати дані. Вкладення, що все ще очікують на обробку, фіксуються як невдалі (`source_removed`). У режимах «папка» та «весь обліковий запис» вони також виключаються. | | Змінити маршрут з’єднання | Вимагає паузи, закриває старі клієнти та скасовує незавершений вхід. | | Зупинити процес Python | Призупиняє роботу всіх робочих просторів; під час перебування в режимі офлайн спостереження не здійснюються. | | Перезапуск після активного спостереження | Спроба відновити збережений діапазон за допомогою збереженої сесії. Ручна пауза скасовує цю спробу. | Колектор фіксує виявлені розриви з’єднання, повторні спроби, помилки, запуски/зупинки та сигнали активності. Короткі переривання можуть бути пропущені під час періодичних перевірок з’єднання. Після перезапуску пропущені оновлення запитуються, починаючи з збереженої позиції оновлення, а спостережувані чати періодично перевіряються повторно; див. [формат доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#durable-collection-and-process-receipts-02). Знімок додає поточний стан як контекст, а пропуск залишається зафіксованим. ## Ізоляція та верифікація облікових записів Кожна робоча область має власний журнал, авторизацію, ключ підпису, політику та чергу. Лише активний клієнт може вносити спостереження в режимі реального часу. Відхилені, очікувані, замінені та клієнти, що перевіряють з’єднання, не можуть записувати оновлення в режимі реального часу до цього журналу. Різні облікові записи можуть спостерігати за однією й тією ж групою, але їхні журнали залишаються окремими. Кожна подія містить попередній хеш та підпис Ed25519. Експорт охоплює весь журнал робочого простору за допомогою фіксованого порядкового номера. Фільтри панелі не фільтрують експорт; збір даних може тривати за межами його меж під час підготовки. **Журнал перевірки** перевіряє ланцюжок подій та підписи в межах відображеної межі. Його результат очищується при зміні робочого простору, а панель ідентифікує нові записи, додані після перевірки. Експорт у форматі ZIP також перевіряє зібрані мультимедійні файли. Зберегти відбитки та контрольні точки окремо. Див. розділ « [Обсяг верифікації](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope)» для перевірок збору даних у кожному режимі, а також розділ «[щоденні операції](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/)» для рутинного збору даних. --- # 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-.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). ## Демонстрація інтерфейсу У сценарії веб-сайту використовуються вигадані запити, повідомлення та файли для демонстрації робочого процесу панелі. Це приклад інтерфейсу; перевірки протоколу та збору даних мають власні датовані результати у записі валідації. --- # Telegram · Завантажити історію джерел Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/history/ Завантажуйте минулі повідомлення з увімкнених джерел, призупиняйте та відновлюйте процес, а також перевіряйте підписаний звіт про хід роботи. [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://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![Збірка](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69) У розділі **Додаткові інструменти → Джерела → Чати в межах дії** перегляньте увімкнені чати, виберіть «Стандартний API» або «Експорт Takeout», а потім натисніть **Завантажити повну історію**. Ця операція виправляє список джерел і завантажує доступні минулі повідомлення у розділ «Чати» та підписаний журнал спостережень. Для мультимедіа використовуються існуючі налаштування вкладень та постійна черга завантажень. Це не пов’язано з підписаним експортом у форматі JSON/HTML для кожного чату окремо. Для збору даних по всьому обліковому запису виберіть **Весь обліковий запис** і збережіть область дії. Історія оновлює всі доступні діалоги, включаючи архівні чати, перед підписанням свого списку джерел. Цей процес виявлення не використовує обмеження списку, встановлене у вікні вибору чатів. Чати, виявлені пізніше, перебувають під спостереженням і отримують налаштований початковий знімок; під час наступного повного запуску можна завантажити їхню попередню історію. Залиште опцію **Продовжувати спостереження під час та після завантаження історії** увімкненою, щоб фіксувати нові повідомлення, редагування та повідомлення про видалення під час завантаження історії. Один цикл обробки історії або експорту використовує слот збору даних; спостереження в режимі реального часу відбувається паралельно з цим. Виберіть від одного до трьох паралельних чатів, від одного до п’яти працівників, відповідальних за обробку вкладень, а також вкажіть, чи слід зберігати доступні «Останні дії» та порівнювати раніше збережені версії. Виведення даних може вимагати затвердження в Telegram та визначеного сервером часу очікування. Ці параметри залишаються незмінними після відновлення роботи. Див. розділ [Поведінка заповнення прогалин та Контракт доказів](https://github.com/phishdestroy/TgWitness/blob/main/docs/BACKFILL.md) для детальної інформації щодо передачі, повторних спроб та довіри. ## Призупинення, поновлення та часткові результати - **Історія паузи** зупиняє читання. **Історія продовження** відновлює з останнього збереженого повідомлення в кожному джерелі; перезапуск програми також залишає процес у стані паузи до його відновлення. Для відновлення потрібен той самий неактивний обліковий запис Telegram. - Спостереження за повідомленням, обробка вкладень та фіксація позиції курсора відбуваються в одній транзакції. При відновленні виконання вже зафіксовані спостереження не повторюються. У режимі реального часу або під час окремого, явно запущеного циклу виконання може відбуватися незалежне спостереження за тим самим повідомленням. - Кожне джерело (кожен розділений діапазон Telegram у Takeout) фіксує верхній ідентифікатор повідомлення під час першого зчитування. Новіші повідомлення належать до поточного спостереження, а не до решти історичних сторінок цього джерела. - Джерела, до яких неможливо отримати доступ, та джерела, вимкнені під час збору даних, залишаються видимими як «неуспішні» або «пропущені». Інші джерела продовжують працювати; загальний результат є неповним. - Telegram показує журнал адміністратора чату лише його адміністраторам. Для звичайного учасника перегляд журналу адміністратора реєструється як `history.admin_log.unavailable` із `reason: not_admin`, і це не призводить до неповноти історії; на відміну від цього, невдалий перегляд журналу адміністратора адміністратором призводить до неповноти історії. - Затримки FloodWait дотримуються збереженого інтервалу очікування для облікового запису. У разі тимчасових збоїв повторюється спроба до п’яти разів; у разі вичерпання квоти та недостатнього місця на диску відбувається пауза з збереженням позиції курсора. - **Завершення цього циклу історії** зберігає збережені спостереження. Воно не видаляє їх і не скасовує завдання з додаванням файлів через стандартний API. Завершення Takeout позначає решту файлів Takeout як пропущені; призупинення дозволяє їх відновити. Новий цикл заново зчитує увімкнені джерела. Поняття «завершення історії» стосується лише зчитування історії. Вкладення можуть залишатися в стані очікування, завершуватися невдало або виключатися згідно з налаштованою політикою. Перевіряйте підтвердження отримання медіафайлів у журналі та черзі вкладень; лише завершене підтвердження з збереженими байтами вважається збереженим вкладенням. Операція з історією є явним запитом на створення знімка і відрізняється від параметрів, що вибирають категорії майбутніх подій у реальному часі. ## Передача та перевірка Збережіть **підписаний звіт про хід роботи**, а потім скористайтеся **функцією «Експорт доказів»**, щоб завантажити журнал та збережені вкладення. Пізніший експорт доказів може містити додаткові записи; звіт прив’язує свої лічильники до префікса журналу на момент його створення. Запустіть верифікатор із надійної версії цієї версії: ``` python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT ``` Збережіть очікуваний відбиток ключа підпису окремо. Верифікатор перевіряє підпис звіту, архів доказів, контрольну точку звіту, вихідний план, обліковий запис та кількість збережених/недоступних повідомлень. Нові запуски також прив’язують хід виконання вихідного коду та параметри до підписаних подій курсору. Без `--evidence` перевіряється лише підписаний звіт та його внутрішня узгодженість. Старі поля прогресу та зведення вкладень залишаються підписаними заявами збирача. Верифікатор доказів перевіряє байти архівних медіафайлів. Зчитуйте перевірену історію разом з інтервалами збору даних, охопленням та доступними Останніми діями. Цей робочий процес зчитує історію, доступну на даний момент; [моніторинг у реальному часі](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#message-history-and-attribution) зберігає версії та сповіщення по мірі їх надходження, тоді як [Секретні чати](https://phishdestroy.io/tgwitness/uk/docs/reference/secret-chats/) використовують увімкнену інтеграцію кінцевих точок. Для верифікації використовуйте збережені контрольні точки, записи свідків та відповідні підтвердження збору даних, описані в [режимах верифікації](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope). Курсор збору даних відображає стан локального робочого простору. Відновлення лише ZIP-файлу з доказами не відновлює завдання збору даних, що перебуває в процесі виконання, або сеансу Telegram. Зберігайте резервну копію робочого простору, якщо потрібно продовжити виконання початкового завдання. --- # Telegram · Робочі процеси та операції Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/operations/ Щоденна робота панелі: режими, категорії моніторингу, параметри, сповіщення, експорт даних, резервне копіювання та ємність. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Translation coverage: this edition includes material from the English original. Щоденна робота панелі: режими, категорії моніторингу, параметри, сповіщення, експорт даних, резервне копіювання та ємність. [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) Для першого підключення використовуйте [облікові записи та формати сеансів](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/). Пояснення щодо збережених версій, політик подій та пропусків див. у розділі [«Як працює збір даних](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/)». Цей посібник охоплює щоденну експлуатацію та відновлення. Управлінська інсталяція включає файли **, START-HERE.html,** та **, а також файл START-HERE.txt**, окрім програми запуску, з посиланням на репозиторій та командами, адаптованими до шляху інсталяції. Запустіть файл `tgwitness guide --print` через SSH або `tgwitness paths`, щоб визначити фактичний каталог даних. Системна інсталяція з правами root зберігає приватні дані у файлі `/var/lib/tgwitness-…`; файл `/opt/tgwitness` містить саму програму. Для керованого тимчасового тунелю Cloudflare код `tgwitness tunnel off` закриває публічний доступ, тоді як локальна панель та збір даних продовжують працювати. Код `tgwitness tunnel on` увімкне його; код `tgwitness tunnel restart` створює нове тунельне з’єднання. Використовуйте код `tgwitness open`, щоб переглянути його поточну адресу. Явне вимкнення зберігається після перезапуску служби. Код `tgwitness stop` зупиняє як панель, так і збір даних. **На цій сторінці** - [Робочий процес оператора](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/#operator-workflow) - [Поділитися результатами роботи без передачі головного ключа](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/#share-work-without-sharing-the-main-key) - [Режими виконання](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/#runtime-modes) - [Категорії моніторингу](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/#monitoring-categories) - [Повідомлення](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/#notifications) - [Розташування панелі](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/#panel-layout) - [Середовища розгортання](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/#deployment-environments) - [Перевірки під час запуску та експорт](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/#startup-checks-and-exports) - [Резервне копіювання, відновлення та переривання](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/#backup-restore-and-interruptions) - [Ємність та термін зберігання](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/#capacity-and-retention) ## Робочий процес оператора Блок-схема · Виберіть спосіб зберігання та захист ключів → Відкрити панель за допомогою її токена; Відкрити панель за допомогою її токена → Виберіть робочу область; Виберіть робочу область → Налаштування прямого або проксі-маршруту; Налаштування прямого або проксі-маршруту → Введіть номер телефону або виберіть файли / QR-код; Введіть номер телефону або виберіть файли / QR-код → Перевірте ідентифікацію облікового запису та виберіть доступні групи; Перевірте ідентифікацію облікового запису та виберіть доступні групи → Збережіть правила щодо подій та вкладень, а потім розпочніть спостереження; Збережіть правила щодо подій та вкладень, а потім розпочніть спостереження → Моніторинг помилок, доступу, черг та дискового простору; Моніторинг помилок, доступу, черг та дискового простору → Збереження незалежних контрольних точок; Збереження незалежних контрольних точок → Експорт та перевірка матеріалів · Виберіть спосібзберігання та захистключів · Відкрити панель задопомогою її токена · Виберіть робочуобласть · Налаштування прямогоабо проксі-маршруту · Введіть номер телефонуабо виберіть файли /QR-код · Перевіртеідентифікаціюоблікового запису тавиберіть доступнігрупи · Збережіть правила щодоподій та вкладень, апотім розпочнітьспостереження · Моніторинг помилок,доступу, черг тадискового простору · Збереження незалежнихконтрольних точок · Експорт та перевіркаматеріалів **Діаграма у вигляді тексту** 1. Виберіть спосіб зберігання та захист ключів → Відкрити панель за допомогою її токена 2. Відкрити панель за допомогою її токена → Виберіть робочу область 3. Виберіть робочу область → Налаштування прямого або проксі-маршруту 4. Налаштування прямого або проксі-маршруту → Введіть номер телефону або виберіть файли / QR-код 5. Введіть номер телефону або виберіть файли / QR-код → Перевірте ідентифікацію облікового запису та виберіть доступні групи 6. Перевірте ідентифікацію облікового запису та виберіть доступні групи → Збережіть правила щодо подій та вкладень, а потім розпочніть спостереження 7. Збережіть правила щодо подій та вкладень, а потім розпочніть спостереження → Моніторинг помилок, доступу, черг та дискового простору 8. Моніторинг помилок, доступу, черг та дискового простору → Збереження незалежних контрольних точок 9. Збереження незалежних контрольних точок → Експорт та перевірка матеріалів Авторизація, транспортне з’єднання, доступ до групи та повнота доставки — це різні властивості. Зелений статус з’єднання не означає, що всі події було зафіксовано. ## Поділіться результатами роботи, не розкриваючи головного ключа Відкрийте **Більше інструментів → Доступ**, щоб надати рецензенту або аналітику власний токен. Виберіть облікові записи та чати, які вони можуть відкривати, а потім надайте дозвіл на перегляд, експорт або операційні дії. Оператор, який запускає/зупиняє збір даних, потребує доступу до всього робочого простору; рецензент може мати доступ лише до одного чату. Обмеження сеансів, термін дії та правила щодо IP-адрес не пов’язані з авторизацією облікового запису Telegram. Див. [Доступ та дозволи](https://phishdestroy.io/tgwitness/uk/docs/reference/access/). Використовуйте **«Відкриті сесії»,** щоб завершити з’єднання, або скасуйте доступ, щоб закрити всі його сесії. Консоль адміністратора об’єднує інформацію про активність поточних процесів у всіх робочих просторах. Закриття сесії не зупиняє збір даних. ## Режими роботи | Режим | Дія | Поведінка | | --- | --- | --- | | Демо | scripts\Demo.cmd або `--demo` | Синтетичні дані; підключення до реальних акаунтів вимкнено | | Спостереження | Почати спостереження | Запис оновлень для вибраних джерел | | Знімок історії | Чати → Дії в чаті → Завантажити історію | До 500 поточних повідомлень; реконструкція всіх минулих змін не здійснюється | | Пауза | Призупинити спостереження | Припинення збору даних із збереженням даних та завдань у черзі | | Перегляд/передача | Експорт | ZIP, JSONL/CSV/HTML, контрольна точка, підтвердження обробки та запит на часовий штамп | | Кілька облікових записів | Робочі простори або верхня кнопка «**+**» | Необмежена кількість окремих робочих просторів у рамках одного процесу | Доступ до локальної демо-версії відкривається автоматично без ручного введення токена. Використовується можливість, обмежена терміном дії процесу, яка діє лише для прямого доступу через лупбек до ізольованої синтетичної демо-версії; токен головної панелі не розкривається. Реальні робочі простори та віддалений або проксі-доступ до демо-версії зберігають аутентифікацію за допомогою токена. Вхід у демо-версію не надає жодних повноважень у Telegram. ## Категорії моніторингу ![Налаштування моніторингу для кожного облікового запису з використанням синтезованих вихідних даних](https://phishdestroy.io/tgwitness/assets/sources.png?v=761b8bfa296c) У розділі **Додаткові інструменти → Джерела → Запис → Вибрати, які зміни зберегти** окремо виберіть нові повідомлення, редагування, повідомлення про видалення, оновлення реакцій та події членства. За замовчуванням зберігаються всі категорії. Параметр **Повідомлення, редагування та видалення** зберігає оригінальний контекст, водночас вимикаючи окремі оновлення реакцій/членства. **Параметр Уся видима активність** відновлює всі п’ять категорій. Пресети змінюють форму; натисніть **Зберегти налаштування запису,** щоб застосувати зміни. Збережена політика застосовується до всіх вибраних джерел у цій робочій області. Інші робочі області зберігають власні налаштування. Кожна фактична зміна фіксує підписані значення «до» та «після» ; поточна політика також включається до квитанцій про обробку та записів про початок спостереження . Вимкнення категорії не призводить до видалення попередніх спостережень. Повторне ввімкнення не відновлює пропущені зміни. У цій версії немає можливості перевизначення категорій на рівні груп. Залишайте функцію запису нових повідомлень увімкненою, якщо попередній вміст має значення: повідомлення про видалення не дозволяє відновити текст, який ніколи не було зафіксовано. Оперативні записи, записи про охоплення та інші події, пов’язані з роботою групи, завжди зберігаються. Знімки історії з явною інформацією відокремлені від вибору категорій у режимі реального часу та можуть містити службові повідомлення. Ці параметри не видаляють метадані реакцій/учасників, вбудовані в об’єкт Telegram, який було зафіксовано іншим чином. Знімок історії може ставити вкладення в чергу під час паузи. Почніть спостереження, щоб обробити їх. Наявність у черзі не означає, що файл завантажено. Недоступний оригінальний файл не замінюється на новішу відредаговану версію; результати фіксуються окремо. **Натискання кнопки «Заблокувати»** очищає доступ браузера та секретні поля, але залишає збір даних у дії. Закриття вкладки також залишає процес у дії. Зупинка процесу Python або служби припиняє збір даних незалежно від стану браузера. Додаткову робочу область можна видалити лише після повного завантаження підписаного контейнера у форматі ZIP або ASiC-E, що містить її журнал та нотатки з Case Board. Підготовки архіву недостатньо: якщо запис не стосується подій налаштування або нотатка була додана після завантаження, **функція Видалити** залишається недоступною. Коли панель отримує сам файл, вона враховує експорт лише після отримання кожного байта, а потім повідомляє розмір за допомогою запиту `POST /api/exports/{id}/received`; завантаження, яке було перервано, не враховується. У разі використання браузерного діалогового вікна вибору файлу (доступ до файлової системи) панель повідомляє про це після того, як файл записано та закрито. Без нього панель передає отриманий файл у список завантажень браузера і не може визначити, чи зберіг його браузер, наприклад, коли діалогове вікно збереження було скасовано; у такому разі панель повідомляє, що завантаження розпочалося, а не що файл було збережено. Файл, який браузер завантажує самостійно (експорт, розмір якого перевищує буфер браузера панелі), та завантаження іншим HTTP-клієнтом враховуються, коли сервер надіслав повну відповідь. Операційна система та зворотний проксі-сервер буферизують кілька мегабайтів відповіді, тому для цих завантажень сервер не може виявити переривання ближче до кінця. Якщо панель не вказала, що файл було збережено, перевірте завантажений файл перед видаленням. Експорт групи враховується для відповідних облікових записів, коли його завантажують одразу після підготовки; повторне завантаження з **розділу Підготовлені експорти** не враховується. Перед видаленням на панелі відображаються формат, розмір, час підготовки та SHA-256 останнього завантаженого підписаного архіву, а також з’являється запит на підтвердження того, що цей архів збережено поза робочою областю. Сервер відхиляє запит `DELETE /api/profiles/{id}`, якщо параметр `kept_copy`не встановлено на значення цього SHA-256 (або на `confirmed` для архіву, завантаженого до того, як було записано відбиток). Видалення додаткового робочого простору зупиняє його колектор та видаляє його локальні дані. Якщо блокований файл або помилка файлової системи перериває видалення, панель повідомляє про збій і залишає робочий простір у списку як недоступний (`DeletionPending`). Закрийте програми, що утримують його файли, та спробуйте виконати **видалення** ще раз. Перезапуск TgWitness залишає цей робочий простір зупиненим і не відновлює його частково видалений журнал або ключі. Успішне видалення фіксується лише після видалення каталогу; окремо експортовані або збережені резервні копії залишаються під дією власної політики зберігання. ## Сповіщення Відкрийте **Налаштування → Сповіщення та копіювання поза сайтом → Пункти призначення сповіщень** або **Додаткові інструменти → Додаткові функції → Сповіщення → Налаштувати**. TgWitness використовує Apprise для надсилання сповіщень у Matrix, Telegram, Discord, Slack, ntfy, електронну пошту та інші підтримувані сервіси. Ви можете додати кілька пунктів призначення до одного робочого простору. 1. Введіть одну URL-адресу призначення Apprise у кожному рядку. Використовуйте [каталог служб та формати URL-адрес](https://appriseit.com/services/) для вашої служби. 2. Увімкніть **«Надсилати сповіщення**», а потім виберіть сповіщення про проблеми, зміни в спостережуваних чатах та щоденний звіт. Час у звіті визначається за серверним часом. 3. Увімкніть опцію **«Включати короткі уривки»,** якщо ви хочете, щоб у сповіщеннях з’являвся збережений текст із видалених та відредагованих повідомлень. 4. Натисніть **«Зберегти сповіщення»**, а потім **«Надіслати тест»,** щоб перевірити доставку. Для власного одержувача використовуйте [JSON-вебхук](https://appriseit.com/services/json/) Apprise. Наприклад, `jsons://notify.example.org/tgwitness` надсилає JSON через HTTPS на цю кінцеву точку. Це вигаданий приклад; замініть його на власний пункт призначення. Пункти призначення та налаштування належать до обраного робочого простору. Повідомлення про зміни охоплюють джерела, що відстежуються, включаючи нещодавно додані чати. Дзвіночок у верхній панелі також відображає список останніх проблем та змін у чатах. У демо-версії елементи керування сповіщеннями відображаються, але надсилання вимкнено. Налаштуйте доставку в реальному робочому просторі. Сповіщення використовують маршрут «Direct», SOCKS5 або HTTP цього робочого простору; MTProxy не може їх передавати. Не-HTTP-призначення, такі як SMTP, вимагають прямого маршруту. ## Розташування панелей ![Робоча область підключення з використанням синтетичних даних](https://phishdestroy.io/tgwitness/assets/connection.png?v=c8781089fe29) **Журнал** відображає спостереження, пошук та фільтри. Редагування відкриває збережені версії; видалення відкриває попередній вміст, якщо він доступний. Невідомі джерела залишаються явно вказаними. Статистика доступна в **розділі «Огляд»**; деталі збору даних зберігаються в локальному посібнику. Відкрийте відредаговане повідомлення, щоб порівняти його версії за допомогою **Зміни в тексті** або **Поруч**; **Вихідні дані** показує збережені поля. Зміни прихованих посилань і кнопок ботів відображаються окремо. Відкрийте попередній перегляд вкладення, щоб переглянути збережені зображення, аудіо чи відео; кнопка завантаження забезпечує доступ до збереженого оригіналу. Режим **Live** оновлює журнал і чати в міру надходження записів. Призупиніть його під час перегляду або скористайтеся кнопкою нових подій, коли будете готові; збір даних при цьому продовжує працювати. Комбінація **Ctrl/Cmd+K** знаходить дії панелі та виконує пошук у журналі. **Більше інструментів → Джерела** містять область спостереження (обрані чати, папку Telegram або весь акаунт), доступні чати всіх типів, вибрані джерела з зірочками пріоритету, налаштування вкладень та повторної перевірки, а також знімки історії. Приватні джерела обираються за діалогом/ID без публічного посилання. Статус доступу описує останню перевірку, а не постійні дозволи. Відфільтруйте джерела, позначте їх прапорцями, а потім одночасно увімкніть, призупиніть або позначте їх як пріоритетні. У списку доступних чатів кнопка **Додати вибрані** використовує ваш вибір; **Додати всі знайдені** використовує поточний пошуковий запит і фільтр за типом. **У розділі «Чати → Користувачі»** перелічено всіх, чиї повідомлення збережено; якщо для чату ввімкнено профілі користувачів, один клік відкриває профіль цієї особи з посиланнями на записи в журналі. **Більше інструментів → Додаткові функції → Незалежний свідок** створює токени свідка, доступні лише для читання, показує, коли кожен свідок востаннє перевіряв дані, та надає команди й параметри для запуску одного ([незалежного свідка](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/)). **Більше інструментів → У розділі Параметри** містяться всі обмеження та темпи роботи робочого простору, які не вказані на інших сторінках: кількість прочитаних діалогів, частота перечитування списку чатів, інтервали пульсу та контрольних точок , буфер запуску, спосіб розподілу запитів під час повторної перевірки (перша затримка, кількість чатів за прохід, пауза між чатами, відновлені та повторно запитані повідомлення), резерв дискового простору, тайм-аути та повторні спроби завантаження, що шукають профілі користувачів (включно з вашими власними регулярними виразами), розмір та частота сповіщень, обмеження на знімки, ZIP-файли та завантаження через браузер, а також тайм-аути та повторні спроби клієнта Telegram. Кожне поле показує свій діапазон та значення за замовчуванням; змінені поля позначені та можуть бути відновлені поодинці або всі разом. Кожна зміна фіксується як `parameters.changed` із значеннями до та після, а записи про початок спостереження вказують діючі значення. Значення застосовуються з наступного використання; тайм-аути клієнта та повторні спроби — з наступного підключення. Інтервали повторної перевірки, типи та розміри вкладень, інтервали збереження доказів та копій поза сервісом залишаються на своїх сторінках і можуть приймати будь-яке значення в межах діапазону, а не лише попередні налаштування. Дзвіночок у верхній панелі відображає останні проблеми та зміни в спостережуваних чатах; непрочитані повідомлення підраховуються, доки їх не позначено як прочитані. Зміни групуються за чатами та годинами («12 видалено, 1 відредаговано, 0 не знайдено»), а такі проблеми, як вихід із системи або переповнений диск, залишаються у списку незалежно від того, наскільки активними є чати. **Більше інструментів → Реєстрація** починається з поля для введення номера телефону. **Натискання Продовжити** веде безпосередньо до введення коду, а запит на введення облікових даних API з’являється лише у разі їх відсутності. QR-код та імпорт файлів — це альтернативні вкладки. Збережені облікові дані API використовуються повторно лише в межах власного робочого простору. Екран введення даних не містить бічної панелі, статистики чи розділів налаштувань. Іконка **Налаштування** відкриває елементи керування API, проксі, сховищем та додатковими обліковими записами. Новий робочий простір відкриває [початкове налаштування](https://phishdestroy.io/tgwitness/uk/docs/reference/settings/) ; після входу в систему робочий простір із збереженими джерелами та записами відкриває **Чати** . Зміна маршруту вимагає призупинення спостереження та скасовує незавершений вхід. Існуючий журнал не можна автоматично прив’язати до іншого облікового запису Telegram. **Експорт** перевіряє цілісність журналу та створює переносимі файли. Його ідентифікатор робочої області можна передати до командного рядка завантаження. Кожен експорт фіксує префікс повного журналу; пізніші події потрапляють до наступного експорту. Фільтри пошуку не змінюють область дії пакета. Детальна інформація щодо підписання та охоплення наведена у розділі **Верифікація та докази**. Панель відображає стан колектора, медіафайли в черзі/з помилками, найстаріші медіафайли в очікуванні, вільне місце на диску, паузи запитів та джерела, доступ до яких не підтверджено, у розділі **«Стан колектора»**. Ці деталі спочатку згорнуті та приховані на сторінці «Обліковий запис». Картка налаштувань показує наступний крок: підключити обліковий запис, вибрати джерела або розпочати спостереження. Список облікових записів є знімком на момент завантаження; обрана робоча область періодично оновлюється. Це не багатопроцесний монітор SLA. Інтерфейс використовує локальні ресурси та текстове відображення вихідного вмісту. Протестовано настільний і вузький макети в Chromium. ## Середовища розгортання | Середовище | Встановлення | Статус перевірки | | --- | --- | --- | | ПК/сервер на базі Windows | Python 3.11+, scripts\Setup.cmd/Start.cmd, приватний каталог даних | Перевірено локально на Windows/Python 3.12 | | Сервер Linux/VPS | Python venv, виділений сервер, HTTPS/SSH | Наведено приклади коду, CI та systemd; не виконується на цьому хості | | macOS | Python venv, процес у фоновому режимі або агент користувача | Наведено приклад запуску; необхідна окрема перевірка встановлення | | Docker/Compose | Постійний обсяг роботи, один виконавець | Надано визначення та перевірку працездатності CI; Docker недоступний локально | | Мобільний браузер | Підключіться до захищеної панелі на працюючому сервері | Перевірено на вузькому макеті Chromium; колектор не працює на iOS/Android | Портативність означає відсутність обов’язкового хмарного сервісу чи фронтенд-збірки. Кожна цільова система все одно потребує сумісних залежностей Python/криптографії, локального диска та доступу до мережі. Див. [файл DEPLOYMENT.md](https://phishdestroy.io/tgwitness/uk/docs/reference/deployment/) та [шаблони сервісів](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Робочі середовища спільно використовують процесор, пам’ять та цикл подій. Для ізоляції процесів використовуйте окремі екземпляри, порти, каталоги даних та авторизації облікових записів. Не існує єдиної панелі управління для окремих екземплярів. Ніколи не направляйте кілька робочих процесів до однієї бази даних. ## Перевірка та експорт даних Перед запуском підготовленого середовища виконайте команду `python start.py --check`. Додайте `--json` для перевірок у машиночитаному форматі або вкажіть потрібні параметри `--data-dir`, `--host` та `--port`. Команда перевіряє наявність необхідних умов без входу в Telegram або створення журналу. Перевірка журналу виконується під час запуску програми, а готовність до збору даних відображається на панелі. Зайнятий порт може бути просто існуючим екземпляром. Браузери, що підтримують API доступу до файлової системи, зберігають експортовані дані через потік із можливістю запису. Інші браузери буферизують не більше 128 МіБ. Для експорту великих обсягів даних або у разі використання браузерів без підтримки потокового запису файлів скористайтеся командним рядком для потокового запису: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Додайте `--profile ID` з розділу «Експорт» для дочірнього робочого простору. Для віддаленого доступу використовуйте `--url https://server` . Простий HTTP приймається лише для локальних адресатів. Токен зчитується з файлу та надсилається у заголовку, а не виводиться на екран чи вставляється в URL-адресу. Перенаправлення не допускаються. Існуючі адресати не перезаписуються. У разі невдалої передачі видаляється її тимчасовий фрагмент файлу. Повідомлений SHA-256 є контрольною сумою передачі; перевірте підписаний ZIP-файл окремо за допомогою надійного відбитка/контрольної точки. ## Створення резервних копій, відновлення та перебої в роботі 1. Призупиніть спостереження та коректно завершіть процес. 2. Скопіюйте весь каталог даних: бази даних, WAL/SHM (якщо є), мультимедіа, `credentials.enc`, `signing.enc`, `network.enc`, ключі сховища/метадані, токен, контрольні точки та кожен каталог `profiles/`. 3. У режимі зовнішнього ключа окремо зберігайте головний ключ та кожен ключ `vault.external.json`. Створення нового ключа не дозволяє відновити старі секретні дані. 4. Відновіть дані, поки пункт призначення зупинено; налаштуйте вихідний ключ, обмежте доступ та перевірте цілісність перед відновленням роботи. 5. Записувати час простою та результати верифікації. Час простою залишається записаним проміжком; знімок історії додає стан після нього. Evidence ZIPs exclude sessions/private keys and are not full service backups. `tgwitness backup FOLDER` makes the same copy while the panel keeps running and leaves out the search index, which rebuilds itself; see [Updates and backups](https://phishdestroy.io/tgwitness/uk/docs/reference/deployment/#updates-and-backups). Four things are protected differently: | Що | Захист | | --- | --- | | Файли експорту без пароля (за замовчуванням) | Підписано, тому зміни можна виявити; щоб зашифрувати експорт, задайте пароль | | Файли експорту з паролем | Якщо ви встановите пароль, готовий експорт без змін зберігається у форматі ZIP із шифруванням AES-256 за допомогою WinZip, який можна відкрити за допомогою 7-Zip та WinRAR; пароль не зберігається ([обробка доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/)) | | База даних журналу та збережені на диску вкладення | Зашифрований диск або том і права доступу до папки | | Сесії Telegram та ключі підпису | Зашифровано в каталозі даних (`credentials.enc`, `signing.enc`, `network.enc`) | Повне резервне копіювання — це описаний вище каталог зупинених даних, а не експорт. Для обох випадків використовуйте захищене сховище та механізм контрольованої передачі. Тимчасові експортовані дані зберігаються у папці `temporary-exports/` кожного робочого простору; завершені відповіді очищуються, а перервані файли експорту видаляються під час наступного запуску, поки триває блокування екземпляра цього робочого простору. Після події відновлення з’єднання колектор запитує пропущені оновлення, починаючи з збереженої позиції оновлення. Постійні завдання з обробки медіаданих та позиція оновлення Telegram зберігаються після перезапуску; див. [формат доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#durable-collection-and-process-receipts-02). ## Ємність та термін зберігання Стандартні обмеження, які можна змінити в меню **Додаткові інструменти → Параметри**: перші 1,000 діалогів, 500 повідомлень на знімок, 4 ГіБ нестисненого підписаного вмісту ZIP (для більших архівів потрібно `verify.py --max-gib N`) та 128 МіБ для резервного варіанту браузера. Вкладення займають 1–2,000 МіБ на тип у **меню Додаткові інструменти → Джерела → Запис → Вкладення**. За замовчуванням CLI для завантаження передає 5 ГіБ. Доступний простір на диску може бути нижчою межею. Зарезервуйте місце для журналів, мультимедіа, WAL, тимчасових експортів та резервних копій. Експорти використовують обсяг даних, а не папку 512 MiB `/tmp` у Compose. Вимірюйте події за секунду, вік черги, обсяг медіаданих у байтах та затримку диска, а не лише кількість груп. Вимірювання потокової передачі здійснюється на працюючому колекторі. Автоматичного видалення збережених даних не відбувається. Видалення кінця журналу порушує його зв’язок із збереженими контрольними точками. Пріоритетні повторні перевірки вже є: джерела, позначені зірочкою, за замовчуванням перевіряються кожні 15 хвилин, інші — кожні 6 годин (див. [рівні повторної перевірки](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#recheck-tiers)). Експорт із паролем працює, як описано вище. Обмежений доступ описано в розділі [доступ і дозволи](https://phishdestroy.io/tgwitness/uk/docs/reference/access/). Див. [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md), [LIVE_ACCEPTANCE.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md) та [VERIFICATION.md](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/). --- # Telegram · Режим розслідування Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/ Повні розслідування акаунтів у каналах, групах, приватних чатах та ботах — від визначення обсягу до формування перевіреного пакету матеріалів справи. [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/assets/chapter-investigate.svg?v=48c1be9d2a52) Відстежуйте справу в різних каналах, групах, приватних чатах та ботах — від початкового збору даних до хронології з посиланнями та перевіреної передачі матеріалів. Інтерактивна версія веб-сайту знаходиться за адресою `/docs/cases/`; [інструкції щодо попереднього перегляду](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally). **На цій сторінці** - [Приклад, що працює: пункт призначення змінюється у чотирьох діалогах](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/#worked-case-a-destination-changes-across-four-conversations) - [1. Визначте суть справи та зберіть повну інформацію](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/#1-define-the-case-and-collect-the-whole-account) - [2. Скласти перелік усіх джерел та зібрати історичний контекст](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/#2-inventory-every-source-and-acquire-historical-context) - [3. Зберегти динаміку розвитку справи та цілеспрямовані взаємодії](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/#3-preserve-the-evolving-case-and-deliberate-interactions) - [4. Пов’язування спостережень у різних чатах](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/#4-connect-observations-across-chats) - [5. Створити хронологію по всіх чатах](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/#5-build-the-cross-chat-timeline) - [6. Додати перспективи облікових записів без втрати їхнього походження](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/#6-add-account-perspectives-without-losing-their-origin) - [7. Скласти та перевірити передачу справи](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/#7-assemble-and-verify-the-case-handoff) - [Адаптувати розслідування](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/#adapt-the-investigation) ## Приклад із практики: зміна пункту призначення у чотирьох діалогах У повідомленні вказується на бота. Оперативна група обговорює новий пункт призначення платежу, і клавіатура бота відображає його. Повідомлення редагується, у приватному повідомленні повторюється пункт призначення, а групове повідомлення зникає. Питання такі: що спостерігалося до та після зміни, які акаунти Telegram опублікували кожен елемент, де з’явився пункт призначення, які байти вкладення були збережені, та які проміжки часу залишаються невідомими? Усі імена, ідентифікатори, час та посилання на журнал у цьому прикладі є вигаданими. Робочий процес використовує поточні функції; карта справи є ілюстрацією, а не автоматичним графіком, згенерованим додатком. Блок-схема · Канали → Журнал робочого простору; Групи → Журнал робочого простору; Приватні чати → Журнал робочого простору; Боти → Журнал робочого простору; Журнал робочого простору → Пошук у всіх джерелах; Журнал робочого простору → Профілі осіб із посиланнями на записи; Журнал робочого простору → Збережені версії та підтвердження отримання вкладень; Пошук у всіх джерелах → Хронологія аналітика та реєстр джерел; Профілі осіб із посиланнями на записи → Хронологія аналітика та реєстр джерел; Збережені версії та підтвердження отримання вкладень → Хронологія аналітика та реєстр джерел; Журнал робочого простору → ZIP-архів із підписаними доказами; Хронологія аналітика та реєстр джерел → Передача справи з окремо перевіреними артефактами; ZIP-архів із підписаними доказами → Передача справи з окремо перевіреними артефактами · Канали · Групи · Приватні чати · Боти · Журнал робочого простору · Пошук у всіх джерелах · Профілі осіб ізпосиланнями на записи · Збережені версії тапідтвердження отриманнявкладень · ZIP-архів із підписанимидоказами · Хронологія аналітика тареєстр джерел · Передача справи з окремоперевіреними артефактами **Діаграма у вигляді тексту** 1. Канали → Журнал робочого простору 2. Групи → Журнал робочого простору 3. Приватні чати → Журнал робочого простору 4. Боти → Журнал робочого простору 5. Журнал робочого простору → Пошук у всіх джерелах 6. Журнал робочого простору → Профілі осіб із посиланнями на записи 7. Журнал робочого простору → Збережені версії та підтвердження отримання вкладень 8. Пошук у всіх джерелах → Хронологія аналітика та реєстр джерел 9. Профілі осіб із посиланнями на записи → Хронологія аналітика та реєстр джерел 10. Збережені версії та підтвердження отримання вкладень → Хронологія аналітика та реєстр джерел 11. Журнал робочого простору → ZIP-архів із підписаними доказами 12. Хронологія аналітика та реєстр джерел → Передача справи з окремо перевіреними артефактами 13. ZIP-архів із підписаними доказами → Передача справи з окремо перевіреними артефактами ## 1. Описати ситуацію та зібрати повну інформацію 1. Підключіть обліковий запис для збору даних у окремому робочому просторі. У [Case Board](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/) або у вашому реєстрі справ зафіксуйте номер справи, ідентифікатор облікового запису, робочий простір та час початку спостереження. Зберігайте відбиток ключа підпису незалежно. 2. Для спеціального облікового запису-колектора відкрийте **Додаткові інструменти → Джерела → Область дії → Режим розслідування**. За замовчуванням вибрано **Весь обліковий запис**, канали/групи/приватні чати/боти, власні дії, профілі джерел та останні 200-ти видимих повідомлень для щойно виявлених джерел. Перегляньте налаштування, натисніть **Зберегти область дії** та завершіть підтвердження області дії. Основні облікові записи використовують вибрані чати або папку; збір даних з усього облікового запису доступний для облікових записів, позначених для розслідування. 3. **Завантажте чати** та порівняйте джерела зі списком діалогів облікового запису. Перевірте виключення. **Більше інструментів → Параметри → Кількість чатів, що зчитуються зі списку облікового запису,** за замовчуванням становить 1,000 і може досягати 20,000. Джерела, що виходять за межі списку, додаються, коли вони стають активними. Зафіксуйте те, що було фактично перелічено. 4. У розділі **Додаткові інструменти → Джерела → Запис** виберіть **Уся видима активність** та збережіть параметри моніторингу. Перевірте типи/обмеження вкладень та вільний простір на диску. 5. Почати спостереження. Перевірити контрольоване нове повідомлення, редагування та видалення, а потім зберегти тестові посилання та будь-які помилки. Область дії Весь обліковий запис фіксує активність, видиму для облікового запису, у межах збережених налаштувань, у чатах, до яких приєднався обліковий запис. Таємні чати фіксуються [модулем Таємний чат](https://phishdestroy.io/tgwitness/uk/docs/reference/secret-chats/), а існуючі розмови заповнюються через [Історію](https://phishdestroy.io/tgwitness/uk/docs/reference/history/). Див. [область дії збору даних](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account). ## 2. Скласти перелік усіх джерел та з’ясувати історичний контекст Ведіть реєстр джерел, де кожен рядок відповідає одному чату: | Галузь | Запис | | --- | --- | | Ідентичність | Робоча область, ідентифікатор облікового запису, числовий ідентифікатор чату, назва та тип | | Видимість | Членство/роль, підтверджений або непідтверджений доступ, виключення | | Запис у реальному часі | Час початку, вибрані типи подій та подальші зміни в політиці | | Історія журналу | Запит на створення/створення знімка, обмеження, час та посилання на записи | | Повна історія | Підписане ім’я файлу експорту для кожного чату, межі та завершення/невдачі | | Вкладення | Завершені записи про отримання медіафайлів, хеші, розміри та результати пропущених/невдалих операцій | | Сфера охоплення | Перебої в роботі, неповне зчитування даних, FloodWait, недоступні повідомлення та інші прогалини | Використовуйте правильний спосіб збору даних для кожного джерела: - **Завантаження повної історії** в **меню Додаткові інструменти → Джерела → Чати в межах дії** завантажує доступні минулі повідомлення з увімкнених джерел у журнал робочого простору. Ця функція підтримує призупинення/відновлення та підписаний звіт про хід виконання. Див. [отримання історії](https://phishdestroy.io/tgwitness/uk/docs/reference/history/). - **Знімок історії** зберігає останні видимі повідомлення у журналі спостережень. Його максимальне значення за замовчуванням становить 500; у меню **Більше інструментів → Параметри → Найбільший знімок історії** можна збільшити це значення до 10,000. Це поточні спостереження за історією, а не реконструйовані редагування. - **Експорт → Захопити або експортувати один чат → Експортувати повний чат** або **Чати → Експортувати чат** витягує поточну видиму історію одного чату в окремий підписаний пакет `chat.json` / `chat.html`. Повторіть цю процедуру для джерел справи та збережіть кожен результат. - **Коли з’являється новий чат або бот**, можна зберегти його профіль та до 1 000 останніх повідомлень; у режимі розслідування вибирається 200. Існуючі чати не отримують цих даних ретроактивно після увімкнення режиму. - **Завантаження видимих вкладень** зберігає байти відповідно до налаштованої політики. Потрібна заповнена квитанція `media.saved` із SHA-256 та кількістю байтів. Завдання в черзі, мініатюра або ім’я файлу не є збереженим вкладенням. Повний експорт чату **не** заповнює журнал або профілі користувачів усіма повідомленнями. Для історії, яку потрібно проаналізувати в TgWitness, використовуйте **функцію «Завантажити повну історію»** або обмежені знімки журналу. Перед початком запуску історії перегляньте список увімкнених джерел. Жоден із цих способів не відновлює матеріали, які Telegram більше не надає. ## 3. Збереження динаміки справи та обміркованих взаємодій Позначте активні чати, пов’язані зі справами, як пріоритетні джерела. Переглядайте інтервали повторної перевірки, постійне наздоганяння та результати у ЗМІ. Під час користування обліковим записом залишайте колектор у режимі спостереження. Використовуйте **«Чати» → «Профіль» → «Зберегти профіль зараз»,** щоб зберегти метадані джерела, такі як описи та команди бота. Це відрізняється від профілів осіб, отриманих на основі збережених повідомлень. У випадках, коли справа пов’язана зі стеженням за джерелом або взаємодією з ботом: 1. **Відкрити посилання Telegram → Зберегти попередній перегляд — ця функція** записує надане посилання та попередній перегляд, що з’являється перед виконанням дії. 2. **Команда «Join / open and observe»** виконує приєднання/відкриття та надсилає параметр запуску бота, якщо він вказаний. Запит на приєднання, що очікує на затвердження, реєструється як «pending». 3. Текстові відповіді, надіслані через панель, та натискання підтримуваних кнопок зберігають `interaction.requested` та `interaction.result`. Квитанції про зворотний виклик можуть зберігати текст спливаючого вікна, стан сповіщення та URL-адресу. Це реальні дії облікових записів. Натискання кнопки зворотного виклику в іншому додатку Telegram не видимі для збирача даних, хоча отримані в результаті повідомлення або редагування можуть бути видимими. Міні-клієнт не виконує робочі процеси, пов’язані з веб-додатками, платежами, телефоном або місцезнаходженням. Щоб дізнатися про точну поведінку, див. [взаємодію з панеллю](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#act-from-the-panel). ## 4. Пов’язування спостережень у різних чатах У розділі **«Журнал**» виберіть **«Усі джерела**» та здійсніть пошук серед записаного вмісту. Відкрийте відповідні записи та збережіть робочу область, чат, ідентифікатор повідомлення, послідовність та хеш запису. У відповідному чаті відкрийте **«Люди**»**→ «Увімкнути профілі**» та перегляньте інформацію про особу: - Імена/імена користувачів, зафіксовані протягом певного періоду, та числовий ідентифікатор Telegram. - Відповіді з посиланнями на вихідні записи. - **Також у…** інших чатах цього робочого простору, де писав користувач із цим ID. - Активність, редагування/видалення, а також згадані гаманці, телефони, імена користувачів та посилання. - Збережені метадані аватарів та подібні кешовані аватари з зазначенням їхнього окремого походження. Відкрийте цитовані записи перед використанням похідного профілю у висновку. Профілі охоплюють осіб із збереженими повідомленнями, а не кожного учасника групи. **Більше інструментів → Параметри → Записи, цитовані за фактом**, обмежують список посилань, а не базову кількість активності. Згадки та схожість аватарів є підказками; право власності та ідентичність ґрунтуються на числових ідентифікаторах та атрибутованих відправниках. У підписаному досьє підказки кодера щодо пересланих та повторно використаних файлів розділено на категорії `clients.forwarded` та `clients.reused`. Такі файли не враховуються у списку `clients.observed` або `media_timing.pre_existing`. Повторно використаний файл означає, що той самий ідентифікатор документа Telegram було раніше виявлено в іншому повідомленні в цьому журналі, у межах дозволених чатів читача. Цитується його перший виявлений запис; подальше виявлення або редагування того самого повідомлення не вважається повторним використанням. У розділі `paid_reactions` досьє зберігається найновіший доступний рейтинг «Зірок» для кожного повідомлення зі списку, разом із даними про джерела та позначками анонімності. Це дані на певний момент часу, а не суми додаткових платежів чи повний список осіб, які відреагували. Знімок без рейтингу не містить жодного замісного списку. У цьому розділі повідомляється про пропущені повідомлення, коли досягається обмеження на їхнє відображення. Списки спостереження та експорт індикаторів перевіряють написи на кнопках, URL-адреси, текст, вбудовані запити та байти зворотного виклику, які декодуються як дійсний UTF-8. Недійсні або надмірно великі кодування зворотного виклику пропускаються під час вилучення тексту; вихідні байти залишаються у збереженому записі. Існуючі списки спостереження потребують повторного сканування для перевірки старих записів з цими додатковими полями. Під час перевірки кнопка не натискається. У наведеному прикладі: | Посилання | Записи | Підтверджені спостереження | | --- | --- | --- | | Один і той самий обліковий запис відправника | Група № 146 та приватне продовження № 205 | Обидва надають ідентифікатор відправника Telegram 71001 | | Те саме призначення | #146, клавіатура бота #173, редагування каналу #188, приватне повідомлення #205 | Усі містять `pay.example.invalid/new`; повторюване місце призначення пов’язує матеріал | | Той самий збережений файл | Завершено обробку квитанцій № 151 та № 209 | Повні значення SHA-256 збігаються для збережених байтів | | Вказівка на джерело каналу | #101 та #188 | Не приписуйте публікацію в каналі користувачеві 71001 без вказівки відправника | Порівняйте хеші вкладень та пов’язані з ними посилання на повідомлення, а також зберігайте хронологію облікових записів, згруповану за ідентифікаторами Telegram, вказаними в цих записах. Зберігайте робочі нотатки команди на [Case Board](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/): додавайте в закладки записи, на які ви покладаєтеся, наприклад #146, #188 та #205, виділяйте точний рядок призначення та зберігайте фрагмент кожної зафіксованої дії між двома записами або в певному часовому діапазоні. Нотатки та статуси зберігають результати перегляду командою у власній підписаній історії, яку можна відокремити від вихідних спостережень. ## 5. Створити хронологію подій у різних чатах Використовуйте збережені версії в **чатах** та їхні посилання **на записи в журналі №…** У **журналі** об’єднайте **всі джерела** з **редагуваннями**, **видаленнями** та **охопленням**. Зберігайте як `source_at` (якщо вказано), так і `observed_at`. | Прикладний час спостереження | Довідка | Спостереження | | --- | --- | --- | | 09:00 | Канал № 101 | Зафіксовано початковий пункт призначення | | 09:12 | Група № 146; ЗМІ № 151 | Опубліковано нове місце призначення; завантаження файлу завершено | | 09:16 | Бот № 173 | Клавіатура вказує на нове місце призначення | | 09:20 | Канал № 188 | Оголошення відредаговано; обидві збережені версії залишаються | | 09:24 | Приватне #205; ЗМІ #209 | Ідентифікатор відправника збігається з ідентифікатором одержувача; байти файлу зберігаються без змін | | 09:28 | Група № 231 | Отримано повідомлення про видалення; особа, яка здійснила видалення, та точний час видалення невідомі | Інші записи з’являються між наведеними прикладами. Послідовні номери впорядковують спостереження; знімки історії можуть містити давніші дати джерел і надходити пізніше, ніж поточні події. Розрізняйте знімки, відновлені повідомлення, повідомлення про видалення та результати, що відсутні при повторній перевірці. Позначте прогалини в охопленні як невідомі інтервали. Пізніше отримання історії не забезпечує ретроактивно безперервного спостереження. ## 6. Додавати перспективи облікових записів без втрати їхнього походження Використовуйте окремий робочий простір для кожного окремого облікового запису та повторюйте його інвентаризацію. Зберігайте ідентифікатор облікового запису, роль, відбиток ключа підпису та посилання на джерела під час кожного порівняння. Номери повідомлень не є глобальними ідентифікаторами для всіх чатів/облікових записів. Case Board зберігає примітки та колекції, пов’язані з джерелами, у межах кожного робочого простору. На екрані групи можна спільно переглядати стан облікових записів та об’єднувати окремі експортовані дані з робочих просторів. Встановлюйте взаємозв’язки між цими джерелами у своїх примітках до справи або в інструментах аналізу; кожен журнал зберігає власне походження та ключ підпису. Глобальний пошук або об’єднана хронологія, що охоплює всі робочі простори, не генеруються. Експорт одного каналу/супергрупи для декількох облікових записів отримує історію цього чату за допомогою відповідних облікових записів. У разі тривалої роботи дотримуйтесь меж, залучаючи [незалежного свідка](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/). Використовуйте перевірки контрольованої доставки, щоб оцінити шлях запису та видимість кожного облікового запису. ## Повторні публікації в ЗМІ та джерела поширення інформації У звітах про докази окремо порівнюються ідентифікатори документів Telegram та хеші SHA-256 із записів збережених файлів. Вони відображають окремі повідомлення, чати, а також перше та останнє збережене входження, з розгортаною хронологією спостережень у форматі HTML. Повторні знімки екрану або редагування одного й того самого повідомлення не збільшують кількість входжень для одного й того самого ключа. Інший файл у відредагованому повідомленні зберігає власне входження. Показник «Вперше помічено» відповідає послідовності публікацій у журналі в межах вибірки звіту. Він не претендує на статус найпершої публікації в Telegram. Ідентифікатори документів використовуються для ідентифікації документів Telegram; SHA-256 порівнює збережені байти. Збіги 64-бітних dHash різних збережених зображень відображаються як візуальні підказки; це порівняння використовує рівні хеші, а не пошук найближчого сусіда. Байти зображення повинні збігатися зі збереженим SHA-256 перед аналізом dHash; файли розміром понад 64 МіБ та зображення розміром понад 40 мільйонів пікселів пропускаються. У зведеннях з джерела «Forward» підраховуються окремі повідомлення призначення. Ідентифікатори однорангових вузлів у заголовках, приховані імена, підписи авторів публікацій та контекст «Збережених повідомлень» залишаються окремими. JSON-файл профілю користувача містить джерела кожного відправника; дописи в каналах також з’являються у підсумковій інформації на рівні чату. Іменоване джерело без ідентифікатора учасника є групою тексту, а не ідентифікованою особою. Заголовки імпортованих чатів залишаються позначеними як імпортовані. До некомпактних ZIP-файлів з даними належать `media-repeats.json`, `forward-sources.json` та `observed-sources.gexf`, захищені маніфестом архіву. Граф GEXF 1.3 має типізовані ребра `forwarded_from` та `recommended`. Стрілки пролягають від спостережуваного чату до вузла, на який є посилання. Ваги рекомендацій враховують збережені спостереження за рекомендаціями; ваги пересилань враховують унікальні повідомлення. Приховані імена та імпортовані заголовки не створюють ребер ідентичності. Жодна операція з графом не розкриває профілі та не звертається до Telegram. Метадані ребер містять послідовності джерел та хеші. Звіти відповідають вибраній частині звіту; архів ZIP із даними все ще містить повний підписаний журнал. Вибірка, що містить лише події повідомлень, порівнює ідентифікатори документів; для порівняння збережених байтів та зображень необхідні події збереження файлів у вибраному потоці. Поточна вибірка хмарних повідомлень не включає файл `media.saved`. Обмеження є явними: 200 000 збережених входжень ключів/повідомлень на аналіз, 100 000 медіа-ключів, 20 груп звітів, 100 хронологічних посилань на групу та 1 000 експортованих ребер графа. Коли досягається обмеження порівняння, у результатах відображаються пропущені випадки, а підрахунки стають нижньою межею. Обмеження щодо відображення хронології та графів вказуються окремо. У компактних ZIP-файлах ці похідні зведені дані не включаються. Підписані вихідні записи залишаються без змін. ## 7. Збір та перевірка матеріалів справи, що передаються Зберігайте ці матеріали разом у каталозі справи, сформованому аналітиком: | Матеріал | Мета | | --- | --- | | Нотатки щодо справ та реєстр джерел | Питання, політика збору даних, доступ/ролі, висновки, альтернативні пояснення та прогалини | | Хронологія | Для кожного запису вказуються як час, так і посилання на робочу область, чат, повідомлення та послідовність повідомлень | | Case Board експорт та фрагменти, якщо вони використовуються | Закладки з посиланнями на джерела, цитати, нотатки команди, колекції, історія редагувань та вибрані записи перевіряються на відповідність ZIP-файлу з доказами | | Підписаний ZIP-файл з доказами для кожного робочого простору | Повний записаний журнал, маніфест та збережені медіафайли; фільтри панелі не обмежують експорт журналу | | Окремо підписані файли профілів користувачів | Посилання, отримані з інших джерел, перевірено на відповідність доказам у робочому просторі | | Підписані повні експортовані дані чатів | Збір поточної видимої історії, окремо від журналу спостережень | | Довірені відбитки, кореневі сертифікати TSA та попередні контрольні точки | Ідентифікатор ключа, зовнішній час останнього запису та збережені межі журналу | | Артефакти Witness, якщо налаштовано | Окремий журнал, підписані записи та відбитки свідків | | Результати перевірки та хеші наданих файлів | Що було перевірено, які байти було передано та кому | З надійної інсталяції, із зазначенням імен файлів та фактичних відбитків кожного робочого простору: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` `--require evidence` завершує роботу з кодом 2, якщо відбиток не збігається, а зовнішній час від третьої сторони не охоплює останній запис; контрольна точка є допоміжною перевіркою. Збережіть фактичні результати верифікації та оригінальні артефакти. Експортуйте робочі нотатки з Case Board разом із цитованими джерелами. Зберіть результати, отримані в різних робочих просторах, у каталозі справи верхнього рівня; кожен артефакт TgWitness має власний підпис та процедуру верифікації. ## Адаптуйте розслідування | Приклад | Траса | Надати | | --- | --- | --- | | Розгляд спорів щодо замовлень/платежів за допомогою бота | Оголошення про вхід → попередній перегляд збереженого посилання → параметр запуску бота → версії повідомлень та клавіатури → квитанції про зворотний виклик панелі → подальші дії у приватних чатах та групах | Спостережувана хронологія пропозицій/відповідей та перевірені джерела; підтвердження платежу надходить із запису про платіж | | Видалені повідомлення після інциденту | Усі відповідні чати → збережені оригінали/редагування → результати видалення або відсутності при повторній перевірці → збережені медіафайли → охоплення та інші перспективи облікових записів | Збережені версії та чітко вказані проміжки часу, про які немає інформації; відсутність вигаданих суб’єктів видалення | | Учасник змінює імена в різних чатах | Числовий ідентифікатор відправника → історія імен/імен користувачів → відповіді → інші спостережувані чати → згадані адресати/файли | Хронологія активності акаунта Telegram із посиланнями на вихідні записи | [Посилання на колекцію](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/) · [Перевірка профілів користувачів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#people-profiles) · [Передача доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#investigation-handoff) · [Перевірка завершена](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/) --- # Telegram · Можливості та охоплення Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/features/ Поточна модель збору даних, робочі процеси з кількома обліковими записами, експорт даних та операційні обмеження 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) · [Довідка про проєкт](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Довідка про проєкт](https://phishdestroy.io/tgwitness/assets/chapter-project.svg?v=f8e31208f561) TgWitness зберігає переписки в Telegram, доступні для підключених облікових записів, фіксує виявлені зміни та готує експортні файли, що піддаються перевірці. Цей довідник описує модель збору даних, поточні робочі процеси та їхні обмеження. **На цій сторінці** - [Автономний додаток](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#standalone-application) - [Спільні розслідування](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#shared-investigations) - [Інструменти архівування](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#archive-tools) - [Додаткові опції](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#optional-extras) - [Протокол та приватні джерела](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#protocol-and-private-sources) - [Кілька облікових записів](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#multiple-accounts) - [Збір даних та вказівка джерел](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#capture-and-attribution) - [Пропускна здатність та обмеження Telegram](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#capacity-and-telegram-limits) - [Надійність та відновлення](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#reliability-and-recovery) - [Модель доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#evidence-model) - [Експорт, розгортання та передача](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#export-deployment-and-handoff) - [Критерії стабільного випуску](https://phishdestroy.io/tgwitness/uk/docs/reference/features/#stable-release-criteria) ## Автономний додаток TgWitness має власну процедуру встановлення, каталог даних та цикл випуску версій. Вбудований веб-інтерфейс забезпечує налаштування та перегляд; експортовані записи можна використовувати самостійно. Користувач підключає свої акаунти, обирає джерела, доступні для кожного з них, та отримує збережений журнал спостережень. Панель відображає вміст, збережені зміни, походження спостережень та відомі прогалини. Інший слідчий може перевірити експортовані матеріали. Панель розрізняє авторизацію облікового запису, доступ до джерела, активність колектора та охоплення записів. Переглядайте ці стани разом під час оцінки інтервалу з невеликою кількістю повідомлень або проблеми з підключенням. ## Спільні розслідування Адміністратор може видавати [токени доступу](https://phishdestroy.io/tgwitness/uk/docs/reference/access/), обмежені робочими просторами та окремими чатами, з правами доступу для кожної дії, обмеженнями за IP-адресою, терміном дії, обмеженнями входу та контролем сеансів. Рецензент із правом лише на читання може перевіряти справу без отримання авторизації Telegram або ключа головної панелі. Доступ, обмежений чатом, залишається окремим від налаштувань на рівні облікового запису та повного експорту журналу. Автоматичний MTProxy підтримує робочі маршрути Telegram із чотирьох публічних джерел або каталогу операторів. [Режими IP](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/#ip-modes) визначають, чи у разі збою потрібно чекати на інший проксі-сервер, чи можна використовувати явно дозволений прямий маршрут. Зовнішні HTTP-запити мають окремий маршрут та перемикач для вимкнення. ## Інструменти архівування З версії 0.7.1 додано функції [отримання історії](https://phishdestroy.io/tgwitness/uk/docs/reference/history/), [пошуку та аналізу в архіві](https://phishdestroy.io/tgwitness/uk/docs/reference/analysis/), [MCP тільки для читання](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/), [локального OCR/транскрипції](https://phishdestroy.io/tgwitness/uk/docs/reference/media-analysis/) та [вихідних веб-хуків](https://phishdestroy.io/tgwitness/uk/docs/reference/webhooks/). Аналітичні звіти та розпізнаний текст зберігаються окремо від зафіксованих подій. [Case Board](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/) додає пов’язані з джерелами закладки, цитати, нотатки та колекції в межах робочого простору. [Конструктор](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/) [звітів](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/) дозволяє вибрати матеріал, розділи та один із восьми макетів для експорту у форматах HTML/PDF, що підтримуються. ## Додаткові опції Повсякденна настройка: обліковий запис → джерела → спостереження. **Більше інструментів → Додаткові** — це окремий розділ для незалежного збору, зберігання, цілей та рівня захисту, сповіщень, доказів та резервних копій, постійно активного сервера, бота-свідка у Telegram та перевірки коду. Кожен з них вказує свою доступність та вимоги перед показом налаштувань. Вибір картки відкриває інструкції; це не призводить до реєстрації чи запуску служби. Налаштування бота складається з трьох етапів: створення доступу тільки для читання, вибір параметрів публікації та запуск на хості свідка. Параметри мережі та публікації, існуючі з’єднання та команди верифікації надаються за запитом. Завантажена конфігурація відрізняється від запущеного свідка. При зміні додаткових параметрів чернетка зберігається; зміни облікового запису та блокування очищають тимчасовий токен і форму. Вбудований посібник містить інструкції щодо запуску. [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md), що відкривається з розділу Експорт, запускає закріплений колектор із вашого форку, фіксує один чат і створює зашифровану передачу з інформацією про походження робочого процесу. ## Протокол та приватні джерела **MTProto — це протокол Telegram; Telethon — це бібліотека Python, яку TgWitness використовує для роботи з MTProto.** Це не альтернативні методи підключення. Функція «Збір» використовує MTProto; опціональний «свідок» публікує підписані перевірки через Bot API. Кожна робоча область має власного авторизованого клієнта та потік оновлень облікового запису. TgWitness відбирає спостереження з налаштованих джерел і надсилає окремі явні запити для таких функцій, як створення знімків історії та завантаження медіафайлів. Приватному джерелу не потрібне публічне ім’я користувача. Ідентифікаторами є тип вузла Telegram та числовий ідентифікатор; назви та імена користувачів можуть змінюватися. Доступ залежить від існуючого членства та дозволів. TgWitness не приєднується до джерел автоматично та не обходить процедуру затвердження приєднання. Хеш доступу з іншого облікового запису не є універсальним токеном доступу. Модель збору даних повинна враховувати приховану історію до приєднання, ролі учасників/адміністраторів, скасування сеансів, видалення або зміну дозволів, міграцію з групи до супергрупи, теми/форуми, пов’язані обговорення, ідентифікатори каналів та недоступні вкладення. Не кожна комбінація була перевірена в реальному часі. Видимість джерела перевіряється під час запуску колектора. Відсутність джерела у результаті обмеженого діалогу означає, що **доступ не підтверджено**, а не те, що видалення доведено. Одне недоступне джерело не заважає спостереженню за іншими доступними джерелами. Ніколи не розміщуйте посилання на запрошення або реальні сесії у публічних фіксаціях. ## Кілька облікових записів Панель підтримує будь-яку кількість **робочих просторів**, кожен із яких має: - Авторизація, зашифроване сховище та маршрут з’єднання. - Журнал на базі SQLite та ідентифікатор підпису Ed25519. - Вибрані джерела, черга медіафайлів та налаштування збору даних. - Стан спостереження, помилки, контрольні точки та експорт даних. Перемикання відображуваного робочого простору не зупиняє роботу іншого колектора. Дублювання авторизації облікового запису у різних робочих просторах не допускається. Журнал, який уже прив’язаний до одного облікового запису Telegram, не можна перепризначити іншому; дозволено повторне підключення того самого облікового запису. Це зберігає ідентичність облікового запису та відповідну область ідентифікаторів повідомлень. Додаток не встановлює фіксованої кількості робочих просторів. Кожен робочий простір виконує власні завдання колектора щодо моніторингу з’єднань, завантаження медіафайлів, повторних перевірок та прийому нових чатів у рамках спільного процесу Python та циклу подій. Пропускна здатність залежить від навантаження. Для ізоляції процесів використовуйте окремі інсталяції, порти та каталоги даних. Призначте кожному обліковому запису джерела, до яких він має доступ. Різні облікові записи можуть спостерігати за однією й тією ж групою, але їхні спостереження залишаються окремими та зберігають своє походження. Два облікові записи на одному комп’ютері, що керується оператором, не є двома незалежними свідками. **Експорт групи** об’єднує окремо підписані ZIP-архіви робочих просторів із підписаним списком файлів, що містить їхні ідентифікатори робочих просторів, хеші та відбитки ключів підпису. Кожен журнал зберігає власні межі. Створіть об’єднану хронологію для всіх робочих просторів у примітках до справи або в інструментах аналізу, зберігаючи ці посилання на джерела. ## Збір даних та вказівка джерел У розділі «Джерела» передбачені налаштування для кожного облікового запису щодо нових повідомлень, редагувань, видалень, реакцій та членства у групах. У пресетах зберігаються або всі категорії, або лише повідомлення/редагування/видалення. Ця політика застосовується до вибраних груп робочого простору, зберігається після перезапуску та підписується з зазначенням стану до та після змін. За замовчуванням зберігаються всі категорії. Вимкнення категорії не видаляє старі записи; повторне ввімкнення не відновлює пропущені події. Операційні записи, інші події групового сервісу та явні знімки історії є окремими. Зафіксовані об’єкти Telegram можуть зберігати вбудовані метадані незалежно від параметрів окремого оновлення. Наразі немає можливості заміни категорій для окремих груп. | Матеріал | Зафіксовано зараз | Межі | | --- | --- | --- | | Повідомлення | Текст, ідентифікатори учасників/повідомлень, метадані відправника, відповіді та оригінальний конверт оновлення | Збережено як спостереження, видиме для облікового запису, підписане збирачем даних | | Редагувати | Нова спостережувана версія, раніше зафіксовані версії, час отримання та вказана дата редагування | Оновлення повідомлень та доступні записи журналу адміністратора зберігають свої відповідні поля атрибуції | | Видалення | Повідомлення Telegram, час отримання та раніше записаний вміст | Час дії суб’єкта та джерела зберігається, якщо він надається окремим записом журналу адміністратора | | Повідомлення про видалення на рівні облікового запису | Оригінальне повідомлення; вирішені записи містять збережений чат та метод кореляції | Потрібно, щоб у межах обсягу було точно одне раніше збережене співпадіння приватного чату або звичайної групи; інші ідентифікатори залишаються в категорії «`deletion.unscoped`». Ідентифікатори каналів та супергруп виключаються з цієї кореляції. | | Реакція | Надані лічильники та видимі останні ідентифікатори | Для отримання повного списку доступних реакторів потрібні окремі запити; канали можуть приховувати ідентифікаційні дані | | Членство | Сервісні повідомлення та оновлення для учасників, яким було надіслано повідомлення | Видимість залежить від ролі та типу чату; інформація про членство надходить із доставлених подій | | Дії адміністратора | Відповідні надані оновлення та знімок журналу адміністратора в експортованих даних чатів каналів/супергруп | Функція експорту зчитує журнал, якщо він доступний для облікового запису адміністратора, що здійснює експорт | | Вкладення | Опис оригінальної версії, завантажені байти/SHA-256 та результати спроб | Початкова версія зберігається; пізніша версія її ніколи не замінює | | Історія | Чіткий знімок поточних видимих повідомлень | Запис у реальному часі зберігає попередні версії та сповіщення про видалення | | Процес збору даних | Запуск/зупинка, сигнал активності, помилки, налаштування, область дії та підписане підтвердження виконання | Локальний інвентар; GitHub та TDX додають [незалежні перевірки середовища](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope) | Інтерфейс вказує обліковий запис, наданий у вихідній події, та зберігає спостережувані імена та імена користувачів. Якщо в події не вказано її учасника, у звіті це поле залишається незаповненим. ## Ємність та обмеження Telegram Ємність визначається для кожного розгортання. Вона залежить від пікової кількості подій за секунду, обсягу та розмірів вкладень, додаткових RPC, активних облікових записів, затримки диска/вільного місця, стану мережі, обмежень Telegram, допустимої затримки та глибини черги. Telegram розрізняє пасивну доставку та активне коротке опитування. У його оновленій документації описано додаткові виклики `updates.getChannelDifference` для відкритих каналів/супергруп та рекомендовано не більше **десяти джерел, що одночасно підлягають короткому опитуванню**. Це стосується короткого опитування; кількість обраних груп встановлюється окремо. | Режим | Мета | Статус | | --- | --- | --- | | Стандартне зауваження | Запис оновлень, отриманих із вибраних джерел | Реалізовано | | Пріоритетні перевірки | Джерела, позначені зірочкою, використовують власний настроюваний інтервал і мають пріоритет у кожному обмеженому циклі повторної перевірки | Реалізовано за допомогою запитів щодо історії та повідомлень | Зірочка пріоритету керує цими повторними перевірками. Додаткове коротке опитування `updates.getChannelDifference` не виводиться як окремий режим користувача. Довільне високочастотне опитування, ігнорування FloodWait або припущення про лінійну пропускну здатність за рахунок додаткових облікових записів не є прийнятною моделлю визначення розміру. Стандартні обмеження становлять: перші 1,000 діалогів у списку, до 500 повідомлень на знімок історії, 1–2,000 MiB на зібраний файл за типом та 4 GiB нестисненого підписаного вмісту ZIP; кожне обмеження змінюється для кожного робочого простору, розміри файлів — у розділі **Додаткові інструменти → Джерела → Запис**, а інші — у розділі **Додаткові інструменти → Параметри**. Експорт не має фіксованого обмеження кількості подій. За замовчуванням резервний режим браузера обмежений до 128 Мб; CLI для потокової передачі має налаштовуване обмеження передачі, за замовчуванням — 5 Гб. ## Надійність та відновлення Реалізовані функції включають: транзакції SQLite WAL/синхронні; атомарні записи повідомлень та мультимедійних завдань; постійні завдання та затримки повторних спроб; дескриптори оригінальної версії; обмежені повторні спроби; збереження медіа-задачі FloodWait; завантаження медіа поза межами мережевого очікування текстової події; експорт зі стабільним префіксом під час продовження подальшого запису; атомарні налаштування та записи аудиту; збереження робочої авторизації після невдалого входу для заміни; ізоляцію пошкодженого додаткового робочого простору; явні спроби повторного підключення; чітке повідомлення про втрату авторизації; та виявлення змін за реальним часом за допомогою монотонного годинника. Параметри pts/qts/seq облікових записів та каналів зберігаються та відновлюються після перезапуску, а відстежувані чати періодично перевіряються повторно; див. [формат доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#durable-collection-and-process-receipts-02). Періодичне збереження позиції не є атомарним підтвердженням прийняття журналу без втрат даних. На початку кожного процесу фіксуються попередній покажчик та межа офлайн-періоду. Поточна історія не розглядається як заповнення прогалин. Обсяг збережених даних у Telegram є обмеженим; `differenceTooLong` не може відтворити весь зниклий вміст. Невідновлювані прогалини повинні залишатися явно позначеними, навіть якщо пізніший знімок історії буде успішним. ## Модель доказів Кожна подія фіксує послідовність, місцевий час спостереження за UTC, час джерела (якщо вказано), тип, джерело, учасника (якщо вказано), оригінальний вміст, попередній хеш та підпис. Спостереження за повідомленнями також зберігають обліковий запис колектора та контекст запуску. Підписана квитанція про процес містить випадковий ідентифікатор запуску; версії залежностей TgWitness/Python/OS; значення SHA-256 вихідних файлів та сукупний відбиток; початковий обліковий запис, область дії та налаштування; показники UTC/монотонності; а також попередній заголовок журналу. Зміни налаштувань, запуск/зупинка та помилки заносяться до того самого журналу. Контрольні точки зберігаються під час запуску, кожні п’ять хвилин під час спостереження (параметр можна змінити) та при упорядкованій зупинці. Збережена локальна контрольна точка дозволяє виявити відкат до попереднього префікса журналу. | Механізм | Що він встановлює | | --- | --- | | SHA-256 файлу | Байти збігаються з відомим дайджестом | | Ланцюжок хеш-кодів подій | Запис упорядкування/взаємозв’язку відносно відомої межі | | Ed25519 | Підпис за допомогою певного ключа | | Незалежно збережений контрольний пункт | Наступні матеріали відповідають встановленим межам | | Вимірювання розміру програмного файлу | Звіт колектора про виміряні файли | | Дійсна незалежна відповідь TSA | Наявність певних байтів на момент часу TSA за умови явних припущень щодо надійності | Підготовку запиту RFC 3161 і перевірку відповіді реалізовано без OpenSSL. У режимі доказів хеші контрольних точок також надсилаються до налаштованих служб міток часу. Збережіть і перевірте відповідь служби міток часу, щоб отримати незалежну прив’язку до часу. Див. [TIMESTAMP.md](https://phishdestroy.io/tgwitness/uk/docs/reference/timestamp/). Зберігайте контрольні точки окремо, контролюйте доступ до ключів підпису, ведіть облік передачі даних та перевіряйте експортовані дані за допомогою надійного програмного забезпечення. У розділі [«Обсяг](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope) [перевірки»](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope) пояснюється, як ці перевірки доповнюють одна одну та які припущення щодо довіри застосовуються. ## Експорт, розгортання та передача Підписаний ZIP-архів містить оригінальні файли у форматах JSONL, CSV, HTML, збережені вкладення, хеші, підписаний маніфест та зручний засіб перевірки. Він охоплює одну робочу область та фіксований повний префікс журналу. Фільтри пошуку на панелі не видаляють записи без попередження. Секретні ключі, токенів та сеансів Telegram виключаються; оригінальні записи все ще можуть містити особисту інформацію та метадані Telegram. Зберігайте дайджест ZIP-архіву, надійний відбиток, контрольну точку, підтвердження обробки та передачі окремо. Використовуйте верифікатор із надійної інсталяції, а не довіряйте виконуваному коду лише тому, що він міститься у перевіреному ZIP-архіві. Інтерфейс браузера поставляється локально без Node.js, CDN або зовнішніх шрифтів. Установкою керує один токен оператора. Для віддаленого доступу потрібен HTTPS або SSH-тунель. Надаються нативні визначення на Python та для контейнерів, а приклади служб містяться в [каталозі deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md); виконані перевірки платформи перелічені окремо. Робоча область за замовчуванням використовує кореневий каталог даних; додаткові робочі області використовують `profiles//`. Для створення резервної копії потрібно зупинити процес та мати повний набір даних/ключів. ZIP-файли з доказами не є резервними копіями програми. Для секретних даних можна використовувати зовнішній головний ключ для нового каталогу даних; шифрування журналу/медіа забезпечується диском/томом оператора. Див. [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/) та [OPERATIONS.md](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/). ## Критерії стабільного випуску До випуску стабільної версії слід зазначити: 1. Реальні приватні групи, супергрупи, форуми та канали з ролями учасників/адміністраторів та прихованою/видимою історією, включаючи дані про вхід/двофакторну автентифікацію, скасування доступу та втрату доступу. 2. Контрольовані редагування, видалення, реакції, членство та медіа-матеріали у порівнянні з відомими діями. 3. Збої процесів/хостингу, несправності диска/переповнення диска, посилання на файли, термін дії яких закінчився, FloodWait, втрата мережевого з’єднання, пошкоджені файли та відкат бази даних. 4. Тривале використання декількох облікових записів із контрольованими затримками, чергами, пам’яттю та дисковим простором, включаючи як «тихі», так і «гучні» джерела разом. 5. Перерва між переходом у наступний стан MTProto та прийняттям запису до журналу. 6. Чиста інсталяція на передбаченій матриці ОС/контейнерів та перевірене відновлення резервної копії. 7. Незалежний огляд питань безпеки, підписів та тверджень щодо авторства/доказів. Доступ до панелі з обмеженою сферою дії описано в розділі [Доступ та дозволи](https://phishdestroy.io/tgwitness/uk/docs/reference/access/). Починаючи з версії 0.6, TgWitness підтримує обмежений імпорт TData для одного облікового запису та імпорт файлів облікових записів, описаний у [файлі ACCOUNTS.md](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/). Перед публікацією ознайомтеся з умовами використання API Telegram. Дослідницькі посилання та висновки щодо платформи знаходяться у [файлі RESEARCH.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/RESEARCH.md). --- # Telegram · Довідка щодо Case Board Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/ Закладки, точні виділення, фрагменти дій, обговорення, обмежений доступ та історія підписаних анотацій, що використовуються Case Board. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Закладки, точні виділення, фрагменти дій, обговорення, обмежений доступ та історія підписаних анотацій, що використовуються Case Board. [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/investigation/) ![Розслідування](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Case Board надає слідчій групі спільний робочий огляд збережених матеріалів. Додавайте спостереження до закладок, виділяйте конкретні фрагменти, зберігайте послідовність дій та обговорюйте їх із колегами. Картки зберігають посилання на джерела та підписану історію редагувань. Коментарі команди залишаються в робочому просторі, де їх можна легко відрізнити від оригінальних спостережень у Telegram. [Модель доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/) · [Доступ](https://phishdestroy.io/tgwitness/uk/docs/reference/access/) · [Звіти](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/) ![Синтетичний канал розслідування](https://phishdestroy.io/tgwitness/assets/case-board.png?v=da27ef9c5b51) **На цій сторінці** - [Робота з випадком](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/#work-with-a-case) - [Дозволи](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/#permissions) - [Збережені контракти](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/#stored-contracts) - [API та експортні дані](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/#api-and-exports) - [Експлуатаційні обмеження](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/#operating-limits) ## Робота зі справою Відкрийте **Більше інструментів → Дошка випадків** у стандартному або експертному режимі. Мова відповідає панелі. Використовуйте **кнопку До дошки** поруч із записом журналу або збереженим повідомленням у чаті, або виділіть його та натисніть **B**. Закладка додається до Вхідних одним кліком. Редагуйте її назву, мітки та примітку або перемістіть її до колекції. Змінена картка доповнюється підписаною версією; її видалення зберігає історію. Для першого випадку виберіть колекцію та додайте записи, які дають відповідь на одне питання. Використовуйте коментарі для перевірки інтерпретації, а потім — **функцію «Презентація»**, щоб переглянути картки та контекст джерел. Окремо вибирайте матеріали для «Case Board» у [«Report Studio»](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/) під час підготовки кінцевого результату. Збереження фрагмента не призводить до автоматичного налаштування фільтрів даних звіту. Виділіть текст у збереженому повідомленні чату, щоб відкрити меню **«Виділити → дошка**». Виберіть колір і додайте примітку. Сервер перевіряє точну цитату та збережену версію, включаючи емодзі, текст у напрямку справа наліво (RTL) та знаки об’єднання. Інтерфейс не відображає виділений фрагмент у маскованому або перетвореному тексті. Натисніть Shift і клацніть на двох записах в одному чаті, щоб вибрати **«Виділити проміжок між ними**», скористайтеся **функцією** **«Виділити за часом**» або збережіть поточні фільтри журналу за чатом, періодом та типом події. Збережений проміжок має власний авторитетний предикат: його відкриття в «Журналі» також застосовує фільтри за кількома чатами, обмеженнями кількості повідомлень та учасниками . **Функція «Показати записи, додані після створення закладки»** виділяє пізніші доповнення. Зміна фільтрів у Journal призводить до виходу зі зрізу. У розділі «Люди» **функція** **«Розділити дії цієї особи»** використовує записаний ідентифікатор учасника; вона не припускає, що автор повідомлення редагував, видалив або відреагував на повідомлення. У діалоговому вікні «Слайс» перед створенням відображається попередній перегляд кількості записів. Термін «`all`» охоплює всі типи записаних даних, включно зі знімками екрана, редагуваннями, видаленнями, реакціями, оновленнями членства/послуг, власними діями, кнопками, мультимедійними результатами, відновленими повідомленнями та майбутніми типами подій. Цей вибір описує збережені спостереження. Повідомлення про видалення невідомих чатів є окремим контекстом, доступним лише для користувачів із повним доступом до робочого простору, і ніколи не пов’язуються з жодним із обраних чатів. Колекції мають визначену область чату. Порожня область означає весь робочий простір. Колекція не може містити картки поза межами своєї області; учасник, обмежений чатом, не може переглядати колекцію, що охоплює ширшу область. «Вхідні» — це віртуальна колекція для непризначених карток. Пошук та фільтри охоплюють лише видимі картки; нитки обговорень та згадки успадковують права доступу батьківської картки. Видалені коментарі мають позначку «видалено» у дискусії. Історія переглядів не фіксується. **У режимі презентації** відкриваються всі картки у вибраній колекції з переглядами «Картка», «Контекст джерела» та «Коментарі команди», а також клавішами «Попередня»/«Наступна». Цей режим не надає засобів редагування. Звичайна стрічка має розбивку на сторінки; у режимі презентації список завантажується сторінками, а деталі однієї картки відображаються по черзі. ## Дозволи Усі операції вимагають доступу до `view`, робочої області/чату та `board.read`. `board.write` додає картки, коментарі, переміщує та встановлює статуси «відкрито»/«переглянуто». `board.manage` дозволяє керувати колекцією, встановлювати статуси «підтверджено»/«відхилено», редагувати або видаляти чужі картки. Статус є рішенням команди, а не результатом криптографічної верифікації. Доступ до попередньо встановлених налаштувань форм: «Рецензент» = читання; «Аналітик» = читання/запис; «Оператор» = читання/запис/управління, на додаток до їхніх існуючих дозволів. Існуючі права доступу не передбачають автоматичного отримання нових прав. Головний адміністратор має всі права та публікує як **«Головний адміністратор**». Використовуйте іменні дозволи для атрибуції. У списку згадок вказано лише поточні доступи, які дозволяють читати повну батьківську картку. Грант для чату A не може отримати картку або фрагмент для A+B, навіть вгадавши його ID або вказавши неправильний `target.chat_id`. Метадані цільового об’єкта визначаються на сервері за підписаним хешем події. Колекції, кількість обговорень, пов’язані картки та оперативні сповіщення фільтруються перед наданням відповіді. Для експорту потрібні права «`export`», а також «`board.read`»; існуючий експортер без доступу до дошки отримує звичайний архів доказів без командних нотаток. SSE перед кожним пакетом повторно перевіряє поточні дозволи. ## Збережені контракти Як і спостереження, анотації записуються транзакційно у таблицю SQLite з можливістю лише додавання даних у робочій області. Файл `annotations.jsonl` є її точним канонічним експортом із того самого знімка для читання, що й `events.jsonl`. Не існує другого конкуруючого сховища анотацій, а також події журналу `board.activity`. Кожен рядок містить саме: ``` { "seq": 1, "at": "2026-11-02T14:00:00.000+00:00", "access_id": "admin", "access_label": "Main administrator", "kind": "board.bookmark", "payload": {"id": "32 lowercase hex digits", "target": {"event_hash": "64 lowercase hex digits"}}, "previous_hash": "64 zeroes for the first record", "hash": "SHA-256 described below", "signature": "base64 Ed25519 signature" } ``` Наведений вище скорочений приклад ілюструє конверт; фактичні корисні дані містять свої значення за замовчуванням та цільові поля, що визначаються сервером. Схеми запитів API знаходяться в папці [`tgwitness/schemas`](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/schemas/board-bookmark.json), вони генеруються з моделей Pydantic під час виконання за допомогою скрипту `python tools/build_board_schemas.py`. Додаткові поля запиту відхиляються. Ідентифікатори генеруються на стороні сервера, якщо вони пропущені. Авторство, час, знімок та підпис не можуть бути вказані викликачем. Ідентифікатори іменних дозволів відповідають існуючому 16-гекс-формату Access; ідентифікатори карток — 32-гекс. Канонічний JSON — це UTF-8, відсортовані ключі об’єктів, відсутність пробілів між токенами, неескеплений Unicode, а також відсутність значень NaN та нескінченності. Хеш анотації — це SHA-256 канонічного об’єкта, що містить формат « `format: "tgwitness-annotations-v1"`» та всі сім полів конверта аж до «`previous_hash`». Цей тег формату відокремлює домен хешу від спостережень. Підпис — Ed25519 над 32 байтами необробленого хешу. Послідовність починається з 1. Ревізії зберігають ідентифікатор картки та вказують попередній хеш анотації у полі «`supersedes`»; вони не можуть змінювати область дії чату. Переміщення, статуси та видалення є окремими записами. Таблиця SQLite відхиляє команди UPDATE та DELETE. Файл `case-board.json` містить `{statement, signature}`. Канонічне твердження підписується ключем робочого простору та містить `format: "tgwitness-case-board-v1"`, `public_key`, `created_at`, `journal_head`, `meaning` та `state`. Стан є детермінованим відтворенням: `annotations_head`, впорядкований масив `items` (колекції, картки, коментарі, включаючи «надгробки») та `status_history`. Елементи зберігають хеш останньої анотації, послідовність, автора та час, а також оригінального творця та час створення у всіх версіях. Повторне відтворення перевіряє версії, батьківські елементи, посилання на колекції та дублікати ідентифікаторів дій. Файл ``manifest.json`` та нові контрольні точки також пов’язують ``annotations_head``. Зберігайте контрольну точку окремо, щоб виявити обрізання або перезапис за допомогою скопійованого ключа підпису. ### Текстові версії `range.start` — це зміщення кодової точки Unicode з нульовою базою, `length` — це додатне значення кількості кодових точок, а `quote` має дорівнювати точному підрядку з `payload.text` або `payload.caption` у цільовій події. Не застосовуються NFC/NFKC, перетворення регістру або нормалізація графем. Фрагменти рядків у Python та `Array.from(text)` у JavaScript реалізують таке саме індексування. Поєднання знаків та емодзі ZWJ може займати кілька кодових точок. `range.version` — це хеш цільової події, а не поточна версія повідомлення чи зміщення сутності UTF-16 у Telegram. Пізніші редагування ніколи не переміщують виділення автоматично. ### Розділ «Ідентифікація та час» `query` приймає рівно один `chat_id` або непорожні `chat_ids`, опціональні діапазони `from`/`to`, діапазони ідентифікаторів повідомлень (лише один чат), `kinds: "all"` або точні/префіксні види з використанням символів-замінників, явні `actors`, `search`, `hide_system` та `include_unscoped`. Групи видів журналу розгортаються до їхніх точних предикатів. Пошук використовує пошук за корисним навантаженням журналу з урахуванням NFC та ігноруванням регістру, не змінюючи підписаний вихідний текст. Дати вимагають часового поясу та нормалізуються до UTC. Дати фільтрують **`observed_at`**. Поле ``source_at`` Telegram відображається окремо. Видалення без мітки часу джерела не має вигаданого часу видалення. Пізній запис, спостережений поза часовим інтервалом, не потрапляє до нього; фрагмент за ідентифікаторами повідомлень може містити пізніші видалення для цих ідентифікаторів повідомлень. «`snapshot`» фіксує час створення, межу послідовності/хешу журналу, кількість збігів, першу/останню послідовність та `result_hash`. Останній — це SHA-256 канонічного масиву JSON у форматі UTF-8 із хешами збігів подій, відсортованих за лексикографічним порядком, включаючи `[]` для порожнього фрагмента. Він також містить точні підрахунки типів та мініатюру часу спостереження з 24 бінами. Слайс зберігає запит, а не дублікати записів джерел . Під час експорту файл `board/slices/.json` містить перелік поточних хешів та доданих/видалених послідовностей. Верифікатор відтворює початковий результат на межі створення, а потім — поточний результат. Додані записи повідомляються як факт зміни. Видалення початкової події порушує незмінний ланцюг доказів; це не сприймається мовчки як звичайне видалення зі зрізу. Знімки реакцій містять неповні списки останніх учасників. Експлорер порівнює сусідні знімки одного й того самого чату/повідомлення, включаючи попередній знімок поза межами фрагмента, та повідомляє про сумарні зміни кількості **між спостереженнями**. Відсутність останніх учасників не означає, що реакція була видалена. Перший знімок не має виведеного попереднього стану. Спостереження за учасниками залишаються прив’язаними до знімка, в якому вони були надані, а не до вигаданого часу дії. ## API та експорт даних `GET /api/board`, що приймає параметри collection/chat/author/label/state/from/to/q/kind/comments, offset/limit та порядок newest/oldest. `GET /api/board/card/{id}` повертає картку, попередній перегляд джерела, ланцюжок повідомлень, історію статусів та пов’язані картки. Підмаршрут participants повертає відповідні варіанти згадок. `POST /api/board/{bookmark|highlight|slice|collection|comment|status|move|remove}` додає запис. `POST /api/board/slice-preview` обчислює запит. Записи фрагментів розбиваються на сторінки за допомогою `GET /api/board/slice/{id}/records`; для переобчислення завжди використовується поточний стабільний знімок для читання. Live `/api/stream` надсилає сповіщення про дошку (`board`) без корисного навантаження, окремо від курсорів журналу. `GET /api/board/export` повертає підписаний документ. Доступ, обмежений чатом, отримує чітко позначене підписане **розкриття інформації**, ніколи — анотації з іншого чату або повний ланцюжок. Повні архівні ZIP-файли з доказами містять файл `annotations.jsonl`, підписаний файл `case-board.json` та додатки у форматі JSON із фрагментами. Налаштування звіту у форматі HTML/PDF/JSON дозволяють вибрати варіант без дошки, закладки/фрагменти без обговорення або картки з коментарями. Цей розділ чітко відокремлює думки команди від спостережень. Фільтри даних звіту також обмежують доступні для читання нотатки; повні підписані вихідні файли у ZIP-архіві з доказами залишаються незмінними. `GET /api/board/slice/{id}/export` генерує підписаний фрагмент JSON-даних у форматі `tgwitness-board-selection-v1`; `?format=csv` генерує зручну таблицю без окремого підпису. Збережіть формати JSON та ZIP: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_KEY_SHA256 --board python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 python -m tgwitness.verify case-board.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 ``` Перевірка відбору підтверджує автентичність підписаної заяви, точність вихідних записів та повноту запиту в межах зазначеної межі. Архів доказів у форматі ZIP може бути новішим, але повинен містити цей префікс. Про відсутню ціль повідомляється явно. Інший знімок вихідного фрагмента, змінена анотація, невідповідність стану відтворення або змінене джерело призводять до відмови. Старі архіви без анотацій зберігають існуючу поведінку перевірки. За замовчуванням для параметра Передача встановлено значення **Не включати**. Явне включення відображає картки проектів через вже зведені записи, опускає недоступні/пропущені цілі, приховує виділені фрагменти, вихідний текст яких був зведений, очищає текст команди за тими самими правилами згадок/контактів та, за бажанням, замінює мітки дослідників на R01, R02… у метаданих та відомих випадках у нотатках. Оригінальний файл `annotations.jsonl` не розкривається. Підписаний супутній файл `tgwitness-case-board-handover-v1` та звіт містять той самий мінімізований матеріал. Кількість фрагментів описує лише розкриті записи, при цьому оригінальні деталі суб’єктів знімків/запитів не розкриваються. Імена у вільному тексті, невідомі мінімізатору, все ще потребують перевірки, як і під час звичайних передач. Похідний файл має власний підпис; оригінальні анотації зберігають свої підписи у повному архіві. ## Обмеження щодо використання Параметри включають м’які обмеження у 10 000 карток та 50 000 коментарів, сторінку фрагмента, що містить до 5 000 записів, та контроль попереднього перегляду медіафайлів. М’які обмеження видають попередження, не видаляючи історію. Сторінки стрічки містять не більше 200 карток. Розмір автономних уривків у форматі JSON обмежено 64 МіБ; для більших обсягів матеріалів звузьте запит або скористайтеся підписаним ZIP-файлом. Автономний верифікатор обмежує відтворення анотацій до 256 МіБ. Case Board не підтримує та не реалізує зовнішні сповіщення про коментарі. Автоматизоване приймання функції використовує вигадані дані та імітований канал передачі Telegram для перевірки зберігання, доступу, візуалізації та експорту. Див. [розділ «Обсяг перевірки»](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope) для ознайомлення з обсягом перевірки доказів. --- # Telegram · Аналіз архіву Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/analysis/ Здійснюйте пошук серед збережених повідомлень, переглядайте результати роботи штучного інтелекту та зберігайте аналітичні звіти з посиланнями на джерела. [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/investigation/) ![Розслідування](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Посібник з організації робочого процесу](https://phishdestroy.io/tgwitness/docs/archive/) · [Вікі](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) Використовуйте **Журнал** для локального пошуку без ШІ; [повнотекстовий пошук](https://phishdestroy.io/tgwitness/uk/docs/reference/search/) (попередній перегляд) знаходить збіги за формами слів, фразами, доменами та @іменами користувачів. Для **Додаткових інструментів → Запитати архів** спочатку увімкніть та налаштуйте провайдера в **Додаткових інструментах → Інтеграції**. Селектор робочого простору вибирає обліковий запис; форма вибирає чати та період спостереження. Пошук виконується локально. Точна фраза або домен звужують результати пошуку; за ID повідомлення запитуються збережені версії. Перегляньте уривки та відкрийте їхні записи в журналі або контекст. Векторної бази даних та автоматичних дій Telegram немає. ## Постачальники та згода Штучний інтелект за замовчуванням вимкнений у кожному робочому просторі. Лише головний адміністратор може налаштовувати модель, кінцеву точку, зашифрований ключ API, обмеження контексту/виводу, час очікування та щоденний ліміт запитів. Ключ ніколи не повертається до браузера. Залиште поле ключа порожнім, щоб зберегти поточний ключ, або явно видаліть його. Ollama використовує свою задокументовану [кінцеву точку `/api/chat`](https://docs.ollama.com/api/chat) з непотоковим виводом у форматі JSON. Її адреса за замовчуванням — `http://127.0.0.1:11434` на сервері TgWitness. Оператор може змінити її за допомогою `TGWITNESS_AI_LOCAL_ENDPOINT`; ця адреса не контролюється моделлю. Встановіть обрану модель самостійно. TgWitness не завантажує її автоматично. Сумісний провайдер очікує базову URL-адресу, що закінчується на `/v1`, та [протокол Chat Completions](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create): `messages`, режим відповіді JSON, `max_completion_tokens` та `choices[0].message.content`. Сервіси, у яких відсутні ці поля, не підтримуються. Тестування з’єднання передбачає надсилання синтетичного тексту та враховується у ліміті запитів. Кожен запит використовує налаштований зовнішній маршрут робочого простору. Заблокований маршрут або MTProxy, призначений виключно для Telegram, є помилкою; повторної спроби через прямий маршрут не відбувається. Навмисно налаштована локальна адреса Ollama дозволяє використовувати приватний пункт призначення. Кінцева точка AI з петлевим підключенням вимагає зовнішнього маршруту «Direct» робочого простору; проксі-маршрути відхиляються ще до передачі. Для інших приватних служб застосовується існуюча опція приватного призначення на рівні сервера. У попередньому перегляді відображаються кінцева точка та зовнішній маршрут, включно з проксі-хостом, якщо це доречно. Зміна цього маршруту вимагає нового попереднього перегляду. Перед генерацією **дані, що надсилаються до моделі**, відображають запит: питання, перевірені уривки, типи подій, час спостережень та маркери охоплення. Сесії Telegram, необроблені поля, ключі постачальників, байти вкладень та повний журнал не входять до цього контексту. Зніміть позначку з небажаних джерел, а потім явно схваліть обробку. Зовнішні постачальники можуть зберігати надісланий вміст відповідно до власних політик. Локальне виконання означає, що кінцева точка є локальною; окремо налаштована служба дотримується власної конфігурації. Одночасно може бути не більше двох запитів до провайдера в цілому та одного на робочу область. Термін дії попереднього перегляду закінчується через десять хвилин, і він може генерувати одну відповідь. Відображаються дані про кількість токенів, надані провайдером; оцінка вартості з’являється лише тоді, коли налаштовано тарифи як на вхідні, так і на вихідні дані. Невдалі спроби також використовують щоденний ліміт запитів. Автоматичні повторні спроби не витрачають додатковий ліміт. ## Джерела та обмеження Пошук використовує [повнотекстовий індекс](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#ask-the-archive-and-mcp), коли той готовий: найкращі збіги у вибраних чатах, з урахуванням словоформ. Запити щодо останніх змін або версій одного повідомлення, а також пошук під час створення індексу, використовують обмежений лексичний пошук серед найновіших записів. У попередньому перегляді вказано метод. Пошук повертає до 24 джерел; довгі тексти обрізаються навколо збігу. Усі урізані уривки та неповні набори результатів позначаються. Цей період стосується **часу спостереження**, а не твердження про те, що історія Telegram є повною. Події, що охоплюють весь робочий простір, не доступні в межах чату. Відсутні дані описуються як такі, що не знайдені в доступному архіві. Модель не отримує жодних інструментів. Її ідентифікатори джерел зіставляються з обраними записами, хеші перевіряються повторно, а цитовані рядки повинні зустрічатися в цих записах. Невідомі ідентифікатори, змінені цитати та непідтверджені твердження призводять до відхилення відповіді. Додаток створює посилання; URL-адреси, згенеровані моделлю, не використовуються як посилання. Ці перевірки підтверджують існування джерел та точність цитат. Перевіряйте висновки на відповідність записам, перш ніж покладатися на них. ## Звіти Збережіть перевірену відповідь як окремий аналітичний звіт. Він містить резюме моделі, хронологію подій, витягнуті посилання та ідентифікатори, записи про редагування/видалення, обмеження охоплення та хеші вихідних подій. До нього додаються дані про постачальника, модель, кінцеву точку, час та версію шаблону запиту. Ідентифікаційні дані автоматично не об’єднуються. Зміни та примітки аналітиків зберігаються окремо від зведеного звіту моделі. Звіти зберігаються у зашифрованих похідних файлах, а їхній індекс знаходиться поза підписаним потоком подій; оригінальні події та мультимедійні дані не змінюються. Лише власник або адміністратор може відкрити звіт, при цьому доступ до джерела перевіряється ще раз. Для завантаження також потрібен дозвіл на експорт. Версія 1 не підписує звіти та не передбачає, що висновки моделі є перевіреними доказами. Обмеження: 100 звітів на робочу область та 100 редагувань аналітика на звіт. Щодо ручного розпізнавання тексту (OCR) та транскриптів див. розділ [«Обробка медіафайлів](https://phishdestroy.io/tgwitness/uk/docs/reference/media-analysis/)». Щодо доступу клієнтів див. розділ [«MCP](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/)». --- # Telegram · Повнотекстовий пошук Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/search/ Знайдіть збережені повідомлення за формами слів, точними фразами, доменами та @іменами користувачів, з найкращими збігами на початку, з індексом, прив’язаним до підписаного журналу. [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/investigation/) ![Розслідування](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Аналіз архіву](https://phishdestroy.io/tgwitness/uk/docs/reference/analysis/) · [Локальне розпізнавання тексту та транскрипція](https://phishdestroy.io/tgwitness/uk/docs/reference/media-analysis/) · [Вікі](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Попередній перегляд.** У розділі **«Журнал**» виберіть **«Найкращий збіг · форми слів»** поруч із полем пошуку. Результати ранжуються за алгоритмом BM25 і відповідають іншим формам того самого слова: *«перевод»* знаходить *«переводом»* і *«переводи»*, *«transfer»* знаходить *«transfers»*, китайська фраза знаходиться без пробілів. **«Новіші спочатку · точний текст»** зберігає попередній пошук підрядка в усьому записі. Індекс є похідними даними. Він відтворюється на основі підписаного журналу, сам ніколи не підписується і ніколи не потрапляє до експорту. Оригінальні записи не змінюються. **На цій сторінці** - [Синтаксис пошуку](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#search-syntax) - [Мови](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#languages) - [Де знаходиться індекс](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#where-the-index-lives) - [Результати та підписаний журнал](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#results-and-the-signed-journal) - [Розпізнаний текст](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#recognized-text) - [Доступ](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#access) - [Запитайте в архіві та MCP](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#ask-the-archive-and-mcp) - [Залежності](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#dependencies) - [Бенчмарк](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#benchmark) ## Синтаксис пошуку | Написати | Знахідки | | --- | --- | | `перевод карта` | Записи, що містять обидва слова в будь-якій формі | | `"переводом на карту"` | Точна фраза, саме в такому порядку | | `бонус OR подарок` | Будь-яке слово | | `перевод -казино` | Записи без виключеного слова | | `example.com` | Домен та його піддомени, у тому числі в прихованих посиланнях та URL-адресах кнопок | | `@username`, `t.me/username` | Згадки та посилання на акаунт, а також надіслані ним повідомлення | | `#tag` | Хештег | | `+79991234567`, адреса гаманця, адреса електронної пошти | Одне й те саме значення у вигляді тексту або посилань | | `from:@username`, `from:123456` | Повідомлення від цього відправника | | `chat:-1001234567890` | Один чат; він може обмежити лише ваш власний доступ | | `id:42` | Збережені версії повідомлення № 42 | | `since:2026-01-01 until:2026-01-31` | Період спостереження; дата без зазначення часу охоплює весь день | | `kind:edited` | Тільки редагування (`new`, `snapshot`, `edited`, `recovered`) | | `source:ocr`, `source:transcription`, `source:all` | Розпізнаний текст замість повідомлень або разом із ними | Прийменники та інші службові слова ігноруються, якщо поруч є інші слова. Схожі літери, що потрапили в слово (наприклад, латинська *«а»* у слові кирилицею), літери Unicode повної ширини та декоративні літери, а також невидимі символи нормалізуються. ## Мови Мова визначається для кожного запису на основі його сценарію та літер: | Скрипт | Відповідність | | --- | --- | | Кирилиця | Російські та українські леми за допомогою [pymorphy3](https://github.com/no-plagiarism/pymorphy3). Без додаткового українського словника використовується полегшений український стеммер | | Латинська | Стеммер «Snowball» для англійської мови; діакритичні знаки ігноруються | | Китайська, японська, корейська, тайська, лаоська, кхмерська, бірманська | Перекривні пари символів: будь-яка фраза шукається без пробілів. Китайські запити розбиваються на слова за допомогою Jieba. | | Інші скрипти | Точні слова | Український словник (`pymorphy3-dicts-uk`) розповсюджується під ліцензією GPL-3.0, тому він не встановлюється за замовчуванням. Встановіть його за допомогою `pip install "tgwitness[uk-dictionary]"`; індекс розпізнає новий аналізатор і самостійно перекомпілюється. ## Де знаходиться індекс | Режим | Зберігання | Використання | | --- | --- | --- | | На диску (за замовчуванням) | `search/fulltext.sqlite3` у каталозі робочої області | Великі архіви; зберігаються після перезапуску | | Тільки в пам'яті | На диску нічого не зберігається; інструмент перекомпілюється при кожному запуску | На диску не зберігаються жодні копії тексту повідомлень | | Вимкнути | Без індексу; **спочатку найновіші · точний текст** залишається без змін | Мінімальні вимоги до встановлення | Головний адміністратор обирає режим у меню **«Журнал» → «Фільтри» → «Індекс пошуку»** для кожного робочого простору. `TGWITNESS_FULLTEXT=disk|memory|off` Встановлює значення за замовчуванням для робочих просторів, які не мають власного вибору. Перехід у режим «У пам’яті» або вимкнення призводить до видалення файлу. Файл індексу має такий самий захист, як і журнал: він зберігається у каталозі приватних даних . Резервні та позамісні копії його не містять. Нові записи індексуються у фоновому режимі за лічені секунди; під час пошуку також спочатку індексується невеликий архів, тому запис, збережений щойно, буде знайдено. Існуючий журнал індексується після оновлення без блокування панелі; до цього моменту результати охоплюють індексовані записи, а журнал показує хід процесу. **Перебудова індексу** починається знову з першого запису. ``` python -m tgwitness index status --data-dir data/live python -m tgwitness index rebuild --data-dir data/live --json ``` `rebuild` необхідно зупинити панель (в іншому випадку — код виходу 3). При `--json`, стандартний вивід містить лише результат; інформація про хід виконання надходить у стандартний вивід помилок. ## Результати та підписаний журнал Індекс зберігає порядковий номер та хеш останнього запису журналу, який він охоплює, і перевіряє їх у порівнянні з журналом під час його відкриття. Замінений, відновлений або відредагований журнал спричиняє перебудову індексу. Кожна відповідь повідомляє про цю позицію, і кожен збіг зчитується з підписаного журналу за його порядковим номером: індекс визначає, які записи показувати та в якому порядку, але ніколи не їхній вміст. Доступ до чату застосовується до власного поля чату журналу, а не до вмісту індексу. ## Розпізнаний текст Результати OCR та транскрипти залишаються у своїх зашифрованих артефактах. Їхній індекс існує лише в пам’яті та відновлюється після завершення завдання розпізнавання. Збіг з’являється у відповідному `media.saved` записі, позначений як «машинне розпізнавання» із зазначенням двигуна, моделі та уривку; він ніколи не відображається як текст, надісланий у Telegram. Цей самий індекс використовується для **пошуку розпізнаного тексту**, який також підтримує збіги з простими підрядками. ## Доступ Доступ у межах чату знаходить лише записи з відповідних чатів, включаючи розпізнаний текст їхніх вкладень. `chat:` та інші фільтри можуть лише звузити цей набір. Стан індексу, що відображається для обмеженого доступу, не включає загальні дані журналу. Тільки головний адміністратор може змінити режим або перебудувати індекс. ## Зверніться до архіву та MCP **Більше інструментів → Запитати архів** отримує джерела з цього індексу, коли він буде готовий: найкращі збіги серед вибраних чатів, причому збережений текст враховується лише один раз. Надсилається до 24 -ти джерел; довгі тексти обрізаються навколо місця збігу та позначаються як урізані. Запити щодо останніх змін, збережених версій одного повідомлення та пошуків, поки індекс ще формується, використовують попередній хронологічний пошук. У попередньому перегляді показано, який метод було використано. Клієнти MCP можуть викликати `search_messages` за допомогою `ranked=true` , а для перегляду сторінок — `next_offset`. З'єднання з обмеженим доступом отримують лише свої чати. Нумерація сторінок за рейтингом охоплює щонайбільше перші 1,000 результатів, незалежно від розміру сторінки. Звузьте запит, чат або період, щоб переглянути інші збіги. Пошук спочатку найновіші сортує повідомлення, результати OCR та транскрипції перед вибором кожної сторінки. ## Залежності | Пакет | Ліцензія | Чому | | --- | --- | --- | | pymorphy3, pymorphy3-dicts-ru, DAWG2-Python | MIT | Російські та українські леми; словники завантажуються локально | | snowballstemmer | Положення BSD-3 | Англійські основи слів, чистий Python | | jieba | MIT | Сегментація китайських запитів, написано на чистому Python (лише дистрибутив вихідного коду) | | pymorphy3-dicts-uk (опціонально) | GPL-3.0 | Повний український словник | Потрібен SQLite FTS5 із `unicode61` токенізатором; він входить до складу SQLite в поточних збірках Python. Без нього пошук найкращого збігу повідомляє про його недоступність. ## Тестування продуктивності `python tools/bench_fulltext.py --messages 1000000 --work `Створює детермінований підписаний журнал, що містить повідомлення російською, українською, англійською, китайською та японською мовами з посиланнями та ідентифікаторами у 200 чатах, формує індекс та вимірює час виконання типових пошукових запитів (50 результатів, медіана за 7 запусків). Виміряно на Windows 11, Intel Core i9-13900K, 128 ГБ оперативної пам’яті, Python 3.12.10, SQLite 3.49.1, дані на диску з файловою системою exFAT, аналізатор `fulltext-v1+pymorphy3-ru+light-uk+snowball-en`: | Вимірювання | Результат | | --- | --- | | Підписаний журнал | 1 000 000 повідомлень, 1,50 ГіБ, записано за 19 хвилин | | Створення індексу на основі журналу | 71 с, приблизно 14 141 повідомлень на секунду | | Індексний файл | 58 Мб, 3,8 % журналу | | Пошук одразу після створення нового запису | Медіана — 8 мс, p95 — 9 мс | | Попередній пошук підрядка, той самий журнал | `перевод` 3,2 с, `银行转账` 2,6 с, `verify-account.example` 2,6 с | | Пошук | Збіг записів | Найкращий збіг, медіана | p95 | Спочатку найновіші, за медіаною | | --- | --- | --- | --- | --- | | Загальні слова, словоформи: `перевод` | 134,403 | 82 мс | 85 мс | 7 мс | | Два слова: `оплата карта` | 28,996 | 43 мс | 43 мс | 14 мс | | Рідкісне слово: `розыгрыш подарок` | 28,881 | 42 мс | 47 мс | 13 мс | | Точна фраза: `"переказ коштів на картку"` | не враховується | 35 мс | 36 мс | 6 мс | | Домен із піддоменами: `verify-account.example` | 12,435 | 17 мс | 17 мс | 3 мс | | @username: `@support_desk_bot` | 10,331 | 15 мс | 16 мс | 3 мс | | Китайська мова без пробілів: `银行转账` | 17,691 | 23 мс | 24 мс | 3 мс | | Японська: `リンク` | 16,603 | 23 мс | 25 мс | 3 мс | | Англійська основа: `withdrawal` | 27,775 | 26 мс | 26 мс | 2 мс | | АБО та виключення: `бонус OR подарок -казино` | 268,034 | 190 мс | 193 мс | 19 мс | | Фільтр чатів: `chat:-1000000000007 перевод` | 652 | 9 мс | 9 мс | 6 мс | | Фільтр за періодом: `since:2026-01-01 until:2026-01-31 выплата` | 115,732 | 155 мс | 156 мс | 81 мс | Точна фраза перевіряється буквально серед варіантів у порядку рейтингу, доки сторінка не заповниться, тому її загальна кількість не враховується. Час виконання зростає із кількістю записів, що відповідають запиту; звуження чату або періоду прискорює широкий пошук. У синтетичному корпусі повторюється невеликий словниковий запас, тому загальні слова відповідають набагато більшій кількості записів, ніж у реальних чатах. --- # Telegram · MCP тільки для читання Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/ Підключіть клієнт MCP до вибраних робочих просторів та чатів із тимчасовим, відкличним доступом. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Підключіть клієнт MCP до вибраних робочих просторів та чатів із тимчасовим, відкличним доступом. [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/cli/) ![Інтеграції з архівами](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) Підключіть клієнт-аналітик до вибраних робочих просторів та чатів. TgWitness надає доступ до **Streamable HTTP за адресою `/mcp` у процесі панелі**. Кожне з’єднання має власний токен, термін дії та дозволені інструменти. MCP не може надсилати повідомлення Telegram, змінювати налаштування або модифікувати підписаний журнал. Ці ж з’єднання працюють із [командним рядком](https://phishdestroy.io/tgwitness/uk/docs/reference/cli/). [Посібник з організації робочого процесу](https://phishdestroy.io/tgwitness/docs/archive/) · [Вікі](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **На цій сторінці** - [Встановити та перевірити](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/#install-and-check) - [Встановити з’єднання](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/#issue-a-connection) - [Підключіть свій клієнт](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/#connect-your-client) - [Тунель Cloudflare](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/#cloudflare-tunnel) - [Інструменти та обмеження](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/#tools-and-boundaries) ## Встановлення та перевірка Використовуйте середовище Python, у якому запущено панель. З каталогу вихідного коду: ``` # Windows PowerShell & .\.venv\Scripts\python.exe -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' & .\.venv\Scripts\python.exe start.py --check ``` ``` # Linux / macOS .venv/bin/python -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' .venv/bin/python start.py --check ``` Перезапустіть панель із її звичайним каталогом даних та аргументами запуску після встановлення. Статус готовності повинен містити `[PASS] mcp: streamable-http available`. У розділі **Інші інструменти → Інтеграції → MCP** відображається стан виконання та команда встановлення з використанням фактичного виконуваного файлу Python цього сервера. **Функція Перевірити ще раз** оновлює цей статус без перезавантаження сторінки; вона не встановлює пакети та не перезапускає сервер. Додаток MCP використовує офіційний [SDK MCP для Python](https://github.com/modelcontextprotocol/python-sdk). Файл`deploy/constraints-mcp.txt` фіксує версію тестованого SDK та його залежностей. ## Створення підключення 1. Введіть мітку та виберіть робочі простори й чати, які клієнт може читати. 2. Виберіть інструменти окремо або скористайтеся шаблоном. Пропонуються лише реалізовані інструменти. 3. Виберіть термін дії 1, 7, 30 або 90 днів чи вкажіть власний термін від однієї хвилини до 90 днів. 4. Натисніть **Create connection**. Токен з’явиться один раз поруч із конфігурацією клієнта. 5. Скопіюйте токен і конфігурацію, а потім натисніть **Check connection**. Це ініціалізує MCP і виведе список дозволених інструментів; **жодні повідомлення не читаються**. Результат показує версію протоколу, назви інструментів, їхню кількість і витрачений час. 6. Натисніть **Done**, коли облікові дані буде збережено. Фонове опитування зберігає форму та картку одноразового показу. Блокування панелі очищає відображені секретні дані. У списку відображаються нещодавнє використання, останній інструмент, адреса та запити за останню хвилину. **Revoke** припиняє доступ. **Rotate token** відкликає старі облікові дані та видає заміну з тією самою областю дії, інструментами та терміном дії; скопіюйте новий токен (він показується один раз). Токени входу в панель та облікові дані Telegram не працюють як токени MCP. ## Підключення клієнта Виберіть клієнт у панелі та скопіюйте згенеровану для нього конфігурацію. Конфігурації використовують посилання на секрети або явні заповнювачі; токен копіюється окремо. | Клієнт | Конфігурація | Зв’язок | | --- | --- | --- | | Код Claude | `.mcp.json` | HTTP, `type: "http"`, заголовок Bearer | | Claude Desktop | `claude_desktop_config.json` | Локальний міст stdio | | Cursor | `.cursor/mcp.json` | HTTP із заголовком через змінну середовища | | VS Code Local | `.vscode/mcp.json` | HTTP із введенням пароля через `promptString` | | Windsurf | `mcp_config.json` | HTTP із заповнювачем у заголовку Bearer | | Інші клієнти | URL-адреса та заголовок Authorization | HTTP із можливістю потокової передачі | TgWitness використовує токени Bearer без виявлення OAuth. Використовуйте локальний міст stdio для клієнтів, чий віддалений конектор вимагає OAuth. У VS Code вхідні змінні застосовуються до середовища **Local** і не передаються в сеанси Copilot. Довідники з конфігурації: [Claude Code](https://code.claude.com/docs/en/mcp), [Cursor](https://prod.cursor.com/docs/mcp), [VS Code](https://code.visualstudio.com/docs/agents/reference/mcp-configuration). Канонічна точка входу для локального мосту: ``` python -m tgwitness.mcp_server --url https://your-panel.example/mcp ``` Використовуйте локальний Python клієнта зі встановленим доповненням MCP. Задайте `TGWITNESS_MCP_TOKEN` у його захищеному середовищі. Не передавайте облікові дані в аргументах команд і URL-адресах. `tgwitness-mcp` — це та сама точка входу. Старий модуль `tgwitness.mcp_bridge` та назва `TGWITNESS_ARCHIVE_TOKEN` залишаються шляхами сумісності з попередженням; нові конфігурації використовують `mcp_server` і `TGWITNESS_MCP_TOKEN`. ## Cloudflare Tunnel Перенаправляйте маршрут `/mcp` панелі та зберігайте заголовок Bearer. Відкриття налаштувань MCP від імені адміністратора реєструє поточне джерело (origin) панелі для цього запуску. Щоб стабільна адреса була доступна одразу після перезапуску, налаштуйте `TGWITNESS_PUBLIC_URL` із HTTPS-джерелом панелі перед її запуском. Довільні заголовки Host і заголовки перенаправлення не реєструють довірену адресу. Перевірки Host і Origin відхиляють сторонні джерела браузера. Відповіді використовують `Cache-Control: no-store`; значення авторизації ніколи не записуються в журнал. Адреса `*.trycloudflare.com` є тимчасовою. Коли перезапуск тунелю змінює ім’я хоста, оновіть налаштовану публічну URL-адресу та URL-адресу MCP кожного клієнта. Використовуйте стабільне ім’я хоста для збережених конфігурацій клієнтів. ## Інструменти та обмеження | Інструмент | Що читає | | --- | --- | | `list_workspaces` | Дозволені робочі простори | | `list_chats` | Дозволені чати | | `search_messages` | Текст збережених повідомлень за вибраний період; `ranked=true` використовує [повнотекстовий пошук](https://phishdestroy.io/tgwitness/uk/docs/reference/search/) (форми слів, найкращі збіги першими, `next_offset` пагінація) | | `get_message_versions` | Зафіксовані версії та спостереження щодо видалення | | `get_message_context` | Сусідні ідентифікатори зафіксованих повідомлень | | `get_journal_event` | Один очищений запис із посиланням на його джерело | | `get_capture_status` | Стан збору даних, дозволені записи охоплення та `gap_summary`: номери повідомлень, які ніколи не спостерігалися, за кожним каналом або супергрупою, а також для послідовності в межах усього облікового запису ([деталі](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#missing-message-numbers-gap_summary)); виберіть чат, щоб переглянути перелік пропусків у ньому | | `get_activity_stats` | Повідомлення за годинами за UTC та днями тижня, дні пікового навантаження, частка редагувань та видалень, відправники, домени та `@handles`, із охопленням ([деталі](https://phishdestroy.io/tgwitness/uk/docs/reference/cli/#activity-statistics)) | | `get_messages_by_date` | Збережені повідомлення за один календарний день у зазначеному часовому поясі IANA (`Europe/Kyiv`, `UTC`), за часом, який повідомляє Telegram; `from_utc` та `until_utc` вказати обчислений день, з урахуванням переходу на літній час | | `get_pinned_messages` | Повідомлення, закріплені в останньому знімку стану чату разом із їхніми збереженими версіями, а також сповіщення про закріплення та зняття закріплення, що відображаються в режимі реального часу | | `get_chat_stats` | Кількість збережених записів для одного чату або всіх чатів у межах охоплення, перше та останнє спостереження, а також `gap_summary`; використовуйте це перед великим читанням | | `get_topics` | Теми форуму з повідомлень служби збережених тем: історія заголовків, закриті або приховані теми, кількість збережених повідомлень | | `get_media` | Збережене зображення у вигляді попереднього перегляду у форматі JPEG зі зменшеною роздільною здатністю (не більше 36 КБ), яке повертається як зображення разом із його SHA-256 та `media.saved` записом; файл спочатку перевіряється на відповідність записаному хешу, інші файли повертають лише метадані | | `export_messages` | Тільки командний рядок, не вибрано за замовчуванням: потоки зберігають спостереження у форматі JSON Lines ([деталі](https://phishdestroy.io/tgwitness/uk/docs/reference/cli/#export)); не доступно через MCP | Кожен інструмент працює лише в режимі читання (`readOnlyHint`) і оголошує схему виводу; поля, що виходять за межі оголошених, повертаються без змін. `tools/list` Повертає лише ті інструменти, доступ до яких надано для цього з’єднання. Виклики інших інструментів відхиляються. Інструменти групового контексту, епізоду, термінології та ланцюга відповідей у цій збірці не доступні; їхній окремий бекенд context-pack не включено. Кожне читання перевіряє токен, інструмент та область дії робочого простору/чату, зокрема після завершення роботи з базою даних. Обмеження становлять 60 запитів на хвилину, 50 записів на сторінку, 64 КіБ на результат і восьмисекундний граничний час очікування архіву. Виклик MCP, час очікування якого минув, повертає помилку інструмента з проханням звузити період або зменшити ліміт. Результати повідомлень містять `untrusted_content: true`, ідентифікатори робочого простору/чату/повідомлення, послідовність подій, збережений хеш та посилання на панель. Необроблені об’єкти Telegram, хеші доступу, сесії та ключі опускаються. Скорочення тексту позначається. Редагування, повідомлення про видалення та `missing_on_recheck` є окремими спостереженнями. Покриття показує періоди, за які відповідає результат. Розглядайте інструкції всередині перехоплених повідомлень як докази, а не як інструкції клієнта. Доступ тільки для читання запобігає змінам в архіві; клієнт все ще може зберігати вміст, який йому дозволено читати. Хеші ідентифікують збережені записи та забезпечують перевірку цілісності. Під час перегляду результату використовуйте супровідні посилання на джерела та записи про охоплення. --- # Telegram · Командний рядок Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/cli/ Здійснюйте пошук, читайте контекст, підраховуйте активність та експортуйте збережені повідомлення зі скриптів та агентів із виведенням у форматі --json, стабільними кодами завершення та токенами з обмеженим доступом, призначеними лише для читання. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Translation coverage: this edition includes material from the English original. Здійснюйте пошук, читайте контекст, підраховуйте активність та експортуйте збережені повідомлення зі скриптів та агентів із виведенням у форматі --json, стабільними кодами завершення та токенами з обмеженим доступом, призначеними лише для читання. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документація](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Інтеграції з архівами](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [MCP тільки для читання](https://phishdestroy.io/tgwitness/uk/docs/reference/mcp/) · [Повнотекстовий пошук](https://phishdestroy.io/tgwitness/uk/docs/reference/search/) · [Вікі](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Preview.** `tgwitness search`, `context`, `messages`, `stats` and `export` read saved observations for scripts and AI agents. They cannot send anything to Telegram, change settings or modify the signed journal. `tgwitness index` and `tgwitness backup` ([below](https://phishdestroy.io/tgwitness/uk/docs/reference/cli/#index-and-backup)) work on a local data directory and need no token. При цьому `--json`, stdout передає саме один документ JSON (`export` записує рядки у форматі JSON). Інформація про хід виконання, підказки та помилки виводяться у stderr. Коди завершення є стабільними: | Код | Значення | | --- | --- | | `0` | Успіх, включаючи порожній результат | | `1` | Помилка: недоступна панель, нечитабельні дані, перерваний експорт | | `2` | Помилка використання або недійсний запит: неправильна дата, невідома опція, індекс пошуку вимкнено | | `3` | Наразі недоступно: робоча область відкрита в активній панелі, або панель пропонує спробувати пізніше (обмеження частоти запитів, перевищення часу очікування) | | `4` | Доступ відхилено: відсутній, прострочений або скасований токен; чат поза межами сфери дії; інструмент, який це не дозволяє | ## Два способи читання **Через панель (`--url`).** Команда використовує той самий API архіву з обмеженою областю дії, що й MCP. Створіть з’єднання в **Додаткові інструменти → Інтеграції → MCP**: виберіть робочі простори та чати, інструменти та термін дії, а потім скопіюйте токен один раз. З’єднання є лише для читання, обмежене цими чатами, має обмеження швидкості до 60 запитів на хвилину та може бути скасоване або оновлене в будь-який час. Токени входу в панель та облікові дані Telegram тут не працюють. ``` export TGWITNESS_URL=https://panel.example.org # default http://127.0.0.1:8787 export TGWITNESS_MCP_TOKEN=tgw_mcp_... # or --token-file path tgwitness search 'перевод карта' --json ``` Віддалена панель вимагає HTTPS; звичайний HTTP допускається лише для `127.0.0.1`, `localhost` та `::1`. Змінні середовища проксі ігноруються, а перенаправлення відхиляються, тому токен надходить лише на вказану вами адресу. **Безпосередньо з зупиненого робочого простору (`--data-dir`).** Зчитує каталог даних із повним локальним доступом, без токена. Використовуйте його на копії каталогу даних або під час зупинки збору даних. Підписані записи ніколи не змінюються; як і у випадку з панеллю, відкриття робочого простору може призвести до оновлення похідних індексів. Коли панель має відкритий робочий простір, команда завершується з кодом `3`; замість цього читайте через панель. Якщо `--data-dir`, `TGWITNESS_DATA`, `./data/live` або використовується каталог даних тієї інсталяції, в якій виконується команда. `--workspace ID` вибирає робочу область (за замовчуванням `default`). `tgwitness messages --workspaces` виводить список тих, які ви можете читати. ## Команди | Команда | Результат | | --- | --- | | `tgwitness search QUERY [--chat ID] [--since] [--until] [--any] [--limit N] [--offset N]` | Спочатку відображаються найкращі збіги, включаючи словоформи, точні фрази в лапках, домени та `@username` ([синтаксис](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#search-syntax)) | | `tgwitness search QUERY --exact [--before SEQ]` | Точний текст, спочатку найновіші записи, без індексу | | `tgwitness context CHAT_ID MESSAGE_ID [--limit N] [--before SEQ]` | Збережені повідомлення в межах десяти ідентифікаторів повідомлень з обох боків | | `tgwitness messages [--limit N] [--offset N]` | Чати, які ви можете читати | | `tgwitness messages CHAT_ID [--since] [--until] [--limit N] [--before SEQ]` | Збережені повідомлення чату, найновіші першими | | `tgwitness messages CHAT_ID --message ID` | Кожна збережена версія та запис про видалення одного повідомлення | | `tgwitness stats [--chat ID] [--sender ID] [--since] [--until] [--top N]` | Статистика активності наведена нижче | | `tgwitness export [--chat ID] [--since] [--until] [--output FILE]` | Збережені спостереження у форматі JSON Lines у порядку записів у журналі | Дати вказано у форматі `2026-10-01` (північ за UTC) або час у форматі ISO із зазначенням часового поясу, `2026-10-01T09:00+03:00`. Щодо `search`, `messages` та `export` вони вибирають час спостереження. Сторінки вміщують до 50 записів: дотримуйтесь `next_offset` (`--offset`) для пошуку за рейтингом та `next_before` (`--before`) в інших розділах. Ranked search stops at 1,000 results. The final page may be shorter than `--limit`. When more observations match, the last page says so (`truncated: true` with `--json`); narrow the query, chat or period. Кожен результат повідомлення містить `untrusted_content: true` , ідентифікатори робочого простору, чату та повідомлення, послідовність журналу, хеш збереженого запису та посилання на панель. Редагування, повідомлення про видалення та `missing_on_recheck` — це окремі записи. Покриття в `stats` показує періоди, за які відповідає результат пошуку. ### Статистика активності `stats` підраховує збережені спостереження для одного чату, одного відправника або всіх чатів у межах обстеження: - повідомлення за годинами за UTC та за днями тижня (починаючи з понеділка), години та дні з найбільшою активністю; - відредаговані, видалені та `missing_on_recheck` поширення; - відправники з кількістю повідомлень та часом надсилання першого та останнього повідомлення; - найпоширеніші домени та `@handles`, що підраховуються один раз на повідомлення у всіх його збережених версіях; - Обсяг: `coverage.gap` записи та, для доступу до всього робочого простору, періоди без сигналу життя підключеного колектора (`collector_liveness`). Період визначає **час повідомлення, зазначений Telegram**. Підрахунок годин та днів тижня допомагає оцінити часовий пояс відправника. Цифри обчислюються за запитом із журналу та не зберігаються. Кожен результат вказує на заголовок журналу, який він охоплює, коли ваш доступ охоплює робочу область. Зчитування зупиняється через п’ять секунд під час роботи через панель або через `--timeout` секунд локально (за замовчуванням 30); тоді `complete` дорівнює false, а `partial` вказує на перший запис, який не було прочитано. У цьому випадку враховуються лише найновіші записи. ### Експорт `export` Записує один об’єкт JSON на кожне збережене спостереження (нові повідомлення, знімки екрана, редагування, відновлені повідомлення, повідомлення про видалення, `missing_on_recheck` та збережені мультимедійні записи) у порядку їхнього внесення до журналу. Кожен рядок містить ті самі поля, що й інші записи, а також повний текст. При `--output`файл записується під `.partial` іменем і перейменовується лише після запису про завершення роботи панелі; перерваний експорт не залишає файлу та завершується з кодом `1`. `--output` ніколи не перезаписує існуючий файл. З `--output` та `--json`, у stdout виводиться зведена інформація: кількість записів, остання послідовність журналу та, у разі доступу до всього робочого простору, початок журналу. Експорт через панель вимагає з’єднання, яке дозволяє **експортувати повідомлення (лише командний рядок)** ; за замовчуванням ця опція не вибрана. Цей файл є робочою копією; для перевіреної передачі використовуйте підписаний експорт у **розділі Експорт** , який перевіряється командою `python -m tgwitness.verify` . Панель повторно перевіряє доступ перед виведенням кожного запису, включаючи запис про завершення. Скасований або прострочений доступ призводить до неповного експорту. Ліниве читання сторінок поділяє ліміт архівного модуля з іншими запитами та має обмежений час очікування. ### Index and backup These two commands read the data directory directly and take no token or `--url`. | Команда | Результат | | --- | --- | | `tgwitness index status [--workspace ID] [--data-dir DIR] [--json]` | Search index state of one workspace or, by default, every workspace: mode, `ready`, `building` or `not built`, indexed and journal head sequence. Works while the panel runs | | `tgwitness index rebuild [--workspace ID] [--data-dir DIR] [--json]` | Rebuilds the index from the first journal record. Rewrites only the derived index, never the signed journal. Exits with code `3` while the panel has the workspace open. Nothing is built when the workspace keeps its index in memory or has search off | | `tgwitness backup FOLDER [--data-dir DIR] [--json]` | Copies the whole data directory into a new or empty folder outside it while the panel keeps running, and writes `backup-manifest.json` with every file's SHA-256 and the journal heads | `index` accepts `--workspace default` or a workspace ID; the default is `all`. The backup skips temporary exports, SQLite sidecar files and lock files. The folder holds the Telegram session and signing keys, so keep it as private as the data directory. [Backup, restore, and capacity](https://phishdestroy.io/tgwitness/uk/docs/reference/deployment/#backup-restore-and-capacity) describes restoring and what the next start records. ## Навички агента [`.agents/skills/tgwitness-cli/SKILL.md`](https://github.com/phishdestroy/TgWitness/blob/main/.agents/skills/tgwitness-cli/SKILL.md) розповідає агенту, як використовувати ці команди, як цитувати записи та як обробляти захоплений текст. Агенти, які читають `.agents/skills` завантажують його з репозиторію чеку. Для Claude Code скопіюйте `tgwitness-cli` папку у `.claude/skills/` у ваш проєкт або `~/.claude/skills/`. ## MCP та командний рядок Обидва використовують ті самі з’єднання, перевірки області дії та обмеження. Результати MCP обмежуються однією сторінкою розміром 64 Кбайт, тому MCP не підтримує масовий експорт; командний рядок передає дані потоком. `get_activity_stats` доступна для обох. --- # Telegram · Локальне розпізнавання тексту (OCR) та транскрипція Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/media-analysis/ Розпізнавайте захоплені зображення та аудіо за допомогою локального робочого процесу; зберігайте отриманий текст із посиланням на вихідний файл. [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/investigation/) ![Розслідування](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Посібник з організації робочого процесу](https://phishdestroy.io/tgwitness/docs/archive/) · [Вікі](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) Відкрийте запис журналу `media.saved` , виберіть **Розпізнати вкладення** , а потім виберіть OCR або транскрипцію в розділі **Додаткові інструменти → Запитати архів** (називається **Машинне розпізнавання,** коли штучний інтелект архіву вимкнений). Обробка відбувається вручну та локально. Режим хмарних медіа та автоматичне завантаження відсутні. Оригінальні байти вкладення та `media_sha256` залишаються незмінними; розпізнаний текст явно позначається як машинне розпізнавання та зберігається окремо разом із вихідним хешем, версією двигуна/моделі, мовою, параметрами та часом завершення. Транскрипти зберігають повернуті часові мітки. Шукайте серед цих результатів за допомогою **функції «Пошук розпізнаного тексту»** та фільтра «OCR/транскрипт», або виберіть розпізнаний текст як джерело для пошуку найкращого збігу в **журналі**. Обидва варіанти зіставляють форми слів за допомогою [індексу](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#recognized-text) [в](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#recognized-text) [оперативній пам’яті](https://phishdestroy.io/tgwitness/uk/docs/reference/search/#recognized-text). Це окремий пошук за похідними даними; він не перетворює автоматичне розпізнавання на оригінальний текст Telegram і не додає його до підписаних подій. ## Налаштування додаткового робочого процесу Версія 1 вимагає хоста під управлінням Linux із локальним демоном Docker. У Windows TgWitness можна запускати у віртуальній машині Linux або середовищі WSL із власним локальним демоном. Панель ніколи не декодує ненадійні вкладення самостійно. ``` docker build -f deploy/media-worker/Dockerfile -t tgwitness-media:local . export TGWITNESS_MEDIA_IMAGE=tgwitness-media:local ``` Встановіть ці змінні в середовищі служби TgWitness і перезапустіть її. Сокет демона за замовчуванням — `/var/run/docker.sock`; для розгортань без прав root можна встановити `TGWITNESS_DOCKER_SOCKET`. Робочий процес явно використовує цей сокет Unix, а не віддалений контекст Docker. Не надавайте доступ до API Docker користувачам панелі управління та не монтуйте його сокет усередині контейнера розпізнавання. Для транскрипції окремо встановіть модель Whisper, сумісну з CTranslate2, а потім вкажіть `TGWITNESS_WHISPER_MODEL_DIR` як її каталог. Робочий процес завантажує її за допомогою `local_files_only=True`; вибрана модель та вхідні дані монтуються у режимі «тільки для читання». Дивіться [документацію щодо завантаження](https://github.com/SYSTRAN/faster-whisper) моделей двигуна. Надане зображення OCR містить навчальні дані англійською та російською мовами. За потреби додайте іншу мову до свого зображення; коди мов відповідають [CLI Tesseract](https://tesseract-ocr.github.io/tessdoc/Command-Line-Usage.html). Під час обробки моделі не завантажуються. Створення/завантаження інсталяційного файлу може вимагати підключення до мережі; у кожному контейнері розпізнавання мережеві функції вимкнені. Встановіть образ перед увімкненням; під час виконання використовується `--pull=never`. ## Обмеження та відновлення Контейнер працює як користувач без привілеїв із доступом до кореневого каталогу лише для читання, обмеженими можливостями, `no-new-privileges` , одним процесором, 2 ГіБ пам’яті, обмеженням PID та обмеженою тимчасовою файловою системою. Монтуються лише перевірена копія вибраного файлу та опціональний каталог моделі. База даних, сховище та сесія колектора не монтуються. Ці обмеження забезпечуються [прапорами середовища виконання Docker](https://docs.docker.com/reference/cli/docker/container/run/) ; це залишається межею контейнера, а не апаратним анклавом. Розмір файлів обмежено до 50 МіБ, зображень — до 20 мільйонів пікселів, аудіозаписів — до 30 хвилин із відомою тривалістю, а час обробки — до п’яти хвилин. Одночасно працює лише один робочий процес, з максимум 20 завданнями в черзі/у виконанні та 100 збереженими завданнями на робочу область. Команда «Cancel» зупиняє контейнер; «Retry» створює нове завдання, пов’язане з попередньою спробою. Перервані завдання позначаються після перезапуску. Обробка може завершитися невдачею, якщо модель не відповідає налаштованим обмеженням; без ізоляції вона не працює в тихому режимі. --- # Telegram · Вихідні веб-хуки Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/webhooks/ Надсилайте визначені події на HTTPS-приймачі з HMAC-підписами, повторними спробами та статусом доставки. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Надсилайте визначені події на HTTPS-приймачі з HMAC-підписами, повторними спробами та статусом доставки. [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/cli/) ![Інтеграції з архівами](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [Посібник з організації робочого процесу](https://phishdestroy.io/tgwitness/docs/archive/) · [Вікі](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) У вибраному робочому просторі відкрийте **Більше інструментів → Інтеграції → Вихідні веб-хуки**. Додайте HTTPS- приймач, виберіть події колектор/медіа/експорт та, за бажанням, виберіть чати для нових спостережень та змін. Текст повідомлень за замовчуванням вимкнено. Увімкнення уривків додає не більше 1,000 символів до подій зміни повідомлень; необроблені поля Telegram та облікові дані ніколи не надсилаються. Один раз скопіюйте секретний ключ HMAC у захищену конфігурацію приймача. Він зашифрований у сховищі TgWitness і не може бути отриманий через панель управління. Видаліть та створіть пункт призначення заново, щоб змінити його. **Надішліть**у**синтетичні тестові** черги тестове повідомлення без вмісту чату; оновіть статус доставки, щоб побачити результат. Доставка розширює існуючий цикл сповіщень разом із Apprise. Вона використовує зовнішній маршрут робочого простору та існуючі обмеження щодо приватних адресатів. Прямого резервного варіанту чи подальшого перенаправлення немає. URL-адреси не повинні містити облікові дані, рядки запиту чи фрагменти; приватні адреси вимагають мережевого підключення на рівні сервера, а не налаштування, яке користувач панелі може обійти. ## Корисне навантаження та підпис Схема: [`tgwitness.webhook/1`](https://github.com/phishdestroy/TgWitness/blob/main/integrations/webhook.schema.json). Кожен корисний вантаж містить `event_id`, `timestamp`, `workspace`, `type`, `synthetic` та лічильники. Події, що фіксуються в журналі, містять їхню послідовність та хеш. Завершення повного експорту та синтетичні тести є подіями доставки, без вигаданих посилань на підписаний журнал. Повідомлення про видалення в Telegram та `missing_on_recheck` залишаються окремими типами. Заголовок `X-TgWitness-Signature` — це `t=UNIX_SECONDS,v1=HEX_HMAC_SHA256`. Обчисліть HMAC для точних байтів `timestamp + "." + raw_request_body`, використовуючи відображений секрет у вигляді байтів UTF-8. Порівнюйте підписи за постійний час перед розбором або обробкою тіла повідомлення. Відхиляйте мітки часу, які відрізняються від вашого годинника більше ніж на п’ять хвилин. Мітка часу оновлюється при кожній спробі доставки. Використовуйте `event_id` як ключ ідемпотентності у стійкому сховищі з атомарним унікальним обмеженням перед побічними ефектами. Сама по собі дійсна підпис не запобігає повторному відтворенню нещодавнього запиту. Зберігайте оброблені ідентифікатори принаймні протягом усього вікна повторних спроб; зберігайте їх довше, якщо одержувач може повторно обробити збережені події. ## Повторні спроби Доставки ставляться в чергу з гарантією збереження перед HTTP-запитами. Вони використовують семантику принаймні один раз : втрачене підтвердження або перезапуск можуть призвести до повторної доставки події з тим самим ID. Передбачено вісім спроб з експоненційним відстроченням, починаючи з 15 секунд і закінчуючи однією годиною. Для успіху необхідна відповідь з кодом 2xx. Завдання, яке вичерпало свої спроби, залишається видимим разом із помилкою для перегляду. Черга вміщує 1 000 відправлень. Коли вона заповнена, сканування подій журналу призупиняється і відновлюється після звільнення місця. Завершення повного експорту, яке не можна поставити в чергу, спричиняє появу видимої помилки черги. За один прохід обробки повідомлень здійснюється до п’яти спроб доставки, а останні 100 записів про спроби зберігаються. Видалення адресата також призводить до видалення його очікуючих на доставку повідомлень. ## Приклад n8n Імпортуйте [приклад робочого процесу](https://github.com/phishdestroy/TgWitness/blob/main/integrations/n8n-tgwitness.json). Він неактивний і не містить жодних секретних даних чи подальших дій. Встановіть `TGWITNESS_WEBHOOK_SECRET` у середовищі n8n worker, надайте цьому середовищу доступ та дозвольте використання вбудованої функції `crypto` для вузла Code. У прикладі використовується опція raw-body вузла Webhook, перевіряються підпис та актуальність, а також підтверджуються перевірені події. Це відповідає [документованій реалізації](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/nodes/Webhook/Webhook.node.ts) вузла. Перед додаванням записів або сповіщень до SIEM додайте стійке сховище з ідемпотентністю, індексоване за допомогою `event_id`. Обмежте редагування робочих процесів n8n та зберігання журналу виконання відповідно до даних, які ви вирішили надіслати. TgWitness не додає вхідних команд. --- # Telegram · Публічна вітрина Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/showcase/ Публікуйте збережені повідомлення з обраних публічних каналів та підписані знімки за допомогою посилань з обмеженим терміном дії, які можна скасувати. [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) **Більше інструментів → Доступ → Публічна вітрина** створює окрему сторінку, доступну лише для читання, використовуючи існуючу систему access-token. Вона зчитує збережені спостереження інсталяції. Вона не запускає колектор, не входить у Telegram і не отримує канал для відвідувача. ## Опублікувати сторінку 1. Збережіть профіль джерела для кожного публічного каналу, який ви хочете показати. Канал повинен мати публічне ім’я користувача в своєму останньому збереженому профілі; групи та приватні чати не підходять. 2. Відкрийте **Більше інструментів → Доступ → Публічна вітрина** (або `/showcase-manage.html`) як адміністратор. 3. Виберіть канали з максимум 16 робочих просторів, введіть назву публічної сторінки та виберіть термін дії посилання: 1, 7 або 30 днів. Внутрішні назви робочих просторів не публікуються. Можна додати до 64 каналів. 4. Перегляньте текст вибраних каналів для публікації, а потім натисніть **«Перегляд вибраних записів**». У попередньому перегляді використовується та сама серверна проекція, що й на сторінці відвідувача. 5. Натисніть **«Створити посилання на вітрину**». Скопіюйте посилання, поки воно відображається. Відкрийте його в окремому браузері, щоб переглянути сторінку одержувача перед її поширенням. Посилання містить токен доступу у фрагменті URL-адреси. Сторінка видаляє цей фрагмент перед надсиланням запитів до API та замінює його сесією браузера. Будь-хто, хто має це посилання, може відкрити вибраний матеріал до закінчення терміну дії або скасування доступу. Нові посилання дозволяють 100 одночасних сесій, кожна з яких триває не більше однієї години. Існуючі засоби контролю доступу також можуть застосовувати обмеження за адресами та ліміти входу через API grant. Звичайний доступ рецензента — це інший режим, який, як і раніше, включає оригінальні дозволені повідомлення та файли. ## Що бачать відвідувачі | Видимі | Залишається приватним | | --- | --- | | Вибрані назви публічних каналів, імена користувачів та дати перегляду профілів | Ідентифікатори облікових записів, внутрішні мітки робочих просторів та невибрані джерела | | Записаний текст та кожна збережена редакція | Структуровані ідентифікатори відправників, імена, імена користувачів, номери телефонів та значення профілів | | Спостереження щодо видалення разом із раніше збереженим текстом, якщо такий є | Вкладення, аватари, мініатюри, імена файлів та вихідні дані | | Позначки, що вказують на те, що автор/профіль або вкладення було зафіксовано | Метадані пересилань та відповідей, мережеві маршрути, IP-адреси та облікові дані | | Кількість подій у вибраних каналах, поточні перемикачі колекцій, інтервал перевірки працездатності та інтервал контрольних точок | Елементи керування колекціями та стандартні API для експорту доказів | | Підписний відбиток, контрольна точка журналу та доказ узгодженості | Ключі підпису та сесії Telegram | **Текст публічних повідомлень не анонімізується автоматично.** Ім’я, згадка, номер телефону або посилання, вказані в повідомленні, залишаються частиною цього тексту. `Redacted`Це стосується структурованих полів автора/профілю. Перегляньте фактичний вибраний вміст перед публікацією, включаючи збережені редагування та видалення. Відповідність критеріям відображає **останній збережений профіль джерела**, а не поточний запит у Telegram. Якщо наступний профіль більше не містить імені користувача публічного каналу, нові запити виключають цей канал. Оновлюйте профілі джерел, коли змінюється публічна видимість. Читачі можуть вже мати збережені матеріали, які вони отримували раніше. Оригінальні підписані записи залишаються незмінними. Відображувана проекція підписується окремо та містить хеші, що посилаються на її оригінальні записи. Підпис проекції підтверджує автентичність відображуваного твердження, а оригінальні записи, на які є посилання, зберігають власні підписи. ## Перевірка підписів та цілісності Розгорніть **«Fingerprint & signed checkpoint»** та завантажте знімок. Після оновлення сторінки завантаження включає попередній знімок браузера та доказ узгодженості за алгоритмом Меркла між межами їхніх журналів. Автоматичне оновлення відбувається раз на хвилину, поки сторінка відображається та показує першу сторінку спостережень. Після встановлення TgWitness перевірте завантажений файл в автономному режимі: ``` python -m tgwitness.showcase_verify showcase.json --fingerprint TRUSTED_COLLECTOR_SHA256 ``` Відбиток повинен походити з окремого надійного джерела. Щоб порівняти з знімком, який ви зберегли самостійно, використовуйте `--previous earlier.json`; це замінить попередній знімок, що міститься у завантаженому файлі. Поточний доказ повинен починатися з цієї збереженої межі. Авторизовані клієнти можуть запросити цей доказ за допомогою `GET /api/showcase/{workspace_id}?challenge=<32-hex-random>&from_count=`. Коротший журнал повертає код статусу HTTP 409 замість того, щоб мовчки скинути межу. Підписана контрольна точка фіксується у **всьому журналі колектора**, включаючи його кількість записів та непрозорий хеш заголовка. Відображувана кількість повідомлень стосується лише вибраних публічних каналів. На сторінці ніколи не відображається вміст інших журналів. Це кількість подій, а не кількість унікальних повідомлень. Налаштування описують поточну конфігурацію, а не кожен попередній інтервал запису. Перевірка підпису та узгодженості дозволяє виявляти зміни відносно збереженої межі. Перерахуйте зареєстровані події з відповідного архіву та перегляньте інтервали збору даних і збережені контрольні точки свідка разом. Використовуйте [верифікатор доказів](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md), [незалежного свідка](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/) та [запис у масштабі тестування](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/). Синтетичні інсталяції помітно позначені як синтетичні. ## Скасувати або розмістити сторінку Скористайтеся **функцією «Скасувати»** у менеджері вітрин або в існуючому розділі **«Доступ»**, щоб закрити посилання та завершити всі сесії за ним. Відвідувач очищає відображені записи, коли запит виявляє, що доступ завершився. Термін дії та дозволи перевіряються під час кожного запиту. Дозволи на вітрини не можна перетворити на звичайний доступ до панелі на місці; створіть новий дозвіл, щоб змінити режим. Сторінка надається через існуючу HTTPS-адресу інсталяції. Публікація посилання не відкриває новий порт, не створює тунель і не змінює DNS. HTML та API залишаються на інсталяції користувача. Відвідувач демонстраційної версії не може використовувати звичайні API для повідомлень, профілів, медіа, експорту чи управління з таким доступом. --- # Telegram · Як працює система збереження доказів Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/how-it-works/ Пояснення щодо хеш-ланцюга, підписів, контрольних точок та свідків із зазначенням точних формул, які використовує верифікатор. [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/evidence/) ![Докази та верифікація](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness зберігає те, що спостерігав обліковий запис-збирач, пов’язує ці спостереження у підписаний журнал і дозволяє іншій особі перевірити експорт за допомогою надійного ключа, зовнішнього часу від третьої сторони та раніше збереженої контрольної точки. На [локальному веб-сайті документації](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally) додано інтерактивні приклади за адресою `/docs/concepts/`, інструмент для аналізу рішень на контрольних точках за адресою `/docs/witness/`, а також покрокові інструкції щодо [Case Board](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/), [оформлення звітів](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/) та [витягів із передачі матеріалів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#handover-extract). Усі приклади повідомлень, кількість та затримки є вигаданими. Хеші в пісочниці ланцюга обчислюються за допомогою алгоритму SHA-256 у браузері. Ніщо не надсилається до Telegram. **На цій сторінці** - [Зміни в повідомленні; накопичення спостережень](https://phishdestroy.io/tgwitness/uk/docs/reference/how-it-works/#a-message-changes-observations-accumulate) - [Що охоплює хеш](https://phishdestroy.io/tgwitness/uk/docs/reference/how-it-works/#what-a-hash-covers) - [Що додає попередній контрольний пункт](https://phishdestroy.io/tgwitness/uk/docs/reference/how-it-works/#what-an-earlier-checkpoint-adds) - [До чого належить свідок](https://phishdestroy.io/tgwitness/uk/docs/reference/how-it-works/#where-a-witness-belongs) - [Перевірка доставки щодо відомих дій](https://phishdestroy.io/tgwitness/uk/docs/reference/how-it-works/#test-delivery-against-known-actions) - [Оберіть робочий процес](https://phishdestroy.io/tgwitness/uk/docs/reference/how-it-works/#pick-a-workflow) ## Повідомлення змінюється; спостереження накопичуються Діаграма послідовності · Telegram → Колектор: Нове повідомлення: Зустріч о 10:00; Колектор → Підписаний журнал: Додати повідомлення.new; Telegram → Колектор: Редагування: Зустріч о 11:00; Колектор → Підписаний журнал: Додати повідомлення.edited; Telegram → Колектор: Повідомлення про видалення; Колектор → Підписаний журнал: Додати повідомлення.deleted; Примітка щодо Підписаний журнал: Зберігаються спостереження за оригінальними повідомленнями, редагуваннями та видаленнями · Telegram · Колектор · Підписаний журнал · Нове повідомлення: Зустріч о 10:00 · Додати повідомлення.new · Редагування: Зустріч о 11:00 · Додати повідомлення.edited · Повідомлення про видалення · Додати повідомлення.deleted · Зберігаються спостереження за оригінальнимиповідомленнями, редагуваннями та видаленнями **Діаграма у вигляді тексту** 1. Telegram → Колектор: Нове повідомлення: Зустріч о 10:00 2. Колектор → Підписаний журнал: Додати повідомлення.new 3. Telegram → Колектор: Редагування: Зустріч о 11:00 4. Колектор → Підписаний журнал: Додати повідомлення.edited 5. Telegram → Колектор: Повідомлення про видалення 6. Колектор → Підписаний журнал: Додати повідомлення.deleted 7. Примітка щодо Підписаний журнал: Зберігаються спостереження за оригінальними повідомленнями, редагуваннями та видаленнями Ця спрощена послідовність передбачає, що Telegram доставив кожне оновлення і що вибраний акаунт міг його побачити. Операційні події також заносяться до журналу. Повідомлення про видалення не вказує особу, яка здійснила видалення, або точний час видалення. Повторні доставки є окремими спостереженнями; у журналі не відбувається придушення дублікатів. ## Що охоплює хеш ![Спостереження, кодування, хешування та підписання: кожна нова подія містить хеш попередньої події.](https://phishdestroy.io/tgwitness/assets/evidence-chain-animated.svg?v=368c25a3be9c) Прочитайте формулу зсередини назовні: **C** перетворює дев’ять полів на точні байти; **SHA-256** генерує їхній дайджест; **hex** — це спосіб зберігання цього дайджесту. Попередній хеш уже міститься всередині події. **unhex** перетворює збережений хеш назад на 32 байти, які підписує Ed25519. [Схема статичного ланцюга](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-chain-static.svg) Нехай C(ei) — це канонічний JSON у форматі UTF-8, що містить дев’ять полів події. Перший запис `previous_hash` складається з 64 нулів. Кожен наступний запис містить шістнадцятковий хеш попереднього запису: hi = hex(SHA256(C(ei))) σi = Ed25519.Sign(sk,unhex(hi)) Підпис охоплює 32 байти необробленого дайджесту. Вхідні дані хешу містять саме `seq`, `observed_at`, `source_at`, `kind`, `chat_id`, `message_id`, `actor_id`, `payload` та `previous_hash`. Ключі об’єктів відсортовані; пробіли та ASCII- ескейп-символи опущені; значення NaN та нескінченність відхиляються. Дивіться [точне кодування](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#event-canonicalization). Блок-схема · 64 нульових символів → Запис 1 / хеш h1; Запис 1 / хеш h1 → Запис 2 містить h1 / хеш h2; Запис 2 містить h1 / хеш h2 → Запис 3 містить h2 / хеш h3; Запис 3 містить h2 / хеш h3 → Підписаний контрольний пункт: count 3, head h3 (зберігати в іншому місці) · 64 нульових символів · Запис 1 / хеш h1 · Запис 2 містить h1 /хеш h2 · Запис 3 містить h2 /хеш h3 · Підписаний контрольнийпункт: count 3, headh3 · зберігати в іншому місці **Діаграма у вигляді тексту** 1. 64 нульових символів → Запис 1 / хеш h1 2. Запис 1 / хеш h1 → Запис 2 містить h1 / хеш h2 3. Запис 2 містить h1 / хеш h2 → Запис 3 містить h2 / хеш h3 4. Запис 3 містить h2 / хеш h3 → Підписаний контрольний пункт: count 3, head h3 (зберігати в іншому місці) | Змінити на наданий журнал | Що це виявляє | | --- | --- | | Змінити запис 2, залишивши його збережений хеш | Перерахований хеш події відрізняється; його підпис більше не охоплює змінену подію | | Відтворити змінений запис та всі наступні хеші | Оригінальні підписи не пройшли перевірку; збережений контрольний пункт на відповідній межі також не збігається | | Видалити кінцеву частину, але залишити префікс без змін | Раніше збережена контрольна точка, що виходить за межі вказаного префікса, вказує на те, що експортний файл занадто короткий | | Повторне підписання замінювального журналу іншим ключем | Окремий відбиток ключа, що викликає довіру, відхиляє заміну ідентифікатора | ![Зміна збереженого поля змінює його дайджест; відновлення хеш-сум не відновлює оригінальні підписи.](https://phishdestroy.io/tgwitness/assets/evidence-tamper-animated.svg?v=5ca92399bea5) **Спробуйте застосувати цю логіку до запису № 2:** змініть `Meet at 11:00` на `Meet at 12:00` у збереженому події. Його перерахований хеш більше не збігається. Перерахунок пізнішого ланцюжка може відновити його ланки, але не може змусити оригінальні підписи покривати нові дайджести. Натомість виявлене редагування в Telegram стає новим записом у журналі. [Схема статичних змін](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-tamper-static.svg) Самі по собі хеш-посилання не заважають комусь перерахувати ланцюжок заміни. Довіра ґрунтується на перевірці підписів за допомогою незалежно перевіреного ключа, зовнішнього часу від третьої сторони, що фіксує початок журналу, та посилань, що зберігаються поза межами колектора. ## Що додає попередній контрольний пункт ![Зберегти лічильник 3 та заголовок h3; пізніший експорт із 4 записами перевіряється у позиції 3.](https://phishdestroy.io/tgwitness/assets/evidence-checkpoint-animated.svg?v=e68f4e7be4b9) **Посилання залишається незмінним, тоді як журнал поповнюється.** Якщо контрольна точка вказує: «3 записи, заголовок h3», експорт із чотирма записами може пройти, оскільки h3 збігається на позиції 3. Його найновіший заголовок — h4, який, як очікується, має відрізнятися. Експорт із лише двома записами не пройде. [Схема статичних контрольних точок](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-checkpoint-static.svg) Після перевірки підпису контрольної точки необхідно: Nexport ≥ Ncheckpoint and hexport[Ncheckpoint] = Hcheckpoint Експорт може виходити за межі контрольної точки. Він повинен збігатися на збереженій межі. Ключ колектора підписує контрольну точку, тому колектор може підписати й іншу. Він пов’язує записи лише в тому випадку, якщо одержувач отримав їх до архівування через інший канал; для мінімального доказу також потрібен зовнішній час від третьої сторони. Справжній верифікатор також перевіряє послідовність кожної події, попереднє посилання, хеш та підпис. Порівнюючи лише кінцеву збережену головку, можна пропустити змінений внутрішній запис, збережений хеш якого не було оновлено. ## Де знаходиться свідок Блок-схема · Колектор / сесія облікового запису / ключ A → Кінцева точка контрольної точки, доступна лише для читання; Witness / закріплений ключ-збирач / власний ключ B → Окремий підписаний журнал свідчень; Witness / закріплений ключ-збирач / власний ключ B → Кінцева точка контрольної точки, доступна лише для читання (Замовити перевірку); Кінцева точка контрольної точки, доступна лише для читання → Witness / закріплений ключ-збирач / власний ключ B (Підписана відповідь); Witness / закріплений ключ-збирач / власний ключ B → Канал із підписаними публікаціями TGW1 (API бота / власний токен) · Хост A · Хост B · Колектор / сесіяоблікового запису / ключ A · Кінцева точка контрольноїточки, доступна лише длячитання · Witness / закріпленийключ-збирач / власний ключB · Окремий підписаний журналсвідчень · Канал із підписанимипублікаціями TGW1 · Замовити перевірку · Підписана відповідь · API бота / власний токен **Діаграма у вигляді тексту** 1. Колектор / сесія облікового запису / ключ A → Кінцева точка контрольної точки, доступна лише для читання 2. Witness / закріплений ключ-збирач / власний ключ B → Окремий підписаний журнал свідчень 3. Witness / закріплений ключ-збирач / власний ключ B → Кінцева точка контрольної точки, доступна лише для читання (Замовити перевірку) 4. Кінцева точка контрольної точки, доступна лише для читання → Witness / закріплений ключ-збирач / власний ключ B (Підписана відповідь) 5. Witness / закріплений ключ-збирач / власний ключ B → Канал із підписаними публікаціями TGW1 (API бота / власний токен) Свідок фіксує відкат, іншу голову журналу за того самого лічильника, змінені ключі, неправильні відповіді та відсутні відгуки. Щоб підтвердити, що всі попередні записи не змінилися, порівняйте експорт зі збереженими контрольними точками. Свідок на іншому хості не поділяє збій хоста колектора; окремий оператор дає додаткову незалежність. Верифікатор перевіряє, що ключ свідка відрізняється від ключа колектора; запис зберігача про контроль над ключем показує, у кого він перебуває. Telegram датує кожен допис у публічному каналі, а `verify.py --channel https://t.me/s/…` зчитує ці дати як зовнішній час. Свідок підтверджує стан журналу, про який повідомив колектор. Використовуйте контрольований тест доставки, щоб визначити, які дії Telegram надійшли на обліковий запис колектора. Див. [налаштування свідка](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/). ## Перевірка доставки на основі відомих дій Використовуйте контрольну групу, окремі облікові записи для збору даних та новий маркер. Надсилайте, редагуйте та видаляйте повідомлення навмисно, перевіряючи збереження даних між етапами. Визначте очікувані дії та межу, перш ніж перевіряти результати. R = |observed∩expected| / |expected| Δ t = treceipt - taction Враховуються лише очікувані дії; дублікати квитанцій не збільшують чисельник. Знаменник повинен бути відмінним від нуля. Відсутня квитанція не має виміряної затримки. Вкажіть похибку часу; використовуйте власний контрольований час дії видалення, оскільки Telegram не надає точного часу видалення. Результат, наприклад, 5/6 (83,3 %), описує тестові дії, а не повноту всього трафіку Telegram. ## Оберіть робочий процес [Повний покроковий опис розслідування,](https://phishdestroy.io/tgwitness/uk/docs/reference/investigation/) що відбувається після інциденту у каналі, групі, боті та приватному чаті: 1. На спеціальному обліковому записі для збору даних увімкніть режим розслідування для всього облікового запису та складіть перелік доступних чатів. Для основного облікового запису використовуйте вибрані чати або папку. 2. Отримуйте знімки журналу, повну історію кожного чату та збережені вкладення. 3. Зберігайте зміни в режимі реального часу та будь-які навмисні взаємодії з панелями разом із відповідними підтвердженнями. 4. Відстежуйте числові ідентифікатори відправників, зв’язки у відповідях, повторювані адресати та хеш-коди файлів через цитовані записи та профілі користувачів. 5. Додавайте примітки та колекції з посиланнями на джерела в Case Board. Відтворіть хронологію переписки між чатами з позначенням часу та явними пропусками. 6. Порівнюйте робочі простори інших облікових записів, зберігаючи їхнє походження та ключі окремо. 7. Збирайте та перевіряйте підписані журнали, профілі та експортовані дані історії разом із примітками до справ. Посібник на веб-сайті `/docs/cases/` містить інтерактивну карту справи та варіанти розв’язання суперечок щодо ботів, видалених повідомлень та учасників, які змінюють імена. Case Board зберігає нотатки та колекції в межах робочого простору. Груповий експорт збирає окремі пакети робочих просторів; кореляція між робочими просторами та об’єднана часова шкала залишаються завданням аналітиків. [Завершена валідація та робота, що залишилася](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/) · [Експорт та перевірка](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#investigation-handoff) · [Почніть з одного облікового запису](https://phishdestroy.io/tgwitness/uk/docs/reference/quickstart/) --- # Telegram · Налаштування та перевірка звітів Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/ Фільтри звітів, вісім макетів, пресети змісту, збережені історії змін та оцінка, що містяться у підписаних експортованих файлах. [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/investigation/) ![Розслідування](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Перетворіть вибрані спостереження на зрозумілий звіт про справу: її суть, обсяг, збережені зміни, діаграми, висновки та посилання на джерела. Кожен звіт надає отримувачу можливість перевірити наданий матеріал та оцінити повноту збору даних. Розділ **«Основа довіри»** з’являється у звітах журналу, передачі, чату, облікового запису та спільного доступу. PDF-файли журналу та передачі використовують ту саму оцінку, що й їхній підписаний файл `report.json`. ZIP-маніфести містять `case_assessment` у підписаному маніфесті. Ця оцінка передається разом з експортованим матеріалом. Оригінальні спостереження зберігають свої наявні підписи. ## Формати документів та порядок читання ### Студія звітів Відкрийте **«Експорт» → «Налаштування» та перегляньте попередній варіант**. Пройдіть по меню **«Дані» → «Дизайн та вміст» → «Попередній перегляд**»: 1. Використовуйте весь робочий простір або виберіть чати, авторів, включаючи дати спостереження за UTC та типи подій. Завантажте каталог для пошуку чатів та авторів або введіть їхні Telegram-ідентифікатори. Фільтри авторів відповідають записаним ідентифікаторам відправників; повідомлення про видалення без відправника не відповідає фільтру авторів. 2. Оберіть макет сторінки, а потім виберіть діаграми, мітки учасників, стенограму та ваші письмові висновки. Зміна макета не впливає на ці налаштування. 3. Створіть попередній перегляд. У ньому відображаються фактичні показники, активність, учасники, зразки записів, збережені зміни та діапазони номерів повідомлень, яких бракує. Зміна вибору робить попередній перегляд застарілим. Збережіть перед завантаженням HTML, підписаного PDF, підписаного JSON або ZIP-файлу з доказами. У попередньому перегляді даних враховується повний стабільний префікс журналу, а не початкова вибірка. Обмежуються лише відображені зразкові рядки та довгі списки; кількість пропущених елементів показано. Під час подальшого експорту створюється новий стабільний знімок, тому тривале збирання даних може збільшити ці показники. Обсяг, кількість та ідентифікація джерел включені до підписаного звіту. Відкриття або попередній перегляд форми не призводить до її збереження. **Рекомендації щодо юрисдикції.** У розділі Деталі документа відкрийте **Рекомендації щодо юрисдикції · опціонально** , щоб вибрати юрисдикцію та цивільну/комерційну або кримінальну процедуру. У додатку наведено правові підстави, посилання на джерела, примітки щодо підготовки та стан досліджень. Підсумки та пояснення щодо заходів безпеки збору даних місцевою мовою є необов’язковими. За замовчуванням жодна юрисдикція не обрана. Ці параметри належать до робочого простору та не враховуються у збережених конфігураціях макета та неявних налаштуваннях за замовчуванням щодо спільного доступу та копіювання. Див. [налаштування за замовчуванням, підтримувані звіти та обмеження дослідження](https://github.com/phishdestroy/TgWitness/blob/main/docs/JURISDICTION_GUIDANCE.md) . **Виберіть копію для одержувача.** Діаграми та стенограма використовують вибрані записи. Цілісність, зберігання та охоплення описують повний журнал джерел. Архів ZIP із доказами містить оригінальні записи та вкладення. Використовуйте [мінімізовану передачу,](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#handover-extract) коли одержувач має отримати лише вибрані, дозволені дані. ### Перегляньте редагування, видалення та відсутні ідентифікатори Редагування показує збережений текст **«До»** та **«Після»** і виділяє змінені слова. Видалення показує останню версію, збережену перед повідомленням. Якщо раніше вміст не було збережено, у звіті про це зазначається. Коли ви вибираєте лише редагування або видалення, попередні версії залишаються доступними як чітко позначений контекст поза фільтрами. Повідомлення, що не мають відношення до справи, не додаються до цих історій. **Неспостережувані ідентифікатори повідомлень** — це прогалини між відомими номерами у вибраних чатах та діапазоном ідентифікаторів, отриманих на основі дати. Кожен відомий запис джерела перевіряється перед тим, як оголосити номер неспостережуваним: відфільтрування іншого автора, типу події чи дати не може створити помилкову прогалину. Сусідні збережені повідомлення позначаються як контекст. Відсутній номер позначає неспостережувану позицію; повідомлення про видалення та невдалі повторні перевірки реєструються як окремі типи подій. ### Оберіть дизайн Для HTML-звітів за журналом і окремим чатом та для підписаних PDF-звітів доступно дев’ять макетів сторінок. Вони використовують ті самі записи й розрахунки, але відрізняються обкладинками, типографікою, заголовками розділів, таблицями та інтервалами. | Дизайн | Стиль викладу | | --- | --- | | Класичний | Традиційне досьє з темною обкладинкою та пронумерованими розділами. | | Редакційні вимоги | Титульна сторінка у рамці з серіфним шрифтом, широкі поля та вузька колонка розділів. | | Інструктаж | Компактна обкладинка з темно-синім корінцем, короткими заголовками та щільно розміщеними таблицями. | | Аналітика | Обкладинка у стилі опитування, модульні таблиці та рисунки з моноширинним шрифтом. | | Технічна | Регістр із лініями, пронумерована довідкова шкала та точні таблиці порівняння. | | Огляд | Панорамна обкладинка, просторий міжрядковий інтервал та виразні ілюстрації з підсумковими даними. | | Серія статей | Навігаційна панель розділів та згруповані розділи для висновків, обсягу робіт, змін та журналу спостережень. | | Реєстр та маржа | Пронумеровані розділи з широкими полями, точні таблиці та окремий стенограма повідомлень. | | Огляд профілю | Ключові показники, історія профілів, пошук за розділами та перехід до записів чату. | Дизайн зберігається для кожного робочого простору та фіксується у підписаному маніфесті експорту. HTML працює в автономному режимі, підтримує світлу та темну теми, а також адаптується до вузьких екранів та мов, що пишуться справа наліво. Вбудовані PDF-файли використовують вбудовані шрифти; дизайн «Editorial» включає шрифт Noto Serif на умовах вбудованої ліцензії SIL Open Font License. Серії читання, а також «Ledger» і поля також застосовуються до оглядів облікових записів, чатів облікових записів та копій для спільного доступу. Для PDF-файлів китайською, японською та корейською мовами додатково потрібен відповідний шрифт на сервері, наприклад Noto Sans CJK, встановлений у всій системі або розміщений у папці `TGWITNESS_FONT_DIR`. Якщо такий шрифт недоступний, у ZIP-архіві зберігаються звіти у форматах HTML та JSON. Ці два макети передбачають зручний для читання журнал без використання JavaScript. Для великих експортних файлів цей вигляд містить до 500 повних записів у межах ліміту в 8 Мбайт; у звіті вказано цей ліміт та наведено посилання на повний переглядач і вихідні записи. Каталог облікових записів та індекс взаємозв’язків описують саме цей зразок для читання, а не всіх учасників. Діаграми повного журналу зберігають свій окремо зазначений обсяг. ### Виберіть вміст | Зміст (заздалегідь визначений) | Включено за замовчуванням | | --- | --- | | Досьє по справі (рекомендовано) | Активність, час спостереження, учасники, чати та стенограма запису. | | Інструктаж | Огляд активності без рейтингу учасників та стенограми. | | Огляд діяльності | Активність, час спостереження, учасники, чати та їхній склад із посиланнями на джерела та точними цифрами. | | Індивідуальний звіт | Ваша власна комбінація діаграм, стенограм та попередніх переглядів. | Зміна попереднього налаштування зберігає ваш макет, деталі справи та письмовий аналіз. Перевірки цілісності, покриття, пояснення до читання та інструкції з верифікації залишаються в кожному макеті. Вихідні записи у файлі ZIP залишаються незмінними, коли діаграма або стенограма приховані. Опціональні **«Примітки щодо експертизи**» містять питання, метод, результати та висновок, написані автором звіту. У результатах слід вказувати номер файлу-джерела та номер запису. Підпис зберігає ці авторські заяви разом із звітом; спостереження з джерел та інтерпретація автора залишаються ідентифікованими. У скорочених передачах ці приватні нотатки та повні журнали оглядів не включаються. Вибір діаграм та методів обстеження застосовується до журнальних звітів. Виберіть активність за певний період, теплову карту днів тижня та годин за UTC, рейтинги учасників, рейтинги чатів та склад записів. Оберіть 5–30 груп за рейтингом та нейтральні псевдоніми учасників або ідентифікатори облікових записів. Невідомі відправники та решта учасників відображаються в окремих рядках. Псевдоніми впливають лише на діаграми; вихідні записи все ще містять їхні справжні ідентифікаційні дані. Попередній перегляд дизайну оновлюється на основі незбереженого чернетки з використанням обкладинки, компонентів експертизи та діаграм, обмежених результатами, що відповідають першим 50 000 записів джерела. Попередній перегляд даних нижче розраховує повний набір даних. Він явно не підписаний і не зберігає редагування. Кнопки «Обкладинка» та «Діаграми» перемикають його розділи. Це не є повним попереднім переглядом PDF. **Функція «Зберегти налаштування звіту»** застосовує вибрані параметри до майбутніх експортів; існуючі підписані файли є незмінними. У PDF використовуються обрана обкладинка, типографіка, макет розділів та ті самі вибрані агрегати, що й у HTML та підписаному JSON. Оцінка довіри, охоплення та інструкції з верифікації залишаються на місці. Приховування діаграм або читабельної транскрипції не видаляє авторитетні рядки джерел з архіву ZIP. Вимкнені серії діаграм не потрапляють до аналітичного JSON; щоб обмежити розкриття записів джерел, використовуйте мінімізований експорт. Фільтри вибору даних застосовуються до звітів за журналом; експорт облікового запису та копії для передачі зберігають власний обсяг збору й розкриття. До вибірки можна включити цілі чати, авторів, дати UTC, типи записів і окремі повідомлення. Повідомлення, позначені в чаті кнопкою **Вибрати**, потрапляють до **Вибрані повідомлення**; звіт охоплює записи цих повідомлень і всіх чатів, вибраних повністю, а номери вибраних повідомлень перелічує в розділі **Вибрані дані**. Відсутні номери повідомлень і сусідні з ними записи показуються лише для чатів, вибраних повністю. **Додати номери повідомлень** під списком чатів додає повідомлення, не відкриваючи чат: по рядку на чат — ID чату, двокрапка й номери повідомлень — або посилання `t.me/c/…` на окремі повідомлення. Загальні налаштування дизайну та діаграм зберігаються у нових експортованих файлах чатів та облікових записів, а також у попередньому перегляді спільного доступу. Мова облікового запису та налаштування конфіденційності залишаються незалежними; приватні нотатки щодо справ та розслідувань не копіюються в ці експортовані файли. Звіти щодо облікових записів та спільного доступу залишаються у форматі HTML, захищеним підписаним маніфестом архіву. Журнал, зведена передача журналу та набори для одного чату також надають підписані PDF-файли. ### Що відображають діаграми Активність журналу та теплові карти враховують нові, історичні, відновлені, відредаговані, видалені та відсутні при повторній перевірці **спостереження** за часом спостереження колектора в UTC. Сигнали та підтвердження отримання вкладень не враховуються. У рейтингах учасників враховуються лише нові, історичні та відновлені спостереження за повідомленнями: відправник не визнається редактором або особою, яка видалила повідомлення. Повторні спостереження можуть описувати одне й те саме повідомлення Telegram. Аналітика журналу зберігає підрахунки за типами, посилання на перший/останній запис та SHA-256 джерела `events.jsonl`. Цифри містять точні значення в HTML та PDF. Щоденні сегменти переходять на місяці після 366 записаних днів; графіки об’єднують їх у не більше ніж 36 інтервалів однакової ширини. Понад 100 000 унікальних ідентифікаторів або 1 200 місяців роблять відповідний графік недоступним, тоді як точні загальні підрахунки залишаються доступними. Діаграми знімків та спільного використання облікових записів враховують лише рядки повідомлень, що не стосуються послуг, використовуючи час їхнього запису. Сумарні показники спільного використання обчислюються після редагування та фільтрування. Ці діаграми використовують щонайбільше 90 інтервалів дати за UTC однакової ширини та зберігають до 10 000 значень групування; надлишкові показники явно зазначаються та узгоджуються. Останній інтервал може бути коротшим. Невідомі або приблизні дати не враховуються у часових діаграмах. Порожній інтервал означає відсутність спостережень; щодо пропусків див. інформацію про охоплення. Ці діаграми описують збережену активність. Невідомі відправники залишаються окремою категорією, і про кожну перевірку повідомляється окремо. Якщо файл `analytics.json` включено, він захищений підписаними хешами файлів архіву. Журнал `report.json` вбудовує той самий вибраний агрегат. Перевірка підпису виявляє змінені байти. Щоб перевірити цифри, перерахуйте агрегати журналу за допомогою `report_analytics.Analytics` та `selected`, або агрегати знімків за допомогою `snapshot_analytics.collect` та `project`. ### Індикатори аномалій **Попередній перегляд.** Звіти про докази містять розділ **Показники аномалій**, обчислені зареєстрованими процесорами (`tgwitness/metrics/`, один файл на кожен показник). У звіті вказано кожен процесор, що працював, із зазначенням його версії, а також наведено його метод під таблицею, щоб обчислення можна було повторити з `events.jsonl` за допомогою `tgwitness.metrics.run`. | Процесор | Що він показує | | --- | --- | | `first_time_posters_over_time`, версія 1 | Кількість нових користувачів та повідомлень за день за UTC. Для позначення необхідні щонайменше п’ять нових користувачів та втричі більше за їхню медіану, при цьому обсяг повідомлень не повинен перевищувати 1.5-кратну медіану. Базова лінія використовує щонайменше сім днів спостереження протягом попередніх 14 календарних днів після семиденного періоду розігріву. | | `service_vs_message_ratio`, версія 1 | Окремі номери збережених повідомлень для кожного чату та частка, яку займають службові повідомлення. Тут описано систему нумерації; тут не пояснюється відсутність конкретного номера. | | `join_leave_per_month`, версія 1 | Приєднання, виходи та видалення або блокування за місяць, по одному на особу, чат, зміну та день. | | `pinned_per_month`, версія 1 | Закріплені службові повідомлення, скасовані закріплення та закріплені повідомлення, додані або видалені між моментальними знімками стану чату, за місяць. | **Більше інструментів → Параметри → Показники звіту** — вибір процесорів та кількості відображуваних рядків, у тому числі у відфільтрованих звітах. Щоденні та щомісячні таблиці показують останні рядки, таблиці розподілу за службами ранжують чати за кількістю збережених повідомлень. Підсумки охоплюють кожен рядок. З вихідного коду зберіть усі дев’ять перелічених вище макетів на тому самому вигаданому журналі: ``` python tools/build_report_styles.py --output test-results/report-styles ``` Відкрийте отриманий файл `index.html`, щоб порівняти повні HTML-звіти, підписані PDF-файли та архіви ZIP. Кожен макет використовує один і той самий вихідний журнал. Використовуйте новий каталог для результатів кожного запуску, щоб зберегти раніше підписані зразки. ![Вигадане HTML-досьє](https://phishdestroy.io/tgwitness/assets/dossier-en.png?v=62db26820986) HTML-файл відкривається титульною сторінкою справи та ключовими показниками. Пронумерована карта доказів містить посилання на кожен висновок, факти, що його підтверджують, обмеження та незалежну експертизу. Записи з можливістю пошуку та стабільні посилання на записи залишаються доступними в офлайн-переглядачі. Дизайн адаптується до вузьких екранів, різних тем та браузерів без JavaScript. Підписаний PDF-файл має спеціальну обкладинку формату А4, посилання на звіт та QR-код, виконавчий резюме, карту доказів, пронумеровані висновки та закладки документів. Заголовки та нижній колонтитул сторінок ідентифікують звіт. QR-код ідентифікує матеріал; він не є незалежним результатом перевірки. Роздруківки з браузера є окремими від цього криптографічно підписаного PDF-файлу. Хронологія спостережень розміщує зафіксовані періоди спостережень та перерви на одній осі за UTC. Порожній простір не означає, що дані відсутні; детальні таблиці зберігають точні інтервали. Архів ZIP містить звіти у форматі для читання, підписані файли JSON, джерельні записи та інструкції з перевірки. Створіть нове, вигадане досьє англійською/російською/німецькою мовами з встановленим середовищем розробки: ``` python tools/build_dossier_example.py --output test-results/my-new-dossier ``` Кожен мовний каталог містить файли `report.html`, `report.pdf`, `report.json` та `dossier.zip`. Існуючі каталоги зразків ніколи не перезаписуються. Для створення звіту не використовуються ані обліковий запис Telegram, ані зовнішній сервіс маркування часом, ані мережеве з’єднання. ![Перші три сторінки вигаданого підписаного PDF-файлу](https://phishdestroy.io/tgwitness/assets/dossier-pdf.png?v=30a8d283dcc2) ## Ознайомлення з конкретною справою Для журналу з 1,200 записів із перевіреним часовим штампом у записі № 1,000 звіт виявляє 200 пізніших записів, що виходять за межі цього часового штампу. Часовий штамп визначає верхню межу існування контрольної точки; кожне повідомлення зберігає власний час відправлення з Telegram. Якщо три інші файли з часовими штампами не проходять перевірку або не можуть бути перевірені, вони підраховуються окремо і не можуть слугувати підставою для позитивного висновку. Придатний часовий штамп повинен відповідати всім цим критеріям: його відбиток збігається з контрольною точкою, його підпис ланцюговим чином пов’язаний із надійним кореневим сертифікатом TSA на момент проставлення штампа, а підпис, ключ, лічильник та головний запис контрольної точки точно відповідають префіксу журналу. Простого аналізу часової мітки або наявності квитанції OTS недостатньо. Читач повинен самостійно вибрати довірений корінь TSA та повторити перевірку. OTS потребує власної перевірки підтвердження Bitcoin. | Статус звіту | Значення | | --- | --- | | Перевірено під час експорту | Експортер виконав зазначену перевірку; все ж таки необхідне незалежне повторення. | | Записано; потрібно перевірити | Зафіксовано відповідне спостереження або заяву оператора; це не є незалежним підтвердженням. | | Не входить до цього тексту | У тексті немає підтверджуючих доказів щодо цього твердження. У ньому також не зазначено, що таких доказів немає в інших джерелах. | | Не перевірено незалежно | Звіт не містить результатів незалежної перевірки. | | Неповні або недоступні | Матеріал або необхідна перевірка відсутні, неповні або не пройшли успішно. | Перевіряйте кожну позицію окремо, з огляду на зафіксований обсяг зібраних даних. ## Що обов’язково має зберігатися в конфігурації 1. Перш ніж покладатися на збір даних, збережіть відбиток ключа колектора через окремий надійний канал. Порівняйте цей відбиток із ключем підпису експортованих даних. 2. Збережіть контрольні точки з незалежними часовими мітками та, у разі використання, журнал свідків, що знаходиться поза адміністративним контролем колектора. Порівняйте їх із експортованим журналом, щоб перевірити його попередні межі. 3. Вкажіть обсяг збору записів, прогалини, фільтри, обмеження та зміни у процесі збору. Поясніть відсутні періоди, що мають відношення до фактичної претензії, чітко розмежовуючи ідентифікатори повідомлень, які не було зафіксовано, повідомлення про видалення та невдалі повторні перевірки. 4. Збережіть оригінальні ZIP-архіви та їхні хеші. Зафіксуйте кожного власника, передачу, дату та мету. Збережіть разом із ними відповідні заяви операторів та примітки щодо справи. 5. Для конфіденційних віртуальних машин збережіть та незалежно перевірте цитату, запит, ланцюжок сертифікатів Intel, вимірювання, точне джерело та умови поводження з ключами. Зберігайте результат перевірки атестації разом із перевіреними артефактами. Див. розділ «[Обсяг верифікації](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope)» щодо перевірок отримання даних, цілісності архіву, часу та охоплення збору даних у кожному режимі. ## Перевірка одержувачем Використовуйте перевірену версію TgWitness та незалежно отриманий відбиток: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca tsa-root.pem python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/WITNESS_CHANNEL --require-witness python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --check-drand ``` Друга та третя команди можуть відповідати мінімальним вимогам до доказів: перевірена мітка часу або дати, встановлені Telegram у публікаціях свідка, дають зовнішній час останнього запису. ZIP-архів свідка повинен походити з незалежного надійного джерела; збережіть також його ключ та походження. Збережіть команди, версію інструменту, результати, перевірені хеш-суми вхідних даних та невирішені питання. Перевірка маяка — це окрема онлайн-перевірка; програма візуалізації звітів ніколи не звертається до служби лише для того, щоб відобразити звіт. У разі суперечки щодо конкретного повідомлення наведіть посилання на архів, авторитетний файл та посилання на запис, а потім опишіть відповідні часові рамки, прогалини в охопленні, відбір та підтверджуючі матеріали. Щодо копії для обміну, також перегляньте зафіксовані трансформації та їхні посилання на вихідний архів. Приватні фільтри та зіставлення ідентичностей залишаються поза межами публічної оцінки. Перевірка підписаного PDF-файлу виявляє зміни в охоплених байтах. Зберігайте оригінальний цифровий файл та результат перевірки разом із будь-якими скріншотами або роздрукованими копіями для ознайомлення. --- # Telegram · Експорт облікового запису Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/account-export/ Експортуйте те, що обліковий запис може переглянути зараз: обсяг даних, завдання, які можна відновити, підписаний архів та мінімізовані копії для спільного доступу. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Translation coverage: this edition includes material from the English original. Експортуйте те, що обліковий запис може переглянути зараз: обсяг даних, завдання, які можна відновити, підписаний архів та мінімізовані копії для спільного доступу. [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/evidence/) ![Докази та верифікація](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) Експорт даних з облікового запису резервує слот збору даних для цього облікового запису. Спостереження в режимі реального часу може продовжуватися під час пошуку, завантаження, перевірки та пакетування архіву. Перед початком іншого збору даних, що перекривається, слід призупинити інше завдання з історії або експорту. Призупинення архівування не зупиняє спостереження, а призупинення спостереження зберігає завдання архівування. Експорт даних з різних облікових записів може виконуватися одночасно. Завдання, призначене виключно для вивантаження даних, яке очікує на затвердження, звільняє відповідний обліковий запис, тому окремий експорт у режимі звичайної сесії може розпочатися ще до завершення процесу затвердження. Активна операція збору даних все ще резервує цей обліковий запис. Як адміністратор установки, виберіть **Головна → Експортувати мій обліковий запис** або **Експорт → Обліковий запис Telegram → Налаштувати експорт облікового запису**. У разі потреби увійдіть у систему, перегляньте обсяг даних та явно запустіть експорт. Постійне спостереження не є обов’язковим. **Збережені спостереження** — це окремий експорт існуючого журналу; його ZIP-архів містить усі джерела незалежно від фільтрів журналу. Кожна робоча область має власні завдання, ідентифікатор підпису та сховище. Наданий доступ до панелі, включаючи необмежений дозвіл на звичайний експорт, не дозволяє відкривати ці маршрути на рівні всього облікового запису. Фільтри за відправником та текстом повідомлення розгортаються в розділі **«Фільтрувати за відправником або текстом повідомлення**». Розділ **«Дані облікового запису та спосіб підключення**» містить опціональні категорії облікових записів та вибір між режимами «Takeout» і «звичайна сесія»; у його зведенні відображаються активні параметри навіть у закритому стані. Закриття цих розділів не призводить до втрати їхніх налаштувань. Чернетки експорту та звітів залишаються у поточній сесії панелі під час зміни переглядів; вони не зберігаються після перезавантаження браузера. До існуючих завдань можна отримати доступ з будь-якого варіанту експорту. Цей робочий процес експортує дані, до яких наразі має доступ підключений обліковий запис. Метод **Автоматично** за замовчуванням починається з [Telegram Takeout](https://core.telegram.org/api/takeout), який повертає доступну історію в її поточному стані, включаючи залишені канали, збережені контакти та інші дані облікового запису. Якщо Telegram встановлює період очікування перед початком Takeout, «Автоматично» одразу продовжує роботу зі звичайною сесією; журнал фіксує `account_export.transport` , а підписаний інвентар вказує на використаний метод і зазначає цю зміну як пропуск. **Сесія Telegram Takeout лише** очікує на затвердження, а **Звичайна сесія взагалі** ніколи не запитує про Takeout. Таємні чати записуються в режимі реального часу модулем [«Таємний чат](https://phishdestroy.io/tgwitness/uk/docs/reference/secret-chats/)», а редагування — шляхом спостереження в режимі реального часу. Звичайна сесія має інший обсяг охоплення та фіксує категорії, що не підтримуються. **Головна → Експортувати все** запускає експорт усіх типів чатів, усіх типів вкладень, профілю, контактів, фотографій профілю, історій, метаданих сеансів та інших даних облікового запису у всіх форматах: підписаний архів TgWitness із JSON- та HTML-переглядами Telegram Desktop. **Вибрати, що експортувати** відкриває форму нижче з тими самими значеннями за замовчуванням. Takeout — це офіційний API експорту, який також використовує Telegram Desktop. TgWitness може записувати JSON, сумісний із Desktop, безпосередньо зі своїх власних даних; імпортувати чужий архів не потрібно. Ідентифікатори чатів та повідомлень доступні через обидва канали передачі даних. Швидкість експорту та затримка затвердження Takeout залежать від обмежень Telegram для облікового запису, а також від того, чи є чат публічним або чи можна його пересилати. Перед порівнянням швидкості виміряйте однаковий обсяг даних та налаштування мультимедіа. Для до 20 явно вибраних ідентифікаторів чатів експорт через звичайний API визначає цих учасників безпосередньо перед тим, як розглядати повний перелік діалогів облікового запису. Тому читабельний публічний канал можна експортувати, не приєднуючись до нього, навіть якщо його немає у списку діалогів. Незакешовані учасники використовують звичайний перелік. Фільтр архівування залишається чинним: якщо Telegram не повертає діалог, а архівні чати виключені, невідомий статус архівування фіксується як пропуск. Takeout зберігає свою процедуру розділення діапазонів у переліку. Жоден із шляхів не приєднує чати та не змінює дозволи на пересилання. У форматі JSON, сумісному з Desktop, канали, які Telegram позначає як `left`, відображаються під `left_chats`, включаючи загальнодоступні канали, до яких обліковий запис не приєднався. Запити на паузу як типу `FLOOD_WAIT`, так і `FLOOD_PREMIUM_WAIT` діють протягом усього періоду, запрошеного сервером. Термін дії облікового запису зберігається після повторного підключення та перезапуску; коротший пізніший час очікування не може його скоротити. Кількість повторних спроб обмежена, скасування зберігає запечатані сторінки, а облікові дані API не оновлюються для обходу обмеження частоти запитів. Придбання преміум-доступу не здійснюється. ## Виберіть, що збирати | Налаштування | Значення | | --- | --- | | Мета | Зафіксуйте, чому це придбання є необхідним. Не вказуйте тут зайвих імен або конфіденційних деталей справи. | | Мова звіту | Оберіть мову міток у звіті для читання. Текст оригінального повідомлення залишається незмінним; неперекладені мітки шаблону використовують англійську мову. Мова фіксується за допомогою параметрів підписаного завдання. | | Типи чатів / ідентифікатори чатів | Усі вибрані типи або лише перелічені чати; «Збережені повідомлення» належать до приватних чатів. Архівні чати можна вибирати окремо. | | Дати | UTC. У календарі панелі вказано як дату початку, так і дату закінчення. API використовує дати з включенням `from_utc` та виключні `to_utc`; панель надсилає початок дня, що настає після дати «До». Порожня межа залишає цю сторону необмеженою. | | Ідентифікатори відправників | Тільки повідомлення від зазначених відправників; порожній список включає всіх відправників. | | Текст містить | Літеральні фрази, що не враховують регістр, поєднуються за допомогою оператора «АБО». Умови «відправник», «дата» та «власне повідомлення» поєднуються за допомогою оператора «І». | | Власні повідомлення | Зберігайте лише вихідні повідомлення. | | Типи медіа | Виберіть категорії вкладень або очистіть усі, щоб уникнути завантаження файлів повідомлень. | | Обмеження на файли / загальний обсяг медіафайлів | Обсяг завантажених медіафайлів у GiB та обсяг кожного файлу в MiB. Текст, квитанції, звіти для читання та накладні витрати ZIP вимагають додаткового дискового простору. | | Категорії облікових записів | Профіль, контакти, фото профілю, історії, метадані сеансів та інші дані Takeout мають окремі елементи керування. | Пресет **колекції «Minimize»** вимикає файли та метадані облікових записів. Фільтри відправників та вмісту застосовуються до збережених сторінок повідомлень та завантажених медіафайлів. Telegram все ще передає сторінки історії API, що містять повідомлення, необхідні для оцінки цих фільтрів: фільтрування не гарантує, що відфільтровані повідомлення ніколи не потраплять до оперативної пам’яті. Інші поточні спостереження у робочому просторі мають власні параметри обсягу та зберігання. Історія фотографій профілю, історії, метадані сеансів та інші дані облікового запису вибираються за замовчуванням. Вимкніть їх, а також профіль і контакти, якщо у справі потрібні лише повідомлення. Якщо вкладення або метадані не потрібні, їх виключення під час збору даних дозволить уникнути збереження ще однієї приватної копії в цьому експорті. Корисні дані фотографій використовують варіант нерухомого зображення, визначений у їхніх метаданих та хеш-маніфестах, включаючи фотографії з анімованим варіантом аватара. Ця анімація не замінює вибране нерухоме зображення. Дані, розмір яких менший або більший за спостережуваний, реєструються як невдале вкладення, а змінене представлення під час оновлення посилання на файл відхиляється. Ці помилки залишають архів неповним, зберігаючи при цьому записи повідомлень. Незалежна верифікація також відхиляє збережені вкладення, довжина яких із підписом суперечить їхньому спостережуваному розміру або представленню, у тому числі в старих архівах. Якщо виділене медіа-з’єднання тимчасово виходить з ладу, для читання вкладень використовується стандартне файлове з’єднання. Через хвилину у фоновому режимі відбувається повторна спроба встановити виділене з’єднання, при цьому завантаження продовжуються. Цей механізм відновлення зберігає налаштований ліміт з’єднань і застосовується окремо для кожного центру обробки даних. Повідомлення про спам у Telegram та помилки авторизації все одно передаються далі. ## Номери повідомлень та карта активності Кожен архів облікового запису містить `message-gaps.json` та `map.html`. Канали та супергрупи нумерують свої повідомлення за кожним чатом, тому кожен відсутній номер між першим і останнім експортованим повідомленням є повідомленням цього чату. Приватні чати, боти та звичайні групи використовують одну послідовність номерів для всього облікового запису: відсутній номер у цьому випадку належав якомусь чату. Його чат підтверджується, коли експортована відповідь або позначка вказує на цей номер; в іншому випадку визначається, які чати були активними в проміжку часу між сусідніми повідомленнями, а решта приписується чатам, що не входять до експорту. Кожен прогін містить своє часове вікно, сусідні повідомлення, кількість повідомлень у кожному чаті та позначку достовірності. Вказується обмежений обсяг (фільтри, невибрані чати), оскільки у такому разі відсутні номери включають повідомлення, що не входять до вибраного набору. `map.html` показує календар, чати з динамікою у часі та сітки за днями тижня та годинами для повідомлень і відсутніх номерів, а також таблиці для кожного чату та найдовших серій повідомлень. Сторінки чатів містять власний календар, учасників груп у динаміці та позначку в транскрипті, де відсутні повідомлення. `verify.py` перераховує `message-gaps.json` на основі підписаних сторінок і відхиляє змінений файл. На карті активності перелічено найбільші прогалини в каналах та супергрупах, включаючи їхні діапазони номерів та час сусідніх повідомлень. Відкрийте діапазон, щоб перейти до позначеної позиції в розбитому на сторінки транскрипті. Ці позначки фіксують відсутні номери між збереженими сусідніми елементами; події видалення, час їхнього виникнення та тексти повідомлень беруться виключно із збережених записів. На невеликих екранах широкі таблиці прокручуються в межах своїх карток. Довгі стенограми містять індекс сторінок із діапазонами дат повідомлень та календарем. Виберіть місяць, щоб відкрити перший запис у порядку, в якому були збережені сторінки. При підрахунку місяців використовуються зафіксовані дати повідомлень у форматі UTC; записи без дати залишаються у стенограмі. Навігація по сторінках включає перехід до першої, останньої та сусідніх сторінок, а також відкриває розділ повідомлень безпосередньо. Індекс працює в автономному режимі без JavaScript. ## Підсумок, охоплення та перевірка Кожне завдання фіксує свої параметри та ідентифікацію облікового запису. Інвентар та збережені сторінки підписуються; у квитанціях сторінок фіксуються хеші, курсори, час, результати обробки вкладень та попередні квитанції. Лише зафіксовані сторінки враховуються у прогресі. При перезапуску/відновленні ці записи перевіряються перед продовженням роботи. Змінений обліковий запис, змінена підписана сторінка або невідповідний ланцюжок квитанцій відхиляються. Параметри не можна редагувати в процесі збору даних: для іншого обсягу даних слід запустити нове завдання. Функція «Pause» призупиняє поточну операцію з обліковим записом. Перезапуск програми залишає незавершену роботу доступною для явного відновлення. Сесія Takeout, термін дії якої закінчився, вимагає явного відновлення; зміна діапазонів фрагментів Telegram може вимагати нового збору даних. Функція «Resume» зберігає попередні спостереження, тому тривалий експорт не є одним атомарним знімком. Інші операції зі зміною облікових записів та конфліктуючі експорти блокуються під час збору даних. Перед видаленням робочого простору дочекайтеся завершення пакування. Функція «Продовжити» відображає **повідомлення Перевірка збережених даних експорту…** одразу ж і перевіряє збережений вміст у фоновому режимі перед зв’язуванням із Telegram. Панель залишається доступною під час перевірки. Функція «Призупинити» очікує, поки процес перевірки безпечно завершиться, перш ніж розблокувати обліковий запис; вона також працює, якщо її натиснути одразу після запуску або відновлення. На повільних носіях даних це очікування може тривати довго. У разі невдалої перевірки цілісності створюється завдання зі статусом «Невдача» та поясненням, а файли зберігаються. Якщо Telegram припиняє авторизацію облікового запису під час інвентаризації, отримання історії або вкладень, завдання призупиняється, не позначаючи незавершену сторінку як завершену. Потрібно повторно підключити той самий обліковий запис і відновити завдання, щоб продовжити з останньої збереженої сторінки. Замінні символи для недоступних повідомлень переміщують курсор історії вперед, але не завершують читання: старіші доступні повідомлення все одно запитуються, а замінний символ не відображається як отримане повідомлення чи підтверджене видалення. The panel distinguishes a completed selected scope from a partial archive, and records omissions and failed reads. How the report shows coverage, gaps and missing message numbers: [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). Deliberately excluded files are different from failed or unavailable files. Inspect coverage even when integrity verification succeeds. No local reader can prove Telegram returned every message that ever existed. Готові ZIP-файли залишаються доступними для повторного завантаження та завантаження за допомогою HTTP-range. Архів облікового запису містить файли `manifest.json`, `manifest.sig`, підписаний `job.json`, `inventory.json`, `receipts/`, авторитетні `data/*.jsonl`, вибрані `media/`, HTML-файли для читання та верифікатор. Зафіксуйте відбиток колектора через незалежний канал, а потім перевірте його за допомогою надійної інсталяції. Панель зберігає архів під назвою `tgwitness-account-export-EXPORT_ID.zip`; запечатаний знімок містить його у своєму архіві доказів як `account-export.zip`. Використовуйте назву файлу, який у вас є: ``` python -m tgwitness.verify tgwitness-account-export-EXPORT_ID.zip --fingerprint TRUSTED_SHA256 ``` Для архівів, розгорнутий вміст яких перевищує 4 ГіБ, слід явно встановити відповідний `--max-gib`. Панель перевіряє свої автентифіковані, завершені локальні архіви, використовуючи їх заявлений розмір у розгорнутому вигляді та опублікований дайджест ZIP; зовнішній CLI зберігає свій незалежний обмеження розміру. Перевірте перед відкриттям HTML-файлу для читання. Вбудований верифікатор архіву зручний, але верифікатор, отриманий незалежно, дозволяє уникнути довіри до виконуваного коду, що поставляється разом із доказами. Підпис Ed25519 та хеші SHA-256 виявляють зміни після того, як колектор зафіксував відповідні байти. Перегляньте цей результат разом із зафіксованою сферою збору, інтервалами збору, зовнішніми квитанціями з часовими мітками та перевірками походження, доступними для обраного розгортання. Пізніші спостереження записуються окремо, зберігаючи раніше зафіксовані версії. ## Підготуйте розкриття інформації для юриста або іншого одержувача Після завантаження готового експорту збережіть оригінальний файл ZIP та відкрийте `index.html` з розпакованої копії. У звіті пояснюються його обсяг, доступний охоплення та обмеження. Посилання на записи поєднують посилання на архів, шлях до документа та номер запису, щоб одержувач міг знайти той самий запис у HTML-файлі або на роздруківці. Практичний приклад: [відкрити вигаданий звіт](https://phishdestroy.github.io/TgWitness/demo/report/). У готовому експорті облікового запису виберіть **«Підготувати копію для спільного доступу**». Це створює окремий підписаний похідний файл. Джерело ZIP залишається незмінним і приватним; не надсилайте його разом із мінімізованим похідним файлом, якщо одержувач не має дозволу на отримання повного вмісту. Окремо виберіть мову звіту. Зміна мови або будь-яких налаштувань вибору вимагає ще одного попереднього перегляду перед створенням. 1. Вкажіть мету розкриття інформації та виберіть дати, ідентифікатори відправників і критерії за текстом повідомлень. 2. Виберіть, чи зберігати ідентичності, розкривати лише перелічених учасників чи псевдонімізувати всіх. У будь-якому режимі псевдонімізації ідентифікатори/назви чатів та ідентифікатори повідомлень також замінюються. Псевдоніми є стабільними в межах одного розкриття інформації та змінюються між незалежно підготовленими розкриттями. 3. Зберігайте текст повідомлення, повністю опускайте його або додавайте до маскування дослівні імена/фрази. У приватних режимах інструмент також маскує відомі приховані імена відправників та альтернативні імена користувачів, ідентифікатори відправників у вигляді цілих токенів, імена у прямих чатах, посилання, адреси електронної пошти та рядки, схожі на номери телефонів. Збіг за відомими іменами враховує перетворення регістру Unicode, включаючи `Straße`/`STRASSE`. Загальні назви груп/каналів не видаляються автоматично з тексту повідомлення. Якщо перевищено обмеження на маскування відомих ідентифікаторів, звузьте джерело експорту або опустіть текст; інструмент не пропускатиме наступні імена без попередження. Це правила, що діють за принципом «найкращих зусиль», а не загальна анонімізація. 4. Не додавайте файли, якщо вони не потрібні одержувачу. Додані оригінали зберігають свої пікселі, аудіо, текст та метадані. Інструмент **не** анонімізує їх. 5. Перегляньте кількість, попередження та зразки перетворених повідомлень, а потім явно підтвердьте створення. Зразки обмежені 12 повідомленнями та 2 000 символів тексту кожне. Це зразок, а не повний огляд результату. Зміна налаштувань вимагає ще одного попереднього перегляду. Попередній перегляд втрачає чинність через 15 хвилин і прив’язаний до цієї сесії адміністратора та точного оригінального ZIP; його не можна повторно використати після створення. Новий попередній перегляд анулює попередній для того самого завдання та сесії. 6. Перегляньте повний результат `index.html` та `messages.jsonl` локально, перш ніж передавати його. Якщо у ньому міститься непотрібна інформація, створіть нове розкриття з більш суворими обмеженнями. Не редагуйте підписаний тег ZIP на місці. ### Повідомлення, які не увійшли до вибірки **Попередній перегляд.** Розкриття інформації не виглядає повним, якщо воно таким не є. У кожному чаті, що містить хоча б одне розкрите повідомлення, повідомлення, які не увійшли до виділеного фрагмента, відображаються як маркери, `[withheld by selection — rule: sender]` (або `text`, `period`). Виберіть **«Повідомлення, виключені з відбору**»: один маркер для кожної серії послідовних прихованих повідомлень (за замовчуванням) або один для кожного повідомлення. Маркери містять лише правило та кількість, ніколи — текст, відправника, дату чи файли. Чати, в яких немає розкритих повідомлень, повністю виключаються, тому пакет не показує, що вони існують. Відкриті відповіді вказують, на що саме вони відповідають: на повідомлення, включене до цієї копії, на повідомлення, вилучене під час відбору, або на повідомлення, якого немає в експорті джерела (видалене перед експортом або ніколи не експортоване; експорт не дозволяє визначити, що саме). Приховане повідомлення, на яке відповідає розкрита відповідь, завжди отримує власний маркер, тож відповідь вказує на запис, що пояснює, чому вона порожня. Ці три стани відрізняються від видалень та прогалин у збірці даних, які належать до вихідного експорту. У `messages.jsonl` (формат `tgwitness-account-disclosure-v2`) кожне повідомлення має `state`: `disclosed`, або `withheld` з `rules` та `count`. Відкрита відповідь має `reply_to` з ціллю `id` та `state` (`disclosed`, `withheld`, `not_in_source`). Маніфест підраховує оприлюднені повідомлення, чати, мультимедіа та `withheld` повідомлення. `verify.py` відхиляє маркер, що містить вміст, та відповідь, яка вказує на запис, якого бракує в пакеті; пакети версії 1 перевіряються, як і раніше. У мінімізованому форматі не відображаються структуровані профілі облікових записів, контакти, аватари, сесії, історії, необроблені об’єкти Telegram, заголовки пересилань, цитати відповідей, картки контактів та метадані про місцезнаходження. Він не містить оригінальних файлів JSONL, налаштувань приватних фільтрів, ключа псевдоніма та карти ідентичностей. Виділений текст, явно збережені ідентичності та включені файли все ще можуть містити ті самі імена, ідентифікатори або фрази, що використовуються в цих фільтрах; вони потребують окремого перегляду. Приватна політика та ключ псевдоніма зберігаються у зашифрованому вигляді в локальному сховищі для завдання; видалення завдання очищає пов’язані з ним записи про приватне розкриття. Записи публічної політики фільтрують кількість, а не значення фільтрів. Зазначена мета є публічною в маніфесті та HTML: явні приватні критерії та, у режимах псевдонімізації, відомі приховані ідентичності також маскуються там, у тому числі коли текст повідомлення опущений. Не включайте в мету зайві особисті дані; невідомий ідентифікуючий контекст може залишатися. У його маніфесті вказано похідні файли, загальнодоступну політику та хеш вихідного ZIP-архіву. Перевірка дозволяє підтвердити цілісність, а також, якщо вихідний код надано локально, — відповідність посилань у вихідному коді. Панель зберігає копію для спільного доступу під назвою `tgwitness-disclosure-DISCLOSURE_ID.zip`: ``` python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 --evidence tgwitness-account-export-EXPORT_ID.zip ``` Зв’язок із джерелом показує, з якого архіву та під яким ключем колектора отримано розкриття. Розкриття містить лише вибраний вміст; відбір і видалення ідентифікуючих подробиць перевіряйте за вихідним експортом. ## Обмін даними та розміщення записів на сервері Виберіть повідомлення та файли, які потрібні одержувачу, перегляньте повну копію для обміну та збережіть оригінал окремо. Запишіть хеш доставленого ZIP-файлу, щоб одержувач міг ідентифікувати та перевірити саме цю копію. Вибрані ідентифікатори замінюються псевдонімізацією; включений текст та оригінальні файли залишаються частиною перегляду. GitHub Actions підтримує експорт даних усього облікового запису та вибраних чатів через Takeout або звичайний API, а також журнал подій одного чату. Посібник із хостингового збору даних пояснює перевірку налаштувань та обмеження у 120 хвилин. Щоб перевірити копію для спільного доступу, отриману з хостингового збору даних, порівняйте її вихідний хеш із оригінальним архівом та перевірте засвідчення цього архіву за допомогою перевірок [, специфічних для режиму](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope). [Формат доказів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/) · [Звіти про справи](https://phishdestroy.io/tgwitness/uk/docs/reference/case-reports/) --- # Telegram · Формат доказів Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/ Вміст підписаного ZIP-архіву, типи записів, підтвердження обробки, профілі користувачів, зовнішні копії та офлайн-перевірка. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Translation coverage: this edition includes material from the English original. Вміст підписаного ZIP-архіву, типи записів, підтвердження обробки, профілі користувачів, зовнішні копії та офлайн-перевірка. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документація](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Докази та верифікація](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness зберігає спостереження Telegram, видимі для облікового запису, у підписаному журналі. Одержувачі можуть перевірити збережені записи, вкладення та звіти за допомогою надійного ключа колектора, перевірити зовнішній час від третьої сторони для останнього запису та порівняти журнал із контрольною точкою, яку вони зберегли раніше. На цій сторінці описано формати, перевірки та матеріали, які слід зберегти для передачі. Користувачі можуть розпочати з **VERIFY.cmd** у Windows: програма запитує оригінальний ZIP-файл та незалежно отриманий відбиток ключа, відображає результат із поясненнями, а також зберігає окремий протокол верифікації. Дивіться запускачі [verification та портативне середовище виконання](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md) для налаштування та обмежень довіри. **На цій сторінці** - [Що підписано](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#what-is-signed) - [Порівняння експортованих даних чатів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#comparing-chat-exports) - [Передача розслідування](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#investigation-handoff) - [Витяг із передачі](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#handover-extract) - [Зрозумілі звіти](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#readable-reports) - [Канонізація подій](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#event-canonicalization) - [Семантика актора](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#actor-semantics) - [Покриття: безперервність, прогалини та неспостережувані ідентифікатори](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids) - [Виробник](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#producer) - [Профілі користувачів](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#people-profiles) - [Незалежний свідок](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#independent-witness) - [Маніфест та контрольні точки](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#manifest-and-checkpoints) - [Обсяг верифікації](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope) - [Вкладення](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#attachments) - [Надійне збирання та обробка квитанцій (0.2)](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#durable-collection-and-process-receipts-02) - [Підготовка RFC 3161 та перевірка відповідей (0.2)](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02) - [Додаткові записи в режимі збору доказів: drand та пристрої Telegram](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices) ## Що підписується | Матеріал | Захист | Що слід зберігати | | --- | --- | --- | | Кожен запис у журналі, включаючи оперативні події | Ланцюжок SHA-256 та підпис Ed25519 для кожної події | Оригінальний `events.jsonl` — відбиток надійного ключа та збережений контрольний пункт | | Вміст ZIP-архіву з доказами | `manifest.sig` підписує канонічний маніфест, у якому перелічено хеші файлів вмісту | Повний ZIP-архів, що містить маніфест та підпис | | Збережені вкладення | SHA-256 та кількість байтів у підписаній події `media.saved`; хеш файлу у підписаному маніфесті ZIP | Оригінальні байти всередині перевіреного ZIP-файлу | | Контрольна точка | Підпис Ed25519, що охоплює довжину журналу, хеш заголовка, відкритий ключ та час створення | Незалежна копія, збережена до внесення спірного зміни | | Квитанція про виконання | Підписаний запис про версію колектора, хеші вихідних файлів та початкові налаштування, також включений у `process.started` | Квитанція, відповідний журнал та докази середовища для обраного режиму верифікації | | Зрозумілі звіти: `report.html` та його частини, `report.json`, `report.pdf`, `chat.pdf` | На кожному файлі розміщується печатка Ed25519, що підтверджує його вміст; PDF також містить стандартний підпис PDF (див. [Читабельні звіти](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#readable-reports)) | Отриманий файл та відбиток надійного ключа; ZIP-архів, який він описує | | Автономний CSV | Відсутність окремого криптографічного підпису; самих хеш-значень подій недостатньо | Для перевірки цілісності використовуйте точну копію, що міститься у перевіреному ZIP-файлі | | Знімки екрана, роздруківки або PDF-файли, створені браузером | Відсутність підпису TgWitness на похідному матеріалі | Зберігайте оригінальний перевірений пакет і задокументуйте, як було створено похідний пакет | Колектор перевіряє підписи журналу перед генерацією кожного формату експорту. Зручні для читання звіти у форматах HTML та PDF мають власні печатки; автономний файл CSV перевіряється як частина підписаного ZIP-архіву. Зберігайте ZIP-архів, щоб зберегти байти вкладень та маніфест, а також окремий контрольний пункт для перевірки журналу щодо попередньої межі. ## Формати та шляхи верифікації Режим збору та формат виводу дають відповіді на різні питання. Режим надає докази щодо збору та середовища; кожен формат зберігає або представляє частину цього запису з урахуванням наведених нижче перевірок. | Вихідні дані | Перевірка та використання | | --- | --- | | Докази ZIP | Канонічні події, підписаний маніфест, охоплення, записи про зберігання, вкладення та наявні зовнішні квитанції; перевірте архів та обраний режим його отримання. | | Контейнер ASiC-E | Архів ZIP із даними у форматі контейнера ETSI ASiC-E (EN 319 162-1), що містить запис про тип медіа (`mimetype`) та файл `META-INF/ASiCManifest.xml`, підписаний за допомогою CAdES власним сертифікатом робочого простору на рівні B-B або B-T, якщо увімкнено функцію часової мітки. Валідатори, такі як EU DSS, перевіряють формат та цілісність і, оскільки сертифікат видано самостійно, повідомляють про відсутність опорного пункту довіри. EU DSS 6.3 із налаштуваннями за замовчуванням відхиляє контейнер, що містить понад 1000 файлів («Виявлено занадто багато файлів»). `verify.py` перевіряє маніфест Ed25519 та кожен файл у списку, значення SHA-256 у файлі `META-INF/ASiCManifest.xml` та у доданому файлі `ASiCManifestNNN.xml` або `ASiCEvidenceRecordManifest.xml`, і видає помилку, якщо зустрічається запис у `META-INF/`, який жоден із них не охоплює. Програма не перевіряє підписи CAdES і повідомляє про це. | | Звіти у форматах HTML та JSON | Індивідуально запечатані перегляди з посиланнями на джерела, також перелічені в маніфесті ZIP-архіву. Їхні зафіксовані підрахунки узагальнюють типи подій журналу. | | Звіти у форматі PDF | Печатка Ed25519 та базовий PDF-підпис PAdES для діапазону байтів: B-B або B-T із міткою часу підпису, якщо функція мітки часу увімкнена. Верифікатор TgWitness використовує надійний ключ Ed25519; відображення довіри до сертифіката у переглядачі є окремою перевіркою. | | CSV | Вигляд електронної таблиці, що охоплюється маніфестом ZIP. Ескейп формул захищає використання електронної таблиці; оригінальний підписаний текст залишається в журналі. | | JSONL | Підписані записи подій, включаючи посилання на вкладення. ZIP-архів з доказами додатково містить збережені байти вкладень. | | Експорт чатів та перегляди, сумісні з настільними ПК | Збір історії та доступних записів журналу адміністратора із запитуваним відтворенням та підписаним архівом. Збережені версії моніторингу в режимі реального часу — це окремий шлях збору даних. | | Медіафайли та записи, що містять лише хеш-значення | Збережені байти перевіряються за їхнім SHA-256 та посиланням на повідомлення. Збір лише хеш-значень зберігає доступні метадані хеш-значень для подальшого порівняння з байтами файлу. | | STIX/MISP та профілі осіб | Витягнуті спостереження з посиланнями на джерела, ідентифікатори облікових записів та аналітичні збіги. Сигнатури профілів та хеші записів можна перевіряти порівняно з оригінальними доказами; походження кешу аватарів позначається окремо. | | Витяг із протоколу передачі | Підписані правила розкриття, незмінені записи та позначені мінімізовані записи, що зберігають оригінальні хеші/підписи. Використовуйте збережений оригінал для порівняння, яке вимагає прихованих полів. | | Свідок та квитанції про час | Раніше — межі журналу, безперервність та окремі перевірені часові заявки. Вони супроводжують перевірки збору та архівування. | | Доставка, захищена паролем | Захищає вкладений пакет під час передачі. `.tgwpw` використовує шифрування з автентифікацією AES-GCM, включаючи автентифікований кінцевий запис; вкладене журнальне файли зберігає свої підписи та квитанції про отримання. | Роздруківка або знімок екрана — це представлення підписаного матеріалу. Його ідентифікатор звіту, відбиток ключа та QR-посилання допомагають знайти оригінальний файл для перевірки. Декларації про зберігання фіксують інформацію про призначеного експерта та передачу даних; результати перевірки та квитанції про отримання зберігаються як окремі докази. ### Зовнішні підписи Підпис також може походити від ключа, якого TgWitness ніколи не зберігає, наприклад, від кваліфікованого електронного підпису слідчого або печатки організації. Щодо **експорту**: **зовнішній підпис** на готовому експорті без пароля надає байти для підписання: новий `META-INF/ASiCManifestNNN.xml` список усіх файлів із їхніми SHA-256 для контейнера ASiC-E або імпорту `manifest.json` для ZIP-файлу. Підписувач повертає CMS (CAdES) `.p7s`, окремий або з вбудованим вмістом. TgWitness перевіряє, чи підпис охоплює саме ці байти, та здійснює верифікацію за допомогою сертифіката підписувача (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448). Ланцюжок перевіряється лише щодо кореневих сертифікатів, наданих оператором; скасування, списки довірених сертифікатів та кваліфікований статус не перевіряються. Панель показує один стан для кожного підпису: очікування підпису, додано та не перевірено, перевірено, алгоритм не підтримується, підпис недійсний, підписані байти не збігаються або сертифікат не пов’язаний із наданим кореневим сертифікатом. Зміна експорту після розподілу байтів встановлює для всіх його підписів стан «підписані байти не збігаються». **Завантаження з підписами** додає підписи та їхні маніфести до `META-INF` у контейнер ASiC-E. У випадку ZIP-файлу додається незмінений ZIP-файл, а також `.p7s` файли та `SIGNATURES.txt` у зовнішній ZIP-файл. Недійсні підписи та підписи, накладені на інші байти, виключаються. Підпис з алгоритмом, який TgWitness не може перевірити, включається; панель показує його стан, як і `SIGNATURES.txt` у випадку ZIP-файлу. ### Зображення з підписаним чатом **Завантаження підписаного ZIP-файлу** з попереднім переглядом зображення дозволяє зберегти сторінки у форматі PNG, `pages.sig.json` а `README.txt`. Кожна сторінка закінчується номерами записів журналу, які на ній відображаються, чатом, часом візуалізації, відбитком ключа робочої області та командою, що його перевіряє. Панель надсилає лише SHA-256 та номери записів кожної сторінки; сервер підтверджує, що записи належать до чату, підписує заяву (`tgwitness-image-attestation-v1`) за допомогою ключа робочої області та фіксує підписання у журналі як `export.image_attested`. ``` python verify.py page-01.png page-02.png pages.sig.json python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip ``` Верифікатор перевіряє підпис, зіставляє кожен файл PNG із підписаною сторінкою та повідомляє відбиток ключа. `--fingerprint` Порівнює підписника з відбитком ключа, отриманим від відправника незалежно. `--evidence` зчитує підписаний ZIP-архів доказів з тієї самої робочої області та вимагає, щоб кожен запис зображень мав однаковий хеш. Змінений піксель, змінене твердження або інший ключ призводять до провалу перевірки. Зображення показують збережені записи у власному форматі TgWitness; вони не відображають те, що Telegram показував будь-кому. ## Порівняння експортованих даних чатів Перевірити та порівняти два підписані ZIP-файли з експортом чатів із незалежно збереженими відбитками підписувачів: відбитки: ``` python -m tgwitness.verify first.zip --compare second.zip \ --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256 ``` Параметри `--require` та `--require-tier` не допускаються разом із `--compare`; перевірте необхідний профіль кожного архіву за допомогою відповідної перевірки. Коли обидва архіви фіксують однакові числові ідентифікатори облікового запису та чату, записи поєднуються за ідентифікатором повідомлення. **Незмінно** означає рівність повного збереженого запису JSON: повний текст, автор, дати, адресат відповіді, вкладені метадані та невідомі поля — все це включено. Порядок ключів об’єкта JSON не має значення; значення мають відсутні поля, нульові значення, типи значень та порядок масивів. Попередній перегляд із 300 символів призначений лише для відображення. Змінені записи вказують на відмінності у верхньому рівні `changed_fields`, включаючи зміни, невидимі в цьому попередньому перегляді. Дублікати ідентифікаторів повідомлень відхиляються, а не перезаписують один одного під час зіставлення. Відмінність може полягати у зміні імені для відображення, кількості переглядів, анотації колекції або інших метаданих спостереження. Редагування в Telegram відображаються як окремі події редагування, а перевірка кожного архіву показує, чи є цей архів цілісним. Нерозпарсовані записи залишаються у порівнянні та порівнюються за їхнім збереженим представленням. У разі відмінних або відсутніх ідентифікаторів облікових записів/чатів інструмент знаходить можливі відповідності, використовуючи відправника, повний текст, хеш файлу, тип медіа та п’ятисекундний часовий допуск, і позначає їх як **Збіг (Matched)**, а не **Без змін (Unchanged)**. Непроаналізовані записи залишаються без відповідності. Відмінності у спарених записах перелічуються у `changed`, у тому числі в режимі вмісту. З параметром `--json` `matched` підраховує потенційні пари, а `unchanged` — пари, повні збережені записи яких є однаковими. Існуючі виводи `changed_fields` та цілочисельний `unchanged` залишаються сумісними з попередніми результатами порівняння. Формат архіву та перевірка підпису не зазнали змін. ## Передача розслідування 1. Зафіксуйте номер справи, ім’я оператора, числовий ідентифікатор облікового запису Telegram, вибрані джерела, політику збору даних та період збору у своїх нотатках щодо справи. TgWitness зберігає спостереження та підтримує нотатки й збір даних, пов’язані з джерелами, у [Case Board](https://phishdestroy.io/tgwitness/uk/docs/reference/case-board/). Зберігайте записи про передачу та зберігання разом із матеріалами справи . Перевірте налаштування збору даних, що відповідають вашим потребам, за допомогою [процедури приймання в режимі реального часу](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md). 2. Перед тим, як покладатися на експортовані дані, незалежно збережіть відбиток відкритого ключа робочого простору. Залиште увімкненим режим підтвердження (за замовчуванням), щоб контрольні точки отримували квитанції згідно з RFC 3161 та OpenTimestamps. Під час збору даних зберігайте підписані контрольні точки поза межами колектора. Реєструйте переривання та обмеження видимості облікового запису. 3. Експортуйте **підписаний ZIP**-файл і збережіть підписану квитанцію про виконання. Використовуйте контрольну точку на межі експортованого журналу або перед нею. Пізніша контрольна точка може правильно відхилити раніше експортований файл як занадто короткий. Експорт включає повний журнал робочого простору, незалежно від фільтрів панелі; перегляньте матеріал перед тим, як поділитися ним. 4. Нехай одержувач перевірить ZIP-архів за допомогою надійної копії верифікатора, незалежно наданого відбитка та кореневого сертифіката служби міток часу, отриманого окремо. З надійного робочого середовища з активним середовищем Python: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence ``` Відбиток та перевірена мітка часу останнього запису відповідають мінімальним вимогам до доказів; у протилежному випадку `--require evidence` завершує роботу з кодом 2. Контрольна точка є підтверджувальною перевіркою, оскільки вона підписана ключем колектора. У разі успішного виконання виводиться `key_pinned: true` та `checkpoint_checked: true`, якщо обидва вхідні параметри надані та прийняті. Збережіть результат верифікації. ``` For a handover requiring the final exported record to be witnessed, use `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`. This refuses an export with an unwitnessed tail. Add `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the witness posts as external time. See the [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary). ``` 1. Зафіксуйте SHA-256 архіву, межу експорту, дату передачі, відправника та одержувача у вашому протоколі зберігання. Зберігайте оригінальний пакет у незмінному вигляді та працюйте з копіями. Поділіться файлами доказів, а не каталогом приватних даних програми, який також містить сесії облікових записів та секрети підпису. Для передачі виберіть захищений паролем ZIP-архів із шифруванням AES-256 або більш надійний контейнер `.tgwpw` . ZIP використовує недосконалий алгоритм генерації пароля WinZip; використовуйте довгу випадкову парольну фразу. `.tgwpw` використовує scrypt та AES-256-GCM і відкривається за допомогою команди `unseal-password` автономного верифікатора. Пароль не зберігається і служить лише для захисту конфіденційності; одержувач розшифровує архів і перевіряє підписаний експортний файл усередині, який залишається незмінним. 2. Щоб поставити часовий штамп на контрольну точку поза режимом доказів, дотримуйтесь [процедури RFC 3161](https://phishdestroy.io/tgwitness/uk/docs/reference/timestamp/) та збережіть запит, контрольну точку, інформацію про довірений центр сертифікації та перевірену відповідь служби міток часу. Сама лише підготовка запиту не забезпечує отримання часового штампу. Для `.tgwpw` використовуйте незалежно отриманий верифікатор і виберіть новий вихідний файл з оригінальним розширенням: `python verify.py unseal-password export.tgwpw --out evidence.zip`. Команда запитує пароль; `--password-stdin` зчитує один рядок для автоматизації. Вона ніколи не перезаписує існуючий файл і публікує відкритий текст лише після того, як усі записи пройдуть автентифікацію. Після цього виконайте звичайну перевірку підпису на розшифрованому файлі. Контейнер використовує scrypt (`N=131072`, `r=8`, `p=1`, 16-байтовий соль; приблизно 128 МіБ оперативної пам’яті) та AES-256-GCM із записами розміром 1 МіБ та автентифікованим кінцевим записом. Зашифрований запис метаданих зберігає внутрішнє ім’я файлу, тому завантажені контейнери можна перейменовувати. Успішна верифікація підтверджує цілісність щодо довіреного ключа колектора та збережених меж. Див. [сферу верифікації](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope) для ознайомлення з припущеннями щодо довіри та [результатами перевірки](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/) виконаних тестів. ## Витяг із протоколу передачі Підписаний ZIP-файл містить повний журнал робочого простору. Якщо суду, адвокату або службі з питань зловживань потрібні лише деякі чати, певний період або конкретні особи, **функція «Експорт → Витяг для передачі»** готує мінімізовану копію (`tgwitness-handover-v1`) відповідно до обраних правил розкриття інформації. Оператор вказує мету та обирає чати, опціональний період (UTC), осіб, яких стосується витяг, що відбувається з усіма іншими (показуються, замінюються псевдонімами P01, P02… або виключені ), які тексти повідомлень залишаються, які вкладення та фотографії профілів включено, а також чи маскуються номери телефонів та адреси електронної пошти в текстах. Мета та ці правила містяться у підписаному маніфесті та у звіті; журнал реєструє запис «`handover.exported`» із зазначенням доступу, який його підготував, та SHA-256-сумою файлу, а не його вмістом. Скрипт `verify.py` перевіряє витяг двома способами. Запис, який позначено як незмінений, перевіряється повністю: його вміст порівнюється з хешем, підписом Ed25519 та посиланням на попередній запис, що входить до складу. У зменшеному записі зберігаються оригінальний хеш та підпис, тому підпис все ще перевіряється, але приховані поля неможливо перерахувати на його основі; у записі вказано, що саме було приховано, а звіт позначає це. Записи про обслуговування на рівні облікового запису (запуски та зупинки, прогалини в покритті, повідомлення про з’єднання, мережу та сховище, зміни обсягу та налаштувань) зберігають лише поля, перелічені для їхнього типу: списки чатів у них скорочуються до обраних чатів, а їхні загальні показники перераховуються; прогалина в режимі реального часу в чаті, що не входить до вибору, призводить до втрати цього чату, його номерів повідомлень та облікового запису свідка; у вибраному чаті для перевірки обліковий запис свідка замінюється його псевдонімом, якщо тільки не показано всіх учасників або це одна з вибраних осіб. Маніфест вказує довжину журналу та його заголовок із підписом збирача над цим заголовком, а також підраховує кількість пропущених записів; файл ``coverage.json`` описує обрані чати. Нові витяги також містять файл ``proofs.jsonl``: для кожного включеного запису та для заголовка журналу — шлях Меркла від оригінального хешу запису до кореня журналу, зазначеного в підписаному маніфесті. `verify.py` перевіряє кожен шлях, тож для кожного запису підтверджується, що він належить до того самого журналу з зазначеною довжиною та заголовком, без повного журналу; витяг із 100 повідомлень перевіряється приблизно за секунду незалежно від розміру журналу. `--range=CHAT:FROM-TO` додатково підтверджує, що повідомлення від FROM до TO у чаті містяться у витягу, та повідомляє, скільки записів було перевірено щодо них. Імена всередині імен файлів не виявляються. Перегляньте кінцеві файли перед тим, як поділитися ними: вільний текст, імена файлів та вибрані вкладення все ще можуть ідентифікувати людей. Зберігайте повний підписаний ZIP-файл: витяг є розкриттям інформації, а не заміною. ## Зрозумілі звіти Підписані докази, передані матеріали та ZIP-архіви чатів містять читабельні звіти у форматах HTML та JSON, а також PDF, якщо доступні необхідні шрифти, мовою, обраною для звіту. Кожен звіт зашифровано ключем Ed25519 робочого простору та його можна перевірити окремо: `python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]`. - `report.html` / `chat.html`: оператор запечатування (`tgwitness-report-seal-v1`) закриває файл і підписує SHA-256 кожного байта, що йде перед ним. Довгі журнали та чати розділяються на частини настроюваного розміру (Налаштування звіту, від 500 до 100 000 записів; за замовчуванням — 5 000): `records/records-0001.html` або `messages/messages-0001.html`, кожна з яких завірена своїм номером, діапазоном та загальною кількістю, і вказана разом із своїм SHA-256 у підписаному маніфесті. Серії сигналів активності колектора відображаються одним рядком, якщо в налаштуваннях звіту не вказано, що їх слід показувати окремо. - `report.json` (`tgwitness-report-json-v1`, ключі `format`, `report`, `seal`): печатка підписує SHA-256 канонічного JSON `report`, завдяки чому факти можуть бути прочитані системами розгляду справ та скриптами, а також на їх основі можна здійснити вибірку для захисту даних, при цьому підписаний файл залишається цілісним. - `report.pdf` / `chat.pdf`: офіційний документ для друку та архівування, підписаний двічі на одних і тих самих байтах, у всьому файлі, за винятком значення підпису (`/ByteRange`). Стандартним підписом у форматі PDF є PAdES baseline (ETSI EN 319 142-1, `/SubFilter /ETSI.CAdES.detached`: CMS із SHA-256 та ECDSA P-256, signing-certificate-v2, без часу підписання CMS; заявлений час становить `/M`) на рівні B-B або B-T із міткою часу підпису RFC 3161 у CMS, коли функція мітки часу увімкнена, а центр міток часу відповідає через маршрут на запити поза межами Telegram. Використовується самовиданий сертифікат для підписання документів, що зберігається у сховищі робочого простору; його серійний номер суб’єкта є відбитком ключа Ed25519. Печатка Ed25519 передається всередині CMS як непідписаний атрибут `2.25.240684792623320047764573196045913242332` і вказує SHA-256 сертифіката з `"content": "pdf-byte-range"`, тож ключ Ed25519 гарантує справжність сертифіката. Сертифікат не є кваліфікованим: програма для перегляду PDF-файлів показує підпис як дійсний, а підписувача — як невідомого або ненадійного, доки сертифікат не буде визнано надійним; замість цього порівняйте відбиток ключа Ed25519 . Для PDF-файлів китайською, японською та корейською мовами потрібен шрифт на сервері (або в `TGWITNESS_FONT_DIR`); без нього ZIP-архів містить лише звіти у форматі HTML та JSON . - `report.en.html`, `report.en.pdf` / `chat.en.html`, `chat.en.pdf`: англійський оригінал того самого звіту, якщо мова звіту не англійська; він опечатаний і підписаний так само та зазначений у підписаному маніфесті під `report.original`. Звіт вибраною мовою починається з рекомендації подати англійський оригінал разом із завіреним або присяжним перекладом; див. [Переклад звітів для суду](https://phishdestroy.io/tgwitness/uk/docs/reference/translation/). У каналі або супергрупі Telegram нумерує повідомлення 1, 2, 3… по порядку. Експорт чату містить перший і останній номер, кількість присутніх повідомлень та кожну серію відсутніх номерів у `message-ids.json` , маніфесті та заголовку `chat.json` , а також позначає кожну прогалину там, де вона трапляється у транскрипті. `verify.py` перераховує їх, починаючи з `chat.json` . Відсутній номер — це повідомлення, яке Telegram не повернуло (видалено до експорту або невидиме для облікового запису); у приватних чатах та базових групах номери спільні для всіх чатів облікового запису, і пропуски не враховуються. Після зчитування історії експорт знову запитує у Telegram усі відсутні номери за номером (`channels.getMessages`, до 10 000 номерів, включаючи 1 000 номерів нижче першого повідомлення, рівномірно розподілених по всіх прогалинах, якщо їх більше). Результат міститься в `message-ids.json` та у звіті. Порожня відповідь фіксує, що номер недоступний для цього облікового запису на момент повторної перевірки; причина залишається невизначеною. Повідомлення, отримане під час повторної перевірки, додається до експорту та позначається `found_on_recheck`. Коли робоча область спостереження виявляла, що повідомлення чату були видалені, відсутні під час повторної перевірки або відредаговані, експорт чату додає `journal-changes.jsonl`: ці записи журналу, кожну збережену версію та відповідне повідомлення, кожен із яких містить хеш та підпис Ed25519, отримані ним у журналі. `verify.py` перераховує хеш кожного запису, перевіряє його підпис за ключем експорту та порівнює кількість із підписаним маніфестом; експорт доказів містить повний ланцюжок хешів. У звіті ці повідомлення перелічені в розділах **«Видалення» та «Попередні версії**». Кожен звіт починається з розділу **Коротко**: один абзац, потім — що показує матеріал і що містить запис. Власна печатка сторінки стає бурштиновою, коли браузер перевірив підпис печатки, а не саму сторінку: браузер не надає сторінці власних байтів. Вона стає зеленою лише тоді, коли читач перетягує файл у поле перевірки внизу сторінки і кожен байт збігається, і лише якщо сторінка, що відображається, є саме цим файлом; в іншому разі вона стає червоною. У кожному звіті вказується точна назва програми: git-комміт, коли колектор запускається з чек-ауту або інсталятор встановлює `TGWITNESS_COMMIT`, а також SHA-256 його вихідних файлів (`source_tree_sha256`, канонічний JSON шляху → SHA-256 кожного файлу `.py`, `.js`, `.css`, `.html` та `.svg` у пакеті), які відтворюються при чек-ауті цього комміту, якщо файли не були змінені. Клієнт Telegram називається за назвою його бібліотеки, рівня API та центру обробки даних. Коли починається спостереження та коли починається й закінчується експорт чату, колектор запитує у Telegram його час (`updates.getState`, цілі секунди) і фіксує час Telegram мінус час за годинником колектора, з похибкою, пов’язаною з часом проходження сигналу в обидва боки; у звітах ці вимірювання наводяться у розділі «Ланцюг відповідальності». Експорт чату також фіксує час зчитування історії, окрім дат повідомлень. ### Посібник з офлайн-перегляду звітів та архівування Розпакуйте повний ZIP-архів перед тим, як відкривати `chat.html` або `report.html`. Переглядач надає функції пошуку, фільтрів, учасників, індикаторів, деталей записів та вибірки JSON/CSV без використання сервера. Зберігайте `viewer/` та `media/` поруч із звітом. Вибірки є похідними: використовуйте `verify.py SELECTION.json --evidence ARCHIVE.zip`, щоб порівняти їх із підписаним архівом. Верифікатор перевіряє ідентифікатор звіту, ключ підпису, межі архіву та кожен вибраний елемент; відредаговані, відсутні та дубльовані елементи не проходять перевірку. Примітки до вибору та час створення залишаються непідписаними метаданими. Пропуски в номерах повідомлень відображаються лише для повного, нефільтрованого чату в порядку зростання номерів. Приховування категорії або неможливість завантаження блоку даних не повинні перетворювати пропущений рядок на доказ відсутності повідомлення. Підсвічування результатів пошуку здійснюється на основі простого тексту до ескейпу HTML, зберігаючи літеральну розмітку. Браузер перевіряє підписи маніфесту, ідентифікатор звіту та ключ, а також усі вказані хеші файлів. Він відхиляє неоднозначні або неправильно сформовані ZIP-структури, дублікати імен та небезпечні шляхи, а також обмежує розмір файлів до 256 МіБ, а загальний обсяг вмісту — до 4 ГіБ. Для архівів більшого розміру використовуйте автономний верифікатор. Ця перевірка браузером доповнює перевірки верифікатора щодо ланцюгів журналів та семантики даних. Файл `README.txt` містить посібник для початківців, вирівняний перелік файлів, інструкції з верифікації та примітки щодо формату даних мовою звіту, а також повний посібник англійською мовою. `SHA256SUMS` охоплює перелічені в ньому файли, за винятком самого цього файлу, `manifest.json` та `manifest.sig`; підписаний маніфест також охоплює `SHA256SUMS`. Залиште оригінальний ZIP-архів без змін і зберігайте робочі файли поза розпакованою папкою. Звіти PDF містять закладки розділів та ідентифікацію справи/звіту на наступних сторінках. ### Чат на момент експорту Експорт чату фіксує те, що Telegram вказав про чат на момент початку експорту: власні мітки Telegram (`scam`, `fake`, `restricted` з відповідними причинами, `verified`), імена користувачів, опис, кількість учасників та адміністраторів, пов’язану дискусію, захист вмісту, чи бачать нові учасники попередні повідомлення та з якого повідомлення цей обліковий запис має доступ до історії (`available_min_id`), дату першого повідомлення, якщо це момент створення чату, та SHA-256 — фото чату (збережене в `media/`). Він фіксує місце облікового запису, що експортує дані, у чаті: роль, дату приєднання, хто його запросив, а для адміністратора — його права. Натомість вказується запит Telegram, який було відхилено. Якщо обліковий запис, що здійснює експорт, належить адміністратору, експорт зчитує журнал адміністратора чату (Telegram зберігає його приблизно 48 годин) у файл `admin-log.json`: видалення та редагування із зазначенням наданого вмісту, облікового запису, що здійснив дію, та дати дії джерела. Ці записи доповнюють збережені версії активного журналу та записи про отримання повідомлень про видалення. ### Індикатори У списку звітів та архіві містяться такі записи: `indicators.csv` , `indicators.stix.json` (STIX 2.1 ) та `indicators.misp.json` (подія MISP ), на які служба з боротьби зі зловживаннями може реагувати у записаних повідомленнях: посилання та домени (у тому числі приховані за текстом, у кнопках та у попередньому перегляді посилань), адреси криптовалют, імена користувачів та посилання для запрошення Telegram , номери телефонів, адреси електронної пошти та збережені зображення. Адреси Bitcoin, Litecoin, Dogecoin та TRON вказуються лише тоді, коли їхня контрольна сума base58 збігається, адреси segwit — коли збігається їхня контрольна сума bech32 або bech32m, а адреси TON — коли збігається їхня CRC; адреси EVM та Solana позначаються як неперевірені. Зображення містять SHA-256 та перцепційний хеш (dHash, 64 біти), який залишається майже незмінним у перекомпресованих або змінених за розміром копіях. Звіти записують індикатори так, щоб вони не відкривалися випадково (`hxxps[://]example[.]com` ); файли зберігають значення такими, якими вони були. Кожен індикатор позначається як невідомий і не призначений для автоматичного виявлення (STIX , `indicator_types: unknown` , MISP , `to_ids: false` , розповсюдження у власній організації): наявність у списку означає, що повідомлення містило його, а не те, що він є шкідливим. Посилання, текст якого показує іншу адресу, ніж та, що відкривається, позначається у звіті. Звіти формату «PDF» закінчуються заявою експерта, яку потрібно підписати власноруч, контрольним списком для нотаріуса або судового експерта, а також QR-кодом (який також розміщений на першій сторінці) з ідентифікатором звіту, відбитком ключа та ідентифікатором «SHA-256» авторитетних даних, завдяки чому роздруківка дозволяє відстежити її походження до архіву. ## Канонізація подій Вхідні дані хешу складаються саме з таких полів: ``` seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash ``` Серіалізація за допомогою JSON, сумісного з Python, у кодуванні UTF-8, із відсортованими ключами об’єктів, без ASCII- ескейпу, без незначущих пробілів та без NaN/infinity: ``` json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"), allow_nan=False).encode("utf-8") ``` SHA-256 цих байтів стає хешем події. Підпис генерується за алгоритмом Ed25519 над 32 необробленими байтами хешу, а потім кодується у форматі base64. Перший previous_hash складається з 64 нулів. Порядкові номери починаються з 1 і збільшуються на 1. Усі події, включаючи оперативні події, об’єднуються в один ланцюжок. Придушення дублювання доставки не відбувається: повторювані спостереження є окремими підтвердженнями отримання, а не твердженням про окремі дії Telegram. Необроблені дані Telegram — це рядки у форматі ISO; бінарні поля перетворюються на об’єкти, що містять bytes_base64. Текст повідомлення, об’єкти, дескриптори мультимедіа, метадані відповіді, реакції та дії сервісу зберігаються в необроблених метаданих повідомлення, якщо вони були надані. У разі повідомлення в режимі реального часу також зберігається оновлення Telegram, яке його доставило, `transport_update`; коли це оновлення містить те саме повідомлення, що й `raw`, його `message` поле `{"same_as": "raw"}` замість другої копії. `observed_at` — це час (UTC) створення запису колектором; `source_at` — це дата, надана цією подією Telegram. До записів, записаних під час обробки оновлення в режимі реального часу, додається `payload.received_at`час UTC, коли оновлення надійшло до колектора, а `payload.processing_delay_ms`. Редагування в режимі реального часу зберігають надану дату редагування, знімки історії зберігають дату повідомлення з поточним часом спостереження, а звичайне повідомлення про видалення фіксує час отримання з нульовою датою джерела. Записи в журналі адміністратора зберігають надану дату дії окремо. Порядок отримання та порядок подій джерела — це різні часові шкали, де для порівняння доступні дані годинника та зовнішні підтвердження отримання. ## Семантика учасників Атрибуція відповідає джерелу події. `message.new.actor_id` та `message.edited.payload.sender_id` зберігають ідентифікатор відправника повідомлення. Звичайні повідомлення `message.deleted` містять ідентифікатори повідомлень і мають поле actor із значенням null; доступні записи журналу адміністратора містять вказані дію, учасника та дату. Повідомлення служби членства зберігають відправника та тип дії, необроблені оновлення учасників зберігають вказаний `actor_id`, а знімки реакцій зберігають вказані кількість та видимі ідентифікатори. Читайте ці записи разом із зафіксованими версіями та [квитанціями взаємодії з панеллю](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#own-actions). Повідомлення про видалення для приватних чатів та звичайних груп містять лише ідентифікатори повідомлень. Ці чати мають спільну послідовність ідентифікаторів для всього облікового запису, тому ідентифікатор ідентифікує одне повідомлення цього облікового запису. Коли повідомлення з цим ідентифікатором було раніше збережено в цьому журналі, видалення фіксується в цьому чаті як `message.deleted` із `payload.chat_resolution`, що вказує на метод. Ідентифікатори, які ніколи не зберігалися, зберігаються як `deletion.unscoped`: це фактичне повідомлення про видалення, чат якого не було співвіднесено. Це відрізняється від `message.missing_on_recheck`, яке фіксує недоступний результат запиту, та від пропуску у збережених ідентифікаторах повідомлень. Канали та супергрупи нумерують повідомлення за кожним чатом і ніколи не зіставляються таким чином. Коли видалене повідомлення було надіслано обстежуваним обліковим записом, payload.deleted_message_was_outgoing має значення true; інформація про особу, яка здійснила видалення, все ще не вказана. Повідомлення без області дії зберігає власний ярлик, оскільки відповідний чат може перебувати поза поточної області спостереження або не мати унікального збігу. Повторна перевірка відсутності залишається окремим спостереженням від повідомлення про видалення в підрахунках звітів, фільтрах та ярликах. Пізніше відновлення скасовує поточний стан відсутності, зберігаючи при цьому попередню невдалу перевірку в підписаній історії; повідомлення про видалення залишаються окремим типом події. Кілька ідентифікаторів, що відносяться до одного й того самого чату з одного повідомлення, групуються як `deletion.batch`, незалежно від їхньої кількості, з ідентифікаторами повідомлень саме в тому вигляді, у якому їх надіслав Telegram, та незалежно від того, скільки з них надіслав цей акаунт. У повідомленні Telegram перелічено ці повідомлення; у журналі адміністратора чату вказано ім’я адміністратора, який вжив заходів, і цей акаунт може ознайомитися з цією інформацією. Зв’язок (`message.deletion_attributed`) встановлюється залежно від того, що надійшло першим: запит, який побачив запис у журналі адміністратора до повідомлення про видалення, зіставляється, коли повідомлення записується. ## Охоплення: безперервність, прогалини та неспостережувані ідентифікатори Кожен підписаний ZIP-файл містить `coverage.json`, HTML-звіт відкривається з тим самим резюме, а `verify.py` перераховує його на основі `events.jsonl`, замість того щоб довіряти файлу: - **Безперервне спостереження від X до Y.** Період починається з `observation.started` і закінчується при паузі, зупинці, втраті з’єднання з Telegram, виході з системи, запуску процесу без послідовної зупинки або проходженні більше трьох хвилин без жодного запису під час спостереження (сигнали пульсу записуються щохвилини, тому відсутність сигналів означає, що процес зупинився, завис або комп’ютер перейшов у режим сну). Коли інтервал heartbeat змінюється в **меню Додаткові інструменти → Параметри**, кожен heartbeat фіксує це, і допустима пауза становить три інтервали, але ніколи менше трьох хвилин. - У списку **прогалин** вказано час між періодами та причину. Прогалина, яка все ще залишається відкритою на момент останнього запису, позначається як `not_resumed_by_last_record`. - **Ідентифікатори повідомлень не фіксуються.** Для каналів та супергруп, у яких повідомлення нумеруються за чатом, ідентифікатори, що відсутні між зафіксованими, вказуються у вигляді діапазонів. Вони позначаються як не*зафіксовані* — видалені, ніколи не доставлені або поза збереженою історією — ніколи як видалені. Приватні чати та звичайні групи використовують спільну послідовність для всього облікового запису, тому пропуски всередині одного такого чату нічого не означають і там не вказуються. - Повідомлення про прогалини на рівні чату (наприклад, запит Telegram щодо відновлення втрачених даних в одному каналі) враховуються як примітки; вони не переривають загального охоплення. - **Записи сеансів.** Окремо перелічуються сеанси, під час яких лічильник оновлень Telegram збільшувався, хоча жодне оновлення не надійшло до цього сеансу (`updates_diverted`), цей сеанс вийшов зі списку сеансів Telegram, хоча його з’єднання продовжувало працювати (`session_revoked_externally`), або відповідь на запит свідка надійшла лише з історії (`probe_ack_missed_live`). Верифікатор також повідомляє, звідки походить сесійний ключ Telegram, про інші сесії, що були увійшли в систему на момент початку спостереження, сесії, додані під час спостереження, повідомлення про безпеку Telegram (777000), інші сесії, завершені з робочого простору, періоди, коли була активна лише одна сесія, кількість запитів до свідка та оновлення телефонних дзвінків. Див. [облікові записи](https://phishdestroy.io/tgwitness/uk/docs/reference/accounts/#witness-probe). Коли увімкнено режим [Суворі вибрані чати](https://phishdestroy.io/tgwitness/uk/docs/reference/collection/#strict-chosen-chats) (`scope.strict` у `observation.started`), список сеансів (за винятком випадків, коли це єдиний сеанс або коли увімкнено **Пристрої Telegram**), повідомлення про безпеку та оновлення телефонних дзвінків не збираються, тому їхня відсутність нічого не означає, а видалення співвідноситься з сеансом лише в тому випадку, якщо вона відбувалася протягом 10 хвилин до цього. ### Послідовність оновлень (`pts`) Telegram повідомляє про оновлення, пов’язані з повідомленнями, за допомогою `pts`: одна послідовність для облікового запису (приватні чати та звичайні групи разом) та одна для кожного каналу або супергрупи. Колектор реєструє кожну отриману без пропусків послідовність як `coverage.sequence` запис: перший та останній `pts`, кількість оновлень кожного типу та те, чи вони були надіслані в режимі реального часу, чи повернуті `getDifference` чи `getChannelDifference`. Перерва — це `coverage.gap` запис, і `coverage.gap_closed` вказує `pts` з якого послідовність знову стає цілою. Безперервний ланцюжок показує, що кожне оновлення Telegram, пронумероване в цій послідовності між першим і останнім `pts` , надійшло до клієнта Telegram цього колекціонера. Це нічого не говорить про вміст, який Telegram ніколи не надсилав на цей обліковий запис, про час до першого зафіксованого `pts`, або про проміжки, які колекціонер не зафіксував. `pts` Проміжок, який не охоплює жоден зафіксований проміжок або різниця, відображається як розрив. `GET /api/continuity` відповіді для інтервалу (`since`, `until`, `chat_id`), чи кожна послідовність є безперервною, та перелічує розриви з зазначенням їх причин. `verify.py` виводить те саме з записів архіву в розділі **«Неперервність послідовностей**». ### Відсутні номери повідомлень (`gap_summary`) For a reader's guide to this section and to observation periods and gaps, see [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). **Попередній перегляд.** `coverage.json` → `gap_summary` Вимірює номери, присвоєні Telegram, які цей збірник даних ніколи не бачив. Telegram нумерує повідомлення один раз на канал або супергрупу, та один раз на обліковий запис у приватних чатах, ботах та звичайних групах. Номер між двома зафіксованими повідомленнями є або зафіксованим, або відсутнім; суцільний діапазон є підтвердженням того, що усі повідомлення, пронумеровані в ньому, були зафіксовані. Пропуск не вказує на жодного учасника та жодної причини. | Галузь | Значення | | --- | --- | | `status` | `on` або `off`, якщо вимкнено в **Додаткові інструменти → Параметри → Аналіз розбіжностей** | | `parameters` | Параметри, за допомогою яких було отримано результат, щоб його можна було відтворити | | `chats[]` | Один запис на канал або супергрупу, кожен із яких має власний номер | | `account` | Послідовність приватних чатів, ботів та звичайних груп у межах всього облікового запису | | `status` (за кожною послідовністю) | `applicable`, або `not_applicable` з `reason` | | `observed_from`, `observed_to`, `span` | Перший та останній номер, що спостерігався, а також розмір діапазону | | `observed`, `observed_without_content` | Спостережувані номери; ті, що відомі лише з запису про видалення або повторну перевірку | | `missing`, `density`, `gap_ranges`, `largest_gap` | Кількість, що ніколи не спостерігалася, її частка в діапазоні, кількість прогонів, найдовший прогін | | `clusters[]` | Перелік прогалин: `low`, `high`, `missing`, а також сусідні спостережувані номери `after` / `before` з часом їх спостереження | | `service_estimate` | Тільки якщо функція увімкнена: скільки відсутніх номерів могли б бути службовими повідомленнями, виходячи з їхньої частки у спостереженнях. Ніколи не віднімається від `missing` | Дійсність виводиться з журналу, її ніколи не приймають за даність: - **Канали та супергрупи** обліковуються за кожним чатом, а також під час експорту вибраних чатів. Записи, вибрані за відправником, формують дані обліку `not_applicable`. - **Послідовність для всього акаунта** вимірюється лише від першого до останнього повідомлення, яке надходило під час увімкненого режиму збору даних для всього акаунта, і включає приватні чати, боти, звичайні групи та власні повідомлення акаунта, без виключення жодного такого чату (`scope.changed`). Числа, позначені `deletion.unscoped` вважаються спостереженими без урахування вмісту. Експорт або передача вибраних чатів не дозволяє виміряти цю послідовність. Якщо збір даних з усього облікового запису було вимкнено та знову увімкнено, у примітці зазначається, що номери, використані в цей проміжок часу, відображаються як пропуски. - Сервісні повідомлення — це записи в журналі з власними номерами, тому вони самостійно заповнюють прогалини; опціональна оцінка слугує лише для контексту. `verify.py` перераховує `gap_summary` з `events.jsonl` з параметрами у підписаному `coverage.json` елемента (за замовчуванням для старих архівів) та виводить рядок для всього облікового запису у зведеній таблиці охоплення. `get_capture_status`(MCP та командний рядок) повертає однакове значення для чатів, які може переглянути користувач; послідовність для всього облікового запису — лише для доступу, що охоплює весь робочий простір. Повторні спостереження одного повідомлення служби враховуються один раз, а оцінка служби облікового запису використовує лише числа в межах вимірюваного діапазону. Застосована область дії повинна явно зберігати власні повідомлення облікового запису до того, як буде увімкнено вимірювання на рівні облікового запису; вимірювання починається з записів, що містять цю інформацію. Вимірюваний діапазон охоплює поточне спостереження, а його відновлення фіксується. Запит до архіву в режимі реального часу має часовий бюджет, включаючи сканування бази даних, і позначає незавершене вимірювання як часткове. Telegram документує [окремі послідовності ідентифікаторів повідомлень](https://core.telegram.org/api/updates#message-id-sequences). Ці номери описують спостереження; повідомлення про видалення, повторні перевірки та запис у журналі адміністратора, що пояснює, чому номер відсутній там, де Telegram його повідомляє. Коли Telegram припиняє приймати обліковий запис, запис `coverage.gap`, що завершує спостереження, містить `cause` (`account_banned`, `account_frozen`, `account_deleted`, `session_duplicated`, `session_revoked`, `session_expired`, `session_ended` або `not_authorized`) та Telegram помилку; `verify.py` вказує причину, через яку період завершується. Покриття поєднує записані періоди спостереження, переривання та результати повідомлень. Оцініть його разом із вибраними чатами, періодом та політикою щодо вкладень; повторна перевірка результатів та зафіксованих прогалин показує, наскільки повно було відстежено оновлення облікового запису. ## Виробник Підписаний маніфест ZIP-архівів з доказами, експортованих чатів, журналів свідків та файлів профілів користувачів містить `producer`: програмне забезпечення, версію, проєкт (PhishDestroy), домашню сторінку та репозиторій вихідного коду. HTML-звіт та верифікатор відображають цей підписаний запис про виробника. Хеші вихідних файлів ідентифікують записане дерево вихідного коду для порівняння з надійною версією коду. Походження виконання перевіряється окремо за допомогою [атестації придбання GitHub](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) або [вимірювань Intel TDX](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/), якщо вони увімкнені. Архіви, створені до появи поля виробник, залишаються підтримуваними та ідентифікуються як застарілі записи. Кожен запис `observation.started` також вказує клієнт Telegram, який здійснював спостереження: його `api_id` (ніколи не хеш), незалежно від того, чи це вбудована публічна пара, чи власний додаток оператора, опис клієнта, надісланий у запиті на з’єднання Telegram, та тип маршруту з’єднання з режимом IP (без проксі-адреси чи секрету). У звіті та записі `custody.json` перелічено кожного унікального клієнта та маршрут із зазначенням часу їх реєстрації, а також випадків, коли жоден із перелічених проксі-серверів не відповів, і запис Telegram зафіксував адресу сервера. Про це свідчать журнали, записані раніше. ## Профілі користувачів Файл профілю (`tgwitness-dossier-v1`, JSON) формується на запит на основі записів, що вже містяться у журналі для одного чату; нічого не отримується з Telegram, а вміст профілю ніколи не записується до журналу (увімкнення та вимкнення профілів фіксується як `dossier.changed`). Для кожної особи, повідомлення якої збережено, вказуються ім’я та історія імен користувача, позначки Telegram (бот, шахрайство, фейк, преміум, підтверджений, обмежений, видалений) станом на момент збереження, ідентифікатори профілю фото-ідентифікатори, SHA-256 та перцепційний хеш (pHash, сумісний з `imagehash.phash`) аватара з локального кешу аватарів із подібними аватарами, активність (перше та останнє повідомлення, кількість, відредаговані та видалені публікації, повідомлення за годинами за UTC), хто кому відповідає, інші чати у цьому журналі, де ця особа писала, та згадані гаманці (BTC, EVM, TRON, TON, LTC, DOGE, XMR, SOL; адреси Base58Check перевірені за контрольною сумою), номери телефонів, імена користувачів та посилання, включаючи посилання, приховані за текстом. Кожен факт містить посилання на записи журналу (`seq`), з яких він походить, а `record_hashes` містить хеш кожного запису, на який є посилання. Заява підписана ключем робочого простору: ``` python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip ``` Перевіряє підпис, перевіряє сам експорт доказів (підпис, ланцюжок хеш-кодів та файли) та наявність кожного згаданого запису без змін у цьому експорті з того самого робочого простору. Хеш-коди аватарів позначені як такі, що походять із локального кешу (а не із записів журналу). Згадки є збігами за шаблоном і підказками для перевірки. Профілі вмикаються для кожного чату окремо, можуть експортуватися у вигляді ZIP-архіву з шифруванням AES-256 та паролем, і видаляються при вимкненні або коли чат видаляється з джерел. ## Незалежний свідок Журнал свідка (`tgwitness-witness-v1`) та його публікації в каналі перевіряються на відповідність експорту доказів за допомогою `verify.py --witness … --channel …`; див. [незалежний свідок](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/). За допомогою публічної адреси `https://t.me/s/…` або `https://telegram.me/s/…` верифікатор зчитує дату кожної публікації з Telegram, а найраніша така дата публікації на початку експорту є зовнішнім часом для останнього запису. Дати з будь-якого іншого джерела є наданими метаданими. ## Маніфест та контрольні точки Файл manifest.json містить формат, час експорту, відкритий ключ, відбиток, довжину журналу, хеш заголовка, область дії, виробника, обмеження та SHA-256 кожного елемента вмісту, крім самих `manifest.json` та `manifest.sig`. manifest.sig — це підпис у форматі base64 за алгоритмом Ed25519 над канонічним маніфестом JSON. Верифікатор відхиляє несподівані/відсутні елементи, дублікати імен, пошкоджені файли, порушену послідовність/ланцюг, недійсні підписи та невідповідність наданій контрольній точці. Він ніколи не витягує шляхи до архівів. Він обмежує загальний заявлений розмір у нестисненому вигляді до 4 ГіБ; `--max-gib N` дозволяє створювати більші архіви за допомогою підвищеного обмеження в розділі **Більше інструментів → Параметри**. Великий архів перевіряється одночасно кількома процесами: елементи архіву хешуються паралельно, а після перших 5 000 записів хеш вмісту та підпис кожного запису перевіряються робочими процесами, тоді як головний процес послідовно відстежує ланцюжок, охоплення та зв’язки . `--jobs N` встановлює кількість процесів; за замовчуванням `auto` використовує по одному на кожен процесор, максимум 16, а `--jobs 1` зберігає все в одному процесі. Результат однаковий у обох випадках, а зміна відхиляється з однаковим повідомленням. Хеші у позиціях, зазначених збереженими контрольними точками та анкерами часових міток, зберігаються протягом цього єдиного проходу, тому кожен анкер порівнюється без повторного читання журналу. На комп’ютері з 32 потоками обробка архіву розміром 10,8 ГБ із 400 000 записів зайняла 58,9 с в одному процесі, 15,2 с — у 4 процесах і 8,4 с — у 16; один прохід по записах у порядку їхнього розташування встановлює межу. Виконайте перевірку з вашої встановленої версії TgWitness або перевіреної версії. Копія, що міститься в архіві, підтримує переносне використання; порівняйте цю копію з вашою довірчою інсталяцією перед її запуском. Контрольна точка підписує заяву, що містить відкритий ключ, довжину журналу, хеш заголовка та час створення. Вона також містить найновіший раунд drand, який робоча область отримала (`drand_anchor` ): колектор запитує ретранслятор drand через зовнішній маршрут робочої області перед кожною періодичною контрольною точкою, тому застосовуються Hide IP, проксі-сервери та вимкнений зовнішній маршрут, і сама контрольна точка ніколи не встановлює з’єднання ззовні. Верифікатор може перевірити, чи містить пізніший архів той самий префікс. За допомогою `--checkpoint` та `--check-drand` він підтверджує цей раунд із ретрансляторами drand і повідомляє, що контрольна точка була підписана не раніше, ніж час раунду; раунд не змінює рівень гарантії. Зберігайте контрольну точку поза колектором, щоб під час подальшої верифікації архів порівнювався з еталоном, що зберігається окремо від нього. Ключ колектора підписує його, тому він пов’язує записи з ним лише в тому випадку, якщо одержувач отримав його до архіву через інший канал; сам по собі він не відповідає мінімальним вимогам щодо доказів. ## Читання результату верифікації Верифікатор окремо повідомляє про цілісність архіву, прив’язку підписувача та перевірки достовірності. Дійсний підпис свідчить про те, що байти не зазнали змін з моменту їх підписання. Оператор передає відбиток ключа одержувачу через окремий канал. Без `--fingerprint`цілісний архів успішно проходить перевірки підпису та формату , `signer_pinned: false`, а остання рядок починається з `EVIDENCE: minimum not met · missing: confirmed signer key`. Для автоматизованої політики локального архівування, яка вимагає закріпленого підписувача та мінімального обсягу доказів: ``` python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence ``` Використовуйте відбиток, збережений через довірений канал одержувача. Довірений свідок також може закріпити колектор за допомогою узгодженого журналу зі свідченням; вкажіть параметри `--witness`, `--witness-fingerprint` та `--require-witness`. Параметр `--strict` завершує роботу зі статусом 2 у разі незакріпленого підписувача; невиконання вимог `--require-tier` або `--require evidence` також призводить до завершення роботи зі статусом 2. Параметр `--require evidence` вимагає наявності `--fingerprint` та зовнішнього часу від сторонньої сторони, що охоплює останній запис. Слід зважати на `signer_pinned`, `requirements_met` та результати перевірки достовірності, а не лише на код завершення. Натомість [Sealed Acquisition](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md#sealed-evidence) використовує свій верифікатор засвідчення та затверджену політику для автентифікації дайджесту придбання. ## Обсяг перевірки Перевірка стосується архіву та режиму збору даних, який використовувався для його створення. Оберіть режим, межа довіри якого відповідає конкретному випадку, а потім збережіть його вхідні дані для перевірки. | Режим збору даних | Що перевіряє верифікатор | Вхідні дані для верифікації та межа довіри | | --- | --- | --- | | Локальна робоча область | Запишіть підписи, ланцюжок хеш-кодів, маніфест та байти вкладень | Відбиток колектора, збережений одержувачем, та зовнішній час від третьої сторони: перевірені квитанції за стандартом RFC 3161 або OpenTimestamps, або публікації свідків, прочитані з t.me. Збережені контрольні точки та записи свідків слугують підтвердженням перевірок | | Локальна робоча область із незалежним свідком | Перевірка архіву та відповідність префіксу попереднього журналу, збереженого свідком | Відбиток і записи свідка; запис зберігача про контроль над ключем показує, у кого перебуває ключ свідка. З `--channel https://t.me/s/…` дати, які Telegram проставив на дописах, дають зовнішній час | | [Запис дій у GitHub Actions](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | Підтвердження на GitHub дайджесту архіву, затвердженого робочого процесу та комітів колектора, розміщеного запуску, нового походження сесії/ключа та цілісності внутрішнього архіву | Політика довіреного верифікатора, репозиторій викликів та пакет атестації GitHub; збір даних відбувається в рамках закріпленого робочого процесу | | [Розгортання у хмарі](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/) | Записи про життєвий цикл та доступ провайдера, стан брандмауера та Cloudflare, а також підписаний запис про роботу колектора | Запити до провайдера та Cloudflare лише для читання; доступність окремих перевірок залежить від провайдера | | [Конфіденційна віртуальна машина Intel TDX](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) | Вказати підпис та стан платформи, прив’язати до заяви збирача, скласти та вимірювання ОС | Ланцюг довіри Intel та очікувані показники розгортання; зберегти результати кожної необхідної перевірки TDX | Під час запечатаного збору затверджений збирач отримує дані через аутентифіковане з’єднання Telegram у перевіреному середовищі. Атестація пов’язує архів із цим виконанням, тому перевірка охоплює як сам збір, так і подальшу цілісність файлів. Це базується на затвердженому коді та ланцюжку довіри платформи, перелічених вище. Перевірка збору даних на GitHub вимагає сеансу, створеного в межах запуску, і відхиляє збори даних з імпортованих сеансів. У квитанції про запуск фіксуються версія колектора, хеші файлів та параметри запуску. Дані про походження з GitHub та вимірювання TDX забезпечують перевірку середовища; запис валідації ідентифікує протестовані конфігурації. ### Звідки надходять повідомлення Telegram доставляє повідомлення кожному клієнту, включаючи офіційні додатки, у межах сеансу MTProto. Ключ авторизації сеансу узгоджується з зафіксованим серверним ключем Telegram, і кожне оновлення надходить у зашифрованому вигляді та перевіряється на цілісність за допомогою цього ключа. Колектор отримує повідомлення через аутентифікований сеанс облікового запису та підписує кожне спостереження в журналі одразу після його надходження, вказуючи ідентифікатори чату, повідомлення та відправника, а також дату, встановлену Telegram для кожного повідомлення. У GitHub Actions та розгортаннях Intel TDX засвідчення також пов’язує цю сесію та ключ підпису з затвердженим запуском колектора. Журнал фіксує, звідки походить ключ авторизації. Увійти за допомогою телефону або QR-коду, або незалежний вхід із файлу сеансу записує `account.authorized` із `key_origin: "created"`; збір даних за імпортованим ключем `.session`, TData або JSON записує `imported`. Імпортований ключ також існує незалежно від того, звідки він походить. Засвідчені розгортання відхиляють імпортовані ключі. Походження запису в Telegram ґрунтується на автентифікованому з’єднанні облікового запису, записах про з’єднання та фіксацію в журналі, зафіксованих кадрах MTProto, що відповідають записам у журналі ([`tgwitness/forensics/`](https://github.com/phishdestroy/TgWitness/tree/main/tgwitness/forensics)), даті Telegram кожного повідомлення та, у разі засвідченої фіксації, перевіреному середовищі виконання. Архівні підписи зберігають цей запис для подальшої перевірки. Збережені контрольні точки фіксують попередні межі журналу, записи про охоплення показують результати збору, а перевірені зовнішні часові мітки фіксують момент запису байтів у часі. Для локального робочого простору одержувач надає вхідні дані від довіреного колектора або свідка. Для запечатаного збору даних довірена політика та засвідчення пов’язують дайджест архіву з затвердженим виконанням колектора. Це різні шляхи верифікації; повідомте про перевірки, виконані для обраного шляху. ## Вкладення Файли ідентифікуються за допомогою SHA-256 у каталозі media/. Подія media.saved пов’язує хеш та довжину у байтах із конкретною подією повідомлення. Необроблені імена файлів є метаданими, а не локальними шляхами. Байти мультимедіа завантажуються асинхронно, тому негайне видалення може перешкодити їхньому збереженню. У результатах відображаються випадки вимкненого збору, файли надмірного розміру або невідомого розміру, помилки завантаження та перервані завантаження. Збій процесу може залишити неповні файли без посилань; вони не включаються в експортні дані. Експортер у форматі ZIP перевіряє збережені медіафайли на відповідність їхнім іменам. Експорт у форматах JSONL, CSV та HTML перевіряє сигнатури подій, але не передає байти медіафайлів. Похідні звіти є допоміжними; файл events.jsonl є авторитетним представленням подій. Повний експорт чату зберігає вкладення відповідно до налаштувань робочого простору у папці media/, присвоюючи їм імена у форматі SHA-256. Кожен запис повідомлення у файлі chat.json містить назву файлу (`file`, `file_sha256`) або причину його відсутності (`file_status`), а також те, що бачив читач навколо тексту: посилання за текстом, джерело пересилання, кнопки ботів, підпис, перегляди та таймер автоматичного видалення. Файл `verify.py` перевіряє, чи кожен названий файл міститься у підписаному маніфесті під цим хешем. ## Довготривале збирання та обробка квитанцій (0.2) Медіа-завдання та фіксація події повідомлення відбуваються в одній транзакції. Завдання зберігає оригінальний дескриптор повідомлення TL; підписане спостереження пов’язує його SHA-256, обліковий запис та політику розміру. Функція відновлення перевіряє цю прив’язку перед завантаженням. Вона ніколи не завантажує поточне повідомлення і непомітно замінює його на новіше вкладення. Перервані завдання повторюються, тоді як постійна помилка залишається явним результатом. Кожна робоча область має власний журнал та ідентифікатор підпису. Подія process.started містить ідентифікатор запуску, час за локальним годинником, версії залежностей, хеші вихідних файлів, початковий обліковий запис/область дії, а також налаштування збору даних. Імпульси містять ідентифікатор запуску, монотонний час та стан черги. Квитанцію про виконання також можна завантажити як окремо підписану заяву. Для перевірки середовища виконання поєднайте її з атестацією GitHub або перевірками TDX, описаними у розділі «[Перевірка сфери дії](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#verification-scope)». Автоматичні контрольні точки зберігаються локально під час запуску, кожні п’ять хвилин під час спостереження (**Більше інструментів → Параметри → Підписана контрольна точка кожні**) та під час упорядкованого зупинення. Перевірка під час запуску та експорт порівнюють журнал з останньою збереженою локальною контрольною точкою. Це дозволяє виявити відкат бази даних, якщо контрольна точка збереглася. Незалежне зберігання забезпечує доступність цього посилання поза робочою областю; перевірена зовнішня мітка часу додатково закріплює його в часі. Після перезапуску відновлюється збережена позиція оновлення Telegram (`catch_up_from` в `observation.started`) та запитуються пропущені оновлення. Збережена позиція охоплює лише ті оновлення, обробка яких завершилася, тому оновлення, що все ще очікували на обробку на момент розриву з’єднання або зупинки процесу, запитуються знову. Періодична повторна перевірка фіксує `message.recovered` на наявність пропущених повідомлень та `message.missing_on_recheck` коли Telegram більше не повертає збережене повідомлення; останнє не є повідомленням про видалення і не вказує ні того, хто видалив, ні часу. ### Зовнішнє копіювання та відновлення (S3) Зовнішня копія (**Налаштування → Повідомлення та зовнішня копія → Зовнішня копія**, або **Більше інструментів → Додаткові функції → Докази та резервні копії**; за замовчуванням вимкнено) завантажує сегменти журналу, збережені файли, контрольні точки з їхніми часовими мітками та готові експортовані чати до сховища, сумісного з S3, зашифровані за допомогою AES-256-GCM перед завантаженням за допомогою ключа, що зберігається у сховищі робочого простору; застосовується функція збереження Object Lock, якщо контейнер її підтримує. Без завантаженого ключа копію неможливо прочитати. Відновлення та перевірка за допомогою команди `python -m tgwitness.replica restore --key-file KEY.json --out DIR`. Для відновлення потрібен порожній звичайний каталог. Завантажені та розшифровані об’єкти залишаються у приватному тимчасовому сховищі, доки не буде перевірено весь журнал та кожну збережену контрольну точку. Небезпечні шляхи до об’єктів, непослідовні діапазони сегментів та журнали, коротші за контрольну точку, відхиляються; у разі невдалої перевірки відновлені файли не публікуються. Перевірки збереження порівнюють повернутий режим Object Lock та дату з кінцевим терміном, надісланим під час завантаження (допуск на округлення — одна секунда). Термін, що минув, недійсний або скорочений, не вважається перевіреним. Статус повідомляє про об’єкт, з якого взято зразок, збереження якого було зчитано для цього циклу завантаження. Відсутність або пошкодження локальних носіїв фіксується як помилка циклу і курсор залишається перед цим місцем, щоб файл було перепробувано під час наступного циклу; файли, контрольні точки та експортовані дані, що йдуть за ним, все одно копіюються. Під час відновлення перевіряються всі посилання на збережені носії на відповідність розшифрованим хешам та записаним розмірам. Ідентичні перекриваючі сегменти журналу від перерваних завантажень дублюються; конфліктні перекриття відхиляються. Контрольні точки, створені під час завантаження, відкладаються доти, доки відповідні записи журналу не будуть скопійовані, тому завершений прохід не публікує контрольну точку раніше, ніж відповідний запис у журналі. ### Потокове експортування знімків екрана Експорт у режимі потокової передачі використовує стабільний знімок для читання SQLite. Його початок може бути старішим за поточний активний журнал на момент завершення завантаження. Контрольна точка, створена після цього знімка, може правильно вказувати, що архів є коротшим; порівнюйте з контрольною точкою на рівні або перед експортованим префіксом, а не з довільною пізнішою контрольною точкою. ## Підготовка RFC 3161 та перевірка відповідей (0.2) У режимі «Evidence» до перелічених авторитетів RFC 3161 та календарів OpenTimestamps надсилається лише SHA-256-хаш кожної підписаної контрольної точки через маршрут робочого простору, але ніколи через MTProxy. Функція «Timestamps» увімкнена за замовчуванням у кожній меті налаштування; **у режимі Evidence для кожної справи** також фіксується drand. Відповіді зберігаються у `checkpoints/anchors/`, експортуються як `.tsr` та `.ots` файли в папці `anchors/`, а також перевіряються `verify.py` (`--tsa-ca` перевіряє підпис TSA; підтверджує докази OpenTimestamps за допомогою `ots upgrade` та `ots verify`). Служба міток часу RFC 3161, яка двічі поспіль не відповіла, чекає перед наступною спробою: один інтервал, потім два, чотири і так далі до шести годин або стільки, скільки просить її `Retry-After`, але не більше доби. Прохід, у якому залишилися лише служби, що очікують, запису не створює; інакше `anchor.completed` перелічує їх у `deferred` з `retry_at`. Доки вони знову не відповідять, панель показує мітки часу у стані **Деградація**. Панель готує архів запитів, що містить канонічні байти checkpoint.json, відбиток повідомлення SHA-256 та випадковий нонс у файлі timestamp.tsq, контрольні суми та інструкції. Мережеві запити не надсилаються; міткою часу є токен, який служба міток часу поверне на цей запит. `python -m tgwitness.anchor verify` звіряє відповідь із байтами контрольної точки та початковим запитом без OpenSSL. Файл довіреного CA потрібно вказати явно; вкладені сертифікати автоматично довіреними не вважаються. У CLI перевірка запиту необов’язкова, тому збережіть запит і передайте --request, щоб перевірити nonce. У результаті зазначено, чи виконувалася ця перевірка. Підпис контрольної точки колектора та журнал однаково треба окремо перевірити за довіреним відбитком колектора. Верифікація перевіряє підпис відповіді, байти контрольної точки та, якщо надано, оригінальний запит у рамках зазначеного довірчого центру (CA). Для часових міток, отриманих у режимі доказів, `verify.py` також перевіряє збережені докази OCSP або CRL ([скасування сертифіката підпису](https://phishdestroy.io/tgwitness/uk/docs/reference/timestamp/#signing-certificate-revocation)). Дивіться [процедуру](https://phishdestroy.io/tgwitness/uk/docs/reference/timestamp/) та [результати валідації](https://phishdestroy.io/tgwitness/uk/docs/reference/verification/). ## Необов’язкові записи в режимі доказів: пристрої drand та Telegram Ще два записи можуть виконуватися в тих самих циклах, що й мітки часу. Обидва діють лише тоді, коли увімкнено режим доказів. **Наявність доказів у справі** вмикає drand; в іншому разі обидва записи спочатку вимкнені. Перемикайте їх у меню «Додаткові інструменти» → «Додаткові функції» → «Докази та резервні копії» → **Більше свідків · за бажанням**, або `"drand": true` та `"devices": true` у `POST /api/evidence`. Збій в роботі одного з них не зупиняє роботу іншого або міток часу; панель показує найновіший результат кожного з них під формою. **drand** (`beacon.drand` ). Кожен прохід записує найновіший раунд drand quicknet, публічну випадковість «Ліги ентропії» (один раунд кожні 3 секунди), у журнал: `chain` , `round` , `randomness` , `signature` , `round_time` та `relay` , що відповіла. Перевірений непередбачуваний раунд забезпечує нижню часову відмітку для наступного матеріалу, пов’язаного хешем. Перевірена часова мітка на пізнішому контрольному пункті забезпечує верхню часову відмітку. Ці перевірки обмежують пов’язаний матеріал. Збирач спочатку звертається до `drand.cloudflare.com` , а потім до ретрансляторів Protocol Labs через маршрут робочого простору, по одному запиту на прохід. `verify.py` перевіряє, чи кожна випадкова величина є SHA-256 свого підпису та чи правильний час раунду, а також повідомляє про раунди, найдовший проміжок часу без раунду та наскільки годинник колектора відставав від drand. `--check-drand` порівнює раунди з ретранслятором Cloudflare та ретранслятором Protocol Labs — усіма ними або випадковою вибіркою зі 100 у довгому журналі; раунд, що відрізняється, не проходить перевірку. Пристрої **, Telegram,** (`account.devices`). Кожен цикл зчитує сесії облікового запису з `account.getAuthorizations`, список Telegram відображається в меню «Налаштування» → «Пристрої», і записує їх: повністю, якщо він змінився з моменту попереднього проходу, із хешами сеансів `added` та `removed`, в іншому випадку — лише його кількість та SHA-256. Зберігаються модель пристрою, платформа, додаток та версія, час створення та останньої активності, країна та регіон; IP-адреси не зберігаються, оскільки експорт доказів виходить за межі вашого контролю. Власна сесія колектора активна постійно, тому як зміна враховується лише активність інших сесій. `verify.py` повідомляє, як часто список записувався, а також про кожну нову та завершену сесію. Він зчитує список лише під час роботи спостереження. Що вони показують: drand упорядковує записи за публічним часом, а список пристроїв — це заява Telegram через колектор, підписана колектором, як і кожен інший запис. **Журнал Cloudflare Gateway** (`cloudflare.gateway_dns`). Для сервера, який здійснює вирішення через Cloudflare Gateway ([Gateway DNS](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/#cloudflare-as-an-outside-witness)), кожен цикл копіює те, що Gateway записав у журнал з моменту попереднього копіювання: один запис на вікно тривалістю не більше трьох годин із `from`, `until`, `location_id`, `address` сервера, якщо він встановлений, та `queries` як `[at, name, type, rcode, decision, colo]`, навіть якщо їх не було. Налаштуйте це в **«Журнал шлюзу Cloudflare»**: обліковий запис, місцезнаходження, опціональна адреса та токен тільки для читання (Account Analytics Read; Zero Trust PII Read для збереження однієї адреси спільного розташування). Панель перевіряє їх одним запитом перед збереженням; токен залишається зашифрованим і ніколи не потрапляє до журналу. `verify.py` перелічує вікна, найчастіше шукані імена та будь-який час, який не охоплює жодна копія; запис, кількість запитів якого не збігається з кількістю запитів, вважається невдалим. Вікно, яке містить більше ніж одну сторінку запитів за одну секунду, зберігає цю сторінку і вказує, що решта відсутня. Копія — це відповідь Cloudflare через колектор, підписана колектором; протягом 24 годин будь-хто, хто має токен лише для читання, може порівняти її з даними Cloudflare. --- # Telegram · Переклад звітів для суду Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/translation/ Який файл є оригіналом, що подавати разом із завіреним перекладом і які терміни зберігають перекладачі. [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/evidence/) ![Докази та верифікація](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness готує звіти 25 мовами. Оригінальною мовою є англійська. Інші мови — це машинні переклади, деякі з яких пройшли термінологічну перевірку; вони допомагають оператору ознайомитися зі звітом і не є завіреними перекладами. ## Що подавати Подайте оригінал англійською мовою разом із завіреним або присяжним перекладом на мову суду. Присяжний перекладач знає місцеву термінологію та формальні вимоги до судових документів. Якщо мова звіту не є англійською, архівні файли з доказами, чатом та матеріалами передачі справи також містять англійський оригінал цього звіту: `report.en.html` та `report.en.pdf`, або `chat.en.html` та `chat.en.pdf` для експорту чату. Вони зашифровані та підписані тим самим ключем, що й звіт на обраній мові, і вказані разом із їхнім SHA-256 у підписаному маніфесті, де вони зазначені під `report.original`. Звіт, експортований англійською мовою, сам по собі є оригіналом. Звіт на обраній мові відкривається з тією самою рекомендацією та вказує на англійський файл. Перед перекладом порівняйте оригінал із версією в архіві: ``` python -m tgwitness.verify report.en.html --fingerprint KEY --evidence tgwitness-evidence.zip ``` `README.txt` у кожному архіві закінчується на **Для перекладачів** розділ, у якому вказано назви вихідних файлів та наведено наведені нижче терміни. Цей [наратив та експертний протокол](https://github.com/phishdestroy/TgWitness/blob/main/docs/NARRATIVE.md) надрукувати ту саму рекомендацію. ## Що залишається буквальним - Імена файлів, команди, хеші, відбитки ключів, ідентифікатори Telegram, номери повідомлень та URL-адреси. - Час: UTC у форматі ISO 8601, як зазначено. Не перераховуйте його у місцевий часовий пояс. - Перехоплені повідомлення: наводьте їх мовою оригіналу та подавайте переклад окремо, позначивши його як переклад. ## Умови | Термін | Значення | Не слід перекладати як | | --- | --- | --- | | журнал | Підписана послідовність записів, з’єднаних хеш-ланцюгом, що зберігається колектором | Щоденник, періодичне видання, журнал | | запис | Один запис у щоденнику з підписом; використовуйте для нього одне слово протягом усього тексту | Примітка, стаття | | спостереження | Що колекціонер отримав у зазначений час | Висновок щодо достовірності змісту | | колекціонер | Процес TgWitness, який здійснював спостереження через особистий акаунт оператора в Telegram | Збір предметів | | збір даних | Отримання та реєстрація оновлень із Telegram | Збірка, набір, компіляція | | повідомлення про видалення | Повідомлення Telegram про те, що повідомлення було видалено; у ньому не вказано, хто його видалив | Підтверджене видалення, здійснене зазначеною особою | | відсутнє при повторній перевірці | Telegram більше не повертав повідомлення при повторній перевірці: воно було видалено або більше не було видиме для цього облікового запису | Видалено | | відсутній номер повідомлення | Номер, щодо якого в експорті немає жодних повідомлень: його було видалено раніше або він ніколи не відображався для цього облікового запису | Зникле повідомлення, втрачене повідомлення | | прогалина | Період без спостереження | Докази того, що нічого не сталося | | попередня версія | Текст до редагування; обидві версії зберігаються | Виправлення, фальсифікація | | контрольний пункт | Підписаний звіт про журнал за період до рекордної кількості | Контрольна точка у фізичному сенсі | | служба маркування часу (TSA) | Незалежна служба маркування часу відповідно до стандарту RFC 3161 | Орган влади, державний орган, центр сертифікації | | квитанція з позначкою часу | Відповідь служби часових міток або квитанція OpenTimestamps, що підтверджує існування контрольної точки на певний момент часу | Докази, підтвердження фактів | | печатка | Підпис Ed25519, вбудований у файл звіту | Печатка посадової особи | | відбиток ключа підпису | SHA-256 відкритого ключа, отриманого через окремий надійний канал | Біометричний відбиток пальця | | свідок | Незалежна сторона або служба, яка веде облік або підтверджує контрольні точки | Особа, яка дає свідчення в суді | | витяг із протоколу передачі | Фрагмент щоденника, підготовленого для іншої сторони, з мінімальним використанням даних інших осіб | Повний експорт | | зведений до мінімуму запис | Запис, у якому поля, що не розкриваються, мають імена та замінюються їхніми хешами | Видалений або відредагований запис | --- # Telegram · Незалежний свідок Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/witness/ Запустіть «witness» із власним ключем та ботом, опублікуйте підписані контрольні точки в каналі та звіряйте експортовані дані з ними. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Запустіть «witness» із власним ключем та ботом, опублікуйте підписані контрольні точки в каналі та звіряйте експортовані дані з ними. [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/evidence/) ![Докази та верифікація](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) [Експорт та перевірка](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/) · [Високий рівень надійності](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/) · [Посібник з панелей](https://phishdestroy.io/tgwitness/uk/docs/reference/panel/#extras) Свідок зберігає підписані контрольні точки окремо від колектора. Він перевіряє підпис колектора та безперервність журналу, підписує результат своїм власним ключем і публікує його в каналі Telegram. Запускайте його на окремому сервері з доступом тільки для читання до кінцевої точки свідка колектора. Технічний результат містить збережені префікси журналу, відповіді на запити, перевірки підписів, перевірки включення та узгодженості Merkle і підписані результати безперервності. Для свідка, яким керує інший зберігач, збережіть відомості про зберігача та запис про контроль над ключем разом із його відбитком. Окремі ключі та окреме зберігання описують різні частини схеми. Верифікатор повідомляє, що другий ключ зберіг голову журналу, і до якого запису; запис зберігача про контроль над ключем показує, у кого перебуває цей ключ. Журнал свідка — допоміжна перевірка; мінімум для доказу — сторонній час. Дописи в каналі додають зовнішній час: Telegram датує кожен публічний допис, і верифікатор сам зчитує ці дати. Блок-схема · Колектор → Свідок (підписаний контрольний пункт: кількість записів + хеш заголовка); Свідок → Журнал Witness, власний ключ; Свідок → Канал у Telegram (підписаний допис через власного бота); ЗIP-архів доказів → verify.py; Журнал Witness, власний ключ → verify.py; Канал у Telegram → verify.py (t.me/s — читання сторінки в режимі реального часу або експорт на робочий стіл) · Колектор · Свідок · Журнал Witness, власнийключ · Канал у Telegram · ЗIP-архів доказів · verify.py · підписаний контрольний · пункт: кількість записів + · хеш заголовка · підписаний допис через · власного бота · t.me/s — читання сторінки в · режимі реального часу або · експорт на робочий стіл **Діаграма у вигляді тексту** 1. Колектор → Свідок (підписаний контрольний пункт: кількість записів + хеш заголовка) 2. Свідок → Журнал Witness, власний ключ 3. Свідок → Канал у Telegram (підписаний допис через власного бота) 4. ЗIP-архів доказів → verify.py 5. Журнал Witness, власний ключ → verify.py 6. Канал у Telegram → verify.py (t.me/s — читання сторінки в режимі реального часу або експорт на робочий стіл) **На цій сторінці** - [Що зберігає свідок](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/#what-the-witness-holds) - [Що перевіряється та фіксується](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/#what-it-checks-and-records) - [Запустити свідка](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/#run-a-witness) - [Публічна сторінка доказів для декількох робочих просторів](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/#public-proof-page-for-several-workspaces) - [Перевірити](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/#verify) ## Що зберігає свідок | Свідок має | Свідок ніколи не має | | --- | --- | | **Токен-свідок,** доступний лише для читання, для одного робочого простору | Сесія Telegram користувача-збирача або облікові дані API | | Власний ключ Ed25519 та журнал | Сховище колектора, ключ підпису або токен панелі | | Власний токен бота Telegram | Зміст повідомлення: у заголовку вказано кількість записів та хеш | Токен створюється в розділі **Додаткові інструменти → Екстра → Незалежний свідок**, відображається один раз і зберігається лише у вигляді SHA-256. Він відкриває саме одну кінцеву точку, `GET /api/witness/head`, яка повертає щойно підписаний контрольний пункт, а також підписані лічильники колекцій без вмісту та інформацію про працездатність системи. Він не може відкрити панель, читати вміст повідомлень або змінювати налаштування, а токен панелі там не приймається. Скасувати токен можна на тій самій сторінці. Колектор фіксує, коли новий ключ свідка починає перевірку (`witness.seen`), і показує останню перевірку для кожного токена; свідок, який не перевірявся протягом 2.5 інтервалів, позначається як прострочений. Нові свідки надсилають випадковий виклик під час кожного опитування; запис про фіксацію повторює його під підписом збирача. Лічильники прив’язані до конкретної контрольної точки та включаються до підписаних повідомлень свідків. Старі заголовки залишаються прийнятними для автономного свідка. Сам по собі приріст журналу ніколи не вважається новим повідомленням. ## Що перевіряється та фіксується Кожного інтервалу (за замовчуванням — кожні 10 хвилин) TgWitness: 1. завантажує сам заголовок (колектор не може його додавати або пропускати); 2. перевіряє підпис колектора, закріплений ключ колектора (`--collector-fingerprint`, або перший виявлений ключ), неспадаючий лічильник та незмінну головку при незмінному лічильнику. Докази включення та узгодженості за алгоритмом Меркла підтверджують, що зростаючий журнал продовжує збережену контрольну точку. Після використання доказів безперервності їх видалення відхиляється; 3. додає підписаний запис до власного журналу: `witness.anchor` зі статусом `ok`, `key_changed`, `rollback` (менше записів, ніж раніше), `fork` (така сама довжина, інший заголовок) або `invalid` (відповідь не пройшла перевірку), або `witness.no_response`, коли колектор не відповів; 4. публікує результат у каналі, підписаний, включаючи «немає відповіді», поки TgWitness працює та має доступ до Bot API. Ідентифікатор публікації записується (`witness.posted`), так само як і невдала публікація (`witness.post_failed`). Публікація виглядає так; в останньому рядку міститься підписана заява: ``` TgWitness witness #42 · journal head Collector 3fa9c2d1e0b4a7f6: 18234 records Head 9b1f…c07e 2026-10-28T19:40:00.123+00:00 TGW1.eyJhdCI6…. ``` ## Запустити Witness Вам знадобиться бот Telegram (створіть його за допомогою @BotFather), канал, де цей бот є адміністратором, а також адреса колектора, доступна для свідка — через HTTPS поза приватною мережею (див. профіль HTTPS у [розділі «Розгортання»](https://phishdestroy.io/tgwitness/uk/docs/reference/deployment/)). У панелі відкрийте **Більше інструментів → Додатково → Незалежний свідок → Налаштувати** . Три кроки охоплюють доступ тільки для читання, ваш канал та інтервал, а потім запуск свідка. Політика публікації, опціональний проксі HTTP/SOCKS5 та власна адреса Bot API знаходяться в розділі **Додаткові налаштування** . Форма завантажує файл `witness.json` із закріпленим ключем колектора цієї робочої області. Завантажте щойно створений токен тільки для читання, вибравши **«Зберегти файл доступу** як» `witness-token.txt` ; розмістіть його та файл `bot-token.txt` , створений на хості свідка, поруч із цим JSON-файлом. Колектор ніколи не отримує токен бота. Завантаження не запускає службу та не публікує повідомлення. Жоден свідок розміщеного проєкту не реєструється неявно. ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json python -m tgwitness.witness fingerprint --config witness.json ``` Перша команда перевіряє файли конфігурації та секретні файли без мережевих запитів або створення ключів. Шляхи у JSON є відносними до цього файлу; шляхи CLI/середовища є відносними до робочого каталогу. Зберігайте відбиток свідка поза межами його хоста. Індикатор останнього опитування колектора лише підтверджує запит; про публікацію повідомляється через Proof або перевіряється у журналі свідка та на каналі. Якщо панель знаходиться за SSH-тунелем, відкрийте доступ лише до обмеженої кінцевої точки Witness на окремому HTTPS-хості за [цим прикладом використання Caddy](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.witness.example). Робоча область за замовчуванням використовує `https://witness.example.org`, інші робочі області — `https://witness.example.org/profiles/ID`. Токени все ще потрібні; панель та її інші маршрути API не переадресовуються цим віртуальним хостом. Виберіть `all` для регулярно опублікованих контрольних точок. П’ятихвилинний інтервал означає приблизно 288 публікацій на робочу область на день. `changes`/`problems` навмисно залишають деякі перевірки неопублікованими. MTProxy призначений для клієнта Telegram, що виконує збір даних. HTTP-опитування Witness та HTTPS-інтерфейс Telegram Bot API використовують власні маршрути: прямий/HTTP/SOCKS5 ([Bot API](https://core.telegram.org/bots/api)). **Поряд із колектором, з використанням Docker** (той самий хост — незалежний процес і ключ, але той самий оператор): введіть значення в поле «`.env`» і запустіть профіль. ``` TGWITNESS_WITNESS_TOKEN=tgww_... TGWITNESS_WITNESS_BOT_TOKEN=123456:ABC... TGWITNESS_WITNESS_CHANNEL=@your_witness_channel # another workspace: TGWITNESS_WITNESS_COLLECTOR=http://tgwitness:8787/profiles/ docker compose --profile witness up -d docker compose logs witness # prints the witness key fingerprint ``` При використанні опублікованого зображення вказуйте код `docker compose --project-directory . -f deploy/compose/compose.image.yaml --profile witness up -d`. **На чужому сервері** (окреме зберігання): скопіюйте туди репозиторій, встановіть `TGWITNESS_WITNESS_COLLECTOR=https://your-collector.example.org` та три наведені вище значення у файлі `.env`, а потім ``` docker compose --project-directory . -f deploy/compose/compose.witness.yaml up -d ``` або без Docker: ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --bot-token-file bot-token.txt --channel @your_witness_channel ``` ### Опублікувати в Discord Свідок може публікувати повідомлення в каналі Discord замість Telegram. У Discord відкрийте **«Редагувати канал» → «Інтеграції» → «Вебхуки»**, створіть вебхук і скопіюйте його URL-адресу. У панелі на кроці 2 виберіть **«Вебхук Discord» · ваш канал**. На хості свідка збережіть URL-адресу як `discord-webhook.txt` поруч із `witness.json`; вона ніколи не надходить до збирача. ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --discord-webhook-file discord-webhook.txt ``` Свідок має одного видавця: канал Telegram або веб-хук Discord, але не обидва одночасно. Пости містять однакове підписане твердження і не можуть надсилати сповіщення нікому. Пост, довжина якого перевищує 2,000 символів у Discord, замінюється коротким рядком із повним перевіреним файлом, прикріпленим як `witness-check.txt` . Кожен ідентифікатор поста записується як `witness.posted` . `verify.py --channel` зчитує лише канали Telegram, тому для Discord слід вести журнал свідка: він містить усі перевірки. Пости Discord не надають верифікатору зовнішнього часу. ### Параметри | Варіант | Середовище | За замовчуванням | Значення | | --- | --- | --- | --- | | `--interval` | `TGWITNESS_WITNESS_INTERVAL` | 10 | Інтервал між перевірками: 1–1440 | | `--timeout` | `_TIMEOUT` | 30 | Час очікування на роботу колектора та Bot API: 5–600 секунд | | `--post` | `_POST` | `all` | `all`: все гаразд; `changes`: нова проблема; `problems`: лише проблеми та відсутні відповіді | | `--title` | `_TITLE` | `TgWitness witness` | Перші слова кожного допису в каналі | | `--collector-fingerprint` | `_COLLECTOR_FINGERPRINT` | – | Збережіть ключ колектора, замість того щоб покладатися на першу відповідь | | `--proxy` | `_PROXY` | прямий | `socks5://host:port` або `http://host:port` | | `--bot-api` | `_BOT_API` | `https://api.telegram.org` | Адреса API-інтерфейсу бота, наприклад, локальний сервер API-інтерфейсу бота | | `--data-dir` | `_DATA` | `witness-data` | Ключ Witness та журнал | | `--config` | `_CONFIG` | – | Файл JSON із будь-яким із наведених вище варіантів | Адреса колектора, токени та канал беруться з `--collector`, `--token` або `--token-file`, `--bot-token` або `--bot-token-file`, `--discord-webhook-file` та `--channel`, або `_COLLECTOR`, `_TOKEN`, `_TOKEN_FILE`, `_BOT_TOKEN`, `_BOT_TOKEN_FILE`, `_DISCORD_WEBHOOK_FILE` та `_CHANNEL`, що не дозволяє секретам потрапляти до списку процесів. У файлі конфігурації використовуються назви опцій з підкресленнями, а також `texts`, який замінює слова у публікаціях каналу: ``` {"collector": "https://your-collector.example.org", "token_file": "witness-token.txt", "bot_token_file": "bot-token.txt", "channel": "@your_witness_channel", "interval": 5, "timeout": 30, "post": "changes", "title": "Partner witness", "texts": {"ok": "journal head", "no_response": "no answer from the collector", "records": "records"}} ``` Ключі `texts`: `ok`, `key_changed`, `rollback`, `fork`, `invalid`, `no_response`, `collector`, `records`, `head`. Командний рядок має пріоритет над середовищем, середовище — над файлом. Невідомі опції або текстові ключі зупиняють роботу свідка з повідомленням, а не ігноруються. Формулювання ніколи не впливає на перевірку: verify.py перевіряє підписаний токен наприкінці кожного посту. З параметрами `--post changes` або `problems` перевірки, які не були опубліковані, все одно залишаються в журналі свідчень, і `verify.py` вказує їх як такі, що ніколи не публікувалися; початковий запис називає політику. Кожна перевірка все одно з’являється в журналі, тому менша кількість постів означає меншу кількість записів, датованих Telegram, а не меншу кількість перевірок. Навіть без каналу TgWitness все одно зберігає свій журнал. Зберігайте відбиток ключа TgWitness (`python -m tgwitness.witness fingerprint`) в іншому місці. ## Публічна сторінка з доказами для декількох робочих просторів `python -m tgwitness.proof` witnesses підтримує до 32 робочих просторів одночасно та надає сторінку, доступну лише для читання, з останньою підписаною перевіркою кожного з них. Кожен робочий простір отримує власний ключ свідка та журнал у папці data, а також закріплений ключ колектора; публікація у каналі Telegram є необов’язковою для кожного робочого простору. Почніть із [файлу proof.config.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proof.config.example): | Галузь | Значення | | --- | --- | | `title` | Заголовок сторінки, 1–100 символів | | `data_dir` | Ключі та журнали Witness, пов’язані з файлом; за замовчуванням `proof-data` | | `interval`, `timeout` | Кількість хвилин між перевірками (1–1440, за замовчуванням 5); кількість секунд очікування (5–600, за замовчуванням 20) | | `workspaces[].id`, `label` | Короткий псевдонім малими літерами та ім’я, що відображається | | `workspaces[].collector` | Адреса Collector; інші робочі простори закінчуються на `/profiles/` | | `workspaces[].collector_fingerprint` | Обов’язкове, різне для кожного робочого простору | | `workspaces[].token_file` | Файл із токеном-свідком цього робочого простору, доступним лише для читання | | `workspaces[].channel`, `bot_token_file` | Опціонально, разом: публікувати кожну перевірку в каналі | | `workspaces[].proxy`, `bot_api` | Опціональний маршрут та адреса API-інтерфейсу бота | ``` python -m tgwitness.proof --config proof.json --check-config python -m tgwitness.proof --config proof.json --host 127.0.0.1 --port 8790 ``` Перша команда перевіряє файл та файли токенів, не встановлюючи з’єднання. Сторінка відповідає лише на запити GET та HEAD: - `/` Показує всі робочі простори; робочий простір, який не перевірявся протягом 2,5 інтервалів, позначається як застарілий. - `/api/proof` повертає те саме, що й JSON. - `/api/proof/` завантажує останню підписану заяву (`tgwitness-public-proof-v1`): номер та хеш запису свідка, статус, закріплений ключ збирача, контрольна точка, лічильники збору даних та інформація про те, чи вдалося опублікувати допис у каналі, підписаний ключем свідка цього робочого простору. - `/healthz` Повертає код 503, коли монітор робочого простору припинив роботу. Присвойте сторінці власне ім’я хосту, як-от [Caddyfile.proof.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.proof.example). Для перевірки експортуйте журнал свідчень робочого простору за допомогою `python -m tgwitness.witness export --data-dir proof-data/ --out witness.zip` та використовуйте його як описано нижче. ## Перевірити З боку користувача TgWitness експортуйте цей журнал: ``` python -m tgwitness.witness export --out witness.zip # Docker (add -f deploy/compose/compose.witness.yaml on a witness server): docker compose exec witness python -m tgwitness.witness export --out /witness/witness.zip docker compose cp witness:/witness/witness.zip . ``` Потім, де завгодно, за допомогою підписаного ZIP-файлу колектора та адреси публічного каналу: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/your_witness_channel ``` `--channel` також приймає експорт із Telegram Desktop (*Експорт історії чату* → JSON дає `result.json`) або збережену копію сторінки; вони перевіряють вміст публікації, але не надають зовнішнього часу. `verify.py` перевіряє журнал свідка (ланцюг та підписи), а потім — чи **кожен заголовок, який бачив свідок, є частиною експортованого журналу**: запис із таким номером повинен мати саме такий хеш. Головка, яка не збігається, не проходить перевірку — журнал було змінено після того, як свідок її побачив. Також повідомляється про головки, побачені після експорту, аномалії, які зафіксував свідок, відповіді, що не пройшли перевірку, періоди, відповідні контрольні точки яких присутні в цьому експорті («Свідковано від X до Y») та прогалини. Пізніші контрольні точки не подовжують ці періоди. Результат містить номер останнього збіжного запису та кількість наступних записів без відповідної контрольної точки. Враховуються лише відповіді, підписані власним ключем експорту: експорт, підписаний ключем, якого свідок ніколи не бачив, повідомляється як не засвідчений, і без параметра `--fingerprint` його підписувач залишається не закріпленим. З параметром `--channel` кожен підписаний запис повинен збігатися з журналом свідка запис за записом: змінені записи не проходять перевірку, відсутні записи вносяться до списку. Збіг токену підтверджує автентичність вмісту; дата не входить до складу підписаного токену. За допомогою активної адреси `https://t.me/s/…` або `https://telegram.me/s/…` верифікатор зчитує дату кожного допису зі сторінки на момент верифікації. Telegram встановлює цю дату; дати відредагованих публікацій не використовуються. Найраніша така дата публікації на початку експорту є зовнішнім часом для останнього запису, що відповідає цій умові мінімальних вимог до доказів. Дати з будь-якого іншого джерела, такого як наданий файл `result.json`, збережена сторінка або інша веб- адреса, є наданими метаданими, а не незалежним часом; результат вказує, звідки походять дати публікацій (`post_date_verification`). ### Необхідна межа експорту з підтвердженням Для передачі, яка має містити остаточний запис у присутності свідків, додайте `--require-witness`: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness ``` Для цього потрібні незалежно збережений відбиток свідка, ключ, відмінний від ключа колектора, та відповідний контрольний пункт, розташований точно в кінці цього експорту. Контрольний пункт, що охоплює лише попередній префікс, є недостатнім. Призупиніть збір даних, дайте свідку спостережити за кінцевим станом та здійсніть експорт до подальшого запису в журнал; якщо журнал зміниться, збережіть інший контрольний пункт і експортуйте цей стан. Сам по собі пізніший контрольний пункт не може перевірити кінцевий хеш коротшого експорту. Коли також вказано `--channel`, відсутність заявлених записів або порожній набір збігів призводять до провалу цієї суворої перевірки. Без цього прапора звичайні перевірки цілісності все одно повідомляють про записи без свідків, не відхиляючи при цьому архів, який в іншому є неушкодженим. Журнал свідка та його закріплений ключ слід зберігати окремо. Онлайн-перевірки підтверджують безперервність між контрольними точками; офлайн-верифікація порівнює кожну збережену контрольну точку з експортом. Старі заголовки без доказів безперервності зберігають результати офлайн-порівняння та відображаються у звіті без онлайн-перевірки безперервності. У звіті наведено час простою свідка та невдалі публікації за інтервалами. ### Щоденні печатки та недоступні календарі часових міток Свідок запечатує межу журналу за попередній день за UTC та надсилає хеш цього підписаного печатки до OpenTimestamps. Подання до календаря є доказом, що очікує на підтвердження; лише незалежно перевірені зобов’язання Bitcoin отримують підтвердження у верифікаторі. Якщо всі календарі дають збій, підписана печатка та невдала спроба залишаються в журналі. Щогодинний цикл обслуговування повторно обробляє цей оригінальний запис, у тому числі після перезапуску або зміни дати. Він сканує не більше ніж 32 печаток, надсилає не більше ніж дві відсутні подачі та витрачає не більше ніж 60 секунд на повторні спроби за один цикл. Постійний курсор по черзі переглядає старіші печатки. Збережені подачі слідують існуючому шляху оновлення доказів. Повторна спроба не перезаписує печатку, не змінює її початкову дату та не стверджує, що календар отримав її раніше. Пізніша зобов’язальна операція з біткойнами залишається пізнішим зовнішнім підтвердженням. Відсутні докази залишаються на рівні `none`; докази, що очікують на перевірку, залишаються на рівні `pending`, доки верифікатор не перевірить їх самостійно. --- # Telegram · Часові мітки Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/timestamp/ Часові мітки RFC 3161 для підписаних контрольних точок: що надсилається до центру авторизації та як перевіряється відповідь. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt) Часові мітки RFC 3161 для підписаних контрольних точок: що надсилається до центру авторизації та як перевіряється відповідь. [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/evidence/) ![Докази та верифікація](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness формує запити за стандартом RFC 3161 та перевіряє відповіді служб міток часу (TSA). Ця ручна процедура не передбачає ні вибору TSA, ні надсилання даних; режим доказового збору виконує обидві ці дії за графіком ([формат доказового збору](https://phishdestroy.io/tgwitness/uk/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)). Підготовлений запит **ще не** є **міткою часу**. ## Що фіксує цей журнал доказів Блок-схема · Спостереження за акаунтами → Ланцюжок SHA-256 та підписи Ed25519; Ланцюжок SHA-256 та підписи Ed25519 → Підписаний контрольний пункт; Підписаний контрольний пункт → Хеш з точністю до байта та випадковий нонс; Хеш з точністю до байта та випадковий нонс → Запит RFC 3161; Запит RFC 3161 → Незалежна TSA; Незалежна TSA → Підписана відповідь TSA; Підписаний контрольний пункт → Перевірка даних, одноразового коду та явного довірчого сертифіката; Підписана відповідь TSA → Перевірка даних, одноразового коду та явного довірчого сертифіката · Спостереження заакаунтами · Ланцюжок SHA-256 тапідписи Ed25519 · Підписаний контрольнийпункт · Хеш з точністю добайта та випадковийнонс · Запит RFC 3161 · Незалежна TSA · Підписана відповідьTSA · Перевірка даних,одноразового коду таявного довірчогосертифіката **Діаграма у вигляді тексту** 1. Спостереження за акаунтами → Ланцюжок SHA-256 та підписи Ed25519 2. Ланцюжок SHA-256 та підписи Ed25519 → Підписаний контрольний пункт 3. Підписаний контрольний пункт → Хеш з точністю до байта та випадковий нонс 4. Хеш з точністю до байта та випадковий нонс → Запит RFC 3161 5. Запит RFC 3161 → Незалежна TSA 6. Незалежна TSA → Підписана відповідь TSA 7. Підписаний контрольний пункт → Перевірка даних, одноразового коду та явного довірчого сертифіката 8. Підписана відповідь TSA → Перевірка даних, одноразового коду та явного довірчого сертифіката Підпис колектора прив’язує записи до свого ключа. Довірений відповідь TSA може підтвердити, що певний контрольний пункт існував на зазначений TSA момент часу. Тоді контрольний пункт може прив’язати префікс журналу. Ця верхня часова межа застосовується до цього зафіксованого префікса; окремі дії Telegram зберігають свої записані часи подій. ## Процедура Верифікатор журналу повідомляє про кроки назад та значення `observed_at`, які неможливо проаналізувати, у `chronology`, якщо такі є, та включає попередження у вихідні дані команди. Він зберігає підписані часові мітки та все одно перевіряє їхні підписи. Крок назад може бути наслідком корекції годинника, тому перевірте його за допомогою записів годинника хоста. Незалежний час отримується з перевірених зовнішніх міток часу, повідомлень свідків, зчитаних з їхньої публічної сторінки t.me, та раундів drand; параметр `--strict` регулює фіксацію підписувачів та підтримувані формати. Записані значення drand проходять офлайн-перевірку на структурну та хеш-самоузгодженість. Команда `--check-drand` порівнює вибрані записані раунди з відповідями ретрансляторів HTTPS; результат вказує, скільки раундів було порівняно та які ретранслятори відповіли, а порівняні раунди забезпечують автентифіковану нижню часову межу. 1. Збережіть відбиток ключа колектора через окремий надійний канал; він ідентифікує колектор незалежно від перевіреного ZIP-файлу. 2. У **розділі «Експорт» → «Підготувати запит на часові мітки**» завантажте ZIP-файл із запитом для обраної робочої області. Розпакуйте файли `checkpoint.json`, `timestamp.tsq`, `SHA256SUMS` та `README.txt`. Не змінюйте байти контрольних точок. 3. Оберіть TSA, що відповідає вимогам розслідування. Надішліть `timestamp.tsq`, використовуючи задокументований метод, а також `application/timestamp-query` для HTTP-сервісу. Збережіть оригінальну бінарну відповідь як `timestamp.tsr`, кінцеву точку, час отримання та результат запиту. Запит містить хеш та нонс, а не повідомлення; метадані мережі все одно розкривають зміст запиту. 4. Отримайте довірений кореневий сертифікат незалежно від відповіді, а також усі необхідні проміжні сертифікати. Сертифікат у відповіді не стає довіреним лише тому, що він там міститься. 5. З надійної інсталяції TgWitness перевірте: ``` python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem ``` За потреби додайте `--intermediates tsa-intermediates.pem`. OpenSSL не потрібен: підпис, посилання на сертифікат підпису та ланцюжок перевіряються в Python бібліотекою `cryptography` — тим самим кодом, що використовує `verify.py --tsa-ca`. `openssl ts -verify` лишається незалежною другою перевіркою для експерта, якому вона потрібна. 1. Експортуйте ZIP-файл із підписаним журналом після контрольної точки, щоб він містив цей префікс. Перевірте за допомогою незалежно відомого відбитка: ``` python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json ``` Це свідчить про те, що експорт містить префікс із часовим штампом. Скрипт `verify.py` зчитує квитанції з часовими штампами лише з архіву ZIP, де їх зберігає режим доказів; ручна відповідь перевіряється на кроці 5 і охоплює записи аж до цього контрольного пункту. 1. Зберігайте ZIP-архів, контрольну точку, запит, відповідь, ланцюжок сертифікатів, результати перевірки та запис про передачу поза межами колектора. Повторіть перевірку після отримання. Щоб підготувати запит із збереженої контрольної точки: ``` python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip ``` Під час підготовки JSON канонізується, а відповідний контрольний пункт включається до архіву. Для перевірки TSA використовуйте **байти контрольного** пункту **з цього архіву**, навіть якщо вхідний файл містив інші пробіли. ## Межі верифікації | Перевірити | Поточна поведінка | | --- | --- | | Дані | SHA-256 точних байтів контрольної точки має збігатися з відповіддю | | Запит | За допомогою `--request` перевіряються оригінальний запит та нонс | | Підпис TSA | Підпис, сертифікат підпису та його ланцюжок до явно вказаного CA перевіряються на момент мітки часу | | Підпис колектора | Окремо перевірено верифікатором журналу за допомогою закріпленого ключа | | Скасування | Режим доказів зберігає докази OCSP/CRL, які перевіряє `verify.py` | | Заплановане подання | Режим «Докази», що вмикається при кожному завданні налаштування | `--request` формально необов’язковий, але без нього неможливо перевірити початковий nonce. Для цієї повної процедури значення `request_checked` у результаті має бути true. Кожен сертифікат ланцюжка має бути чинним на момент мітки, а сертифікат підпису має призначатися лише для міток часу. Відповідь TSA прив’язує надіслані байти контрольної точки до зазначеного часу. Перевірте цей результат, зіставивши його із записами збору даних та верифікацією середовища для обраного режиму. Режим доказів включає кваліфікований TSA уряду Бельгії (`http://tsa.belgium.be/connect`; відповіді RFC 3161 підписані, тому звичайний HTTP не послаблює їх). Якщо кореневий сертифікат цього постачальника передати до `--tsa-ca`, `verify.py` повідомляє про кваліфіковану мітку часу eIDAS та її одиницю виміру часу; Регламент (ЄС) № 910/2014, стаття 41(2), передбачає точність часу та цілісність пов’язаних даних. ### Відкликання сертифіката підпису Відразу після кожної відповіді режим доказів отримує докази скасування для сертифіката підпису TSA: відповідь OCSP з адреси AIA OCSP сертифіката, або ж CRL з його точки розповсюдження (не більше 4 МіБ). Він зберігається поруч із відповіддю як `checkpoint-N..ocsp` або `.crl` та експортується разом із нею. Невдале отримання ніколи не затримує мітку часу; запис `anchor.completed` вказує її як `unavailable` із зазначенням причини. `verify.py` перевіряє підпис відповіді OCSP (підпис емітента або сертифікат відповідача, який емітент надав для підписання OCSP), ідентифікатор сертифіката та статус, а також те, що відповідь була видана не раніше genTime або була на той момент ще чинною (nextUpdate). Для CRL перевіряється підпис емітента, те саме часове вікно та відсутність серійного номера у списку. Потім він повідомляє: `signing certificate not revoked as of