SMB2/Samba Block

A workflow block for interacting with SMB2/Samba file shares. This block enables reading, writing, and managing files on SMB2-compatible network shares in your workflow automation.

Features

Actions

• Download File - Download files from SMB shares
• Upload File - Upload files to SMB shares
• List Directory - List contents of directories
• Delete File/Folder - Delete files or directories
• Rename/Move File - Rename or move files and directories

Triggers

• File Watcher - Monitor directories for file changes with various trigger options:
  • New files only
  • Modified files only
  • New and modified files
  • Deleted files
  • All changes

Authentication

The block uses custom authentication with the following required fields:

• Server Host - Hostname or IP address of the SMB server
• Username - Username for authentication
• Password - Password for authentication
• Share Name - Name of the SMB share to connect to

Optional fields:

• Domain - Domain name for Active Directory authentication
• Port - SMB port (default: 445)
• Connect Timeout - Connection timeout in milliseconds (default: 15000)
• Request Timeout - Request timeout in milliseconds (default: 15000)

Usage Examples

Download a File

{
  "path": "/public/documents/report.pdf",
  "binaryPropertyName": "downloadedFile"
}

Upload a File

{
  "path": "/public/uploads/new-document.txt",
  "binaryData": false,
  "fileContent": "Hello, this is file content!"
}

List Directory

{
  "path": "/public/documents",
  "recursive": true,
  "includeHidden": false,
  "filesOnly": false
}

Monitor Directory for Changes

{
  "watchPath": "/public/uploads",
  "watchSubdirectories": true,
  "filePattern": "*.pdf",
  "triggerOn": "new_files",
  "pollingInterval": 60
}

Error Handling

The block provides detailed error messages for common SMB issues:

• Access denied errors
• Network connectivity issues
• File/path not found
• Share not found
• Authentication failures
• Quota issues
• File sharing violations

Compatibility

• Requires Node.js v18 or later
• Compatible with SMB2/SMB3 protocol
• Works with Windows shares, Samba servers, and NAS devices

Installation

This block is part of the workflow automation platform and will be automatically available when the platform is installed.

License

MIT License