Collect Kaseya Datto File Protection logs
This document explains how to ingest Kaseya Datto File Protection logs to Google Security Operations using the Bindplane agent.
Datto File Protection (Siris and Alto) generates syslog messages in CEF format for backup, replication, and file protection events. The parser extracts fields and maps them to the Unified Data Model (UDM).
Before you begin
Make sure you have the following prerequisites:
- A Google SecOps instance
- Windows Server 2016 or later, or Linux host with
systemd - Network connectivity between the Bindplane agent and the Datto appliance
- If running behind a proxy, ensure firewall ports are open per the Bindplane agent requirements
- Privileged access to the Datto Web Console
Get Google SecOps ingestion authentication file
- Sign in to the Google SecOps console.
- Go to SIEM Settings > Collection Agents.
- Download the Ingestion Authentication File.
Save the file securely on the system where the Bindplane agent will be installed.
Get Google SecOps customer ID
- Sign in to the Google SecOps console.
- Go to SIEM Settings > Profile.
Copy and save the Customer ID from the Organization Details section.
Install the Bindplane agent
Install the Bindplane agent on your Windows or Linux operating system according to the following instructions.
Windows installation
- Open Command Prompt or PowerShell as an administrator.
Run the following command:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietWait for the installation to complete.
Verify the installation by running:
sc query observiq-otel-collectorThe service should show as RUNNING.
Linux installation
- Open a terminal with root or sudo privileges.
Run the following command:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shWait for the installation to complete.
Verify the installation by running:
sudo systemctl status observiq-otel-collectorThe service should show as active (running).
Additional installation resources
For additional installation options and troubleshooting, see the Bindplane agent installation guide.
Configure the Bindplane agent to ingest syslog and send to Google SecOps
Locate the configuration file
Linux:
sudo nano /etc/bindplane-agent/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Edit the configuration file
Replace the entire contents of
config.yamlwith the following configuration:receivers: tcplog: listen_address: "0.0.0.0:514" exporters: chronicle/datto_file_protection: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: DATTO_FILE_PROTECTION raw_log_field: body service: pipelines: logs/datto_file_protection_to_chronicle: receivers: - tcplog exporters: - chronicle/datto_file_protection
Configuration parameters
Replace the following placeholders:
Receiver configuration:
listen_address: IP address and port to listen on:0.0.0.0to listen on all interfaces (recommended)- Port
514is the standard syslog port (requires root on Linux; use1514for non-root)
Exporter configuration:
creds_file_path: Full path to ingestion authentication file:- Linux:
/etc/bindplane-agent/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: Customer ID copied from the Google SecOps consoleendpoint: Regional endpoint URL:- US:
malachiteingestion-pa.googleapis.com - Europe:
europe-malachiteingestion-pa.googleapis.com - Asia:
asia-southeast1-malachiteingestion-pa.googleapis.com - See Regional Endpoints for complete list
- US:
Save the configuration file
- After editing, save the file:
- Linux: Press
Ctrl+O, thenEnter, thenCtrl+X - Windows: Click File > Save
- Linux: Press
Restart the Bindplane agent to apply the changes
To restart the Bindplane agent in Linux, run the following command:
sudo systemctl restart observiq-otel-collectorVerify the service is running:
sudo systemctl status observiq-otel-collectorCheck logs for errors:
sudo journalctl -u observiq-otel-collector -f
To restart the Bindplane agent in Windows, choose one of the following options:
Command Prompt or PowerShell as administrator:
net stop observiq-otel-collector && net start observiq-otel-collectorServices console:
- Press
Win+R, typeservices.msc, and press Enter. - Locate observIQ OpenTelemetry Collector.
- Right-click and select Restart.
Verify the service is running:
sc query observiq-otel-collectorCheck logs for errors:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- Press
Configure Syslog for Datto Siris and Alto
- Sign in to the Datto Web Console.
- Go to Configure > Device Settings > Remote Logging.
- Enable Remote Logging.
- Provide the following configuration details:
- Make sure the Bindplane agent is configured to listen on port 514 over the TCP connection.
- IP Address: Enter the Bindplane agent IP address.
- Click Apply.
UDM mapping table
| Log Field | UDM Mapping | Logic |
|---|---|---|
act |
security_result.category_details |
The value of act from the raw log's extensions field. |
desc |
metadata.description |
The value of the description field extracted from the desc field using grok. |
dvc |
target.ip |
The value of dvc from the raw log's extensions field. |
extensions |
security_result.category_details, target.ip |
Parsed using kv filter to extract act and dvc which are then mapped to UDM fields. |
hostname |
principal.hostname |
The hostname extracted from the raw log message. |
log_id |
metadata.product_log_id |
The log ID extracted from the raw log message. |
prod_dvc_version |
metadata.product_version |
The product version extracted from the raw log's desc field. Same value as principal.hostname. Set to STATUS_UPDATE if hostname or dvc are present in the raw log, otherwise "GENERIC_EVENT". Hardcoded value \n\n\0017 when extensions field exists in the raw log. The timestamp extracted from the raw log message. Same value as edr.raw_event_name. Hardcoded value DATTO_FILE_PROTECTION. Hardcoded value S4P4. Hardcoded value Datto. Derived from syslog_severity_code. If < 3, severity is LOW. If > 2 and < 6, severity is MEDIUM. If > 5, severity is HIGH. |
timestamp |
metadata.event_timestamp |
The timestamp extracted from the raw log message. |
Need more help? Get answers from Community members and Google SecOps professionals.