n8n-nodes-arubacentral/README.md

n8n community node for Aruba Central API integration with comprehensive monitoring, configuration, and management capabilities

# n8n-nodes-arubacentral

This is an n8n community node for Aruba Central API integration. It provides comprehensive access to Aruba Central's monitoring, configuration, and management capabilities for network infrastructure.

[Aruba Central](https://www.arubanetworks.com/products/network-management/aruba-central/) is a cloud-native network management platform that simplifies operations across campus, branch, and data center environments.

## Installation

Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

## Operations

This node provides access to all major Aruba Central API domains:

### Monitoring
- **Access Points**: Monitor AP status, performance, clients, bandwidth usage
- **Clients**: Track client connections, usage patterns, mobility
- **Gateways**: Monitor gateway performance, tunnels, ports, usage
- **Switches**: Monitor switch performance, ports, VLANs, PoE information
- **Networks**: Monitor network-wide statistics and bandwidth usage
- **Events**: Access system events and alerts
- **Labels**: Manage device labeling and categorization
- **Sites**: Monitor site-level statistics and performance

### Configuration
- **Access Points**: Configure AP settings, CLI commands, SSIDs, hostnames
- **Devices**: Manage device groups, move devices between groups

### Inventory
- **Device Management**: Add, remove, archive devices, verify device status

### Firmware Management
- **Device Firmware**: Check versions, upgrade firmware, manage compliance
- **Swarm Management**: Monitor and manage AP swarms
- **Status Tracking**: Track firmware upgrade progress and status

### AI Operations (AIOps)
- **Connectivity Insights**: Monitor global, group, and site connectivity
- **Performance Insights**: Track AP, client, gateway, network, site, and switch insights
- **Anomaly Detection**: Access detailed insight information and recommendations

### Topology
- **Network Topology**: Discover network topology, device relationships, VLANs
- **Device Connections**: Monitor device connections, uplinks, tunnels

### Key Management
- **Security Operations**: Manage WPA keys, roaming cache, client roam history

### Troubleshooting
- **Command Execution**: Run troubleshooting commands on devices
- **Session Management**: Manage troubleshooting sessions
- **Backup Operations**: Initiate and manage device backups
- **Certificate Management**: Handle EST certificate enrollment

### RAPIDS (Rogue AP Detection)
- **Rogue Detection**: Monitor rogue and interfering access points
- **WIDS Events**: Access wireless intrusion detection events
- **Security Monitoring**: Track client and infrastructure attacks

## Authentication

This node uses OAuth2 authentication with Aruba Central. You'll need:

1. An Aruba Central account with API access
2. OAuth2 application credentials (Client ID and Client Secret)
3. Appropriate API permissions for the operations you want to use

### Setting up Authentication

1. Log into your Aruba Central dashboard
2. Navigate to Platform Integration > API Gateway
3. Create a new application or use an existing one
4. Note the Client ID and Client Secret
5. Configure the OAuth2 credentials in n8n with these values

## Compatibility

- Requires n8n version 1.0.0 or later
- Compatible with Aruba Central API v2
- Supports both cloud and on-premises Aruba Central deployments

## Resources

- [Aruba Central API Documentation](https://developer.arubanetworks.com/aruba-central/docs)
- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
- [Aruba Central User Guide](https://help.central.arubanetworks.com/)

## License

MIT License - see LICENSE file for details

## Support

This is a community-maintained node. For issues and questions:

- Check the [Aruba Central API documentation](https://developer.arubanetworks.com/aruba-central/docs) for API-specific questions
- Use the [n8n community forum](https://community.n8n.io) for general n8n questions
- Report bugs and feature requests in the GitHub repository

## Contributing

Contributions are welcome! Please read our contributing guidelines and submit pull requests for any improvements.

## Version History

### 1.0.0
- Initial release with comprehensive Aruba Central API support
- All major API domains included: Monitoring, Configuration, Inventory, Firmware, AIOps, Topology, Key Management, Troubleshooting, RAPIDS
- OAuth2 authentication support
- Extensive parameter coverage for filtering and pagination
- Enterprise-grade error handling and logging