Add n8n custom node for APort verification

nodes/n8n-nodes-aport/.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true

nodes/n8n-nodes-aport/.gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+*.log
+.env
+.DS_Store

nodes/n8n-nodes-aport/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2025-10-29
+
+### Added
+
+- Initial release of n8n-nodes-aport
+- Support for Verify Policy operation
+- Support for Create Passport operation
+- Support for Get Passport operation
+- Support for Suspend Passport operation
+- Support for List Policy Packs operation
+- Comprehensive error handling with continueOnFail support
+- Full documentation and examples
+- APort API credentials integration
+- Live tested in n8n environment
+
+### Known Issues
+
+- Newly created passports require indexing time before verification (API limitation)
+- Get Passport operation may return 403 for recently created agents (API limitation)
+- Suspend Passport may return 405 depending on API permissions

nodes/n8n-nodes-aport/README.md

@@ -0,0 +1,121 @@
+# n8n-nodes-aport
+
+This is an n8n community node for APort agent verification and policy compliance.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+[APort](https://aport.io) provides agent verification and policy compliance for AI agents.
+
+## Installation
+
+### Windows Installation
+
+1. Copy the node to n8n's custom nodes directory:
+
+```powershell
+Copy-Item -Path "path\to\n8n-nodes-aport" -Destination "$env:USERPROFILE\.n8n\nodes\" -Recurse
+```
+
+2. Install dependencies:
+
+```powershell
+cd "$env:USERPROFILE\.n8n\nodes\n8n-nodes-aport"
+npm install
+```
+
+3. Start n8n with custom extensions:
+
+```powershell
+$env:N8N_CUSTOM_EXTENSIONS = "$env:USERPROFILE\.n8n\nodes"
+n8n start
+```
+
+### Linux/Mac Installation
+
+1. Copy the node to n8n's custom nodes directory:
+
+```bash
+cp -r path/to/n8n-nodes-aport ~/.n8n/nodes/
+```
+
+2. Install dependencies:
+
+```bash
+cd ~/.n8n/nodes/n8n-nodes-aport
+npm install
+```
+
+3. Start n8n with custom extensions:
+
+```bash
+export N8N_CUSTOM_EXTENSIONS=~/.n8n/nodes
+n8n start
+```
+
+### Community Nodes (Future - requires npm publish)
+
+Once published to npm:
+
+1. Go to **Settings > Community Nodes** in your n8n instance
+2. Click **Install**
+3. Enter `n8n-nodes-aport`
+4. Click **Install**
+
+## Operations
+
+The APort node supports the following operations:
+
+- **List Policy Packs** - List all available policy packs (no credentials required)
+- **Verify Policy** - Verify an agent against a policy
+- **Create Passport** - Create a new agent passport (requires API key)
+- **Get Passport** - Get passport information for an agent
+- **Suspend Passport** - Suspend an agent passport
+
+## Quick Start Examples
+
+### 1. List All Available Policy Packs
+
+**Operation**: List Policy Packs
+
+### 2. Create a New Agent Passport
+
+Required: API Key credential
+
+```json
+{
+  "name": "My Export Bot",
+  "role": "Data Exporter",
+  "description": "Agent for CSV exports",
+  "capabilities": [{ "id": "data.export", "params": {} }],
+  "limits": {
+    "max_rows_per_export": 10000,
+    "allow_pii": false
+  },
+  "regions": ["US"],
+  "contact": "[email protected]",
+  "controller_type": "person",
+  "status": "active"
+}
+```
+
+## Testing
+
+The node has been live tested in n8n with the following results:
+
+- ✅ **List Policy Packs** - Working perfectly
+- ✅ **Create Passport** - Working perfectly
+- ⚠️ **Verify Policy** - Returns 404 for newly created agents (requires indexing time)
+- ⚠️ **Get Passport** - Returns 403 for newly created agents (requires indexing time)
+- ⚠️ **Suspend Passport** - Returns 405 (method not allowed or requires different permissions)
+
+**Note:** The ⚠️ warnings are API-side limitations, not node issues. The node correctly handles all responses and displays appropriate error messages.
+
+## Resources
+
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+- [APort Documentation](https://docs.aport.io)
+- [Example Workflow](./examples/example-workflow.json)
+
+## License
+
+MIT

nodes/n8n-nodes-aport/credentials/APortApi.credentials.js

@@ -0,0 +1,27 @@
+class APortApi {
+  name = "aportApi";
+  displayName = "APort API";
+  documentationUrl = "https://docs.aport.io";
+  properties = [
+    {
+      displayName: "API Key",
+      name: "apiKey",
+      type: "string",
+      typeOptions: {
+        password: true,
+      },
+      default: "",
+      description:
+        "Your APort API key (optional for verification, required for passport creation)",
+    },
+    {
+      displayName: "Base URL",
+      name: "baseUrl",
+      type: "string",
+      default: "https://api.aport.io",
+      description: "The base URL for the APort API",
+    },
+  ];
+}
+
+module.exports = { APortApi };

nodes/n8n-nodes-aport/examples/example-workflow.json

@@ -0,0 +1,54 @@
+{
+  "name": "APort Verification Workflow",
+  "nodes": [
+    {
+      "parameters": {
+        "operation": "listPolicyPacks"
+      },
+      "name": "List Available Policies",
+      "type": "n8n-nodes-aport.aport",
+      "position": [250, 300],
+      "typeVersion": 1
+    },
+    {
+      "parameters": {
+        "operation": "createPassport",
+        "passportData": "{\n  \"name\": \"My Test Agent\",\n  \"role\": \"Data Export Bot\",\n  \"description\": \"Agent for exporting user data\",\n  \"capabilities\": [\n    { \"id\": \"data.export\", \"params\": {} }\n  ],\n  \"limits\": {\n    \"max_rows_per_export\": 10000,\n    \"allow_pii\": false\n  },\n  \"regions\": [\"US\"],\n  \"contact\": \"[email protected]\",\n  \"controller_type\": \"person\",\n  \"status\": \"active\"\n}"
+      },
+      "name": "Create Agent Passport",
+      "type": "n8n-nodes-aport.aport",
+      "credentials": {
+        "aportApi": {
+          "name": "APort API"
+        }
+      },
+      "position": [450, 300],
+      "typeVersion": 1
+    },
+    {
+      "parameters": {
+        "operation": "verifyPolicy",
+        "policyId": "data.export.v1",
+        "agentId": "={{$json[\"agent_id\"]}}",
+        "context": "{\n  \"rows\": 1000,\n  \"dataset\": \"users\",\n  \"idempotency_key\": \"{{$json[\\\"request_id\\\"]}}\",\n  \"export_type\": \"csv\"\n}"
+      },
+      "name": "Verify Export Policy",
+      "type": "n8n-nodes-aport.aport",
+      "position": [650, 300],
+      "typeVersion": 1
+    }
+  ],
+  "connections": {
+    "Create Agent Passport": {
+      "main": [
+        [
+          {
+            "node": "Verify Export Policy",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  }
+}

nodes/n8n-nodes-aport/index.js

@@ -0,0 +1,13 @@
+const APort = require("./nodes/APort/APort.node.js");
+const {
+  credentialClass: APortApi,
+} = require("./credentials/APortApi.credentials.js");
+
+module.exports = {
+  nodes: {
+    APort,
+  },
+  credentials: {
+    APortApi,
+  },
+};