开发文档

Telegram 网站登录、OIDC 与 Passport

区分登录网站、授权 Telegram 客户端和身份资料共享,正确处理 ID Token、回调地址与 Passport 加密数据。

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

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

本页内容
  1. 登录网站不等于获取账号会话
  2. Passport 用于明确的数据共享
  3. 接入建议

登录网站不等于获取账号会话

当前 Telegram Login 文档提供登录库与 OpenID Connect 流程,旧 iframe widget 文档另行归档。注册允许的地址并验证 ID Token,是网站建立登录状态的一部分;这不会自动给网站一个可读取聊天的 Telegram 客户端会话。

客户端处理 URL 授权时还需按深度链接来源和请求上下文展示确认,不能把任意链接交给授权方法。

Passport 用于明确的数据共享

Passport 让用户选择并同意共享身份资料,接收服务通过自己的密钥读取所获内容。Bot 侧接收与用户客户端侧的提交流程不同;编码、密钥和完整性校验必须采用对应说明,不能只做 Base64 解码后就视为可信。

接入建议

先确定需要的是普通网站身份还是证件资料,尽量只请求必要范围。回调地址严格匹配,验证签发者、受众、有效期及当前登录事务。登录成功后建立自己的受限会话;撤销授权和删除已保存资料应有清晰入口。

不要把 Passport 当成一般客服或申请 API ID 的必需步骤。