Zoom Logs
Panther supports pulling logs directly from Zoom
Panther can fetch Zoom operational and activity logs by querying various Zoom API endpoints. Panther can specifically monitor the following Zoom events:
- Changes to Account and Group settings
- Changes in role and license assignments for users
- Changes to subscriptions under Billing
- Changes made to SSO configuration, including changes made by your SSO and SAML mapping configuration
To set up this integration, you will create an OAuth2 app in your Zoom account and then configure Zoom as a log source in your Panther Console.
- To create an OAuth app in Zoom, you need to register the app in the Zoom Marketplace. You can find more details on this process in Zoom's documentation here: Create an OAuth App.
- The Zoom user authorizing the integration must have the Admin role and Reports permissions to read Operations Logs and Sign-in/Sign-out Activity.
- 1.Log in to your Panther Console.
- 2.In the left sidebar menu, click Configure > Log Sources.
- 3.Click Create New.
- 4.Select Zoom from the list of available log sources. Click Start Source Setup.
- 5.On the next screen, enter a descriptive name for the source e.g.
My Zoom logs. - 6.Click Continue Setup.
- 7.Copy the Redirect URL from Panther and save it in a secure location. You will need this in the next steps when you create an OAuth2 App in Zoom.
- 8.Keep this browser window open, as you will need to complete additional configuration in the next steps.
You must be an Admin user in your organization's Zoom account to create the OAuth2 App.
- 1.Log in to your Zoom account.
- 2.Register your app.
- 1.
- 2.Click Develop in the dropdown menu in the top-right corner of the page.
- 3.Select Build App.
- A new page will appear displaying the available app types.
- 4.Click Create in the OAuth option to continue.
- 3.Create an OAuth app with the following parameters:
- App Name: The app’s name.
- App Type: Choose Account-level app as the app type.
- Distribution: You can choose Enabled to make the app publicly available in the Zoom App Marketplace, or toggle to Disabled to make the app private. The app does not need to be publicly available for this integration.
- 4.When finished, click Create.
- A new window displaying your new OAuth app will appear.
- 5.When you create your app, be sure to copy the Client ID and Client Secret for your app as you will need this to finish your setup in the Panther Console.
- 6.In the Redirect URL field, paste in the Redirect URL that you copied from the Panther Console in the earlier steps of this documentation.
- 7.In the OAuth Allow List field, paste in the Redirect URL that you copied from the Panther Console in the earlier steps of this documentation.
- 8.Navigate to Scopes > Add Scopes and Select Report with "View report data" ticked.
- 9.Click Done.
- After you click Done, do not click Continue in Zoom.
- 10.Navigate back to the Panther Console to complete the final setup.
- 1.In the Panther Console, on the Set Credentials page, enter the Client ID and the Client Secret that you obtained from Zoom.
- 2.Click Continue Setup.
- You will be directed to a success screen:
- 3.To finish the source setup:
- 1.Optionally configure a log drop-off alarm.
- Before you finish the setup, we recommend that you create a log drop-off alarm to alert you if data stops flowing from the log source. Be sure to set an appropriate time interval for when you would like Panther to alert you that the log source is not sending data.
- 2.
- 3.Click Finish Setup.
Required fields in the schemas are listed as "required: true" just below the "name" field.
Sign in/sign out activity logs of users under a Zoom account.
schema: Zoom.Activity
parser:
native:
name: Zoom.Activity
description: Sign in / sign out activity logs of users under a Zoom account
referenceURL: https://marketplace.zoom.us/docs/api-reference/zoom-api/reports/reportsigninsignoutactivities
fields:
- name: email
required: true
description: The email address of the user used for activity.
type: string
indicators:
- email
- name: time
required: true
description: The timestamp of user activity
type: timestamp
timeFormat: rfc3339
isEventTime: true
- name: type
description: 'Type of user activity: sign in/sign out'
type: string
- name: ip_address
description: The IP address of the device used to access Zoom.
type: string
indicators:
- ip
- name: client_type
description: The client interface type using which the activity was performed.
type: string
- name: version
description: Zoom client version of the user.
type: string
The report allows you to audit admin and user activity, such as adding a new user, changing account settings, and deleting recordings.
schema: Zoom.Operation
parser:
native:
name: Zoom.Operation
description: The report allows you to audit admin and user activity, such as adding a new user, changing account settings, and deleting recordings
referenceURL: https://marketplace.zoom.us/docs/api-reference/zoom-api/reports/reportoperationlogs
fields:
- name: time
required: true
description: The time at which the operation was performed.
type: timestamp
timeFormat: rfc3339
isEventTime: true
- name: operator
required: true
description: The user who performed the operation.
type: string
indicators:
- email
- name: category_type
required: true
description: Operation category type
type: string
- name: action
description: Action descriptions
type: string
- name: operation_detail
description: Operation detail
type: string
Last modified 2mo ago