# n8n-nodes-arubaclearpass

This is an n8n community node for Aruba ClearPass API integration. It provides comprehensive access to ClearPass identity, policy, and enforcement management capabilities for network security operations.

[Aruba ClearPass](https://www.arubanetworks.com/products/network-management-operations/clearpass/) is a comprehensive network access control (NAC) solution that provides policy management, device profiling, and network security for enterprise 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 ClearPass API domains:

### Identities
- **Devices**: Manage network devices, device profiling, and device attributes
- **Endpoints**: Monitor and manage endpoint devices, endpoint profiling
- **Guest Users**: Create, update, and manage guest user accounts and access
- **Local Users**: Manage local user accounts, passwords, and user attributes

### Policy Elements
- **Roles**: Define and manage user roles and role-based access control
- **Role Mappings**: Configure role mapping rules and policies
- **Enforcement Policies**: Create and manage network enforcement policies

### Enforcement Profile
- **Enforcement Profiles**: Configure network enforcement profiles and VLAN assignments

## Key Features

### Device Management
- Add, update, and delete network devices
- Configure device attributes and settings
- Monitor device status and connectivity
- Manage device profiling and classification

### User Management
- Create and manage guest user accounts
- Configure local user accounts and credentials
- Set user attributes and permissions
- Manage user roles and access levels

### Policy Management
- Define role-based access control policies
- Configure enforcement rules and VLAN assignments
- Manage policy mapping and enforcement profiles
- Monitor policy compliance and violations

### Endpoint Control
- Track and manage endpoint devices
- Configure endpoint profiling rules
- Monitor endpoint compliance and status
- Manage endpoint access and permissions

## Authentication

This node supports both API key and OAuth2 authentication with ClearPass:

### API Key Authentication
1. Log into your ClearPass Policy Manager
2. Navigate to Administration > API Services > API Clients
3. Create a new API client or use an existing one
4. Note the Client ID and Client Secret
5. Configure the API credentials in n8n

### OAuth2 Authentication
1. Configure OAuth2 application in ClearPass
2. Set up the OAuth2 credentials in n8n
3. Authorize the application for API access

### Setting up Authentication

1. Access your ClearPass Policy Manager web interface
2. Navigate to Administration > API Services
3. Configure API access and create application credentials
4. Set appropriate permissions for the API operations you need
5. Use the credentials in n8n's ClearPass API credential configuration

## Compatibility

- Requires n8n version 1.0.0 or later
- Compatible with ClearPass API versions 6.7 and later
- Supports ClearPass Policy Manager deployments
- Works with both on-premises and cloud ClearPass instances

## Resources

- [ClearPass API Documentation](https://developer.arubanetworks.com/clearpass)
- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
- [ClearPass Policy Manager User Guide](https://www.arubanetworks.com/techdocs/ClearPass/)

## License

MIT License - see LICENSE file for details

## Support

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

- Check the [ClearPass API documentation](https://developer.arubanetworks.com/clearpass) 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 ClearPass API support
- Identity management: Devices, Endpoints, Guest Users, Local Users
- Policy management: Roles, Role Mappings, Enforcement Policies
- Enforcement profile management
- API key and OAuth2 authentication support
- Comprehensive CRUD operations for all resource types
- Enterprise-grade error handling and logging

## Use Cases

### Network Access Control
- Automate guest user provisioning and management
- Implement dynamic policy enforcement based on device profiling
- Monitor and respond to network access violations

### Identity Management
- Synchronize user accounts with external systems
- Automate role-based access control assignments
- Manage device registration and compliance

### Security Operations
- Monitor endpoint compliance and security posture
- Automate response to security policy violations
- Generate reports on network access and policy enforcement

### Integration Scenarios
- Connect ClearPass with ITSM systems for automated ticket creation
- Integrate with HR systems for user lifecycle management
- Sync with asset management systems for device tracking
- Connect with SIEM systems for security event correlation