模式、场景和证据级别

一个日志。四种收集模式。八个验证级别。

TgWitness 记录已连接账户所观察到的内容。第三方可借助独立的可信密钥验证该记录的完整性。

3–5 分钟概述 · 虚构示例 · 当前实现

  1. Telegram

    账户可见的更新

  2. 收集器

    关联记录,每条均已签名

  3. 验证者

    可信密钥 + 保留边界

h₁ → h₂ → h₃ · Ed25519请结合来源标识和采集记录查看每条观察记录。

选择观察范围

三个观察范围和一个调查预设。排除项和已启用的源类型仍然适用。

记录
仅采用人工精选的来源。
新聊天
不会自动添加。
选择
一组已知的频道或群组。尚未确定固定的聊天容量。
记录
文件夹包含项和分类,若已配置,则不包括排除项和已归档的聊天。
新聊天
匹配活跃聊天;一小时内的文件夹变更。
选择
分析员已维护一个案件文件夹。请在专用账户上确认数据收集情况。
记录
选定类型中,账户可见的聊天,包括私人对话和机器人。
新聊天
将在首次更新时添加。
选择
一个专门的观察账户,包括参与案件的账户。
记录
所有源类型、自身操作、源配置文件以及新发现源的最新 200 条可见消息。
新聊天
新的聊天或机器人将获得一个配置文件和历史记录快照。
选择
通过控制面板加入团队或与机器人交互。查看并保存预设。

这些卡片仅用于本地比较,并非实时收集器控制项。它们不会更改任何账户。

阅读详情

记录内容

仅已交付或明确请求的观察记录才会被纳入记录。来源不明的观察记录仍保持未知状态。

捕获开关 · 本地示意图

该面板按工作区应用这些开关。关闭某项开关会保留现有记录;重新开启该开关不会重建遗漏的事件。

事件矩阵:已保存的材料与剩余未知项
分类已保存
消息文本、ID、发送者元数据、回复上下文及原始更新信封。
编辑记录所有被观察到的版本,且不覆盖较早的版本。
删除如有,请附上通知及先前保存的文本。
无作用域的删除账户级通知;未知对等方仍被明确标识。
反应已交付的计数器及可见的近期身份信息。
成员资格已发送的服务消息和参与者更新。
附件原始版本描述符、已保存字节、 SHA-256 以及尝试结果。
历史快照当前可见的消息,被标记为历史观察记录。
自主行动发送 messages/edits 及匹配的回复键盘 button_press 元数据。
机器人按钮回调、URL、Web 应用及请求元数据将随消息一并保留。

默认附件限制

照片
20 MiB
视频
100 MiB
文件
50 MiB
动画
20 MiB
视频笔记
50 MiB
语音
20 MiB
音频
50 MiB
贴纸
5 MiB
阅读详情

仅使用您拥有的授权权限

每个账户都有自己的工作区、日志、签名密钥、路由和队列。

Direct · SOCKS5 · HTTP CONNECT · MTProxyMTProxy 处于实验阶段;内置的公共 MTProxy 列表可用。代理路由失败时不会回退到直接连接。

同一台机器上的两个工作区并不构成两个独立的见证者。

账户格式

从面板操作

发送或回复消息、点击当前机器人按钮、保存链接预览后,请显式加入聊天或使用其启动参数启动机器人。

interaction.previewinteraction.requestedinteraction.result

预览、请求和结果回执均经过签名。在按下按钮之前,服务器会再次获取消息,并拒绝已更改的键盘输入。返回的回调文本和 URL 仍作为记录上下文保留。

阅读详情

恢复与连续性

应展示缺口,而非隐藏。

恢复保存的位置

重启后,系统会向 Telegram 查询遗漏的更新。有限的保留时长和过期的差异可能导致数据缺失。

重新检查可见消息

默认设置:优先级来源每15分钟更新一次,其余来源每6小时更新一次。结果包括 message.recovered 以及 message.missing_on_recheck.

阅读 coverage.json

观察时段、附有原因的缺失记录以及未观察到的 ID 均随签名导出文件一同提供。重新检查时未发现的记录并不等同于删除通知。

阅读详情

七个层次。不同的问题。

每种机制都针对一个有限的问题提供解答。请单独配置外部服务,并将它们的信任锚点保留在收集器之外。

  1. 记录

    SHA-256 chain + Ed25519 每个事件;第一个 previous_hash 为64个零。

    第三方验证 基于固定收集器密钥的排序和签名。

    验证命令
    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256
  2. 容器

    manifest.json 列出文件哈希值; manifest.sig 对其进行签名。 media.saved 将附件字节绑定到一个事件上。

    第三方验证 提供的文件与已签名的清单及媒体收据一致。

    验证命令
    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256
  3. 保留边界

    启动时进行检查点备份,默认每 5 分钟一次,并有序停止。请在其他位置保留一份副本。

    第三方验证 后期的导出结果应与先前保留的长度和头部一致;可检测到回滚情况。

    验证命令
    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json
  4. 外部时间

    证据模式会发送一个检查点 SHA-256 至 RFC 3161 相关机构(FreeTSA, DigiCert) 及 OpenTimestamps 日历。

    第三方验证 经过验证的 TSA 响应会标注这些字节的时间戳;已确认的 OpenTimestamps 证明将这些字节锚定至比特币。

    验证命令
    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca trusted-ca.pem
    ots upgrade checkpoint.ots
    ots verify checkpoint.ots
  5. 独立见证人

    将主机、范围限定只读端点、新挑战及其专属 key/journal 以及 TGW1 频道帖子。

    第三方验证 先前已接受的分支头;状态包括 ok、 key_changed、回滚、分叉、无效以及 no_response.

    验证命令
    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/WITNESS_CHANNEL
  6. 站外副本

    S3-兼容的副本,使用 AES-256-GCM; Object Lock 加密的副本(当存储桶支持时)。

    第三方验证 仅在日志、检查点和已保存媒体的验证成功后,Restore 才会发布文件。

    验证命令
    python -m tgwitness.replica restore --key-file KEY.json --out EMPTY_DIR
  7. 运行溯源

    签名运行收据:源代码哈希值、依赖项版本及进程上下文。由系统自行报告。

    第三方验证 签名收集器对其自身执行情况的报告。

    验证命令
    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256

本地 SHA-256 实验

尝试修改第 2 条记录

下一条记录保留了之前保存的链接。修改文本会改变记录 2 的计算哈希值。

记录 1h1以 64 个零开头
记录 2h2包括已保存的 h1
记录 3h3包括已保存的 h2

静态示例: h2 涵盖“11:00见面”。更改该文本会改变 h2;记录 3 仍引用已保存的 h2.

检查完整的摘要
已保存记录 2 的哈希值
SHA-256(e₂)
重新计算的第 2 条记录哈希值
SHA-256(e₂)
此示例计算的是哈希值,而非签名。真正的验证器会使用可信密钥对每个签名和链接进行验证。
阅读详情

选择一条贯穿证据的路径

虚构情境。在相关事件发生前开始收集数据;在记录内容的同时,保留其边界和空白处。

频道更改支付详情

模式 → 事件
选定聊天 → 消息、编辑、删除。
输出
通过哈希值记录观察到的帖子版本和附件。
验证
已签名 ZIP + 保留检查点 + 经验证的 TSA 响应。

事件发生后,消息将消失

模式 → 事件
文件夹或整个账户 → 所有事件类别。
输出
已保存的原始内容、删除通知以及存在缺口的覆盖范围。
验证
已签署 ZIP + 独立见证日志。

调查一个商店机器人

模式 → 事件
调查预设 → 按钮、链接预览和显式机器人启动。
输出
已签名的交互收据、返回的回调以及保存的配置文件。
验证
已签名 ZIP;请对照 ZIP.

参与者在不同聊天中会更改昵称

模式 → 事件
任何范围 → 被观察的 sender/profile 元数据。
输出
按数字 ID 记录名称/用户名历史、"也出现在"链接及提取的线索。
验证
文件 JSON 已与签名版本核对 ZIP.

长期观察,并保留异地副本

模式 → 事件
任何作用域 → 证据模式以及一个 S3 支持的副本 Object Lock.
输出
加密副本、保留的检查点及时间戳响应。
验证
使用导出的密钥进行恢复,然后在不依赖原始服务器的情况下进行验证。
阅读详情

交付可验证的软件包

请提供已签名的原始文件、独立保存的密钥指纹、相关检查点以及验证结果。

python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint checkpoint.json --require evidence

请从可信副本中获取验证器,而非从正在检查的存档中获取。

阅读详情

对比交付的成果

基本 artifacts 不包含额外的签名、时间戳或见证系统。脚本和日志记录器因实现而异;“部分”指仅限于捕获或可见的内容。

方法论编辑 / 删除记录签名外部时间独立见证人覆盖范围 / 缺失部分无作者的验证
Telegram Desktop 导出部分无无无无无
Telethon 快照脚本部分无无无无无
删除日志记录器:文本日志部分无无无无无
屏幕截图 / 网页截图部分无无无无无
TgWitness 带配置的附加项部分是是是部分是
阅读详情