How to enable Presence/Proximity data from gateways

This article covers the hardware configuration to the Marketing4WiFi platform to enable presence/proximity data for compatible hardware. This guide assumes your compatible hardware has already completed the marketing configuration.

1. Login to the Marketing4WiFi dashboard.
2. Go to the desired client’s Edit Client page, enable Presence/Proximity for the client.
   Submit the page.
3. Go to the desired hotspot’s Edit hotspot page, enable Presence/Proximity for the hotspot.
   Submit the page.
4. Complete the hardware configuration of your compatible gateways.
   
   Aerohive ExtremeCloud IQ Configuration

   This guide assumes that your Aerohive access points have already been deployed in your venue, adopted to the ExtremeCloud IQ controller, and assigned to a floorplan.

   
   
   

   Step 1: Enable Presence Analytics on the Network Policy
   

   1. Login to the Extreme Cloud IQ dashboard and use the navigation bar on top to select Configure > Network Policies.
   2. Click the Edit Icon next to the Network Policy you would like to enable Presence Analytics on.
   3. Using the navigation bar for the Network Policy, select the ‘Additional Settings’ tab.
   4. On the menu list to the left, select Presence Analytics, configure to the following settings and leave the rest at their default values.
      • • Enable Presence Analytics: ON
        • Trap Interval: 15
   5. Save the policy and upload to the desired access points.

   Step 2: Creating an Aerohive Developer App

   1. Go to https://developer.aerohive.com/ and create an account or sign in.
   2. After signing in, on the developer account page, click ‘Create new application’.
   3. Give the application a generic name and description.
   4. The application page will be displayed once created.
      Copy the Client ID.

   Step 3: Creating API Token and Management

   1. Log into the Extreme Cloud IQ dashboard, using the nav bar on the top right to select ‘Global Settings’

      

   2. Using the navigation bar on the left, select ‘API Token Management’.
   3. Click the + icon to generate a new token. Configure to the settings below:
      • Client ID: Paste the Client ID collected in step 2.4.
      • Expiration Settings: Time from Enrollment- Select 1 year or more if your plan is longer.
   4. Copy and save the Access Token that is generated, take note to remove the Client ID collected in step 2.4 from the end of the Access Token.
   5. Using the navigation bar on the left, select ‘API Data Management’.
   6. Click the + icon to generate a new API. Configure to the settings below:
      • Post URL:
        US-A Environment

        https://gatewaypresence.smartwifiplatform.com/v1/aerohive

        US-B Environment

        https://gatewaypresence-usb.smartwifiplatform.com/v1/aerohive

      • Access Token: Paste the Access Token collected in step 2.8.
      • Message Type: Client Centric
      • Enable: Checked

   Step 4: Configure the Hotspot
   

   1. Login to your Marketing4WiFi dashboard.
   2. Use the navigation panel to the left to select Network > Hotspots.
   3. Open the Edit hotspot page containing the Aerohive APs that were configured in step 1.
   4. Enable the ‘Presence Data’ toggle.
   5. Paste the Access Token collected in step 3.4 to the ‘Aerohive Access Token’ field.
   6. Submit the page.

   Cambium Configuration

   Please make sure the time is set has been configured correctly on your AP Group.

   
   

   1. Login to the CN Maestro dashboard.
   2. Navigate to the AP Group list.
   3. Edit the desired AP Group.
   4. Click on Services.
   5. Click on the plus sign next to Location API.
   6. Check the Enable box.
   7. Paste the link to the Server field for your environment:
      US-A Environment

      https://gatewaypresence.smartwifiplatform.com/v1/cambium

      US-B Environment

      https://gatewaypresence-usb.smartwifiplatform.com/v1/cambium

   8. Make the Interval 300 seconds.
   9. Click the blue save button and push the update.

   Cisco Meraki Configuration

   Step  1: Generate GET/Post URL

   1. Login to your Marketing4WiFi dashboard.
   2. Use the navigation panel to the left to select Network > Hotspots.
   3. Open the Edit hotspot page containing the Meraki APs to be configured.
   4. Enable the ‘Presence Data’ toggle.
   5. Under ‘Meraki Validation URL’ click the blue refresh button to generate an URL.
   6. Under ‘Meraki Secret’ enter a secret of your choosing.
   7. Save the URL and secret for use later.
   8. Submit the page.

   Step 2: Configure Meraki network

   1. Login to the Meraki portal
   2. Select the correct network
   3. Hover over Network-Wide and Click on General
   4. Scroll down to “Location and scanning”
   5. Enable Analytics
   6. Enable Scanning API
   7. Save the ‘Validator’ value for use later.
   8. Use the URL and secret collected in step 1.7 for the ‘Post URL’ and secret.
   9. Click the save button in the bottom right.

   Step 3: Update Hotspot Validator setting

   1. Login to your Marketing4WiFi dashboard.
   2. Use the navigation panel to the left to select Network > Hotspots.
   3. Open the Edit hotspot page containing the Meraki APs to be configured.
   4. Under ‘Meraki Validator Key’ paste the Validator collected in step 2.7.
   5. Submit the page.

   CloudTrax Configuration

   1. Login to your CloudTrax account.
   2. Choose the network that you want to enable presence reporting on.
   3. Select the ‘Advanced’ Menu.
   4. Toggle the ‘Presence Analytics’ button.
   5. Fill in the ‘Server Location’ field with the URL for your environment.
      US-A Environment

      https://gatewaypresence.smartwifiplatform.com/v1/cloudtrax

      US-B Environment

      https://gatewaypresence-usb.smartwifiplatform.com/v1/cloudtrax

   6. For the key field use: SmartWiFi
   7. Adjust the ‘Rate’ to send data if desired (60 seconds is default and recommended).
   8. Click ‘Save Changes’

   Mist Configuration

   This guide assumes your Mist access points are already adopted to a site and placed on map floorplans in the Mist dashboard.

   Step 1: Collect Mist MAP ID

   1. Login to the Mist portal, use the navigation bar to the left to select Location > Live View.
   2. Select the floor plan containing the APs you would like to enable presence data from.
   3. With the floor plan open, you can collect the MAP ID.
   4. Looking at the URL of the page, copy the alphanumeric number for the SITE ID as outlined in the example below.
      Example: #!cliLocation/View/[MAP ID]/[SITE ID]In the image above the Map ID starts with ‘c4939’ and ends with ‘2b44c’
      In the image above the Site ID starts with ’42b8′ and ends with ‘af7e’
      • The Site ID will be the same for all Maps.
      • If you have APs on multiple maps that you want to enable presence reporting on, repeat steps 2 through 4 recording the MAP ID for the APs on it that you want to add to the Marketing 4 WiFi platform.

   Step 2: Update Mist Gateways

   1. Login to the Marketing 4 WiFi dashboard.
   2. Use the Navigation panel on the left to select Network> Gateways.
   3. Edit the gateway for each Mist gateway that you want to enable presence reporting on. Add the correct MAP ID to the gateway settings and submit the page

   Xirrus Configuration

   This guide assumes your Xirrus access points are already adopted to a profile and placed on map in the Xirrus dashboard.

   1. 1. Login to the Xirrus dashboard.
      2. Select the desired profile.
      3. Click the ‘Configuration tab’.
      4. Select the ‘Access Points’ option under the configuration tab.
      5. Scroll down to the ‘Location Reporting section’.

   Configure with the following settings

   1. • Would you like to send location data to an external service? Yes
      • Provide a URL to forward data:
        US-A Environment

        https://gatewaypresence.smartwifiplatform.com/v1/xirrus

        US-B Environment

        https://gatewaypresence-usb.smartwifiplatform.com/v1/xirrus

        
        
        

      • Would you like to enable per-radio data? Yes
      • Press ‘Save Configuration’
      • Press ‘Push Now’