Telegram

RootAuth 支持接入 Telegram 登录。开启后，用户可以在登录/注册页选择「Telegram」，通过 Telegram 官方授权完成登录或注册，无需输入密码。

路径：登录 RootAuth 控制台 → 进入目标应用 → 点击顶部导航栏的「配置」→「应用管理-认证配置」→ 选择「提供方」

 

1. 开始前准备

配置 Telegram 登录前，请先完成以下准备：

1. 拥有一个 Telegram 账号。
2. 在 Telegram 中联系 @BotFather 创建机器人。
3. 在 @BotFather 中为机器人配置 Web Login 域名。
4. 获取 Telegram 提供的 Client ID 和 Client Secret。

Telegram 会校验授权域名。请确保 BotFather 中配置的域名，与 RootAuth 后台展示的回调地址所属域名一致。

 

2. 在 RootAuth 后台开启 Telegram

在「提供方」列表中找到 Telegram，点击右侧「启用」。

打开配置弹窗后，开启 Telegram 登录开关，并填写以下信息：

填写完成后，点击「保存」。

保存成功后，Telegram 会显示为「已启用」，右侧按钮变为「管理」。后续如需调整配置，可点击「管理」重新编辑。

3. 用户如何使用 Telegram 登录

开启后，登录/注册页会展示 Telegram 登录按钮。

用户点击「Telegram」后，会进入 Telegram 官方授权流程。根据用户当前登录状态，Telegram 可能会弹出授权窗口，或跳转到授权页面。

用户确认授权后，RootAuth 会自动完成以下操作：

1. 获取 Telegram 返回的用户公开信息。
2. 使用 Telegram ID 查找是否已有账号。
3. 如果已有账号，直接登录。
4. 如果没有账号，自动创建新账号并完成登录。

4. 查看用户的 Telegram 认证方式

用户通过 Telegram 登录或注册后，可以在用户详情中查看认证记录。

进入「用户管理」，打开对应用户详情，在「认证方式」区域查看。

Telegram 认证方式会展示：

如果应用通过 API 解绑了用户的 Telegram 账号，该认证方式会从用户详情中移除。

 

5. 接入方式

Telegram 登录支持两种接入方式：

具体的接入指引，请参考开发集成文档

 

6. 关闭 Telegram 登录

如需关闭 Telegram 登录，进入 Telegram 管理弹窗，关闭开关并保存。

关闭后：

1. 登录/注册页不再展示 Telegram 登录按钮。
2. 已保存的 Telegram 配置会保留。
3. 已有用户的 Telegram 绑定记录不会被删除。