Cisco Webex
  • 20 Mar 2024
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Cisco Webex

  • Dark
    Light
  • PDF

Article Summary

Cisco Webex is an enterprise solution for video conferencing, online meetings, screen share, and webinars.

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Devices
  • Users

Parameters

  1. Host Name or IP Address (required, default: empty) - The hostname or IP address of the Cisco Webex server that Axonius can communicate with via the Required Ports. For the cloud version the default domain is https://webexapis.com. For Cloud server,

  2. Server Type - From the dropdown, select one of the following:

    • On-Prem (default) - This type of server has the following connection parameter:
      • Access Token (required, default: empty) - An API Key associated with a user account that has the Required Permissions to fetch assets.
    • Cloud - - This type of server has the following connection parameters:
      • Client ID - The client ID that was provided after creating the integration.
      • Client Secret - The client secret that was provided after creating the integration.
      • MFA Code - The code provided in the query params of the OAuth2 redirection. As it appears here:
        http://your-server.com/auth?code=YjAzYzgyNDYtZTE3YS00OWZkLTg2YTgtNDc3Zjg4YzFiZDlkNTRlN2FhMjMtYzUz
        For more information, see Authenticating and Receiving the MFA Code.
      • Redirect URL (required, default: http://localhost) - The redirection URI provided during the integration’s creation.
        Important: Make sure that the redirect URI you registered to the integration is the same one entered for the adapter connection and the same one you authenticate to.
  3. Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

  4. HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

  5. HTTPS Proxy User Name (optional) - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.

  6. HTTPS Proxy Password (optional) - The password to use when connecting to the server using the HTTPS Proxy.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

CiscoWebexOnPremServer

CiscoWebexCloudServer

APIs

Axonius uses the Cisco Webex Devices API.

Axonius uses the Cisco Webex People API.

Required Ports

Axonius must be able to communicate with the value supplied in Host Name or IP Address via the following ports:

  • TCP port 443

Required Permissions

The value supplied in API Key must be associated with the following permissions in order to fetch assets:

  • Devices

    • spark:devices_read - See details for the devices in the integration's organization (associated with the creator's organization).
    • spark-admin:devices_read - See details for the devices in your entire organization.
  • Users

    • To fetch users, the signed-in user must have Admin privileges.

Setting Up the Integration

To create an integration, follow the instructions in Build - Integrations | Webex for Developers, making sure to do the following:

  • In the Requesting Permission section of the integration, select the following options:
    • spark:devices_read - See details for the devices in the integration's organization (associated with the creator's organization).

    • spark-admin:devices_read - See details for the devices in your entire organization.

  • To fetch users, the signed-in user must have Admin privileges.

Authenticating and Receiving the MFA Code

  1. Navigate to https://webexapis.com/v1/authorize?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&scope=spark-admin:people_read spark-admin:devices_read&state=AXONIUS_STATE

    • Replace CLIENT_ID and REDIRECT_URI with the actual values.
      You are redirected to a Webex login page.
  2. Log in to Webex.
    You are redirected to the REDIRECT_URI that you provided.
    It should look like this: REDIRECT_URI?code=YjAzYzgyNDYtZTE3YS00OWZkLTg2YTgtNDc3Zjg4YzFiZDlkNTRlN2FhMjMtYzUz

  3. Copy the code query parameter and use it as the MFA Code in your Webex adapter.


Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.