Collect Stealthbits Audit logs
This document explains how to ingest Stealthbits Audit logs to Google Security Operations using the Bindplane agent.
Stealthbits StealthAUDIT (now Netwrix StealthAUDIT) is an IT auditing and data governance platform used for Active Directory monitoring, file system auditing, and access rights management. The Netwrix Activity Monitor component supports native syslog forwarding for real-time event delivery.
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 Stealthbits StealthAUDIT server
- If running behind a proxy, ensure firewall ports are open per the Bindplane agent requirements
- Privileged access to the Netwrix Enterprise Auditor (StealthAUDIT) console and Activity Monitor
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 Bindplane 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 /opt/observiq-otel-collector/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: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/stealthbits_audit: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: STEALTHBITS_AUDIT raw_log_field: body service: pipelines: logs/stealthbits_audit_to_chronicle: receivers: - udplog exporters: - chronicle/stealthbits_audit
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 the 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 Stealthbits StealthAUDIT syslog forwarding
- Open the Netwrix Activity Monitor console.
- Go to Monitored Hosts and select the target host.
- Click the Outputs tab, then select Syslog.
Configure the following settings:
Setting Value Syslog server Enter the Bindplane agent IP address and port in SERVER:PORTformat (for example,192.168.1.100:514)Protocol Select UDP Message template Configure the syslog message template to control what data is included in the event stream Click Save to apply the configuration.
UDM mapping table
| Log Field | UDM Mapping | Logic |
|---|---|---|
Operation |
additional.fields |
Mapped: Change → additional_old_value, Change → additional_new_value |
additional_field |
additional.fields |
Merged |
additional_new_value |
additional.fields |
Merged |
additional_old_value |
additional.fields |
Merged |
intermediary_domain |
intermediary.hostname |
Directly mapped |
event_description |
metadata.description |
Directly mapped |
event_timestamp |
metadata.event_timestamp |
Parsed as yyyy-MM-dd HH:mm:ss.SSS |
product_event_type |
metadata.event_type |
Mapped: Windows File System Update → FILE_MODIFICATION, `Active Directory Object Modifie... |
product_event_type |
metadata.product_event_type |
Directly mapped |
ClientHost |
principal.hostname |
Directly mapped |
ClientAddress |
principal.ip |
Merged |
NewAttributeValue |
principal.process.command_line |
Directly mapped |
blocked_event |
security_result.action |
Merged |
Operation |
security_result.category_details |
Merged |
target_administrative_domain |
target.administrative_domain |
Directly mapped |
file_path |
target.file.full_path |
Renamed/mapped |
target_hostname |
target.hostname |
Directly mapped |
target_ip |
target.ip |
Merged |
ModifiedObject |
target.resource.name |
Directly mapped |
| N/A | metadata.event_type |
Constant: FILE_MODIFICATION |
| N/A | metadata.product_name |
Constant: StealthINTERCEPT |
| N/A | metadata.vendor_name |
Constant: Stealthbits |
Need more help? Get answers from Community members and Google SecOps professionals.