Zoom Video SDK Auth Endpoint sample

Use of this sample app is subject to our Terms of Use.

This is a Node.js / Express server that generates a Video SDK JWT via an HTTP request for authorized use of the Zoom Video SDK.

If you would like to skip these steps and just deploy the finished code to a managed service, click the Deploy to Railway/Render/Heroku button. (You will still need to configure a few simple things, so skip to Deployment.)

Note: Both Railway and Render have free tiers, but Heroku requires a credit card to deploy.

Installation

In terminal, run the following command to clone the repository:

$ git clone https://github.com/zoom/videosdk-auth-endpoint-sample.git

Setup

1. In terminal, cd into the cloned repository:

   $ cd videosdk-auth-endpoint-sample

2. Then install the dependencies:

   $ npm install

3. Rename .env.example to .env, edit the file contents to include your Zoom Video SDK key and secret, save the file contents, and close the file:

4. Start the server:

   $ npm run start

Usage

Make a POST request to http://localhost:4000 (or your deployed url) with the following request body:

Audio Compatible Mode vs Audio WebRTC Mode

audioWebRtcMode replaces audioCompatibleMode, which is now deprecated. Update your code to use audioWebRtcMode going forward.

Example Request

POST http://localhost:4000

Request Body:

{
  "sessionName": "Cool Cars",
  "role": 1,
  "sessionKey": "session123",
  "userIdentity": "user123"
}

If successful, the response body will be a JSON representation of your signature:

{
  "signature": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfa2V5IjoiVklERU9fU0RLX0tFWSIsImlhdCI6MTY0NjI0ODc5NiwiZXhwIjoxNjQ2MjU1OTk2LCJ0cGMiOiJDb29sIENhcnMiLCJ1c2VyX2lkZW50aXR5IjoidXNlcjEyMyIsInNlc3Npb25fa2V5Ijoic2Vzc2lvbjEyMyIsInJvbGVfdHlwZSI6MH0.Y6C65mZUxTZFeGiOI6oW5q2UkIXe3nLTK0MVNkfiJ9c"
}

In the Video SDK, pass in the signature to the join() function:

// Make http request to your auth endpoint to get the Video SDK JWT

// Video SDK - web - example:

client.join(
   signature: signature,
   topic: sessionName,
   userName: userName,
   password: sessionPasscode
)

Deployment

Deploy to a Managed Service

1. After clicking the "Deploy to <Provider>" button, enter a name for your app (or leave it blank to have a name generated for you), and insert your Zoom Video SDK credentials:

   • ZOOM_VIDEO_SDK_KEY (Your Zoom Video SDK Key, found on your Zoom Video SDK App's Credentials page)
   • ZOOM_VIDEO_SDK_SECRET (Your Zoom Video SDK Secret, found on your Zoom Video SDK App's Credentials page)

2. Then click "Deploy App".

3. Use your URL as your Video SDK Auth Endpoint.

   Example: https://abc123.provider.com/

$ curl <YOU_URL> -X POST -d '{  "sessionName": "Cool Cars",  "role": "1",  "sessionKey": "session123",  "userIdentity": "user123"}' -H "Content-Type: application/json"

Deploy with Docker

If you prefer to run the application in a Docker container, follow the steps below.

1. Build the Docker Image: In your terminal, run the following command to build the Docker image:

   docker build -t zoom-videosdk-auth .

2. Run the Docker Container: Once the image is built, you can run the container while passing in the required environment variables for the Zoom Video SDK credentials:

$ docker run -d -p 4000:4000 \
   -e ZOOM_VIDEO_SDK_KEY=your_zoom_videosdk_key \
   -e ZOOM_VIDEO_SDK_SECRET=your_zoom_videosdk_secret \
   --name zoom-videosdk-auth zoom-videosdk-auth

This will start the app on port 4000.

3. Make Requests to the Endpoint: Once the container is running, you can make a POST request to <YOU_URL> with the required parameters:

Example Request:

$ curl <YOU_URL> -X POST -d '{  "sessionName": "Cool Cars",  "role": "1",  "sessionKey": "session123",  "userIdentity": "user123"}' -H "Content-Type: application/json"

Stopping the Docker Container: To stop the Docker container, run:

$ docker stop zoom-videosdk-auth

Removing the Docker Container: To remove the container:

$ docker rm zoom-videosdk-auth

Now you can generate your Video SDK JWT.

Other Server Hosting

1. For Other Server Hosting information, see this tutorial.

2. Use your deployed URL as your Video SDK Auth Endpoint.

   Example: https://abc123.compute-1.amazonaws.com/

Now you can generate your Video SDK JWT.

Need help?

If you're looking for help, try Developer Support or our Developer Forum. Priority support is also available with Premier Developer Support plans.