Adding a Data Provider

Before you begin

Review the requirements in Licensing and Prerequisites for Indoor Location.

About this task

This section describes how to add an Indoor Location data provider and configure either a Cisco Spaces, Extreme Networks, Juniper Networks, or Aruba Central Wi-Fi network provider.

Procedure

The following steps describe how to perform the initial configuration steps to add a data provider.
  1. Select Live View from the main menu.

    Select Live View from the main menu

  2. Select Manage Locations from the main menu.

    Select Manage Locations from the main menu

  3. In the Manage Locations panel, select Data Providers (red box below).

    Select Data Providers tab and then select the Add icon

  4. Select the Add a New Data Provider button. (blue box above).
  5. Enter a data provider Name and Description.
    Note: The data provider name must be unique.
  6. From the Type dropdown menu, select one of the following Wi-Fi network provider device types and then follow the steps in the corresponding section below.
    • Aruba Central
    • Cisco Spaces
    • Extreme Network
    • Juniper Networks

    Enter the data provider Name and Description and select a Type

Adding an Aruba Central Wi-Fi Network Provider

Procedure

The following steps describe how to configure an Aruba Central Wi-Fi network provider.
  1. Select Aruba Central from the Type dropdown menu. This opens the Connection Details panel.
  2. Enter the Client ID, Client Secret, Refresh Token, REST API URL, Streaming API Key, Streaming URL.
  3. Select Save.
    Note: Navigate to Aruba Central > Organization > Platform Integration to create tokens and copy over the connection details. The table below lists instructions on where to find the connection details.
    Connection Details Instructions
    Client ID Copy and paste the Client ID from the System Apps and Tokens Dashboard table in your Aruba Central > Organization > Platform Integration > REST API Dashboard.

    Get the Client ID from Aruba Central
    Client Secret Copy and paste the Client Secret from the System Apps and Tokens Dashboard table in your Aruba Central > Organization > Platform Integration > REST API Dashboard.

    Get the Client Secret from Aruba Central
    Refresh Token In your Aruba Central > Organization > Platform Integration > REST API > System Apps and Tokens, select ‘Download Token’, and copy the Refresh Token:

    Get the Refresh Token from Aruba Central
    REST API URL Insert the REST API URL from from your Aruba Central > Organization > Platform Integration > REST API. For example, https://apigw-eucentral2.central.arubanetworks.com/
    Note: The URL varies, depending on your region.
    Note: In the Aruba REST API Dashboard, only copy the base URL, without the parameters ‘swagger/apps/nms’
    Get the REST API URL for Aruba Central
    Streaming API Key Copy and paste the Streaming API Key from your Aruba Central > Organization > Platform Integration > Streaming.

    Get the Streaming API Key from Aruba Central
    Streaming URL Copy and paste the Streaming URL from your Aruba Central > Organization > Platform Integration > Streaming. For example, wss://app-eucentral2.central.arubanetworks.com/streaming/api.
    Note: The URL varies, depending on your region.

Adding a Cisco Spaces Wi-Fi Network Provider

Procedure

The following steps describe how to configure a Cisco Spaces Wi-Fi network provider.
  1. Select Cisco Spaces from the Type dropdown menu. This opens the Connection Details panel.
  2. Enter the API Key.
    Note: To obtain the API Key, go to your Cisco Spaces web console and select Detect and Locate > Notifications > API Keys > Add and then paste it into the API Key field.
  3. In the URL field, enter https://dnaspaces.io.

    Enter the Cisco Spaces API Key and URL

  4. Select Save And Copy Webhook URL. The Webhook Details panel displays.
  5. Copy the webhook details:
    • Navigate to DNA Spaces > Detect and Locate > Notifications > Webhooks > Add Webhook.
    • Note: You must create two webhooks, one with Type LocationUpdate, and one with Type In/Out. All values of the two webhooks must be identical, with only their Types being different.
    • Device Type, Status: Select ‘All’
    • Assigned Site: Select ‘All’ or select your floor(s)
    • MAC address list: leave empty
    • Receiver: Paste the URL copied from the Webhook Details popup in SOTI XSight (fill in the host address and port separately)
    • Header Key and Header Value: Paste the Header Key and Header Value from the Webhook Details popup in SOTI XSight
    • MAC Hashing: Toggle Off
    Enter the webhooks details for Cisco Spaces

Adding an Extreme Networks Wi-Fi Network Provider

Procedure

The following steps describe how configure an Extreme Networks Wi-Fi network provider.
  1. Select Extreme Networks from the Type dropdown menu. This opens the Connection Details panel.
  2. Enter your login Username for Extreme Cloud IQ.
  3. Enter your login Password for Extreme Cloud IQ.
  4. Enter https://api.extremecloudiq.com/ into the URL field.
    Enter the configuration details for an Extreme Networks Wi-Fi network provider.
  5. Select Save And Copy Webhook URL. The Webhook Details panel displays.
  6. Copy the webhook details:
    • Navigate to Extreme Cloud IQ > Essentials > Extreme Location > More Insights > Settings > Third Party Configurations
    • Enter the information from the Webhook Details panel:
      • Subscriber Push URL
      • Username
      • Password
    Enter the webhook details for Extreme

Adding a Juniper Networks Wi-Fi Network Provider

Procedure

The following steps describe how to configure a Juniper Networks Wi-Fi network provider.
  1. Select Juniper Networks from the Type dropdown menu. This opens the Connection Details panel.
  2. Enter the API Key.
    Note: To obtain the API Key, go to your Mist Dashboard, and from the Organization tab, create a new API token. Copy the API Token and paste it into the API Key field.
  3. Enter https://api.ac2.mist.com/api/v1 into the URL field.

Enter the configuration details for an Juniper Networks Wi-Fi network provider.

  1. Select Save And Copy Webhook URL. The Webhook Details panel displays.
  2. Enter the Webhook details for Juniper Mist.
    • Navigate to Juniper Mist Dashboard > Organization > Settings > Add Webhook
    • Fill in the following details:
      • Name
      • Topics (select all)
    • Paste in the information from Webhook Details panel:
      • URL
      • Header Key
      • Header Value
    Enter the webhook details for Juniper Mist