This article shows how to create and manage projects in Agora Console.
To create a new project, follow these steps:
Log in to Agora Console, and click in the left navigation menu to enter the Project Management page.
Enter your project name and select your authentication mechanism in the dialog box.
Click Submit, and you can see the project on the Project Management page. Agora automatically assigns each project an App ID as a unique identifier.
For created projects, you can also do the following on the Project Management page:
Search: Enter a project name or App ID, and click to search for a project.
View basic project information, including:
Click to enable real-time communication on the web page.
Click to generate a temporary token for authentication during the project testing stage.
Click Usage to view the amount of Agora services the project uses.
Click Edit to view the Edit Project page. You can edit your project information, including the following:
An app certificate is a string generated from Agora Console, and it enables token authentication. For different security requirements, Agora provides two types of app certificates. The differences are as follows:
For scenarios requiring high security, you can enable a primary certificate as follows:
If you choose the APP ID + APP Certificate + Token authentication mechanism when creating a project, Agora enables the primary certificate for you by default. On the Edit Project page, you can click to view and copy the primary certificate.
If you choose the APP ID authentication mechanism when creating a project, you need to enable the primary certificate manually. On the Edit Project page, find Primary certificate and click Enable. Once the primary certificate is enabled, you can click to view and copy the primary certificate, and use either an App ID or the token generated by the primary certificate for authentication.
After successfully enabling the primary certificate, you can enable the secondary certificate when you need to change app certificates.
On the Edit Project page, find Secondary certificate, and click Enable. Once the secondary certificate is enabled, you can click to view and copy the secondary certificate, and use either the primary certificate or the secondary certificate to generate tokens for authentication.
After enabling both the primary certificate and the secondary certificate, if the primary certificate is exposed to security risks, you can switch it to Secondary certificate and delete it.
To switch and delete the primary app certificate, do the following:
Find Secondary certificate, click Set as primary to switch the secondary certificate and the primary certificate. Once you switch the primary certificate to the secondary certificate, all temporary tokens become invalid.
Click Delete to delete the original primary certificate. You cannot restore the deleted certificate, and all tokens generated by the original primary certificate become invalid. You need to use a new primary certificate to generate tokens for authentication.
After deletion, the status of the secondary certificate becomes Disabled. A new secondary certificate is generated when you click Enable next time.
No certificate is enabled only if you choose the APP ID authentication mechanism when creating a project. No certificate means that your project uses only the App ID for authentication, which is less secure.
If you need to raise the security level, you can click Enable to enable the primary certificate, and generate a token for authentication. After enabling the primary certificate, you can delete No certificate.
To delete a specified project, call Agora Server RESTful API https://api.agora.io/dev/v1/project.