Skip to main content

Collection of API functions for Aruba products.

Project description

aos_api_connector

API connector for ArubaOS products

APIs supported:

  • ArubaOS-S Switches
  • ArubaOS-CX Switches
  • Aruba ClearPass

Installation

Install through pypi via pip:

pip install aos-api-connector

Or manually using the GitHub.

Usage

Every type of API has an API caller class. You can create instances of that class with at least three arguments:

  • Username
  • Password
  • URL / IP / FQDN address of the device

After creating the device, use connect() to create a session. Then use the other functions to use the API. When you are finished use disconnect() to logout.

AurubaOS-S Switch

from aos_api_connector.aos_s import aos_api_caller as aos_s


data = { "url": "172.16.78.65",
  "username": "admin",
  "password": "Aruba123",
  "api_version": "v7"
}
switch = aos_s.AOSSwitchAPIClient(**data)
switch.connect()
sys_info = switch.get_system_info()
print(sys_info)
switch.disconnect()

ArubaOS-CX

from aos_api_connector.aos_cx import aoscx_api_caller as aos_cx


data = { "url": "172.16.78.65",
  "username": "admin",
  "password": "Aruba123",
  "api_version": "v10.04"
}
switch = aos_cx.AOSCXwitchAPIClient(**data)
switch.connect()
sys_info = switch.get_system_info()
print(sys_info)
switch.disconnect()

ClearPass

ClearPass neds either an API token or a username password. That has to be set during instantiation of the API caller class. You can choose with which you want to login, look into example folder for more info.

from  aos_api_connector.cppm import cppm_api_caller as cppm


data = {  
	"url": "10.10.10.10",  
	"api_version": "v1",  
	"client_id": "api_client",  
	"grant_type": "client_credentials",  
	"client_secret": "lTOcISWlXzDV3HCZLT8CVJlN9zxrUirdP+gHpva4mWZ5"  
	}
cppm_test = cppm.CPPMAPIClient(**data)
cppm_test.connect()  
nd_info = cppm_test.get_all_network_devices()  
for nd in nd_info['_embedded']['items']:  
    print(f"Name: {nd['name']} \nIP: {nd['ip_address']} \n\n")

Please note that there is no syntax check!

Some parameters are case sensitive. For example, api_version, there is no check for "V7" or "v7", but only "v7" will work.

Differences between classes

The functions between the two classes should have the same name, if they end up doing the same. So both classes have connect(), disconnect() or get_vlans() even if they are implemented differently.

Roadmap

I am working on implementing more functions and to create classes for the ClearPass and ArubaOS WLAN APIs. After that I will create workflows spanning different APIs.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aos-api-connector, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size aos_api_connector-0.1.2-py3-none-any.whl (15.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size aos-api-connector-0.1.2.tar.gz (2.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page