开发文档

Telegram 私密聊天、密钥轮换与消息顺序

理解 Telegram 私密聊天的独立加密边界、顺序检查和密钥轮换,避免把 HTTPS 或普通 Bot 对话称为端到端加密。

GetTGAPI 编辑团队更新于
文档解读核对日期

依据官方资料整理,由 GetTGAPI 独立维护。 文档目录与术语表 →

本页内容
  1. 先明确加密端点
  2. 顺序检查属于安全要求
  3. 轮换不是随意更换密钥
  4. 接入建议

先明确加密端点

私密聊天有独立的端到端协议与 TL schema。普通云聊天、Bot 对话、HTTPS 连接和私密聊天不是同一种安全模型。文档中的密钥管理规则也不能用一句“数据库加密”代替。

顺序检查属于安全要求

私密聊天序号用于检测重放、重排和遗漏,服务消息也参与序列。奇偶校验、缺口恢复和删除处理均有严格规则。不能为了让消息显示出来而忽略不符合协议的序号。

轮换不是随意更换密钥

PFS 文档定义重新协商、接受、提交和旧密钥退出的步骤,未完成交换时不能并行发起另一轮。旧密钥的销毁和用户看到的安全核验也需要正确实现。

接入建议

优先使用经过维护的实现,并按官方安全检查逐项审查;本文不是密码协议实现说明书。将消息传输、磁盘加密、设备密钥和备份恢复分别评估。测试异常序列时使用隔离账号,不把失败检查改成宽松通过。