Repository navigation
Highlights
- Detect a blinded or stopped sensor.
The agent writes a heartbeat line toheartbeat.json.<date>everytelemetry.snapshot_interval_secs, and emitsagent::lifecycle::stoppingandagent::lifecycle::unclean_shutdownalerts.
On Windows,agent::tamper::etw_provider_modifiedfires when an ETW provider is disabled while the sensor runs.
Loss alerts now also cover ETW sessions, eBPF rings and maps, macOS ESF and BPF drops, and the artifact queues. - Windows image loads carry code-signing verdicts.
Image and driver loads exposeSigned,SignatureandSignatureStatus, with Sysmon semantics, for embedded signatures, catalog-signed files, and AppX and MSIX package files.
A file that cannot be checked leaves the fields absent, so a rule onSigned: 'false'never fires on it. - Windows no longer needs the Visual C++ redistributable.
The C runtime is now linked statically, sorustinel.exestarts on a clean Windows install instead of exiting silently withSTATUS_DLL_NOT_FOUND.
The release build checks the binary's import table to keep it that way. - More Windows telemetry and more Sigma rules that can fire.
Process starts populateCurrentDirectoryandLogonId(also on Linux), kernel image loads classify asdriver_load, and Security 4740 is collected by default.
category: antivirusrules route to Defender detections,linux/auditdrules are satisfied through an auditd field view, and DNS events gain derived fields such as the registered domain. - Lower overhead and fewer silent gaps.
Artifact eviction is amortized, files are streamed when only digests are missing, pending alert output is bounded by bytes, and the reload poller wakes only for watched files.
On Windows, the startup file rundown is no longer rejected under load.
Upgrade notes
- New heartbeat file.
Addheartbeat.json.*to your log shipper's paths, next toalerts.json.*.
It is written even whentelemetry.enabledis false, andheartbeat.webhooks = truealso sends it to webhooks.
rustinel doctorwarns when the service runs and the file is stale. - New
edr.agentalerts.
Lifecycle, tamper, and the extended loss alerts bypass deduplication and active response.
Route or filter onevent.dataset: "edr.agent"if you do not want them in the same pipeline as detections. - New Windows options, all off by default:
windows.security_long_tail_eventsandwindows.security_domain_controller_events.
Security 5379 joins the default subscription.
The domain controller gate is not yet measured on a real domain controller, so enable it on one host first. - Sigma pin: the SigmaHQ compatibility pin moves to
c04ad420, sosigma doctorverdicts on the SigmaHQ tree can change. - Rule engine and dependencies:
rsigmais updated to 0.25, yara-x to 1.22.1, and the lockfile clears the open RustSec advisories. - Restart the service after replacing the binary, then run
rustinel doctorand verify a known detection before broad deployment.
Downloads
| Platform | Architecture | Package |
|---|---|---|
| Linux | x86_64 | rustinel-1.11.0-x86_64-unknown-linux-musl.tar.gz |
| Linux | arm64 | rustinel-1.11.0-aarch64-unknown-linux-musl.tar.gz |
| Windows | x86_64 | rustinel-1.11.0-x86_64-pc-windows-msvc.zip |
| macOS | arm64 | rustinel-1.11.0-aarch64-apple-darwin.tar.gz |
| macOS | x86_64 | rustinel-1.11.0-x86_64-apple-darwin.tar.gz |
Code signing policy
Free code signing for the Windows binary is provided by SignPath.io, certificate by SignPath Foundation.
See the Code signing policy.
Installer
Linux and macOS
curl -fsSL https://rustinel.io/install.sh | sh -s -- --version 1.11.0
cd rustinel
sudo ./rustinel runmacOS support is experimental. Grant Full Disk Access before the first run: https://docs.rustinel.io/macos-permissions/
Windows (elevated PowerShell)
$env:RUSTINEL_VERSION='1.11.0'; irm https://rustinel.io/install.ps1 | iex; Remove-Item Env:\RUSTINEL_VERSION -ErrorAction SilentlyContinue
Set-Location rustinel
.\rustinel.exe runQuickstart, configuration, and SIEM guides: https://docs.rustinel.io/getting-started/
Scripts install published release binaries only. Verify downloads with the signed rustinel-1.11.0-checksums-sha256.txt and its .minisig file.
Provenance
All release artifacts have SLSA build provenance attestations signed by GitHub:
gh attestation verify <artifact> \
--repo Karib0u/rustinel \
--signer-workflow Karib0u/rustinel/.github/workflows/release.ymlWhat's Changed
Performance
- fix(bench): keep config.toml out of the directory the harness writes into by @Karib0u in #814
- perf(reload): wake the poller only for watched files and cheapen fingerprint passes by @Karib0u in #816
- perf(alerts): bound pending alert output by bytes by @Karib0u in #824
- perf(artifact): stream files when only digests are missing by @Karib0u in #829
- perf(artifact): amortize eviction in the shared artifact store by @Karib0u in #842
Features
- feat(linux-ebpf): capture DNS over TCP and recvmmsg responses, flag cut names by @Karib0u in #828
- feat(sigma): route category: antivirus rules to Defender detections by @Karib0u in #827
- feat(sigma): derived DNS fields (registered domain, name shape) by @Karib0u in #830
- feat(telemetry): extend loss alerts to kernel-side and artifact-queue loss by @Karib0u in #833
- feat(sensor): populate LogonId on Windows and Linux process starts by @Karib0u in #834
- feat(windows-eventlog): collect Security 4740 and gate 4672, 5140, 4799 (#805) by @Karib0u in #835
- feat(windows-etw): populate CurrentDirectory on process starts by @Karib0u in #836
- feat(windows-etw): classify kernel image loads as driver_load by @Karib0u in #837
- feat(alerts): agent heartbeat and lifecycle alerts by @Karib0u in #839
- feat(windows-etw): alert when an ETW provider is disabled while running by @Karib0u in #841
- feat(sigma): satisfy linux/auditd rules through an auditd FieldView by @Karib0u in #844
- feat(windows): add Authenticode Signed, Signature and SignatureStatus on image loads by @Karib0u in #843
- feat(windows-eventlog): collect the domain-controller Security events behind a gate (#544) by @Karib0u in #845
- feat(windows): verify AppX and MSIX package files against their signed block map by @Karib0u in #846
Bug Fixes
- fix(windows): stop the startup file rundown from being rejected under load by @Karib0u in #811
- fix(sigma): derive sigma doctor routing and event IDs from the runtime by @Karib0u in #825
- fix(sigma): resolve field-view aliases and category: dns in sigma doctor by @Karib0u in #826
- fix(windows): link the C runtime statically, drop the vc_redist requirement by @Karib0u in #858
Documentation
- fix(docs): regenerate compatibility/field-availability.json after the sigma doctor merges by @Karib0u in #831
- docs(sigma): trim two lines to satisfy the 300-line page limit by @Karib0u in #847
- docs: separate unavailable, planned and out-of-scope telemetry in coverage and limitations by @Karib0u in #848
- docs(signing): add code signing policy and Windows version resource for SignPath by @Karib0u in #850
Dependencies
- chore(deps): bump zip from 8.6.0 to 9.0.2 by @dependabot[bot] in #823
- chore(deps): bump uuid from 1.27.0 to 1.28.0 by @dependabot[bot] in #820
- chore(deps): bump the patch-updates group across 1 directory with 2 updates by @dependabot[bot] in #822
- fix(deps): clear RustSec advisories via yara-x 1.22.1 and lockfile bumps by @Karib0u in #859
- chore(deps): bump the patch-updates group across 1 directory with 2 updates by @dependabot[bot] in #860
- chore(deps): bump rsigma-parser from 0.24.0 to 0.25.0 by @dependabot[bot] in #868
- chore(deps): bump uuid from 1.28.0 to 1.29.0 by @dependabot[bot] in #869
- chore(deps): bump the patch-updates group with 4 updates by @dependabot[bot] in #867
Maintenance
- test: widen timing margins in the resolver and log rate limiter tests by @Karib0u in #809
- chore(sigma): bump the SigmaHQ compatibility pin to c04ad420 by @Karib0u in #815
- chore(deps): bump actions/upload-artifact from 7.0.1 to 7.0.2 by @dependabot[bot] in #817
- chore(deps): bump taiki-e/install-action from 2.87.25 to 2.87.28 by @dependabot[bot] in #818
- chore(deps): bump astral-sh/setup-uv from 10.2.0 to 10.3.0 by @dependabot[bot] in #819
- chore(deps): bump actions/download-artifact from 8.0.1 to 8.0.2 by @dependabot[bot] in #821
- refactor(macos-esf): decode through a message trait and test with recorded events by @Karib0u in #838
- test(linux): drive the drain_*_ring functions from ring buffer fixtures by @Karib0u in #840
- ci(nix): fix install-nix-action pin version comment by @Karib0u in #852
- chore(deps): bump taiki-e/install-action from 2.87.28 to 2.87.30 by @dependabot[bot] in #856
- chore(deps): bump zizmorcore/zizmor-action from 0.6.4 to 0.7.1 by @dependabot[bot] in #855
- chore(deps): bump cachix/install-nix-action from 31.11.1 to 31.11.2 by @dependabot[bot] in #854
- chore(deps): bump taiki-e/install-action from 2.87.30 to 2.87.32 by @dependabot[bot] in #863
- chore(deps): bump actions/setup-python from 7.0.0 to 7.1.0 by @dependabot[bot] in #864
- chore(deps): bump zizmorcore/zizmor-action from 0.7.1 to 0.8.0 by @dependabot[bot] in #862
- chore(deps): bump astral-sh/setup-uv from 10.3.0 to 10.3.2 by @dependabot[bot] in #865
- chore(deps): bump cachix/install-nix-action from 31.11.2 to 31.11.3 by @dependabot[bot] in #866
Other Changes
Full Changelog: v1.10.0...v1.11.0