创建和管理项目

本页介绍如何在 Agora 控制台创建项目、查看项目信息和管理项目证书。

使用限制

• 对于有不同角色和权限的账户，只有管理员、工程师和拥有项目权限的自定义角色可以查看项目管理页面。
• 一个账户最多可创建 20 个项目，包括已删除的项目。如果需要创建更多项目，请通过工单系统申请。
  在 2021 年 10 月 1 日前注册的账户最多可创建 10 个项目，包括已删除的项目。如果需要创建更多项目，请通过工单系统申请。

创建项目

参考以下步骤创建一个 Agora 项目：

1. 进入 Agora 控制台的项目管理页面。
2. 在项目管理页面，点击创建按钮。
3. 在弹出的对话框内输入项目名称、使用场景，然后选择安全模式： APP ID + Token。
4. 点击提交按钮。新建的项目会显示在项目管理页中。

查看项目信息

对于已创建的项目，你可以在项目管理页面进行以下操作：

• 查看项目基本信息，包括项目阶段、项目名称、创建日期。
• 点击 App ID 右侧的 图标，可以复制项目的 App ID。
• 点击配置，可以进入项目详情页面，查看和修改 App 证书、项目状态、拓展能力的启用情况等。

管理 App 证书

App 证书是 Agora 控制台为开发项目生成的字符串，用于开启 Token 鉴权。根据不同的安全需求，Agora 项目提供以下几种 App 证书：

• 主要证书：可以用于生成临时 Token 和正式 Token。
• 次要证书：只可用于生成正式 Token，并且不适用于 RESTful API。
• 无证书：只有在创建项目时选择调试模式：APP ID 为鉴权机制，才会显示为无证书。

启用主要证书

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

• 如果在创建项目时选择 安全模式：APP ID + Token 为鉴权机制，主要证书会默认启用。在项目详情页面，点击主要证书下方的 图标，即可查看并复制主要证书。

• 如果在创建项目时选择 调试模式：APP ID 为鉴权机制，你需要手动启用主要证书。在项目详情页面，打开主要证书下方的开关。
  

  成功启用后，你可以点击 查看并复制主要证书。此时，App ID 和主要证书生成的 Token 均可用于鉴权。

启用次要证书

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

在项目详情页面，打开次要证书下面的开关。

成功启用后，你可以点击 查看并复制次要证书。此时，主要证书和次要证书生成的 Token 均可用于鉴权。

更换主要证书

如果主要证书存在安全风险，你可以将次要证书更换为主要证书，并删除原来的主要证书，以规避风险。

参考如下步骤更换主要证书：

1. 启用次要证书。
2. 在次要证书右侧，点击切换为主证书，将次要证书和主要证书互换。
3. 关闭次要证书下方的开关，停用当前的次要证书。
4. 按照屏幕提示完成身份验证。验证成功后，次要证书的状态会变成已停用，并且会出现删除选项。
   
5. 点击删除。
6. 按照屏幕提示完成身份验证。验证成功后，删除选项会消失，此时次要证书（即原来的主要证书）已成功删除。

删除无证书

只有在创建项目时选择调试模式：APP ID 为鉴权机制，Agora 才会为你启用无证书。无证书表示项目的安全性较低。

参考以下步骤删除无证书：

1. 启用主要证书。
2. 点击无证书右侧的删除按钮。
   
3. 按照屏幕提示完成验证。