Docs Portal
Documentation
API ReferenceConsole

Aruba Central Source

Aruba Central Source logo

Aruba Central Source connects to HPE Aruba Networking Central to sync floor-level WiFi occupancy counts and network device online/offline status into Mapped. The connector provisions floor occupancy zones, creates optional device inventory for selected access points, switches, and gateways, and refreshes both data streams every 5 minutes. Note this connector uses GreenLake / HPE SSO unlike the legacy version.

Use Cases

  • Monitor floor occupancy trends using WiFi client counts
  • Detect offline network devices that may impact building operations
  • Combine occupancy and device health data in one graph for dashboards and workflows

Configuration

Auth Requirements

FieldRequiredDescriptionWhere to Find
Base URLYesAruba Central cluster URL used for API callsAruba Central cluster/region for your tenant
Client IDYesOAuth client credential IDAruba Central or HPE GreenLake API credential setup
Client SecretYesOAuth client credential secretGenerated with the client ID

The connector authenticates with OAuth2 client credentials against Aruba Central and stores the current access token automatically.

Place Mappings

The Place Mapping step loads sites, buildings, and floors from Aruba Central. Users confirm the hierarchy and add any missing business context before provisioning.

FieldRequiredEditableDescription
Building NameYesNoBuilding name returned by Aruba Central
Building AddressYesYesCustomer-supplied street address for the building
Building Ref IDYesNoAruba building ID used for device location matching
Aruba Site IDYesNoStored as building context and used for occupancy/device API filtering
Sub-building NameNoYesOptional subdivision for wings or towers
Sub-building CodeNoYesOptional short code for the sub-building
Floor NameYesYesDisplay name for the floor
Floor LevelYesYesNumeric floor level
Floor Ref IDYesNoAruba floor ID used by provisioning and polling

Enumerations

After saving place mappings, the Device Status tab devices at the mapped Aruba sites. Users choose which rows to monitor for online/offline status. Each saved selection records the device serial number, device type, site, and any available building/floor location IDs.

Supported device categories are:

  • IAP — provisioned as a wireless access point
  • SWITCH — provisioned as an ethernet switch
  • GATEWAY — provisioned as a generic networked device

Advanced Options

OptionDefaultDescription
Poll OccupancyTRUEEnables or disables floor occupancy polling
Poll Device StatusTRUEEnables or disables device status polling

Mapped Concepts

API to Mapped Entities

This connector creates a place hierarchy from Aruba Sites/Buildings/Floors, adds one Occupancy Zone per mapped floor, and optionally provisions selected Aruba devices with a status point.

Aruba conceptMapped entityexactTypeRelationships
Building from site mapBuildingBuildingParent place in the hierarchy
Optional sub-buildingBuildingBuildinghasPart from building, isPartOf to building
Floor from site mapFloorFloorhasPart from building or sub-building
Virtual floor occupancy areaZoneOccupancyZonehasPart from floor
Selected access pointThingWirelessAccessPointhasLocation to floor or building
Selected switchThingEthernetSwitchhasLocation to floor or building
Selected gatewayThingNetworkedDevicehasLocation to floor or building

API to Mapped Points

Aruba dataPoint locationexactTypeDatatypeUnitDescription
/network-services/v1/wifi-clients-locations total countFloor occupancy zoneOccupancyCountSensorINTCurrent WiFi client count for the mapped floor
/network-monitoring/v1/clients failed-device resultSelected devicePointINT1 when the device is not in the failed list, 0 when it is

Occupancy and device status polls both run every 5 minutes when enabled.

Sample Code

Query Aruba Central devices

Request Response
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  things(filter: {connectedDataSourceId: {eq: "your-connector-Id"}}) {
    id
    name
    exactType
    mappingKey
    hasLocation {
      ... on Building {
        id
        name
        exactType
      }
      ... on Floor {
        id
        name
        exactType
      }
    }
    hasPoint {
      id
      name
      exactType
      mappingKey
    }
  }
}

Query Aruba Central Occupancy Zones

Request Response
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  zones(filter: {connectedDataSourceId: {eq: "your-connector-Id"}}) {
    id
    name
    exactType
    mappingKey
    hasPoint {
      id
      name
      exactType
      mappingKey
    }
  }
}

Query Time Series for On Off Status and Occupancy Count Sensors

Request Response
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
{
  points(filter: {connectedDataSourceId: {eq: "your-connector-Id"}}) {
    id
    name
    exactType
    mappingKey
    isPointOf {
      ... on Zone {
        id
        name
        exactType
        mappingKey
      }
      ... on Thing {
        id
        name
        exactType
        mappingKey
      }
    }
    series(latest: true) {
      timestamp
      value {
        int64Value
      }
    }
  }
}

Graph Diagrams

Aruba Central Source graph shape. Building isLocationOf Networked Device and hasPart Floor. Building hasPart SubBuilding which hasPart Floor. Floor hasPart OccupancyZone, isLocationOf WirelessAccessPoint, and isLocationOf EthernetSwitch.