Aruba
Integrate Aruba Central to retrieve network access control and policy management data
This document describes how to configure the Aruba Central connector, allowing OverSOC to retrieve network access control data via the Aruba API.
Objective
The Aruba connector retrieves the following information:
- Network device inventory (access points, switches, controllers)
- Network Access Control (NAC) policies
- Connected client status
Prerequisites
- Access to Aruba Central with administrator rights.
- An API application (OAuth2) created in Aruba Central.
Information required in OverSOC
| Field | Description |
|---|---|
| Client ID | OAuth2 application identifier created in Aruba Central |
| Client Secret | Secret associated with the OAuth2 application |
| Region | Region of your Aruba Central instance (e.g. EU Central3) |
Procedure
Create an API Client in Aruba ClearPass
- Log in to your Aruba ClearPass administration interface.
- Go to Guest > Administration > API Services > API Clients.
- Click Create API Client.
- Configure the OAuth2 application:
- Operator Profile: Choose or create a profile with appropriate read permissions.
- Grant Type: Select
client_credentials.
- Complete the configuration and confirm.
- Note the auto-generated Client ID and Client Secret.
Configure the connector in OverSOC
- In OverSOC, go to Data Sources Settings > Sources.
- Select Aruba and click Configure.
- Choose the API Connection mode.
- Fill in the required fields:
- Client ID: Your OAuth2 application identifier.
- Client Secret: The associated secret.
- Click Save Configuration.
Official Documentation
For additional information, refer to the Aruba ClearPass API Client documentation.
Required permissions
The API application must have read permissions on:
- Devices (network equipment)
- Clients (connected users)
- Network policies
!!! tip "Best practice" Use an application dedicated to OverSOC in Aruba Central so you can revoke access independently without impacting other integrations.