Zoom Chat Connector 24.3

# Configure Authentication (All Users)

This section describes how to configure OAuth authentication, so that the connector can access data through the Zoom API. Follow these steps if you want to process data from all users and have set ProcessAllUsers=TRUE in your task configuration.

To retrieve data from a single user, see Configure Authentication (Single User).

## Create a Zoom Chat Application

To index content from Zoom, you must create a Zoom OAuth application to represent the connector.

To create a Zoom OAuth application to represent the connector

1. Go to https://marketplace.zoom.us/develop/createLegacy.

2. Log in as an administrator and create an OAuth (Account-level) app.

3. Make a note of the app key and app secret. You will need this information to run the OAuth configuration tool that is supplied with the connector.

4. Grant the following permission scopes:

   Name | Justification
   --- | ---
   `team_chat:read:list_user_channels:admin` |
   `team_chat:read:channel:admin` |
   `team_chat:read:list_members:admin` | for Mapped Security
   `team_chat:read:user_channel:admin` |
   `team_chat:read:list_user_sessions:admin` |
   `team_chat:read:list_user_messages:admin` |
   `team_chat:read:user_message:admin` |
   `team_chat:read:file:admin` |
   `user:read:list_users:admin` |
   `meeting:read:list_past_participants:admin` | for Mapped Security for Meeting Recordings
   `cloud_recording:read:list_recording_registrants:admin` | for Mapped Security for Meeting Recordings
   `cloud_recording:read:list_recording_files:admin` | for Meeting Recordings
   `cloud_recording:read:list_user_recordings:admin` | for Meeting Recordings

5. Ensure the app has a valid redirect URL.

   - To use the NiFi Ingest connector, the redirect URL must match the URL shown in the advanced configuration dialog of the NiFi processor.
   - To use the ACI connector, the redirect URL must match the value of the `RedirectUrl` parameter in the OAuth tool configuration file, `oauth_tool.cfg`. The default value is `http://localhost:7878/oauth`.

## Configure the Connector

After creating the OAuth application, follow these steps to configure the connector.

To configure OAuth authentication

- To configure the NiFi Ingest connector

  1. In the NiFi web interface, right-click the processor and click Configure.
  2. Click ADVANCED, and complete the guided setup wizard.
  3. Configure OAuth using the OAUTH SETUP > ALL USERS tab.

- To configure the standard connector

  1. Open the folder where you installed the connector.
  2. Open the OAuth tool configuration file, `oauth_tool.cfg`, in a text editor.

  3. In the `[Default]` section, set any SSL or proxy settings that are required to access the repository:

     `SSLMethod` | The version of SSL/TLS to use.
     `ProxyHost` | The host name or IP address of the proxy server to use.
     `ProxyPort` | The port of the proxy server to use.

     For example:

         SSLMethod=NEGOTIATE
         ProxyHost=10.0.0.1
         ProxyPort=8080

  4. In the `[OAuthTool]` section, set the following parameters:

     `AppKey` | The application key (client ID) that was provided by Zoom.
     `AppSecret` | The application secret (client secret) that was provided by Zoom.

     Do not modify the other parameters in this section.

  5. Open a command-line window and run the following command:

     `oauth_tool.exe oauth_tool.cfg OAuthTool`

     A web browser opens, asking you to log in and grant consent.

  6. Log in and grant consent.

     The web page displays a message stating that the OAuth details have been successfully stored, and the OAuth tool creates the file `oauth.cfg`. When you configure the connector, import the parameters from `oauth.cfg` into your task configuration. For more information about including parameters from another file, see Include an External Configuration File.

     You can now configure a task to retrieve data from Zoom. See Retrieve Information from Zoom.

Copyright 2024 Open Text
Version 24.3 | Last updated June 2024

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL Zoom Chat Connector 24.3

Topic Title: Configure Authentication (All Users)