本页面部分内容仍为英文:英文原文在翻译后发生了变更。
参考 / 证据
Telegram · 证据格式
签名 ZIP 文件的内容、记录类型、操作收据、用户资料、异地副本及离线验证。
TgWitness 将账户可见的 Telegram 观察结果保存在一个已签名的日志中。 接收方可使用可信的 收集器密钥验证已保存的记录、附件和报告,通过第三方核对最后一条记录的外部时间,并对比 日志与他们先前保留的检查点。 本页面描述了格式、校验方法以及移交时需保留的材料。
Windows 用户可通过 VERIFY.cmd 开始操作:该程序会要求提供原始 ZIP 文件和独立获取的密钥指纹,显示附有说明的结果, 并保存一份独立的验证记录。有关设置和信任限制,请参阅验证启动程序和 便携式运行时。
本页内容
什么是签名#
| 资料 | 保护 | 应保留的内容 |
|---|---|---|
| 日志中的每一项记录,包括操作事件 | 每个事件均包含 SHA-256 链和一个 Ed25519 签名 | 原始 events.jsonl(可信密钥指纹)及保留的检查点 |
| 证据 ZIP 文件内容 | manifest.sig 对规范清单进行签名,该清单列出了内容文件的哈希值 |
完整的 ZIP 压缩包,包含其清单和签名 |
| 保留的附件 | 带签名的media.saved事件中包含SHA-256和字节计数;带签名的ZIP清单中包含文件哈希值 |
经过验证的 ZIP 文件中的原始字节 |
| 检查点 | 对日志长度、头部哈希值、公钥及创建时间进行 Ed25519 签名 | 在发生争议性更改前保留的独立副本 |
| 运行收据 | 包含采集器版本、源文件哈希值和启动设置的签名记录,该记录也包含在process.started中 |
所选验证模式对应的收据、相关日志及环境证据 |
可读报告:report.html及其组成部分,report.json、report.pdf、chat.pdf |
每个文件均带有针对其内容的 Ed25519 密封;PDF 还包含一个标准的 PDF 签名(参见 可读报告 ) | 收到的文件及其可信密钥指纹;该文件所描述的 ZIP 压缩包 |
| 独立版 CSV | 不包含独立的加密签名;仅凭事件哈希值是不够的 | 请使用经过验证的 ZIP 文件中的原文件进行完整性校验 |
| 由浏览器生成的屏幕截图、打印件或 PDF 文件 | 衍生作品上不包含 TgWitness 的签名 | 保留原始的经过验证的软件包,并记录衍生版本的制作过程 |
采集器在生成每种导出格式之前,都会验证日志签名。 可读的 HTML 和 PDF 报告带有各自的印章;独立的 CSV 文件作为 已签名 ZIP 文件的一部分进行验证。保留 ZIP 文件以保留附件字节和清单, 并设置单独的检查点,用于将日志与较早的边界进行比对。
格式与验证路径#
采集模式和输出格式旨在解答不同的问题。该模式 提供采集和环境证据;每种格式均通过以下检查机制保留或呈现 该记录的一部分。
| 输出 | 验证与使用 |
|---|---|
| 证据 ZIP | 规范事件、签名清单、覆盖范围、保管条目、附件及可用的外部收据;检查归档及其选定的获取模式。 |
| ASiC-E 容器 | 作为ETSI ASiC-E容器(EN 319 162-1)的证据ZIP文件,其中包含mimetype条目和META-INF/ASiCManifest.xml文件,并使用工作区自身的证书以B-B级别进行CAdES签名;若启用了时间戳功能,则以B-T级别进行签名。 EU DSS 等验证工具会检查格式和完整性,并且由于证书是自签发的,因此会报告“无信任锚点”。默认设置下的 EU DSS 6.3 会拒绝包含超过 1000 个文件的容器(“检测到文件过多”)。 verify.py会检查Ed25519清单及所有列出的文件,以及META-INF/ASiCManifest.xml中、新增的ASiCManifestNNN.xml或ASiCEvidenceRecordManifest.xml中的SHA-256值,若存在上述文件均未涵盖的META-INF/条目,则验证失败。该工具不检查CAdES签名,并会明确提示此情况。 |
| HTML 和 JSON 报告 | 这些视图均单独封装,附有来源引用,并在 ZIP 清单中列出。其记录的计数汇总了日志事件的种类。 |
| PDF 报告 | Ed25519 密封,外加一个覆盖字节范围 B-B 的 PAdES 基线 PDF 签名;若启用了时间戳功能,则为 B-T 范围,并附带签名时间戳。TgWitness 验证器使用受信任的 Ed25519 密钥;查看器中证书信任状态的显示则属于另一项独立检查。 |
| CSV | 电子表格视图受 ZIP 清单保护。公式转义机制保障电子表格的使用安全;原始签名文本仍保留在日志中。 |
| JSONL | 带签名的事件记录,包括附件引用。证据 ZIP 文件还包含已保留的附件字节。 |
| 聊天记录导出和与桌面端兼容的视图 | 历史数据采集及可用的管理日志记录,包含所需的呈现形式和签名存档。实时监控的保存版本属于另一条采集路径。 |
| 媒体和仅含哈希值的记录 | 将保存的字节与相应的 SHA-256 哈希值及消息引用进行比对。仅采集哈希值的方式会保留可用的哈希元数据,以便日后与文件字节进行比对。 |
| STIX/MISP 及人员档案 | 与来源关联的提取观察结果、账户 ID 和分析匹配结果。特征签名和记录哈希值可与原始证据进行核对;头像缓存的来源信息单独标注。 |
| 交接摘要 | 签名披露规则、未更改记录以及标记为最小化的记录均保留原始哈希值/签名。若需进行涉及被隐藏字段的比较,请使用保留的原始数据。 |
| 见证人和时间收据 | 早期的日志边界、连续性以及各个经过验证的时间声明。这些内容与采集和归档检查相关联。 |
| 密码保护的交付 | 在传输过程中保护所包含的包。.tgwpw使用AES-GCM认证加密,包括一条经过认证的最终记录;所包含的日志保留其签名和获取收据。 |
打印件或屏幕截图是已签名材料的呈现形式。其报告 ID、密钥指纹和二维码引用可帮助定位原始文件以供验证。 保管声明记录了提供的检查员和传输信息; 验证结果和获取收据作为单独证据予以保留。
外部签名#
签名也可以来自 TgWitness 从未持有的密钥,例如调查人员的
合格电子签名或组织的印章。在导出功能中,对未设置密码的已准备好导出文件进行外部
签名时,会提供待签名的字节数据:一个新的
META-INF/ASiCManifestNNN.xml 列表,其中列出了ASiC-E
容器中每个文件及其SHA-256值,或是该导出文件的 manifest.json 。签名者返回一个 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 同时使用;请通过各自的验证机制检查
每个存档所需的配置文件。
当两个存档均记录了相同的数字账号和聊天 ID 时,记录将通过消息 ID 进行配对。
未更改指完整的保存 JSON 记录完全一致:
包括全文、作者、日期、回复对象、嵌套元数据和未知字段。
JSON 对象键的顺序无关紧要;缺失字段、空值、值类型
以及数组顺序则会影响匹配结果。300 字符的预览仅用于显示。 已更改的条目
会将差异列为顶级字段changed_fields,包括预览中不可见的更改。
匹配过程中,重复的消息 ID 会被拒绝,而非相互覆盖。
差异可能表现为显示名称、浏览量、集合注释或 其他观察结果元数据的变更。Telegram 的编辑操作会以独立的编辑事件形式出现,且每个 存档的验证结果会显示该存档是否完整。未解析的记录仍保留 在比较中,并根据其保存的表示形式进行比较。
对于不同或缺失的账户/聊天标识,该工具会利用发送者、完整文本、文件哈希、媒体类型以及五秒
的时间容差来查找候选
对应项,并将它们报告为已匹配而非未更改。 未解析的
记录仍保持未匹配状态。配对记录中的差异会列在changed中,
包括内容模式下的差异。使用--json选项时,matched统计候选配对对数,
unchanged则统计完整保存记录完全相等的配对对数。现有的
changed_fields和整数型unchanged输出仍与
之前的比较结果保持兼容。归档格式和签名验证保持不变。
调查移交#
- 请在案件笔记中记录案件编号、操作员、Telegram 账户数字 ID、选定的 来源、采集政策及采集时间段。TgWitness 会保留观察记录,并在 “案件看板”中支持与来源关联的笔记和采集内容。请将移交和保管记录与案件 材料一并保存。 通过 实时验收程序核对预期的采集设置。
- 在依赖 工作区导出的内容之前,请先独立保存该工作区的公钥指纹。保持证据模式开启(默认状态),以便检查点能够接收符合 RFC 3161 和 OpenTimestamps 标准的收据。在收集过程中,将已签名的检查点保存到收集器之外。 记录中断情况以及该账户可见性的限制。
- 导出带签名的 ZIP 文件并保留带签名的运行收据。请在 导出日志边界处或之前设置检查点。较晚的检查点会正确地拒绝 较早的导出,因为其长度不足。导出内容包含完整的工作区日志, 不受面板过滤器影响;请在分享前仔细审查相关材料。
-
请收件人使用可信的验证器副本、 独立提供的指纹以及单独获取的时间戳权威机构的根 证书来验证 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).- 在保管记录中记录归档文件的 SHA-256 值、导出边界、传输日期、发送方和
接收方。保持原始包的完整性,并仅
使用副本进行操作。分享证据文件而非应用程序的私有数据
目录,该目录还包含账户会话和签名密钥。
传输时,请选择受密码保护的 AES-256 ZIP 文件或更安全的
.tgwpw容器。 ZIP 采用 WinZip 的低成本密码派生算法;请使用较长的随机 密码短语。.tgwpw采用 scrypt 和 AES-256-GCM 算法,可通过独立 验证器的unseal-password命令打开。密码不会被存储,仅用于保护 机密性;收件人解密 归档文件后,将验证其中未被篡改的已签名导出文件。 - 要在非证据模式下为检查点添加时间戳,请遵循 RFC 3161 中的 流程,并保留请求、检查点、受信任的 CA 信息以及经过验证的权威机构响应。仅准备请求 并不能获得时间戳。
- 在保管记录中记录归档文件的 SHA-256 值、导出边界、传输日期、发送方和
接收方。保持原始包的完整性,并仅
使用副本进行操作。分享证据文件而非应用程序的私有数据
目录,该目录还包含账户会话和签名密钥。
传输时,请选择受密码保护的 AES-256 ZIP 文件或更安全的
对于 .tgwpw,请使用独立获取的验证器,并选择一个
保留原始扩展名的新输出文件:python verify.py unseal-password export.tgwpw --out evidence.zip。
该命令会提示输入密码;--password-stdin 会读取一行内容以实现自动化。
它绝不会覆盖现有文件,且仅在所有记录
通过认证后才发布明文。随后对解密后的文件执行常规签名验证。
该容器使用 scrypt(N=131072、r=8、p=1、16 字节盐;约 128 MiB 内存)
以及 AES-256-GCM 算法,包含 1 MiB 的记录和一条经过身份验证的最终记录。一个加密的
元数据记录存储了内部文件名,因此下载后的容器可以重命名。
验证成功即表明相对于可信采集器 密钥和保留边界,数据完整性得到保障。请参阅验证范围,了解 信任假设以及所执行检查的验证结果。
交接摘要#
一个已签名的 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):该密封对report的规范 JSON 中的 SHA-256 进行签名,因此案件系统和脚本可以读取相关事实, 并可在保持签名文件完整性的前提下,从中进行数据保护方面的筛选。report.pdf/chat.pdf:一份用于打印和归档的正式文件,在同一组 字节上签名两次,整个文件(除签名值外)(/ByteRange)。标准PDF签名 采用PAdES基准规范(ETSI EN 319 142-1,/SubFilter /ETSI.CAdES.detached:采用 SHA-256 和 ECDSA P-256 的 CMS,签名证书 v2,无 CMS 签名时间;声明的时间为/M) 处于 B-B 级别,或 B-T 级别——当时间戳功能开启且 时间戳授权机构通过路由响应 Telegram 外部请求时,CMS 中包含 RFC 3161 签名时间戳。它使用 保存在工作区保险库中的自签发文档签名证书;其主体序列 号即为 Ed25519 密钥指纹。 Ed25519 印章作为 未签名属性2.25.240684792623320047764573196045913242332在CMS中传输,并以 “SHA-256”标识该证书的SHA-256值, 因此Ed25519密钥为该"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下列出。所选语言的报告开头建议将英文原件连同经认证或宣誓的译文一并提交;参见为法院翻译报告。
在频道或超级群中,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 的时间减去收集器时钟的时间,其中包含因
往返传输产生的不确定性;报告在“保管链”部分显示这些测量值。 聊天导出记录的
内容还包括读取历史记录的时间,而不仅仅是消息的日期。
离线报告查看器和存档指南#
在打开 chat.html 或 report.html 之前,请先解压完整的 ZIP 文件。该查看器提供搜索、
筛选、参与者、指标、记录详情以及无需服务器即可进行的 JSON/CSV 选择功能。请将
viewer/ 和 media/ 放在报告旁边。所选内容均为衍生文件:请使用 verify.py SELECTION.json
--evidence ARCHIVE.zip 将其与签名存档进行比对。
验证器会检查报告 ID、签名密钥、归档边界以及每个选定项目;经过编辑、
缺失或重复的项目将导致验证失败。选择说明和创建时间仍属于未签名的元数据。
仅在完整、未经过滤且按升序排列的聊天记录流中显示消息编号缺口。隐藏 类别或未能加载数据块,绝不能将省略的行视为消息缺失的 证据。搜索高亮功能在HTML转义之前对纯文本进行操作,并保留字面标记。
该浏览器会检查清单签名、报告 ID 和密钥,以及所有列出的文件哈希值。它 会拒绝模棱两可或格式错误的 ZIP 结构、重复的文件名和不安全的路径,并将文件 大小限制在 256 MiB 以内,声明的总内容大小限制在 4 GiB 以内。对于更大的归档文件,请使用独立验证器。 此浏览器检查是对验证器对日志链和数据语义检查的补充。
README.txt包含一份入门指南、一份对齐的文件清单、验证说明以及
以报告语言编写的数据格式说明,随后是完整的英文指南。 SHA256SUMS涵盖了
其中列出的文件,但不包括该文件本身、manifest.json和manifest.sig;签名清单
还涵盖了SHA256SUMS。请保持原始ZIP文件不变,并将工作文件保存到
解压文件夹之外。PDF报告包含章节书签,后续页面上带有案件/报告标识。
导出时的聊天记录#
聊天导出记录了导出开始时 Telegram 对该聊天的描述:Telegram 自身的
标签(scam、fake、restricted 及其理由、verified)、用户名、描述、成员
和管理员数量、关联的讨论、内容保护、新成员是否能查看早期
消息,以及该账户从哪条消息开始能查看聊天记录(available_min_id), 消息 1 的日期
(当该消息即为聊天创建时间时),以及聊天照片的 SHA-256(保存在 media/ 中)。
它记录了导出账户在聊天中的位置:角色、加入日期、邀请人,以及对于
管理员而言,其权限。Telegram 拒绝的请求将另行标注。
当导出账户为管理员时,导出操作会将聊天室的管理员日志(Telegram 保留约
48 小时)读取到 admin-log.json 中:包括删除和编辑操作,以及相关内容、
操作账户和源操作日期。这些条目补充了实时日志的
捕获版本和删除接收记录。
指标#
报告列表及存档中包含 indicators.csv
、indicators.stix.json
(STIX 2.1
)
以及 indicators.misp.json
(MISP
事件),滥用处理部门可据此对记录的消息采取行动:
链接和域名(包括隐藏在文本中、按钮内及链接预览中的内容)、加密货币
地址、Telegram
用户名和邀请链接、电话号码、电子邮件地址以及保存的图片。
比特币、莱特币、狗狗币和波场地址仅在 base58 校验和通过时才会被列出,
SegWit 地址在 bech32 或 bech32m 校验和通过时会被列出,而 TON 地址在 CRC
校验通过时会被列出;EVM 和 Solana 地址则被标记为未经过校验。 图片包含 SHA-256
以及一个感知
哈希(dHash,64 位),其值在重新压缩或调整大小的副本中几乎保持不变。报告会写入
标记,以防止意外打开(hxxps[://]example[.]com
);文件保留
原始值不变。 每个指示符均被标记为未知且不适用于自动检测(STIX
、
indicator_types: unknown
、MISP
、to_ids: false
,分发至本组织):被
列出仅表示某条消息中包含该指示符,并不意味着其具有恶意。若链接的文本显示的
地址与其实际打开的地址不同,则该链接会在报告中被标记。
PDF报告末尾包含一份需由检查员亲笔签署的声明、一份供公证员或 法院专家使用的核对清单,以及一个二维码(首页亦有显示),其中包含报告ID、密钥指纹以及 权威数据的SHA-256,以便打印件可追溯至其存档。
事件规范化#
哈希输入必须包含以下字段:
seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash
使用与 Python 兼容的 JSON 格式进行序列化,采用 UTF-8 编码,对象键按顺序排列,不进行 ASCII 转义,不包含无关的空白字符,且不包含 NaN/无穷大:
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通知包含消息ID,且actor字段为空;
可用的管理日志条目包含其提供的操作、执行者和日期。
成员服务消息保留发送者和操作类型,原始参与者更新
保留提供的actor_id,而反应快照保留其提供的
计数和可见身份。请结合捕获的
版本和面板交互收据一起阅读这些记录。
私聊和普通群组的删除通知仅包含消息 ID。
这些聊天共享一个全账户范围的 ID 序列,因此一个 ID 唯一标识该
账户中的一条消息。当具有该 ID 的消息此前已保存在日志中时,
删除操作会在该聊天中以 `message.deleted` 的形式记录,其中 `payload.chat_resolution`
指定了方法名称。从未被保存过的 ID 将作为 deletion.unscoped 保留:这是一种
实际的删除通知,但其对应的聊天尚未被关联。 这与
message.missing_on_recheck(记录不可用的查询结果)以及
已保存消息 ID 中的缺口有所不同。频道和超级群组按聊天对消息进行编号,
绝不会通过这种方式进行匹配。当被删除的消息是由被观察账户发送时,
payload.deleted_message_was_outgoing 为 true;但仍未提供删除者信息。
无范围的通知会保留其自身的标签,因为匹配的聊天可能位于 当前观察范围之外,或者没有唯一匹配项。在报告计数、过滤器和 标签中,重新检查缺失仍与删除通知视为 独立的观察项。后续的恢复操作会清除当前的缺失状态,同时在 签名历史记录中保留先前的检查失败记录;删除通知仍作为 独立的事件类型存在。
来自同一条通知且解析为同一聊天室的多个ID将被归类为
deletion.batch,无论其数量多少,其中消息ID完全按照Telegram
发送时的原样保留,并记录该账户发送了多少条。Telegram的通知中
列出了这些消息;聊天室的管理员日志会标明实际操作的管理员,该账户
可在该处查阅。 链接(message.deletion_attributed)的建立取决于以下两种情况中发生得较早的那一种:
如果某次轮询在删除通知记录之前就已看到管理员日志条目,则在通知
被记录时,该轮询将被匹配。
覆盖范围:连续性、缺失内容及未被观察到的 ID#
每个签名 ZIP 文件都包含 coverage.json,HTML 报告以相同的摘要开头,而
verify.py 会根据 events.jsonl 重新计算该摘要,而非直接信任该文件:
- 从 X 到 Y 持续进行观察。一个观察周期始于
observation.started, 并结束于暂停、停止、Telegram 连接丢失、注销、未按正常流程停止的进程启动, 或观察期间超过三分钟无任何记录 (心跳每分钟写入一次,因此无记录意味着进程已停止、卡死或 计算机进入睡眠状态)。 当在更多工具 → 参数中更改心跳间隔时,每次心跳 都会记录该间隔,允许的静默时间将变为三个间隔,且绝不少于三分钟。 - “缺口”列出了各时段之间的时间间隔及原因。若最后
一条记录处仍存在缺口,则标记为
not_resumed_by_last_record。 - 未观察到的消息 ID。对于按 聊天计数消息的频道和超级群组,观察到的消息 ID 之间的缺失 ID 将以范围形式列出。这些消息会被报告为 “未观察到”——即已被删除、从未送达或超出保存的历史记录范围——但绝不会被标记为 “已删除”。私人聊天和普通群组共享全账户范围的序列号,因此此类聊天内部的 缺口没有任何意义,也不会在此处列出。
- 聊天层面的数据缺失通知(例如 Telegram 在某个 频道中要求恢复差异数据)被计为注释;它们不会中断全局覆盖。
- Session records. Windows in which Telegram's update counter grew while no update
reached this session (
updates_diverted), this session left Telegram's session list while its connection kept working (session_revoked_externally), or a witness probe's answer arrived only from history (probe_ack_missed_live) are listed separately. The verifier also reports where the Telegram session key came from, other sessions signed in when observation started, sessions added during observation, Telegram security notices (777000), other sessions ended from the workspace, only-session periods, witness probe counts and phone call updates. See accounts. While strict chosen chats is on (scope.strictinobservation.started), the session list (except while this is the only session, or when Telegram devices is on), security notices and phone call updates are not collected, so their absence says nothing, and a deletion is matched to a session check only if one ran in the 10 minutes before it.
更新序列 (pts)#
Telegram 通过以下方式更新与消息相关的信息: pts:每个账号有一个序列
(将私人聊天和基本群组合并为一个),每个频道或超级群组则各有一个序列。该
收集器将收到的每个无缺口的序列记录为 coverage.sequence
一条记录:起始和结束 pts、每种类型的更新数量,以及它们是
实时推送的还是由 getDifference 或 getChannelDifference返回。中断被视为一个
coverage.gap 记录,并 coverage.gap_closed 指明 pts ,从该点起,序列
又恢复完整。
一段连续的记录表明,Telegram在该序列中编号的每一条更新,从
第一条到最后一条 pts 之间,Telegram按该序列编号的每次更新都已到达该收集器的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.
预览。 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“count”命名的数字均视为已观察到的消息,不包含内容。导出或 移交选定聊天记录无法测量该数值。如果全账户收集功能曾被 关闭后又开启,则会提示说明:期间使用的数字将显示为缺口。 - 服务消息是带有独立编号的日志记录,因此它们会自动填补间隙; 可选的估计时间仅作为上下文参考。
verify.py 重新计算 gap_summary 基于 events.jsonl 基于签名
coverage.json 成员中的参数(针对旧版存档使用默认值),并
在覆盖范围摘要中打印该账户范围内的行。该存档的 get_capture_status(MCP 和命令行)针对某次访问可能读取的聊天记录返回相同的测量结果;
而账户级序列仅适用于覆盖整个工作区的访问。
对同一服务消息的重复观测仅计为一次,且账户服务估算 仅使用测量范围内的数值。在启用全账户测量之前,应用范围必须显式保留 该账户自身的消息;测量 从携带该信息的记录开始。测量范围涵盖正在运行的 观测,且其恢复情况会被记录。实时归档查询具有时间 预算(包括其数据库扫描),并将未完成的测量标记为部分完成。
Telegram 记录了独立的消息 ID 序列。 这些数字描述了观察结果;删除通知、重新检查以及管理日志记录 了为何在 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 报告和验证器会显示此签名
的 producer 记录。源文件哈希值用于标识记录的源代码树,以便
与可信的检出版本进行比对。 执行溯源信息将通过
GitHub 获取证明或
Intel TDX 测量(若已启用)进行单独验证。在
生产者字段出现之前创建的存档仍受支持,并被标识为遗留记录。
每条 observation.started 记录还会指明进行监视的 Telegram 客户端:其 api_id
(绝非哈希值),无论该客户端是内置的公钥对还是运营商自有的应用程序,
Telegram 连接请求中发送的客户端描述,以及连接
路由的类型及其 IP 模式(无代理地址或密钥)。 该报告和custody.json列出了每个
不同的客户端和路由及其记录时间,以及未列出的代理未响应的时间
和Telegram检测到服务器地址的时间。此前记录的日志中已有说明。
人物简介#
应请求,系统会基于日志中已有的
某次聊天的记录生成个人资料文件(tgwitness-dossier-v1,JSON);该文件不会从 Telegram 获取任何数据,且个人资料内容绝不会
写入日志(个人资料的启用和停用将记录为 dossier.changed)。
对于每位拥有已保存消息的用户,该文件会列出其姓名和用户名历史记录、Telegram标记
(机器人、诈骗、虚假、高级、已验证、受限、已删除)——以保存时显示的状态为准,以及个人资料
照片ID、来自本地头像缓存中与该头像相似的头像的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
该工具会检查签名,验证证据导出文件本身(包括签名、哈希链和文件), 并确保每个被引用的记录在同一工作区的导出文件中完整无缺且未被修改。头像哈希值会被标注为来自本地缓存 (而非日志记录)。提及内容属于模式匹配,是待核查的线索。 配置文件按聊天进行启用,可导出为带密码的 AES-256 压缩包,且 在关闭配置文件或聊天从来源中移除时被删除。
独立见证者#
通过 verify.py --witness … --channel … 命令,将见证人日志(tgwitness-witness-v1)及其频道帖子与
证据导出文件进行比对;参见独立见证人。
使用公共 https://t.me/s/… 或 https://telegram.me/s/… 地址时,验证器会从 Telegram 中读取
每条帖子的日期,而导出文件开头处最早的此类日期
即为最后一条记录的外部时间。来自任何其他来源的日期均为提供的元数据。
清单与检查点#
manifest.json 包含格式、导出时间、公钥、指纹、日志
长度、头部哈希、作用域、生成者、限制,以及除 manifest.json 和 manifest.sig 本身之外
每个内容成员的 SHA-256 值。
manifest.sig 是规范化清单 JSON 的 Base64 Ed25519 签名。
验证器会拒绝处理意外/缺失的成员、名称重复、文件损坏、
序列/链断裂、无效签名以及与提供的检查点不匹配的情况。
它绝不会提取归档路径。它将声明的总未压缩大小限制为 4 GiB;
--max-gib N 允许通过提高更多工具 → 参数中的限制来创建更大的归档文件。
大型存档由多个进程同时进行校验:成员记录会并行进行哈希计算,
在前5,000条记录之后,每个记录的内容哈希值和签名将由
工作进程进行校验,而主进程则按顺序跟踪链、覆盖范围和绑定
关系。 --jobs N 用于设置进程数量;默认 auto 是每个CPU一个进程,
最多16个,而 --jobs 1 将所有操作保留在一个进程中。无论采用哪种方式,结果都是一样的,
且更改请求都会因相同的错误信息而被拒绝。在该单次遍历过程中,会保留由保留的
检查点和时间戳锚点指定的位置处的哈希值,因此无需再次读取日志即可
对每个锚点进行比较。 在一台 32 线程的计算机上,一个包含
400,000 条记录、大小为 10.8 GB 的归档文件,在单个进程中耗时 58.9 秒,在 4 个进程中耗时 15.2 秒,在 16 个进程中耗时 8.4 秒;按顺序对
记录进行一次遍历后,便确定了上限。
请从您已安装的 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以及保证结果,而不仅仅是退出
代码。密封获取则使用其
证明验证器和已批准的策略来验证获取摘要。
验证范围#
验证过程会检查存档文件及其生成所使用的采集模式。请选择 其信任边界与当前情况相匹配的模式,并保留该模式的验证输入。
| 采集模式 | 验证器检查的内容 | 验证输入与信任边界 |
|---|---|---|
| 本地工作区 | 记录签名、哈希链、清单和附件字节 | 接收方保留的收集器指纹以及来自第三方的时间戳:经过验证的 RFC 3161 或 OpenTimestamps 收据,或从 t.me 读取的见证人帖子。保留的检查点和见证人记录作为辅助验证依据。 |
| 带独立见证节点的本地工作区 | 归档校验以及与见证人保留的早期日志前缀的一致性 | 见证者指纹和记录;保管方的密钥控制记录表明见证者密钥由谁持有。使用 --channel https://t.me/s/… 时,Telegram 为帖子设定的日期提供外部时间 |
| GitHub Actions 捕获 | GitHub 对存档摘要、已批准的工作流和收集器提交、托管运行器、新的会话/密钥来源以及内部存档完整性的认证 | 可信验证者策略、调用者存储库和 GitHub 证明包;数据采集在固定工作流下运行 |
| 云部署 | 提供商的生命周期和访问记录、防火墙和 Cloudflare 状态,以及收集器的签名运行记录 | 对服务提供商和 Cloudflare 进行只读查询;各项检查的可用性取决于服务提供商 |
| Intel TDX 机密虚拟机 | 引用签名和平台状态,将其与收集器声明、组装及操作系统测量数据相关联 | Intel 信任链及预期部署指标;保留每次必需的 TDX 检查结果 |
在密封采集过程中,经批准的采集器通过经过身份验证的 Telegram 连接在已验证的环境内接收数据。证明将归档文件与 该执行过程绑定,因此验证既涵盖采集过程,也涵盖后续的文件完整性。 这依赖于经批准的代码以及上文列出的平台信任链。 GitHub 捕获验证要求在运行过程中创建会话,并拒绝 导入会话的捕获。
运行收据记录了收集器的版本、文件哈希值和启动设置。GitHub 来源信息和 TDX 测量结果用于环境验证; 验证记录标识了已测试的配置。
消息的来源#
Telegram 通过 MTProto 会话向每个客户端(包括官方应用)发送消息。该会话的授权密钥是根据 Telegram 的 固定服务器密钥协商生成的,每次更新都会使用该密钥进行加密并经过完整性校验后 发送。收集器通过账户的经过身份验证的 会话接收消息,并在每条观察记录到达时将其签名记录到日志中,其中包含聊天、 消息和发件人标识符,以及 Telegram 为每条消息设定的日期。在 GitHub Actions 捕获和 Intel TDX 部署中,认证还会将该会话和 签名密钥与已批准的收集器执行绑定。
日志记录授权密钥的来源。通过手机或二维码登录,
或从会话文件独立登录,会将 account.authorized 写入日志,并标注
key_origin: "created";基于导入的 .session、TData 或 JSON 密钥进行收集时,则写入
imported。无论源自何处,导入的密钥均会保留。经认证的部署
拒绝使用导入的密钥。
一条记录在Telegram中的来源基于该账户的经过身份验证的连接、
日志中的连接和捕获记录、与日志条目匹配的已捕获MTProto帧
(tgwitness/forensics/)、每条
消息在Telegram中的日期,以及对于经认证的捕获,还包括经过验证的执行环境。 存档签名
可保存该记录以供日后核查。保留的检查点确定了早期日志的
边界,覆盖记录显示了采集结果,而经过验证的外部时间戳
则将已提交的字节定位在特定时间点。
对于本地工作区,接收方需提供可信收集器或见证人的输入。 对于密封采集,可信策略和证明将归档摘要与 经批准的收集器执行绑定。这些是不同的验证路径;请报告 所选路径上已完成的检查。
附件#
文件在 media/ 目录下通过 SHA-256 哈希值进行标识。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 事件包含 运行 ID、本地时钟、依赖项版本、源文件哈希值、初始账户/作用域, 以及捕获设置。心跳消息包含运行 ID、单调时间和队列状态。 运行收据也可作为单独签名的声明下载。若要验证 执行环境,请将其与验证范围中所述的 GitHub 证明或 TDX 检查 结合使用。
自动检查点会在启动时、观察期间每五分钟 (更多工具 → 参数 → 每隔)以及有序停止时保存在本地。启动验证和导出操作会将日志 与最新保留的本地检查点进行比对。当检查点仍存在时,此操作可检测到数据库回滚 。独立保留机制确保该引用在 工作区之外仍可用;经过验证的外部时间戳则进一步将其锚定在特定时间点。
重启后,将恢复保存的 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进行恢复和验证。
恢复操作需要一个空的普通目录。下载的文件和解密后的对象将保存在私有 临时存储中,直至整个日志及所有保留的检查点均通过验证。不安全的对象 路径、不一致的段范围以及长度短于检查点的日志将被拒绝;验证失败 时,系统不会发布任何恢复文件。 保留性检查会将返回的“对象锁定” 模式和日期与上传时发送的截止时间进行比对(允许一秒的四舍五入误差)。过期、 无效或被缩短的截止时间均不视为已验证。状态报告将显示该上传批次中 被读取保留状态的抽样对象。
缺失或损坏的本地媒体文件将作为当前迭代的错误报告,并保持媒体光标停留在 该文件之前,以便在下一次迭代中重新尝试处理该文件;其后的文件、检查点和导出内容仍将 被复制。恢复过程会 将所有已保存媒体的引用与解密后的哈希值及记录的大小进行比对。 来自中断上传的 相同重叠日志段将被去重;冲突的重叠部分将被拒绝。 上传过程中创建的检查点将推迟处理,直至其所涵盖的日志记录被 复制完毕,因此一个完成的处理阶段不会在日志之前发布检查点。
流式导出快照#
流式导出使用稳定的 SQLite 读取快照。当下载完成时,该快照的起始点可能早于 当前的实时日志。在此快照之后创建的检查点 可能会正确报告存档长度较短;请与位于导出前缀处或之前的检查点进行比较, 而非任意的后续检查点。
RFC 3161 准备与响应验证 (0.2)#
证据模式仅通过工作区路径(绝不通过 MTProxy)将每个已签名检查点的 SHA-256 哈希值发送至列出的 RFC 3161
权威机构和 OpenTimestamps 日历。
在每个设置目标中,时间戳功能默认开启;案件的证据还会记录 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 中的随机非ce值、校验和及操作说明。 不会发起任何网络请求;授权方为此请求返回的令牌即为时间戳。
python -m tgwitness.anchor verify 无需 OpenSSL,即可根据检查点字节和原始请求核对响应。必须明确指定受信任的 CA 文件;附带的证书不会被自动信任。在 CLI 中请求检查是可选的,因此请保留请求,并传入 --request 以检查 nonce。结果会说明是否进行了检查。收集器的检查点签名和日志仍需使用受信任的收集器指纹另行验证。
验证过程会检查响应签名、检查点字节以及(若提供的话)
在指定 CA 信任下生成的原始请求。对于在证据模式下获取的时间戳, verify.py 还会检查存储的 OCSP 或
CRL 证据(签名证书吊销)。
请参阅 流程 以及 验证结果.
证据模式下的可选记录: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 )进行解析的服务器,每次
复制都会包含自上次复制以来 Gateway 记录的内容:每个时间窗口(最长三
小时)对应一条记录,包含 from、until、location_id、服务器的 address(若已设置),以及
queries(作为 [at, name, type, rcode, decision, colo],即使没有记录时也包含)。 请在
下进行设置。Cloudflare Gateway日志:账户、位置、可选地址以及一个只读令牌(账户
Analytics 读取;零信任 PII 读取,用于保留共享位置的一个地址)。控制面板会在保存前通过
一次请求验证这些信息;令牌始终保持加密状态,且绝不会进入日志。
verify.py 列出了时间窗口、被查询次数最多的名称以及任何未被副本覆盖的时间段;如果某条记录
的计数与其查询不匹配,则该记录将失败。 若某个时间窗口在单秒内包含超过一页的
查询,则保留该页内容,并标注其余部分缺失。该副本是
Cloudflare 通过收集器返回的响应,并由收集器签名;在 24 小时内,任何持有
只读令牌的用户均可将其与 Cloudflare 进行比对。