{"id":21319474,"url":"https://github.com/zoom/meetingsdk-auth-endpoint-sample","last_synced_at":"2025-04-13T02:11:54.624Z","repository":{"id":40741063,"uuid":"244490549","full_name":"zoom/meetingsdk-auth-endpoint-sample","owner":"zoom","description":"Generate a Meeting SDK JWT to join Zoom meetings and webinars with the Meeting SDK.","archived":false,"fork":false,"pushed_at":"2025-04-02T18:41:26.000Z","size":88,"stargazers_count":117,"open_issues_count":0,"forks_count":114,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-04-04T04:11:10.157Z","etag":null,"topics":["sample-app"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zoom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-02T22:37:58.000Z","updated_at":"2025-04-02T18:40:55.000Z","dependencies_parsed_at":"2023-12-28T00:13:02.662Z","dependency_job_id":"68f585dc-1961-4694-8999-2548ec96e880","html_url":"https://github.com/zoom/meetingsdk-auth-endpoint-sample","commit_stats":null,"previous_names":["zoom/meetingsdk-auth-endpoint-sample"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoom%2Fmeetingsdk-auth-endpoint-sample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoom%2Fmeetingsdk-auth-endpoint-sample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoom%2Fmeetingsdk-auth-endpoint-sample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoom%2Fmeetingsdk-auth-endpoint-sample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zoom","download_url":"https://codeload.github.com/zoom/meetingsdk-auth-endpoint-sample/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248654089,"owners_count":21140236,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["sample-app"],"created_at":"2024-11-21T19:42:06.783Z","updated_at":"2025-04-13T02:11:54.598Z","avatar_url":"https://github.com/zoom.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zoom Meeting SDK Auth Endpoint sample\n\nUse of this sample app is subject to our [Terms of Use](https://explore.zoom.us/en/legal/zoom-api-license-and-tou/).\n\nThis is a Node.js / Express server that generates a [Meeting SDK JWT](https://developers.zoom.us/docs/meeting-sdk/auth/#generate-a-meeting-sdk-jwt) via an HTTP request for authorized use of the [Zoom Meeting SDK](https://developers.zoom.us/docs/meeting-sdk/).\n\nIf 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](#deployment).)\n\n| Railway | Render | Heroku |\n|:-:|:-:|:-:|\n| [![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/JsX6Pk?referralCode=HTPdHX) | [![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/zoom/meetingsdk-auth-endpoint-sample) | [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/zoom/meetingsdk-auth-endpoint-sample) | \n\n\u003e Note: Both Railway and Render have free tiers, but Heroku requires a credit card to deploy.\n\n## Installation\n\nIn terminal, run the following command to clone the repo:\n\n`$ git clone https://github.com/zoom/meetingsdk-auth-endpoint-sample.git`\n\n## Setup\n\n1. In terminal, `cd` into the cloned repository:\n\n   `$ cd meetingsdk-auth-endpoint-sample`\n\n1. Then install the dependencies:\n\n   `$ npm install`\n\n2. Rename `.env.example` to `.env`, edit the file contents to include your [Zoom Meeting SDK key and secret](https://developers.zoom.us/docs/meeting-sdk/developer-accounts/), save the file contents, and close the file.\n\n3. Start the server:\n\n   `$ npm run start`\n\n## Usage\n\nMake a POST request to `http://localhost:4000` (or your deployed url) with the following request body:\n\n| Property            | Type     | Required?  | Validation Rule(s)                                                                          |\n| ------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------- |\n| `meetingNumber`     | `string` | Yes (web)* | - Required if generating a web JWT, optional for native.                                    |\n| `role`              | `number` | Yes (web)* | - Required if generating a web JWT, optional for native. \u003cbr\u003e - Must be equal to `0` or `1` |\n| `expirationSeconds` | `number` | No         | - Must be between `1800` (30 minutes) and `172800` (48 hours) seconds                       |\n| `videoWebRtcMode`   | `number` | No         | - Optional, only applicable for web. \u003cbr\u003e - Must equal `0` or `1`                           |\n\n\u003e [!IMPORTANT]\n\u003e If `meetingNumber` or `role` are supplied in the request body, the other must be present as well. If both are supplied, the JWT will be valid for web, otherwise it will be valid for native.\n\n### Example Request\n\nPOST `http://localhost:4000`\n\nRequest Body:\n\n```json\n{\n  \"meetingNumber\": \"123456789\",\n  \"role\": 0\n}\n```\n\nIf successful, the response body will be a JSON representation of your Meeting SDK JWT:\n\n```json\n{\n  \"signature\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZGtLZXkiOiJhYmMxMjMiLCJtbiI6IjEyMzQ1Njc4OSIsInJvbGUiOjAsImlhdCI6MTY0NjkzNzU1MywiZXhwIjoxNjQ2OTQ0NzUzLCJhcHBLZXkiOiJhYmMxMjMiLCJ0b2tlbkV4cCI6MTY0Njk0NDc1M30.UcWxbWY-y22wFarBBc9i3lGQuZAsuUpl8GRR8wUah2M\"\n}\n```\n\nIn the [Meeting SDK](https://developers.zoom.us/docs/meeting-sdk/auth/#join-meetings-and-webinars-with-the-meeting-sdk-jwt), pass in the `signature` to the `join()` function:\n\n```js\n// Make http request to your auth endpoint to get the Meeting SDK JWT\n\n// Meeting SDK - web - Client View - example:\nZoomMtg.join({\n  signature: signature,\n  sdkKey: sdkKey,\n  userName: userName,\n  meetingNumber: meetingNumber,\n  passWord: password\n})\n\n// Meeting SDK - web - Component View - example:\nclient.join({\n  signature: signature,\n  sdkKey: sdkKey,\n  userName: userName,\n  meetingNumber: meetingNumber,\n  password: password\n})\n```\n\n## Deployment\n\n### Deploy to a Managed Service\n\n1. After clicking the \"Deploy to \u003cProvider\\\u003e\" button, enter a name for your app (or leave it blank to have a name generated for you), and insert your [Zoom Meeting SDK credentials](https://developers.zoom.us/docs/meeting-sdk/developer-accounts/#get-meeting-sdk-credentials):\n\n   - `ZOOM_MEETING_SDK_KEY` (Your Zoom Meeting SDK Key or Client ID for Meeting SDK app type's created after February 11, 2023, found on your Zoom Meeting SDK App Credentials page)\n   - `ZOOM_MEETING_SDK_SECRET` (Your Zoom Meeting SDK Secret or Client Secret for Meeting SDK app type's created after February 11, 2023, found on your Zoom Meeting SDK App Credentials page)\n\n1. Then click \"Deploy App\".\n\n1. Use your URL as your Meeting SDK Auth Endpoint.\n\n   Example: `https://abc123.provider.com/`\n\n```bash\n$ curl \u003cYOU_URL\u003e -X POST -d '{  \"role\": \"1\", \"meetingNumber\": \"123123123\"}' -H \"Content-Type: application/json\"\n```\n\u003c!-- ### Heroku (CLI)\n\n1. If you cloned this repo, you may use the [Heroku CLI](https://devcenter.heroku.com/articles/heroku-cli) to deploy your server. Remember to [set your config vars (envoirnment variables)](https://devcenter.heroku.com/articles/config-vars).\n\n1. Use your Heroku URL as your Meeting SDK Auth Endpoint.\n\n   Example: `https://abc123.herokuapp.com/` --\u003e\n\n### Other Server Hosting\n\n1. For Other Server Hosting information, see [this tutorial](https://developer.mozilla.org/en-US/docs/Learn/Server-side/Express_Nodejs/deployment#choosing_a_hosting_provider).\n\n1. Use your deployed URL as your Meeting SDK Auth Endpoint.\n\n   Example: `https://abc123.compute-1.amazonaws.com/`\n\nNow you can [generate your Meeting SDK JWT](#usage).\n\n## Need help?\n\nIf you're looking for help, try [Developer Support](https://devsupport.zoom.us) or our [Developer Forum](https://devforum.zoom.us). Priority support is also available with [Premier Developer Support](https://explore.zoom.us/docs/en-us/developer-support-plans.html) plans.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoom%2Fmeetingsdk-auth-endpoint-sample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzoom%2Fmeetingsdk-auth-endpoint-sample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoom%2Fmeetingsdk-auth-endpoint-sample/lists"}