Skip to content

redanthrax/cove-node

Repository files navigation

n8n-nodes-cove

An n8n community node for integrating with Cove Data Protection (formerly N-able Backup) JSON-RPC API.

Installation

Follow the installation guide in the n8n community nodes documentation.

npm install n8n-nodes-cove

Prerequisites

Setup

Enabling API Authentication

  1. Log into your Cove Data Protection Management Console
  2. Navigate to Settings > Users
  3. Edit your user account or create a dedicated API user
  4. Enable API Authentication checkbox
  5. Note down your partner name, username (email), and password for use in n8n

Configuring Credentials in n8n

  1. API URL: The JSON-RPC endpoint (default: https://api.backup.management/jsonapi)
  2. Partner Name: Your company/reseller name as it appears in Cove
  3. Username: Your email address for API access
  4. Password: Your password

Important: The user account must have API Authentication enabled in the Management Console.

Supported Operations

Partners

Manage partner/reseller hierarchy and relationships:

  • Create - Create a new partner
  • Delete - Delete a partner
  • Get by ID - Retrieve a specific partner by ID
  • Get Many - Enumerate partners with optional recursive fetching
  • Update - Update partner information

Accounts

Manage backup accounts (devices) with comprehensive operations:

  • Create - Create a new backup account
  • Delete - Delete an account
  • Get by ID - Retrieve a specific account by ID
  • Get Many - Enumerate accounts for a partner
  • Get Statistics - Get detailed account statistics with column codes (normalized field names)
  • Update - Update account information

Account Statistics Column Codes

The Get Statistics operation automatically normalizes Cove's column codes to friendly field names:

Common Mappings:

  • I0deviceId - Unique device identifier
  • I1deviceName - Device/account name
  • I4creationDate - Unix timestamp of creation
  • I14usedStorage - Storage used in bytes
  • I16osVersion - Operating system version
  • I17clientVersion - Backup client version
  • I18computerName - Computer/hostname
  • I19internalIps - Internal IP addresses
  • I20externalIps - External IP addresses
  • I21macAddress - MAC address
  • I78activeDataSources - Active backup data sources (D1=Files, D2=System State, etc.)

For a complete list of column codes, see the Column Codes Documentation.

Users

Comprehensive user management operations:

  • Create - Create a new user with role assignment
  • Delete - Delete a user
  • Get by ID - Retrieve a specific user by ID
  • Get Many - Enumerate users for a partner
  • Update - Update user information

API Authentication

Cove Data Protection uses a visa-based authentication system:

  • Initial login with partner name, username, and password
  • Receives a visa (session token) valid for 15 minutes
  • Each API response includes a new visa to maintain the session
  • The node automatically manages visa renewal and caching

Resources

License

MIT

About

n8n node for Cove Data Protection

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published