n8n-nodes-licensekit

This is an n8n community node that provides LicenseKit runtime operations for workflow automation.

n8n is a fair-code licensed workflow automation platform.

LicenseKit is a modern licensing API for software vendors.

Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in n8n
2. Select Install
3. Enter n8n-nodes-licensekit in the npm Package Name field
4. Click Install

Manual Installation

npm install n8n-nodes-licensekit

Operations

License Operations

• Activate: Bind license to a device and activate it
• Validate: Validate license status and refresh timestamps
• Check: Check entitlements without updating timestamps (lightweight)
• Consume: Record metered feature usage with idempotency
• Deactivate: Release device binding
• Offline: Issue encrypted offline license envelope

Floating License Operations

• Checkout: Acquire a floating license lease
• Checkin: Release a floating license lease
• Heartbeat: Refresh floating license lease to extend expiry

Credentials

To use this node, you need:

1. License Key: Your LicenseKit runtime license key (starts with lsk_ or LK-)
2. Base URL: Your LicenseKit API endpoint (default: https://api.licensekit.dev)

Get your license key from your LicenseKit dashboard or by creating a license via the management API.

Example Workflows

Basic License Validation

1. Add the LicenseKit node to your workflow
2. Configure credentials with your license key
3. Select License resource and Validate operation
4. Provide device fingerprint (e.g., hardware ID)
5. The node returns license status, features, and entitlements

Access response data in subsequent nodes:

{{$json["data"]["status"]}}              # License status (e.g., "active")
{{$json["data"]["device_id"]}}           # Device ID
{{$json["data"]["features"]}}            # Array of feature entitlements
{{$json["data"]["expires_at"]}}          # Expiration timestamp
{{$json["meta"]["request_id"]}}          # Request ID for debugging

Metered Usage Tracking

Track API calls or feature consumption:

1. Add LicenseKit node with Consume operation
2. Set Feature Code to your metered feature (e.g., api_calls)
3. Set Event ID to a unique identifier for idempotency
4. Set Amount to the quantity consumed (default: 1)
5. The response includes updated consumed and remaining counts

Example Event ID expression:

evt_{{$json["request_id"]}}

Floating License Workflow

Manage concurrent license leases:

1. Checkout: Acquire a lease and get lease_token
2. Heartbeat: Periodically refresh the lease
3. Checkin: Release the lease when done

Lease token reference:

{{$json["data"]["lease_token"]}}

Response Format

All runtime operations return signed responses with this structure:

{
  "data": {
    "license_id": "lic_...",
    "status": "active",
    "device_id": "dev_...",
    "features": [
      {
        "code": "api_access",
        "enabled": true
      },
      {
        "code": "api_calls",
        "quota": 10000,
        "consumed": 42,
        "remaining": 9958
      }
    ],
    "issued_at": "2026-03-25T10:30:00Z",
    "next_check_at": "2026-03-26T10:30:00Z"
  },
  "signature": {
    "alg": "Ed25519",
    "kid": "key_...",
    "value": "base64-encoded-signature"
  },
  "meta": {
    "request_id": "req_...",
    "timestamp": "2026-03-25T10:30:00Z"
  }
}

Error Handling

The node provides detailed error messages for common scenarios:

• 401 UNAUTHORIZED_LICENSE: Invalid license key
• 403 FORBIDDEN_RUNTIME: License suspended, expired, or limit reached
• 404 NOT_FOUND: License or device not found
• 409 CONFLICT: Duplicate event_id in consume operation
• 422 VALIDATION_ERROR: Invalid request parameters

Enable Continue On Fail in node settings to handle errors gracefully in your workflow.

Use Cases

• License Validation: Verify software licenses before granting access
• Metering: Track API calls, processing time, or resource consumption
• Device Management: Activate/deactivate licenses on specific devices
• Floating Licenses: Manage concurrent user sessions
• Offline Licensing: Issue time-limited offline licenses
• Feature Gating: Check entitlements for premium features

Resources

• LicenseKit Documentation
• LicenseKit API Reference
• n8n Community Nodes
• GitHub Repository

Support

For issues or questions:

• GitHub Issues: https://github.com/drmain1/n8n-nodes-licensekit/issues
• LicenseKit Support: [email protected]

License

MIT

Version

Current version: 0.1.0

This is an early release. The API is stable, but additional features may be added based on community feedback.