Skip to content

Prerequisites

Create the Webex OAuth Integration in Webex

The Cisco Webex Add-on for Splunk supports OAuth2 Authentication, which allows third-party integrations to get a temporary access token for authenticating API calls. Therefore, creating an Admin-level Webex integration is required to work along with this Add-on. Please follow the following steps to create a dedicated Webex integration for this Add-on. Further documentation can be found here.

  1. Registering your Integration:
    • Visit the Webex for Developers and then log in using your Webex Admin Account
    • Select My Webex Apps from the menu under your avatar at the top of this page
    • Click Create a New App then Create an Integration to start the wizard

  2. Provide app related information:

    • Integration name: Enter a name for yor integration. e.g. Webex Integration for Splunk
    • Icon: Upload your own or select from the defaults
    • Description: Provide some details about your integration

    • Redirect URI(s): Follow the following steps to retrieve your Redirect URI:

      • Open Cisco Webex Add-on for Splunk in Splunk. Go to Configuration > Account > Add. The Redirect URI will show up in the Redirect url field. Please copy and paste it to the Redirect URI(s) field in the Webex Integration.
      • For Splunk Heavy Forwarders (or IDM): please replace the {domain} with the domain of your Splunk Heavy Forwarder (or IDM). For example, if the domain of your HF or IDM is example.splunk.link, then the Redirect URI you have to enter is: https://example.splunk.link/en-US/app/ta_cisco_webex_add_on_for_splunk/ta_cisco_webex_add_on_for_splunk_redirect. Ensure not to submit the form yet.

    • Scopes: Please select only the scopes you need referring to the table below

    Here are the endpoints, their corresponding source types, and the required scopes.

    Splunk Input Webex Endpoint Splunk Sourcetype Required Scopes
    Webex Scheduled Meetings Meetings cisco:webex:meetings meeting:admin_schedule_read spark-admin:people_read
    Webex Meetings Summary Report Meeting Usage Reports cisco:webex:meeting:usage:reports meeting:admin_schedule_read meeting:admin_participants_read meeting:admin_config_read
    Webex Meetings Summary Report Meeting Attendee Reports cisco:webex:meeting:attendee:reports meeting:admin_schedule_read meeting:admin_participants_read meeting:admin_config_read
    Webex Admin Audit Events Admin Audit Events cisco:webex:admin:audit:events audit:events_read spark:organizations_read
    Webex Meeting Qualities Meeting Qualities cisco:webex:meeting:qualities analytics:read_all
    Webex Detailed Call History Detailed Call History cisco:webex:call:detailed_history spark-admin:calling_cdr_read
    Webex Security Audit Events Security Audit Events cisco:webex:security:audit:events audit:events_read spark:organizations_read

  3. Click Add Integration on the bottom of the page, your Client ID and Client Secret are ready to use.