# Проверка доказательств: SHA-256 и Ed25519

Canonical page: https://phishdestroy.io/tgwitness/ru/docs/reference/how-it-works/

Объяснение принципов работы цепочки хешей, подписей, контрольных точек и свидетелей с указанием точных формул, используемых верификатором.

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

[Documentation index](https://phishdestroy.io/tgwitness/ru/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/ru/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/ru/docs/reference/case-board/), [оформлению отчетов](https://phishdestroy.io/tgwitness/ru/docs/reference/case-reports/) и [передаче выдержек](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#handover-extract). Все примеры сообщений, количественные показатели и задержки являются вымышленными. Хэши в тестовой среде цепочки рассчитываются с помощью алгоритма SHA-256 в браузере. Никакие данные не отправляются в Telegram.

**На этой странице**

- [Сообщение изменяется; наблюдения накапливаются](https://phishdestroy.io/tgwitness/ru/docs/reference/how-it-works/#a-message-changes-observations-accumulate)
- [Что охватывает хеш](https://phishdestroy.io/tgwitness/ru/docs/reference/how-it-works/#what-a-hash-covers)
- [Что добавляет более ранний контрольный пункт](https://phishdestroy.io/tgwitness/ru/docs/reference/how-it-works/#what-an-earlier-checkpoint-adds)
- [Куда относится свидетель](https://phishdestroy.io/tgwitness/ru/docs/reference/how-it-works/#where-a-witness-belongs)
- [Проверка доставки по отношению к известным действиям](https://phishdestroy.io/tgwitness/ru/docs/reference/how-it-works/#test-delivery-against-known-actions)
- [Выберите рабочий процесс](https://phishdestroy.io/tgwitness/ru/docs/reference/how-it-works/#pick-a-workflow)

## Сообщение изменяется; наблюдения накапливаются

Диаграмма последовательности · Telegram → Коллектор: Новое сообщение: Встречаемся в 10:00; Коллектор → Подписанный журнал: Добавить сообщение.new; Telegram → Коллектор: Изменение: Встреча в 11:00; Коллектор → Подписанный журнал: Добавить сообщение.отредактировано; Telegram → Коллектор: Уведомление об удалении; Коллектор → Подписанный журнал: Добавить сообщение.deleted; Примечание относительно Подписанный журнал: Сохраняются данные об оригинале, редактировании и удалении · Telegram · Коллектор · Подписанный журнал · Новое сообщение: Встречаемся в 10:00 · Добавить сообщение.new · Изменение: Встреча в 11:00 · Добавить сообщение.отредактировано · Уведомление об удалении · Добавить сообщение.deleted · Сохраняются данные об оригинале, редактировании иудалении

**Схема в текстовом формате**

1. Telegram → Коллектор: Новое сообщение: Встречаемся в 10:00
2. Коллектор → Подписанный журнал: Добавить сообщение.new
3. Telegram → Коллектор: Изменение: Встреча в 11:00
4. Коллектор → Подписанный журнал: Добавить сообщение.отредактировано
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/ru/docs/reference/evidence/#event-canonicalization).

Блок-схема · 64 нулевых символа → Запись 1 / хеш h1; Запись 1 / хеш h1 → Запись 2 содержит h1 / хэш h2; Запись 2 содержит h1 / хэш h2 → Запись 3 содержит теги h2 и h3; Запись 3 содержит теги h2 и h3 → Контрольная точка с подписью: счет 3, заголовок h3 (сохранить в другом месте) · 64 нулевых символа · Запись 1 / хеш h1 · Запись 2 содержит h1 /хэш h2 · Запись 3 содержит тегиh2 и h3 · Контрольная точка сподписью: счет 3,заголовок h3 · сохранить в другом месте

**Схема в текстовом формате**

1. 64 нулевых символа → Запись 1 / хеш h1
2. Запись 1 / хеш h1 → Запись 2 содержит h1 / хэш h2
3. Запись 2 содержит h1 / хэш h2 → Запись 3 содержит теги h2 и h3
4. Запись 3 содержит теги h2 и h3 → Контрольная точка с подписью: счет 3, заголовок 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 на третьей позиции. Его новейший заголовок — h4, который, как и ожидается, будет отличаться. Экспорт, содержащий только две записи, не пройдёт проверку.

[Схема статических контрольных точек](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-checkpoint-static.svg)

После проверки подписи контрольной точки необходимо:

Nexport ≥ Ncheckpoint and hexport[Ncheckpoint] = Hcheckpoint

Экспорт может выходить за пределы контрольной точки. Он должен совпадать на сохраненной границе. Ключ сборщика подписывает контрольную точку, поэтому сборщик может подписать и другую. Он связывает записи только в том случае, если получатель получил их до архивирования через другой канал; для обеспечения минимальных требований к доказательствам также требуется внешнее время от третьей стороны. Реальный верификатор также проверяет последовательность каждого события, предыдущую ссылку, хеш и подпись. Сравнение только конечной сохраненной головки привело бы к пропуску измененной внутренней записи, хеш которой не был обновлен.

## Где находится «Witness»

Блок-схема · Сборщик / сессия учетной записи / ключ 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/ru/docs/reference/witness/).

## Проверка доставки с учётом известных действий

Используйте контрольную группу, отдельные учетные записи для сбора данных и новый маркер. Направляйте, редактируйте и удаляйте сообщения целенаправленно, проверяя запись на каждом этапе. Определите ожидаемые действия и предельный срок перед проверкой результатов.

R = |observed∩expected| / |expected| Δ t = treceipt - taction

Учитываются только ожидаемые действия; дубликаты подтверждений не увеличивают числитель. Знаменатель должен быть не равен нулю. Отсутствующее подтверждение не имеет измеренной задержки. Укажите погрешность времени; используйте собственное контролируемое время действия удаления, поскольку Telegram не предоставляет точное время удаления. Результат, например, 5/6 (83,3 %), описывает тестовые действия, а не полноту всего трафика Telegram.

## Выберите рабочий процесс

[Полный пример расследования](https://phishdestroy.io/tgwitness/ru/docs/reference/investigation/) прослеживает инцидент в канале, группе, боте и личном чате:

1. На выделенном аккаунте для сбора данных включите режим расследования всего аккаунта и составьте перечень доступных чатов. Для основного аккаунта используйте выбранные чаты или папку.
2. Получайте моментальные снимки журнала, полную историю каждого чата и сохраненные вложения.
3. Отражайте оперативные изменения и любые целенаправленные действия с панелями вместе с соответствующими подтверждениями.
4. Отслеживайте цифровые идентификаторы отправителей, связи между ответами, повторяющиеся адресаты и хэши файлов посредством ссылок на записи и профилей пользователей.
5. Добавляйте примечания со ссылками на источники и коллекции в Case Board. Восстанавливайте хронологию переписки между чатами с указанием как временных меток, так и явных пробелов.
6. Сравнивайте рабочие пространства других учетных записей, сохраняя при этом их происхождение и ключи отдельно.
7. Соберите и проверьте подписанные журналы, профили и экспортированные данные истории вместе с примечаниями по делу.

Руководство на сайте в разделе `/docs/cases/` содержит интерактивную карту дела и варианты решений для споров с ботами, удаленных сообщений и участников, сменивших имена. Case Board хранит заметки и коллекции в рамках рабочего пространства. Групповой экспорт собирает отдельные пакеты рабочих пространств; сопоставление данных между рабочими пространствами и составление объединенной временной шкалы остаются задачей аналитиков.

[Завершённая валидация и оставшиеся задачи](https://phishdestroy.io/tgwitness/ru/docs/reference/verification/) · [Экспорт и проверка](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/#investigation-handoff) · [Начните с одной учетной записи](https://phishdestroy.io/tgwitness/ru/docs/reference/quickstart/)
