本页介绍如何在 Agora 控制台创建和管理项目。

角色为管理员和工程师的账户拥有查看项目管理页面的权限。

创建新项目

一个账户最多可创建 10 个项目,包括已删除的项目。如果需要创建更多项目,请通过工单系统申请。

创建新项目的步骤如下:

  1. 登录控制台,点击左侧导航栏 项目管理按钮进入项目管理页面。
  1. 项目管理页面,点击创建按钮。

  1. 在弹出的对话框内输入项目名称,选择一种鉴权机制
Agora 提供两种鉴权机制:APP ID + APP 证书 + Token(推荐)APP ID。我们推荐使用安全性更高的 APP ID + APP 证书 + Token 鉴权机制:
  • 在项目测试阶段,启用主要证书后可以直接在控制台生成一个临时 Token 进行测试。详见获取临时 Token
  • 项目准备正式上线时,你需要在你的服务端部署一个 Token Generator 来生成正式 Token。详见生成正式 Token

  1. 点击提交后,新建的项目就会显示在项目管理页中。Agora 会给每个项目自动分配一个 App ID 作为项目唯一标识。

管理已创建的项目

对于已创建的项目,你还可以在项目管理页进行以下操作:

  • 查看项目基本信息,包括:

    • 项目阶段:测试中已上线未表明
    • 项目名称
    • 创建日期
    • App ID
  • 点击 ,可在网页端即刻体验实时音视频通信。

  • 点击 img,可生成临时 Token,用于在项目测试阶段进行鉴权。

    只有主要证书可以用来生成临时 Token,详见启用主要证书
  • 点击用量,查看项目用量。

  • 点击编辑,进入编辑项目页面,编辑项目信息,包括项目阶段、项目名称、App 证书、临时 Token、项目状态等。

管理 App 证书

App 证书是 Agora 控制台为开发项目生成的字符串,用于开启 Token 鉴权。根据不同的安全需求,Agora 在项目中设置了两种 App 证书,区别如下:

  • 主要证书:用于生成临时 Token 和正式 Token。你不能删除主要证书。
  • 次要证书:只可用于生成正式 Token。启用次要证书后,你可以将次要证书与主要证书互换或删除次要证书。
  • 无证书表示仅使用 App ID 鉴权。只有在创建项目时选择 APP ID 为鉴权机制,你才会看到无证书
  • 次要证书不适用于 RESTful API。

启用主要证书

在对安全要求较高的场景中,你可以通过以下方法启用主要证书:

  • 如果你在创建项目时,选择 APP ID + APP 证书 + Token 为鉴权机制,Agora 会默认为你启用主要证书。主要证书会显示在编辑项目页面,你可以点击 查看并复制主要证书。
  • 如果你在创建项目时,选择 APP ID 为鉴权机制,那么你需要手动启用主要证书。在编辑项目页面,找到主要证书,点击启用。成功启用后,你可以点击 查看并复制主要证书。此时,App ID 和主要证书生成的 Token 均可用于鉴权。

启用次要证书

开启主要证书后,在需要更换 App 证书的场景中,你还可以启用次要证书。

编辑项目页面,找到次要证书,点击启用。成功启用后,你可以点击 查看并复制主要证书。此时,主要证书和次要证书生成的 Token 均可用于鉴权。

更换和删除主要证书

启用主要证书和次要证书后,如果主要证书存在安全风险,你可以将次要证书转换为主要证书并删除原来的主要证书,从而规避风险。

参考如下步骤更换和删除 App 证书:

  1. 找到次要证书,点击切换为主证书,次要证书就会和主要证书互换。切换后,使用原主要证书生成的临时 Token 会失效。
  2. 点击删除即可删除原主要证书。删除后,你无法恢复该证书,且使用该证书生成的 Token 会失效。你需要使用新的主要证书重新生成 Token 并鉴权。
  3. 删除后,次要证书的状态会变成未启用。下次启用时会生成新的次要证书。

删除无证书

只有在创建项目时选择 APP ID 为鉴权机制,Agora 才会为你启用无证书无证书表示用户仅使用 App ID 鉴权,安全性较低。

如果你需要提高安全性,你可以启用主要证书,并使用 Token 鉴权。启用主要证书后,你还可以删除无证书

一旦无证书被删除,你无法仅使用 App ID 鉴权,且项目无法重新开启无证书。