通知
本站点除 Legacy 产品与方案外,已迁移至 声网新文档中心 ,当前页面不再维护
文档中心
全部产品
Console 官网 社区 技术支持

如何升级到 Token 鉴权方案?

分类: 集成类    平台: All Platforms   最后更新时间: 2023/01/03 18:37:02

为提高项目的安全性,Agora 会逐步取消对 App ID 鉴权方案的支持。对于创建时选择 APP ID 为鉴权机制的项目,你可以参考本文升级到 Token 鉴权方案。

1. 开启 App 证书

如果你在创建项目时,选择 APP ID 为鉴权机制,则需要先手动启用主要证书。

编辑项目页面,找到主要证书,点击启用。成功启用后,你可以点击 查看并复制主要证书。

开启 App 证书后,项目同时支持 App ID 和 Token 鉴权,因此不会对当前使用 App ID 鉴权的 app 客户端产生影响。

2. 在服务端生成 Token

参考在服务端生成 Token 在你的 app 服务器上部署生成 Token 的代码。

3. 修改客户端逻辑

你需要修改 app 客户端的鉴权逻辑。将 joinChannel 或者 login 方法中的 token 参数填入服务端实际生成的 Token。

4. 灰度升级

此时你可以开始对 app 客户端进行灰度升级。该状态同时支持用户直接加入频道,或者通过 Token 鉴权后加入频道。

5. 删除无证书

当全部用户切换到 Token 鉴权后,在控制台中删除项目的无证书,防止用户不经鉴权就加入频道。

一旦删除无证书,未使用 Token 鉴权的客户端会无法加入频道。