2-Click Setup: Testing Token Server

Hermes
Agora.io
Published in
3 min readMar 29, 2019

To run a production app using Agora.io’s Voice and Video SDK, developers need to implement a token server.

This requires efforts on both the front-end and backend. Sometimes when trying to coordinate, the two teams realize they need to develop both in parallel. But how can the front-end get built and tested without a backend?

Luckily some of the great developers in the Agora.io dev community put together a repo of a NodeJS implementation with a quick setup/deployment button that you can use for testing your front-end implementation. To make things even simpler, I’ve included everything you need below.

Please note: Agora is not responsible for any charges you may incur from Heroku, as Heroku is an independent service provider and not affiliated with Agora.

This tutorial is meant to provide a testing environment for front end developers and is not meant for production purposes. If you choose to use this development environment in production you do so at your own risk.

Prerequisites

Preparation

Make sure you are logged into your Heroku account and have logged in to your Agora.io Developer account. You’re also going to need to have an app setup with the App Certificate enabled.

note: enabling App Certificate requires email confirmation

Deployment

Click the deploy link above to start

Fill in your: app name, Agora.io APP_ID, and APP_CERTIFICATE

Make a cup of coffee and wait for heroku to finish :)

Smash that Deploy App button!

Once the server is running you replace <heroku url> below with your instance url and generate tokens using this endpoint.

https://<heroku url>/access_token?channel=test&uid=1234

Thats it

Now your front-end team can add some simple server calls and get the token services running, without dependancy or pressure on the backend team.

Resources

In case you want to check out the code, find the repo below.

Other Resources

--

--

Hermes
Agora.io

Director of DevRel @ Agora.io … former CTO @ webXR.tools & AR Engineer @ Blippar — If you can close your eyes & picture it, I can find a way to build it