Skip to main content

Check out Interactive Visual Stories to gain hands-on experience with the SSE product features. Click here

Skyhigh Security

Custom OAuth Application for Zoom

Skyhigh CASB allows connecting to Zoom APIs through a custom application. For details on OAuth creation, see Create an OAuth App documentation.

Create a Custom OAuth Application for Zoom

To create an OAuth Application for Zoom:

  1. Go to Zoom Marketplace
  2. Choose Develop > Build App > OAuth
  3. On the Create an OAuth app page, configure the following:
    1. App Name. Enter a name for your app.
    2. Choose app type. Select Account-level app.
    3. Would you like to publish this app on Zoom App Marketplace?. Toggle the switch to prevent this app from being published on Zoom App Marketplace.
      clipboard_e3ef2b8cc3a619b74283e74e6631f8c37.png
  4. Click Create.
  5. Go to Manage and select the new app created on the Create an OAuth app page.
  6. Under App Credentials, configure these:
  7. Under OAuth allow list, enter the same URL as Redirect URL for OAuth.
  8. Click Continue.
    clipboard_e79c0e486bc699faa02a876ea04a7ebf3.png
  9. Select the Information tab.
  10. Under Basic Information, provide these mandatory information about your app:
    • App Name. Enter a name for your app.
    • Short Description. Enter a short description about your app.
    • Long Description. Enter a long description about your app.
    • Company Name. Enter the name of your organization.
      clipboard_e829cf841abceb6ac41270cc4f2c4f748.png
  11. Under Developer Contact Information, configure these:
    • Name. Enter your name.
    • Email Address. Enter your email address.
      clipboard_e98ea2791fbc00a2de2db686ac83d4597.png
  12. Click Continue.
  13. Select the Feature tab.
  14. On the Add Feature page, under Token, copy the Secret Token to use in Step 2.
    clipboard_e5a3cee6e505f3448c76418a2f1e2406d.png

NOTE: 

If the secret token is not available for selection, click Generate.

 

 

 

Configure Scopes for Zoom

You can use the Scopes tab to define the permissions based on which users can access Zoom resources, such as chat messages or user details.

To configure scopes for Zoom:

  1. Go to Scopes > Add Scopes.
    clipboard_e8e90579ad2c974715f17b80c82fe4541.png
  2. Select the following scopes and their associated permissions, then click Done.
    clipboard_e3d000ec86bb34129809c586758a57b4f.png
    clipboard_e6659ba5b0a8b8393b087cefda60268ee.png

After configuring the scopes for your Zoom instance, go to Step 1 and create a Zoom instance in Skyhigh CASB.

Validate Skyhigh CASB's Webhook URL

You must create an event subscription for Zoom and validate Skyhigh CASB's webhook URL for your Zoom instance so that Skyhigh CASB receives Zoom event notifications.

To validate Skyhigh CASB's webhook URL:

  1. On the Add Feature page, under General Features, click Add Event Subscription.
    clipboard_e4d9a30a8a046718cf12890ada6b49f67.png
  2. Under Event Subscriptions, configure these:
    • Subscription Name. Enter the subscription name.
    • Event notification endpoint URL. Enter the URL in the following format, and click Validate. For details on Tenant ID and Instance ID, see Skyhigh CASB Tenant ID and Instance ID.
      <webhook server domain name/zoom/16000/<tenantId>/<instanceId>

Skyhigh CASB's webhook URL is validated to receive Zoom event notifications.

clipboard_e5606474e74fec5547b336e47e7ef5568.png

Skyhigh CASB Tenant ID and Instance ID

To get the Tenant ID and Instance ID from Skyhigh CASB:

  1. Log in to Skyhigh CASB, and go to Settings > Service Management.
  2. Select the managed Zoom instance, and right-click Inspect Element. You can find the InstanceId from the URL.
    clipboard_eb79c0d8d2e68851cca0ee52f8abc4ae2.png
  3. Go to Network, and click Command R or Control R to reload.
  4. Under Name, select the InstanceId and choose Response and navigate right to get the tenantId.
    clipboard_eb9dc8ca0d7ffea13c08d1294044b648e.png

Configure Event types for Zoom

You can configure the event types for Zoom to specify the Zoom events based on which Skyhigh CASB receives Zoom event notifications. 

To configure event types for Zoom:

  1. On the Add Feature page, under Add Events, click Add events.
    clipboard_e263a91894aa4ce24e1c9a7b0fca7552b.png
  2. Select the following Event types and their associated events, then click Done.
    clipboard_e8333311bd87ad042e1c50514b77acb45.png
    clipboard_ec2c5e6c24af307ace0a4fd2ccb505c2f.png
    clipboard_ecb812c22eb497a73b11598edc33121c3.png
    clipboard_e7b09444356eaf27448e262983110a2b3.png

IMPORTANT: If you select Event types other than the event types listed above, Zoom does not process those events and Skyhigh CASB throws 500 Internal Server Error. Zoom also blocks sending events if you receive too many 500 Internal Server Errors.

 

After integrating Skyhigh CASB with Zoom, you can define DLP policies and attach them to your Zoom instance. For details, see DLP Collaboration Use Cases for Zoom.

  • Was this article helpful?