创建和管理项目

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

创建新项目

创建新项目的步骤如下：

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

2. 在项目管理页面，点击创建按钮。

   

3. 在弹出的对话框内输入项目名称，选择一种鉴权机制。

   Agora 提供两种鉴权机制：APP ID + APP 证书 + Token（推荐）和 APP ID。我们推荐使用安全性更高的 APP ID + APP 证书 + Token 鉴权机制：

   • 在项目测试阶段，启用主要证书后可以直接在控制台生成一个临时 Token 进行测试。详见获取临时 Token。
   • 项目准备正式上线时，你需要在你的服务端部署一个 Token Generator 来生成正式 Token。详见生成正式 Token。

   

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

管理已创建的项目

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

• 查看项目基本信息，包括：

  • 项目阶段：测试中、已上线、未表明
  • 项目名称
  • 创建日期
  • App ID

• 点击 ，可在网页端即刻体验实时音视频通信。

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

  只有主要证书可以用来生成临时 Token，详见启用主要证书。

• 点击用量，查看项目用量。

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

管理 App 证书

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

• 主要证书：用于生成临时 Token 和正式 Token。你不能删除主要证书。
• 次要证书：只可用于生成正式 Token。启用次要证书后，你可以将次要证书与主要证书互换或删除次要证书。

启用主要证书

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

• 如果你在创建项目时，选择 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 鉴权。启用主要证书后，你还可以删除无证书。