Skip to main content

Architecture

Kavach is Zyvor’s unified endpoint security controller: host process and file observation, optional eBPF telemetry, Netra network-event correlation, AI assist, and an investigation API/console. It is observation-first — no automatic containment.

Sister product: Netra (network XDR / eBPF datapath). Kavach owns host EDR; Netra owns network datapath. Together they form Zyvor XDR.


Hard rule​

DETECT + REPORT ✓
CONTAIN / KILL / ISOLATE / DROP ✗
  • Prevention policies and IOA/IOC drive Detect() only.
  • Containment APIs append a request ledger.
  • eBPF programs never return deny / drop.
  • AI recommends; it does not act.

Component diagram​

Browser / curl / kavachctl / MCP / SIEM
│
▼
┌──────────────────────┐
│ kavach (server) │
│ :8099 / :30899 │
│ │
│ • HTTP /v1 API │
│ • dashboard.html │
│ • findings store │
│ • incident ledger │
│ • AI platform │
│ • eBPF platform API │
│ • world inventory │
│ • SIEM exporter │
└──────────┬───────────┘
│
bearer token / session cookie / optional mTLS
│
┌─────────────┴──────────────┐
▼ ▼
┌─────────────┐ ┌──────────────────┐
│ kavach agent│ │ netra-bridge / │
│ │ │ Netra poller │
│ /proc poll │ │ network events │
│ proc conn. │ │ drops / flows │
│ eBPF pins │ │ (never write │
│ collectors │ │ Netra BPF maps) │
└─────────────┘ └──────────────────┘

Binaries​

PathRole
cmd/kavachController (-mode server) or agent (-mode agent)
cmd/kavachctlOperator CLI (sister to netractl)
cmd/kavach-mcpMCP stdio server for AI agents
cmd/netra-bridgeStdin JSONL → POST /v1/network-events

Packages​

PackageResponsibility
internal/edrStore, Detect(), APIs, console, world/AI/eBPF/finance platforms
internal/mcpserverMinimal MCP framing for kavach-mcp
bpf/CO-RE observation objects (exec, process, file, priv, net)
helm/kavachDeployment, agent DaemonSet, Envoy Gateway opts

Data path​

  1. Discover — agent uses eBPF pin (if present) → proc connector → /proc poll.
  2. Detect — process/file/network signals evaluated by rules, IOC/IOA, custom STAR-style rules.
  3. Persist — findings and recent events in bounded JSONL; inventory domains in *.inventory.json.
  4. Correlate — Netra-shaped network events join by host + PID; threat graph / storyline APIs.
  5. Present — console, kavachctl, MCP tools, SIEM webhook/syslog/NDJSON.
  6. Assist — AI Hub scores, briefs, NL hunt (optional external LLM).

Bootstrap on empty stores seeds live inventory so demos are never blank (BootstrapLivePlatform).


Trust & network boundaries​

SurfaceDefault
Local listenLoopback HTTP :8099
Helm chartIn-pod HTTPS, NodePort 30899
Envoy GatewayOptional HTTPS NodePort 30943 (kavach.<ip>.sslip.io)
AuthKAVACH_TOKEN bearer; console session cookie via POST /v1/session
Agent authSame bearer; optional mTLS (docs/agent-mtls.md)
TLS verifyLab often uses self-signed → KAVACH_TLS_INSECURE=true

eBPF placement​

Host kernel Userspace
─────────── ─────────
kavach_*.o ──ringbuf──► pin ──► WatchEBPF / ingest
│
▼
/v1/ebpf/events
Detect() / console

Netra’s TCX/XDP/cgroup programs are out of process. Kavach polls Netra observe APIs and exposes /v1/ebpf/netra/* mirrors. See ebpf.md.


API map (high level)​

PrefixPurpose
/healthzLiveness
/v1/summary, /v1/findings, /v1/detectionsCore EDR
/v1/fleet, /v1/hosts, /v1/agentsFleet
/v1/hunt/*, /v1/timeline, /v1/threat-graphHunt
/v1/ai/*AI Hub
/v1/ebpf/*eBPF observe platform
/v1/finance/*Banks / markets / payments (observe — never freezes money)
/v1/sectors/*Railways / govt / energy / aviation / … (observe — never stops services)
/v1/world/* + inventory domainsGlobal catalog
/v1/siem/*Export
/v1/sessionConsole login

Contract: openapi.yaml.


Kubernetes layout​

kavach-system
├─ Deployment/kavach controller
├─ DaemonSet/kavach-agent optional node agents
├─ Service NodePort 30899
└─ (optional) Envoy Gateway + HTTPRoute :30943

Chart: helm/kavach. Deploy script: scripts/deploy-remote.sh.