Zoom

Zoom is a remote conferencing service that provides video conferencing, online meetings, chat, and mobile collaboration.

Types of Assets Fetched

This adapter fetches the following types of assets:

• Devices
• Users
  
  

Parameters

1. Zoom Domain (required, default: https://api.zoom.us) - The hostname or IP address of the Zoom API.
2. Authentication Method (required, default: JWT) - Select whether to authenticate by JSON Web Token (JWT) or Server-to-Server OAuth.
3. JWT API Key and JWT API Secret (required) - If the authentication method is by JWT, enter the JWT API Key and API Secret. For more details, see Generate a JWT Key and API Secret.
   Note:

   These parameters are only displayed when the JWT option is selected from the Authentication Method dropdown.

4. Account ID and OAuth Client ID and OAuth Client Secret (required) - If the authentication method is by Server-to-Server OAuth, enter the Account ID, OAuth Client ID, and OAUth Client Secret to be used to authenticate the request. For more details, see Create a Server-to-Server OAuth App.
   Note:

   These parameters are only displayed when the Server-to-Server OAuth option is selected from the Authentication Method dropdown.

5. Verify SSL - Select to verify the SSL certificate offered by the value supplied in Zoom Domain. For more details, see SSL Trust & CA Settings.
6. HTTPS Proxy (optional) - A proxy to use when connecting to the value supplied in Zoom Domain.
7. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Advanced Settings

1. Days of meetings data (required, default: 7) - Specify the number of days of meeting data that all connections for this adapter will fetch.
2. Fetch devices only with hostname and MAC address (required, default: true) - Select whether to fetch devices that have both hostname and MAC address details.
   • If enabled, all connections for this adapter will only fetch devices that have both hostname and MAC address details.
   • If disabled, all connections for this adapter will fetch any device, even if it doesn't have hostname or MAC address details.
3. Fetch devices (required, default: true) - Select whether to fetch devices assets from Zoom.
   • If enabled, all connections for this adapter will fetch devices assets from Zoom.
   • If disabled, all connections for this adapter will not fetch devices assets from Zoom.
4. Fetch inactive users (default: false) - By default, the Zoom API returns only users with a status of 'active'. Enable this option to also fetch users with a status of 'inactive'.
5. Skip service accounts (default: false) - Select this option to not fetch devices whose account type is a service account (such as ‘Google Service Account’)
6. Exclude calendar room entries (default: false) - Select to not fetch information about rooms on the Zoom calendar.

APIs

Axonius uses the following APIs:

• Zoomrooms

• List H323./SIP Devices

• List meetings

• List Zoom Room devices

• List Users

Generate a JWT API Key and API Secret

1. Log in to Zoom account as an admin.

2. From the left menu, click Advanced > App Marketplace.
   

3. If you are not signed in, sign into the App Marketplace by clicking the Sign In link in the top bar. Then, click Manage.
   

4. If there is a JWT application in the list, select it. Otherwise, click Develop > Build App and create a new JWT App. Follow the instructions to create that app.

5. Click App Credentials and copy the API Key and the API Secret to the Axonius Zoom Adapter.
   

Permissions

The following permissions are required in order to fetch assets. Permissions are required, whatever the authentication method used,

• dashboard_zr:read:admin
• h323:read:admin
• dashboard_meetings:read:admin
• room:read:admin
• user:read:admin