Configure Authentication (Single User)

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 a single user. To process data from multiple users, see Configure Authentication (All Users).

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 (User-managed) 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  
    team_chat:read:channel  
    team_chat:read:list_members for Mapped Security
    team_chat:read:user_channel  
    team_chat:read:list_user_sessions  
    team_chat:read:list_user_messages  
    team_chat:read:user_message  
    team_chat:read:file  
    user:read:user  
    meeting:read:list_past_participants for Mapped Security for Meeting Recordings
    cloud_recording:read:list_recording_registrants for Mapped Security for Meeting Recordings
    cloud_recording:read:list_recording_files for Meeting Recordings
    cloud_recording:read:list_user_recordings 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 > SINGLE USER 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.