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 Indoor Locations panel, select Data Providers (red box below).

    Select Data Providers tab and then select the Add icon

  4. Select the Add icon (blue box in the diagram 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.
    • Cisco Spaces
    • Extreme Network
    • Juniper Networks
    • Aruba Central

    Enter the data provider Name and Description and select a Type

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

Adding an Aruba Central Wi-Fi Network Provider

Procedure

The following steps describe how to configure a Juniper Networks 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.
    Note: To obtain the above connection details, you can find them at your Aruba Central > Organization > Platform Integration. Here are the detailed instructions on where to find them:
    Connection details Instructions
    Client ID Please copy and paste the Client ID from the System Apps and Tokens Dashboard table in your Aruba Central > Organization > Platform Integration > REST API Dashboard
    Client Secret Please copy and paste the Client Secret from the System Apps and Tokens Dashboard table in your Aruba Central > Organization > Platform Integration > REST API Dashboard
    Refresh Token Please insert the Refresh Token from your Aruba Central > Organization > Platform Integration > REST API > System Apps and Tokens
    REST API URL

    Please insert the REST API URL from from your Aruba Central > Organization > Platform Integration > REST API

    e.g. https://apigw-eucentral2.central.arubanetworks.com/

    Depending on your region, the URL will be different
    Streaming API Key Please paste the Streaming API Key from your Aruba Central > Organization > Platform Integration > Streaming
    Streaming URL

    Please insert the Streaming URL from from your Aruba Central > Organization > Platform Integration > Streaming

    e.g. wss://app-eucentral2.central.arubanetworks.com/streaming/api

    Depending on your region, the URL will be different
  3. Select Save.