This is an n8n community node. It lets you use Seclore DRM Server in your n8n workflows.
[Seclore](https://www.seclore.com) is a leading data-centric security platform that provides enterprise-grade Digital Rights Management (DRM) capabilities to protect sensitive files and documents throughout their lifecycle.
[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
[Installation](#installation)
[Operations](#operations)
[Credentials](#credentials)
[Compatibility](#compatibility)
[Usage](#usage)
[Resources](#resources)
## Installation
Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
Use `n8n-nodes-seclore` as the package name.
## Operations
This node supports the following operations with Seclore DRM Server:
### DRM Protection
#### Protect using Policy
- **Description**: Protects files using Seclore's HotFolder ID configuration and policy-based protection
- **Required Parameters**:
- **HotFolder ID**: The ID of the HotFolder configuration to use for protection
- **Input Binary Property**: Name of the binary property containing the file to protect (default: 'data')
- **Retry Count**: Number of retry attempts for failed requests (default: 3)
- **Output**: Protected file with DRM protection applied according to the specified policy
### DRM Unprotection
#### Unprotect
- **Description**: Removes DRM protection from Seclore-protected files
- **Required Parameters**:
- **Input Binary Property**: Name of the binary property containing the protected file (default: 'data')
- **Retry Count**: Number of retry attempts for failed requests (default: 3)
- **Output**: Unprotected original file content
## Credentials
To use this node, you need to authenticate with your Seclore DRM Server. The following credentials are required:
### Prerequisites
- Access to a Seclore DRM Server instance
- Valid tenant credentials (Tenant ID and Tenant Secret)
- Appropriate permissions for file protection/unprotection operations
### Authentication Setup
1.**Base URL**: The base URL of your Seclore DRM Server (e.g., `https://api.seclore.com`)
2.**Tenant ID**: Your unique Seclore tenant identifier
3.**Tenant Secret**: Your tenant's secret key for API authentication
### Configuration Steps
1. In n8n, go to **Credentials** → **Create New**
2. Search for "Seclore API" and select it
3. Fill in your Seclore DRM Server details:
- **Base URL**: Enter your Seclore DRM Server base URL
- **Tenant ID**: Provide your unique tenant identifier
- **Tenant Secret**: Enter your tenant's secret key (will be masked for security)
4. Test the connection to ensure credentials are valid (tests against `/seclore/drm/1.0/auth/login` endpoint)
5. Save the credentials for use in your workflows
## Compatibility
- **Minimum n8n version**: 1.0.0
- **Tested with n8n versions**: 1.0.0+
- **Node.js version**: 18.x or higher
- **Seclore API version**: Compatible with Seclore DRM API v1.0
## Usage
### Basic Workflow Examples
#### Protecting Files with Policy
1. Use a trigger node to receive files (HTTP Request, File Trigger, etc.)
2. Add the **Seclore** node to your workflow
3. Configure the node:
- **Resource**: Select "DRM Protection"
- **Operation**: Select "Protect using Policy"
- **HotFolder ID**: Enter your HotFolder configuration ID
- **Input Binary Property**: Specify the binary property name (default: 'data')
- **Retry Count**: Set retry attempts (default: 3)
4. Configure your Seclore API credentials
5. The node will return the protected file with DRM encryption applied according to your policy
#### Unprotecting Files
1. Receive protected Seclore files in your workflow
2. Add the **Seclore** node to your workflow
3. Configure the node:
- **Resource**: Select "DRM Unprotection"
- **Operation**: Select "Unprotect"
- **Input Binary Property**: Specify the binary property containing the protected file (default: 'data')
- **Retry Count**: Set retry attempts (default: 3)
4. Configure your Seclore API credentials
5. The node will return the original unprotected file content
### Important Notes
- Ensure your Seclore DRM Server is accessible from your n8n instance
- File operations may take time depending on file size and server performance
- Always handle errors appropriately in your workflows
- Protected files can only be unprotected by authorized users with proper credentials
- HotFolder ID must be configured in your Seclore Policy Server before using protection operations
- The node supports binary data processing for both input and output files
- Retry mechanism is built-in for handling temporary network or server issues
### Error Handling
The node includes comprehensive error handling and logging:
- Connection failures to Seclore server
- Authentication errors
- File processing errors
- Automatic cleanup of temporary files
## Resources
* [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
* [Seclore Official Documentation](https://docs.seclore.com/)
* [Seclore Support](https://support.seclore.com/)
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.
## Support
For issues related to this n8n node:
- Create an issue in this repository
- Contact: support@seclore.com
For Seclore platform support:
- Visit [Seclore Support Portal](https://support.seclore.com/)
