Skip to content

Releases

Netra for macOS 0.4.1 (security fix, 30-day trial)

Choose a tag to compare

@zyrona-labs zyrona-labs released this 19 Nov 22:40
ed415a1

Netra for macOS 0.4.1: a security fix for 0.4.0 and earlier. Upgrade recommended.

Security fix. Up to 0.4.0, Netra saved the key that encrypts your stored API token (~/Library/Application Support/Netra/secrets/master.key) with permissions 0644, so other user accounts on the same Mac could read it and decrypt the token. 0.4.1 fixes this:

  • The key now lives in the macOS Keychain, accessible only while the Mac is unlocked and never copied to other devices. If the Keychain is unavailable, Netra falls back to a file readable only by you (mode 0600) and writes a line to the system log saying so.
  • The secrets folder is now mode 0700 and the token files 0600. Change-history cache files are now 0600 too.
  • On first launch after upgrading, Netra repairs the permissions of an existing install and moves the existing key into the Keychain, so your saved token keeps working; you do not need to re-enter it. The old key file is overwritten and deleted (best effort on APFS).
  • Anyone who had an older version installed on a shared Mac may want to rotate the API token they saved in Netra.

Trial. Free 30-day trial key: request a key from sales@zyvor.dev. The app also runs without a key. Buy a licence at https://zyvor.dev/buy. Licence behaviour is unchanged.

Requirements. macOS 15 or later. Universal binary (arm64 and x86_64); tested by us on Apple silicon only.

Notarized. Signed with our Developer ID (hardened runtime) and notarized by Apple.

Checksum. SHA-256 of Netra-0.4.1.dmg: 033624d44c07ea6b5cc9f0364343cd08a1a67c369cdb73d809947605f2328a95

Netra for macOS 0.4.0 (30-day trial)

Choose a tag to compare

@zyrona-labs zyrona-labs released this 19 Nov 14:51
d5e64e9

Netra for macOS 0.4.0, the native Mac app.

Trial. The app runs without a key. For a free 30-day trial key, email sales@zyvor.dev. Buy a licence at https://zyvor.dev/buy.

Requirements. macOS 15 or later, Apple silicon and Intel (universal).

Notarized. Signed with our Developer ID. Notarized by Apple; macOS shows its standard first-open confirmation for apps downloaded from the internet.

Checksum. SHA-256 of Netra-0.4.0.dmg: 4db26f8323f6edc81e835adcde75307717c5c0ff33db7ede661ca057f947f6d0

Netra for macOS 0.3.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 13:34

What's Changed

  • build(deps-dev): bump playwright from 1.63.0 to 1.64.1 in /web by @dependabot[bot] in #88
  • build(deps): bump actions/checkout from 4 to 7 in the actions group across 1 directory by @dependabot[bot] in #92
  • build(deps): bump golang.org/x/net from 0.61.0 to 0.62.0 in the x group across 1 directory by @dependabot[bot] in #93
  • build(deps-dev): bump vite from 8.3.4 to 8.3.5 in /web by @dependabot[bot] in #94
  • build(deps): bump google.golang.org/grpc from 1.84.0 to 1.85.0 by @dependabot[bot] in #95
  • build(deps): bump lucide-react from 1.52.0 to 1.67.0 in /web by @dependabot[bot] in #98
  • build(deps): bump modernc.org/sqlite from 1.61.0 to 1.61.1 by @dependabot[bot] in #100

Full Changelog: macos-v0.2.0...macos-v0.3.0

Netra for macOS 0.2.0

Choose a tag to compare

@github-actions github-actions released this 09 Nov 07:49
b6b3cab

What's Changed

  • feat: per-node mTLS, scoped auth, SQLite flows, investigate timeline by @zyrona-labs in #80
  • release: cut 0.32.0 by @zyrona-labs in #81
  • ci: add advisory AI PR review by @zyrona-labs in #83
  • Fix AI-review findings: lease sub-second state, UTF-8 truncation by @zyrona-labs in #84
  • Fix raw-IP ClientHello extraction fallthrough (AI review pass 2) by @zyrona-labs in #85
  • build(deps): bump the x group across 1 directory with 2 updates by @dependabot[bot] in #82
  • build(deps-dev): bump vite from 8.3.3 to 8.3.4 in /web by @dependabot[bot] in #76
  • build(deps): bump react-dom from 19.3.0 to 19.3.1 in /website by @dependabot[bot] in #86
  • build(deps): bump the react group in /web with 2 updates by @dependabot[bot] in #87
  • build(deps): bump modernc.org/sqlite from 1.60.1 to 1.61.0 by @dependabot[bot] in #97
  • macos: native SwiftUI client (NetraKit + app shell) by @zyrona-labs in #103
  • macos: guarded node isolation, shield, scope, rate limits, netpol, deny import, intel, bulk capture by @zyrona-labs in #104
  • macos: bespoke views for the remaining observe pages by @zyrona-labs in #105
  • macos: observe, metrics, ops, console, notifications and links by @zyrona-labs in #106
  • macos: policy tools, insights pages, AI agent chat and accurate route coverage by @zyrona-labs in #107
  • macos: profiles and SSO, link filters, VNC and VMs, packaging and CI by @zyrona-labs in #108
  • macos: fix topology hit-test build on the CI runner SDK by @zyrona-labs in #109
  • macos: fix field-name, decode and request-body mismatches by @zyrona-labs in #110
  • macos: bulk-apply counts, Shortcuts intents, What-changed page, smarter palette by @zyrona-labs in #111
  • macos: blank-column diagnostic, link-filter hooks, silence parser units, app icon by @zyrona-labs in #112
  • macos: import connection details from a file and inline certificate trust by @zyrona-labs in #113
  • Remove the built-in admin key from deploy script and web login by @zyrona-labs in #114
  • macos: add a Handoff page for the on-call shift-note pack by @zyrona-labs in #115
  • macos: add "Explain with Netra AI" to the row inspector on every data page by @zyrona-labs in #116

Full Changelog: v0.31.0...macos-v0.2.0

Netra 0.31.0

Choose a tag to compare

@zyrona-labs zyrona-labs released this 17 Oct 04:14
  • CI and deps match the GA chart defaults. Helm CI now expects DNS/scan detect and bounded auto-capture on by default; golang.org/x/net bumps to v0.60.0 for the HTTP/2 Trailer advisories; toolchain Go 1.27.2 + golangci-lint v2.15.0; govulncheck ignore drops the stale Cilium catch-all and documents GO-2026-6665 (Snowflake logger, no fixed release yet). Agent-image and release publish jobs run on hosted runners while the org zyvor-build pool sticks busy with no assigned job.
  • Diagnose surfaces for APIs that already existed. New console pages: Deny Preview (live + flow-history blast radius), Netlink timeline, BPF Attachments / hook drift, and Detect (DNS + scan findings). Overview Detect links to Detect; Needs action ranks detect findings there. MCP adds netra_netlink, netra_netlink_findings, netra_ebpf_attachments, netra_listen_queues.
  • Auto-mitigate shadow preview. GET /api/v1/ebpf/auto-mitigate/preview (MCP netra_ebpf_auto_mitigate_preview) lists candidates from scan findings and UDP deltas without mutating store or datapath. Metric anomalies never feed it; live actions still need an enforce lease.
  • Detector HA warm-start. DNS/scan finding rings persist beside NETRA_STATE_FILE (.dnsdetect / .scandetect) and reload on leader promote so observe continuity survives failover. Never persists auto-mitigate actions.
  • Capture session summaries for agents. GET /api/v1/capture/summaries (MCP netra_capture_summaries) returns frame/protocol/duration metadata for active and recent sessions — no PCAP bytes.
  • Flowlog DNS/SNI for historical deny preview. Flow deltas retain best-effort dnsName / tlsSni joins from the same agent report; counterfactual history preview can match name-based denies when those fields were observed.
  • Exe-hash leased deny. BlockedExeHashes + exehash_pids (capgate-shaped, procmeta-sourced) with POST /api/v1/ebpf/exehash-deny requiring X-Netra-Confirm-Risk: high. Enforce only while leased; fails open.
  • Stack pressure histograms. GET /api/v1/ebpf/stack-histograms (MCP netra_ebpf_stack_histograms) buckets softirq/softnet and listen-queue depth from agent reports (not entry→exit softirq latency). Overview adds a notify-only Metrics chapter (anomaly rate + raised alerts).
  • Helm agent.server. Optional NodePort/host override for NETRA_SERVER when hostNetwork agents cannot reliably reach the in-cluster Service.
  • Helm Envoy Gateway front door and agent scheduling. Optional Gateway API route with backend TLS policy (tested against Envoy Gateway); agent.nodeSelector and agent.affinity for DaemonSet placement.
  • K3s/Cilium bootstrap survives host reuse. ensure-cilium-k3s.sh starts a stopped k3s unit when the binary is already present, and points Cilium at the host apiserver so a LAN route for 10.43.0.0/16 cannot break the install chicken-and-egg with an x509 unknown-authority error.
  • GA maturity defaults and historical deny preview. README Maturity labels shipped surfaces as GA (default / optional attach) vs privacy/safety opt-in. Chart defaults turn on observe-only DNS and scan detect, lease-gated auto-mitigate, and bounded auto-capture (dnsdetect.enabled, scandetect.enabled, automitigate.enabled, alerting.autoCapture.enabled). Sampled L7, TLS plaintext uprobes, Cilium/Hubble and MCP mutations stay opt-in. Deny preview gains a flow-history path (POST /api/v1/ebpf/deny/preview-history, netractl ebpf deny-preview --since, MCP netra_ebpf_deny_preview_history) wired through internal/counterfactual over the existing 7-day flowlog. Overview shows compact DNS/scan finding counts and a TLSFP link.
  • Image signature check names the renamed repository. Release images are signed by zyvorai/zyvor-netra's workflow since the repository rename, so the cosign verify command in deploy/README.md (which named zyvorai/netra) failed; it now matches the signer. Clone commands, Helm chart home/sources, docs-site and README links point at zyvorai/zyvor-netra too (the Go module path is unchanged).
  • README maturity table covers 0.30.0. L7 names and query types, per-second metrics, node isolation (loaded but inert until a policy is set) and security review now say what runs by default.
  • security CI job tolerates one misfiled advisory, explicitly. GO-2026-6596 (Cilium Gateway API HTTPRoutes, CVE-2026-56742) affects Cilium v1.17–v1.19, but its OSV record also carries a catch-all range that flags every version of github.com/cilium/cilium, so govulncheck reported Netra's use of the flow protobuf types and no upgrade could clear it. scripts/ci-govulncheck.sh now fails on any reachable advisory except those listed with a reason in scripts/govulncheck-ignore.txt, and reports stale entries.
  • web-e2e checks every shipped page again. Its page list lacked metrics, metric-anomalies, metric-alerts and security-review, so the job failed on its own consistency check since the metrics platform landed.

Images

  • ghcr.io/zyvorai/netra:0.31.0
  • ghcr.io/zyvorai/netra-agent:0.31.0
  • ghcr.io/zyvorai/netra-mcp:0.31.0

Release workflow: https://github.com/zyvorai/zyvor-netra/actions/runs/39000613329

Netra 0.30.0

Choose a tag to compare

@zyrona-labs zyrona-labs released this 07 Oct 06:49
  • Security intelligence and review. Matched DNS response events carry the query type (dnsQType, two bytes of existing event padding, so the 196-byte event ABI and every earlier offset are unchanged), which turns on the DNS detector's txt-heavy signal. The threat feed gains canonical indicators, an optional ?ttl=, X-Netra-Intel-Revision compare-and-set, the last 16 revisions with rollback (GET /api/v1/intel/history, POST /api/v1/intel/rollback/{revision}, netractl intel history|rollback), an optional persistent journal (NETRA_INTEL_STATE_PATH) and a leader-only HTTPS refresh (NETRA_INTEL_SOURCE_URL) that keeps the last good revision on any bad download. GET /api/v1/security/optimizer reports equivalent, covered and overlapping deny predicates, and GET /api/v1/security/incidents correlates DNS findings, scan findings and feed hits on the same exact workload within ten minutes (netractl security optimizer|incidents, Security → Security Review, read-only MCP tools netra_security_optimizer, netra_security_incidents, netra_intel_history). None of it applies a deny, deletes a rule or changes mode; applying a feed still needs a lease and X-Netra-Confirm-Risk: high. Docs

  • MCP tool counts corrected. netra-mcp registers 189 tools (129 read, 60 mutating); README, capabilities, MCP integration, brochure and website copy said 180 or 183, and one place said 52 mutating.

  • L7/DNS programs load on Linux 6.8+ again. netra_l7_cgroup_egress was rejected by the verifier on the lab host (Linux 7.0) with "the sequence of 8193 jumps is too complex", in the image built before this change as well, so NETRA_L7=auto had been running those hosts without TLS SNI, HTTP Host, DNS query names or DNS QTYPE. The SNI and Host searches indexed packet memory with their loop counters, so the verifier tracked one state per iteration until its branch queue passed the fixed 8192 limit; with that lifted, the unrolled DNS QNAME decoder alone exceeded the 1,000,000-instruction budget. The parsers in bpf/netra_l7.h now copy up to 640 payload bytes with bpf_skb_load_bytes into a work area in the per-CPU scratch map and walk it with bpf_loop callbacks (nested for name copies), keeping parser state in the map so the verifier treats it as unknown. netra_l7_cgroup_egress now verifies in about 95,000 instructions and netra_l7_cgroup_ingress in about 37,000 (Linux 7.0, clang 18 as in Dockerfile.agent; clang 21 also loads). Behavior is unchanged: positions searched, name rules and outputs match, the existing parser tests pass on the new API, and new ones cover an invalid SNI candidate before the real one, Host after other headers with tabs, a Host value ending the payload, and a QNAME cut by a compression pointer. The parsers now also see bytes outside the skb's linear area, and the HTTP method is read from the same copy: egress request bytes usually sit outside it, so reading the method from packet memory had missed most requests. Two fixes found while testing live: a DNS response is now matched to its query by the receiving socket's cgroup (bpf_skb_cgroup_id) rather than bpf_get_current_cgroup_id(), which on ingress is whatever task the softirq interrupted, so no response had ever matched (node-wide dnsHealth showed 320 queries and 0 responses); responses, latency, RCODE and QTYPE now arrive. Live on the lab host after deploy: www.wikipedia.org SNI and neverssl.com GET Host recorded, DNS responses matched (284 on the node within a minute), and TXT responses carrying QTYPE 16 with RCODE 3 for a nonexistent name. bpf_loop needs Linux 5.17; older kernels drop the L7 programs through NETRA_L7=auto as before. Docs: docs/l7-metadata.md.

  • Per-second metrics platform. Every agent now collects host (CPU, memory, pressure, disks, filesystems), network stack (interfaces, SNMP/netstat, sockstat, softnet, conntrack), cgroup v2 (one chart per pod; per container with NETRA_METRICS_CGROUP_CONTAINERS=true), comm-only process groups, eBPF datapath and per-workload RED series once a second into a Gorilla-compressed store (internal/tsdb), and streams them to netrad over a replay buffer so a restart or network blip leaves no gap. netrad keeps 1 s for an hour, 1 min for two weeks and 1 h for a year per node. Every dimension gets an unsupervised k-means anomaly model (internal/anomaly, stdlib only), with anomaly rates on every query and a Kolmogorov–Smirnov "what changed here" ranking for a highlighted range. internal/metricalert evaluates Netdata-style rules (lookup, calc/warn/crit expressions, hysteresis, delays, silences, ack) with 46 built in, notifying through the existing channels and never touching enforcement. App collectors cover nginx, Apache, HAProxy, Redis, memcached, Envoy, CoreDNS, etcd and any Prometheus endpoint, with credentials from environment variables only and optional discovery by comm and socket inode (never cmdline). Exporters: Prometheus remote write, OTLP JSON, Graphite. Netra-only: GET /api/v1/metrics/evidence joins a chart window to flows, drop reasons, TCP/DNS/HTTP boards and captures; AI briefs cite metric alerts and anomalies; GET /api/v1/metrics/fleet rolls up peer clusters. Surfaces: /api/v1/metrics/*, netractl metrics, MCP netra_metrics_*, console Metrics/Anomalies/Alerts pages. Tests: scripts/ci-metrics-unit.sh (job go) and scripts/ci-metrics-veth.sh (job metrics-veth-smoke: real collectors and netrad, iperf3 on a veth, anomaly flagged, alert raised, evidence answered), both passing on a live lab host. Docs: docs/metrics.md, docs/metric-alerts.md, docs/anomaly-detection.md, docs/app-collectors.md.

  • Kubernetes list calls page, and pod lists skip terminated pods. On a lab cluster with 12,629 pods (over 11,000 Evicted) the pod list was 72 MB and the client cut every response at 8 MiB, so the insights boards, ebpf workloads and policy simulate failed with "unexpected end of JSON input". Pods, services and events are now listed with limit/continue. ListPods and ListWorkloads also ask the API server for status.phase!=Failed,status.phase!=Succeeded: terminated pods cannot own traffic and their stale IPs may belong to a new pod, and on that cluster the list went from 10.7 s per page to 129 pods in under a second. GET /api/v1/pods still lists every pod.

  • Node isolation: a per-node allow-only egress filter, in shadow or enforce. Until now Netra could not say "this node may only talk to these destinations": allowed_* maps are exceptions to deny rules, default-deny exists only per workload, and observe mode does not count what enforce would drop. bpf/netra_nodeiso.c is a standalone TCX program at the head of each agent interface's egress chain that judges new outbound TCP connections and all UDP against up to 64 CIDR + protocol + port-range rules; shadow counts would-block packets and bytes and the destinations behind them, enforce drops them. It is independent of the cluster mode and of config_map. Replies to inbound connections, flows established before the policy, ICMP/ICMPv6, DHCP and non-first fragments always pass, local UDP services can be exempted by source port (SSH's 22 by default), and the agent always allows its controller. Enforce carries a lease (15 m default, at most 1 h) and falls back to shadow when it lapses, when the controller goes stale, when an apply fails, and on a controller restart (shadow policies persist). Policies are replaced atomically by generation. GET/PUT/DELETE /api/v1/ebpf/node-isolation[/{node}] (PUT admin-only), agent NETRA_NODE_ISOLATION=auto|off|required (Helm agent.nodeIsolation). Ported from FluxVM's pod-policy engine and XDP shield, including its global per-rule match function: the inlined rule scan was rejected by the Linux 7.0 verifier at 1,000,000 instructions, and the ported version verifies in 5,820. Tests: BPF_PROG_TEST_RUN verdicts with FluxVM's prefix cases plus shadow/always-pass/generation-swap cases, and a scratch-veth attach with real UDP, both passing on Linux 7.0 and wired into scripts/ci-ebpf-tests.sh; unit tests for the ABI, store (lease expiry, restart fail-open) and API. Docs: docs/node-isolation.md. Duvora uses this for its shadow/enforce isolation stages.

  • Node isolation attaches where the agent has no interfaces, and coverage reports it. The first live deploy (Linux 7.0, k3s with Cilium) loaded netra_nodeiso but attached it nowhere: in cgroup mode beside Cilium the agent has no TC interfaces, so the list was empty. It now attaches on NETRA_NODE_ISOLATION_INTERFACES (Helm agent.nodeIsolationInterfaces) when set, else on the agent's interfaces, else on the interfaces of the IPv4 and IPv6 default routes (read from /proc/net/route and /proc/net/ipv6_route); on that host that is eno8303. netra_nodeiso_egress also now appears in program health and /api/v1/ebpf/coverage, which previously listed only the main datapath collection. Live test on that host, driven from Duvora: shadow counted SYNs to 1.1.1.1:443 and NTP while traffic flowed; enforce dropped them (and upstream DNS) while SSH, the controller and Duvora stayed reachable; the kill switch and release restored egress.

  • Stable controller certificate. The chart minted a new self-signed certificate on every controller pod start, so no client could pin it. tls.existingSecret serves a kubernetes.io/tls Secret instead, and deploy-remote.sh creates netra-system/netra-tls once (SANs as before plus the host IP), reuses it on later deploys, and saves its certificate to ~/.netra/tls.crt for clients such as Duvora (NETRA_TLS_PERSIST=0 keeps the per-pod certificate).

Images: ghcr.io/zyvorai/netra:0.30.0, ghcr.io/zyvorai/netra-agent:0.30.0 (multi-arch, keyless cosign signed, SBOM + provenance). Install and verification: deploy/README.md. Verify with ...

Read more