Location Based Provisioning Service for Aruba Central

A service to auto provision devices in Aruba Central based on the Geo-IP location

Geo-IP auto provisioning service (GAPS) will auto assign any new AP to a group in Central based on the location of the device.

How It Works:

• New AP is plugged in and automatically connects to Aruba Central.
• Central via webhook posts a message to GAPS which then does a REST API call to Central for AP details.
• The details are parsed for the public IP. GAPS makes an API call to a public GEO IP service which return the physical location of the installed AP.
• The location data parsed for the two letter state code. This is checked against a local dictionary that maps the state to a group in Central (IE East-Group / West-Group).
• GAPS then sends the group info to Central and provisions the AP into the proper group.

First Steps:

1. Log into Aruba Central from the Account Home page:
   • API Gateway > System Apps & Tokens > Create a new key
   • Webhooks > Click the + sign > Enter the URL where the GAPS service will be posted "https://your-server.com/webhook"
2. Launch the Network Dashboard:
   • Global > Alerts & Events > Config
   • Under Access Point > Enable AP Detect > Select the Webhook for GAPS

Install Instructions:

1. Copy the files to host
2. Open location_mapping.py
   • Match the two letter state code to the Central Group
   • Add a Group for the default for any Geo-IP locations that don't match
3. Open dockerfile and add the Aruba Central Credentials

> ENV [email protected]  
> ENV PASSWORD=xxxxxxxxxx  
> ENV CLIENT_ID=xxxxxxxxxx  
> ENV CLIENT_SECRET=xxxxxxxxxx  
> ENV CUSTOMER_ID=xxxxxxxxxx  
> ENV BASE_URL=https://apigw-prod2.central.arubanetworks.com   
> ENV WEBHOOK_TOKEN=xxxxxxxxxx  

4. Create the container "docker build -t gaps:latest ."
5. Start the container "docker run -p 5000:5000 gaps"

This container includes gunicorn web-server, modify the wsgi config as needed.

Question - Feel free to contact me:
#(c) 2021 Will Smith - [email protected]