n8n-nodes-arubaclearpass 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Cybernetic Node Composer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,140 @@
+# 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

package/dist/nodes/ArubaClearPass/methods/EnforcementProfile/EnforcementProfile.methods.js

@@ -68,9 +68,16 @@ async function createEnforcementProfile() {
             body.action = action;
         }
         // Add complex configuration
-        const profileConfigJson = this.getNodeParameter('profileConfig', 0, '{}');
+        const profileConfigRaw = this.getNodeParameter('profileConfig', 0, '{}');
         try {
-            const profileConfig = JSON.parse(profileConfigJson);
+            let profileConfig;
+            // Handle both string (JSON) and object inputs
+            if (typeof profileConfigRaw === 'string') {
+                profileConfig = JSON.parse(profileConfigRaw);
+            }
+            else {
+                profileConfig = profileConfigRaw;
+            }
             // Merge the profile config with the body
             Object.entries(profileConfig).forEach(([key, value]) => {
                 body[key] = value;
@@ -168,7 +175,14 @@ async function updateEnforcementProfile() {
         // Handle complex profile configuration if provided
         if (updateFields.profileConfig) {
             try {
-                const profileConfig = JSON.parse(updateFields.profileConfig);
+                let profileConfig;
+                // Handle both string (JSON) and object inputs
+                if (typeof updateFields.profileConfig === 'string') {
+                    profileConfig = JSON.parse(updateFields.profileConfig);
+                }
+                else {
+                    profileConfig = updateFields.profileConfig;
+                }
                 // Merge the profile config with the body
                 Object.entries(profileConfig).forEach(([key, value]) => {
                     body[key] = value;
@@ -219,7 +233,14 @@ async function updateEnforcementProfileByName() {
         // Handle complex profile configuration if provided
         if (updateFields.profileConfig) {
             try {
-                const profileConfig = JSON.parse(updateFields.profileConfig);
+                let profileConfig;
+                // Handle both string (JSON) and object inputs
+                if (typeof updateFields.profileConfig === 'string') {
+                    profileConfig = JSON.parse(updateFields.profileConfig);
+                }
+                else {
+                    profileConfig = updateFields.profileConfig;
+                }
                 // Merge the profile config with the body
                 Object.entries(profileConfig).forEach(([key, value]) => {
                     body[key] = value;
@@ -267,9 +288,16 @@ async function replaceEnforcementProfile() {
             body.action = action;
         }
         // Add complex configuration
-        const profileConfigJson = this.getNodeParameter('profileConfig', 0, '{}');
+        const profileConfigRaw = this.getNodeParameter('profileConfig', 0, '{}');
         try {
-            const profileConfig = JSON.parse(profileConfigJson);
+            let profileConfig;
+            // Handle both string (JSON) and object inputs
+            if (typeof profileConfigRaw === 'string') {
+                profileConfig = JSON.parse(profileConfigRaw);
+            }
+            else {
+                profileConfig = profileConfigRaw;
+            }
             // Merge the profile config with the body
             Object.entries(profileConfig).forEach(([key, value]) => {
                 body[key] = value;
@@ -316,9 +344,16 @@ async function replaceEnforcementProfileByName() {
             body.action = action;
         }
         // Add complex configuration
-        const profileConfigJson = this.getNodeParameter('profileConfig', 0, '{}');
+        const profileConfigRaw = this.getNodeParameter('profileConfig', 0, '{}');
         try {
-            const profileConfig = JSON.parse(profileConfigJson);
+            let profileConfig;
+            // Handle both string (JSON) and object inputs
+            if (typeof profileConfigRaw === 'string') {
+                profileConfig = JSON.parse(profileConfigRaw);
+            }
+            else {
+                profileConfig = profileConfigRaw;
+            }
             // Merge the profile config with the body
             Object.entries(profileConfig).forEach(([key, value]) => {
                 body[key] = value;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-arubaclearpass",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "n8n community node for Aruba ClearPass API integration with comprehensive identity, policy, and enforcement profile management",
   "keywords": [
     "n8n-community-node-package",