# 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/)
