Zoom Meeting SDK Sample Signature Node.js

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

NOTE: This Sample App has been updated to use SDK App type credentials instead of JWT App type credentials.

This is a Node.js / Express server that generates a Web or Native Meeting SDK signature via an http request from your frontend for use in the Web or Native Meeting SDKs.

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

Installation

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

$ git clone https://github.com/zoom/meetingsdk-sample-signature-node.js.git

Setup

In terminal, cd into the cloned repo:

$ cd meetingsdk-sample-signature-node.js
Then install the dependencies:

$ npm install
Create an environment file to store your SDK Key and Secret:

$ touch .env
Add the following code to the .env file, and insert your Zoom SDK App's Key and Secret found on the App Credentials page in the Zoom App Marketplace:
```
ZOOM_SDK_KEY=SDK_KEY_HERE
ZOOM_SDK_SECRET=SDK_SECRET_HERE
```
Save and close .env.
Start the server:

$ npm run start

Usage

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

Key	Value Description
meetingNumber	Required, the Zoom Meeting or Webinar Number.
role	Required, `0` to specify participant, `1` to specify host.

Example Request

POST http://localhost:4000

Request Body:

{
  "meetingNumber": "123456789",
  "role": 0
}

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

{
  "signature": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZGtLZXkiOiJhYmMxMjMiLCJtbiI6IjEyMzQ1Njc4OSIsInJvbGUiOjAsImlhdCI6MTY0NjkzNzU1MywiZXhwIjoxNjQ2OTQ0NzUzLCJhcHBLZXkiOiJhYmMxMjMiLCJ0b2tlbkV4cCI6MTY0Njk0NDc1M30.UcWxbWY-y22wFarBBc9i3lGQuZAsuUpl8GRR8wUah2M"
}

In the Web or Native Meeting SDK, pass in the signature to the join() function:

// 1. Make http request to your server to get the signature

// 2. Pass in the signature to the join function

// Web Meeting SDK Client View example
ZoomMtg.join({
  signature: signature,
  sdkKey: sdkKey,
  userName: userName,
  meetingNumber: meetingNumber,
  passWord: password
})

// Web Meeting SDK Component View example
client.join({
  signature: signature,
  sdkKey: sdkKey,
  userName: userName,
  meetingNumber: meetingNumber,
  password: password
})

Deployment

If you used the Deploy to Heroku button, enter a name for your app on the page the button took you to (or leave it blank to have a name generated for you), and fill in the values for these,

ZOOM_SDK_KEY (Your Zoom SDK App Key, found on your Zoom SDK App Credentials page)
ZOOM_SDK_SECRET (Your Zoom SDK App Secret, found on your Zoom SDK App Credentials page)

Then click "Deploy App".

Now you can generate and use your signature via the deployed url Heroku provides.

If you cloned this repo, use the Heroku CLI to deploy your server.

In terminal, create a Heroku app:

$ heroku create
Add your files:

$ git add -A
Commit your files:

$ git commit -m "deploying to heroku"
Deploy your server by pushing your files to Heroku:

$ git push origin heroku
Navigate to your app on the Heroku dashboard, click settings, and add your SDK App Credentials in the Config Variables,
- ZOOM_SDK_KEY (Your Zoom SDK App Key, found on your Zoom SDK App Credentials page)
- ZOOM_SDK_SECRET (Your Zoom SDK App Secret, found on your Zoom SDK App Credentials page)