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
| Path | Role |
|---|---|
cmd/kavach | Controller (-mode server) or agent (-mode agent) |
cmd/kavachctl | Operator CLI (sister to netractl) |
cmd/kavach-mcp | MCP stdio server for AI agents |
cmd/netra-bridge | Stdin JSONL → POST /v1/network-events |
Packages
| Package | Responsibility |
|---|---|
internal/edr | Store, Detect(), APIs, console, world/AI/eBPF/finance platforms |
internal/mcpserver | Minimal MCP framing for kavach-mcp |
bpf/ | CO-RE observation objects (exec, process, file, priv, net) |
helm/kavach | Deployment, agent DaemonSet, Envoy Gateway opts |
Data path
- Discover — agent uses eBPF pin (if present) → proc connector →
/procpoll. - Detect — process/file/network signals evaluated by rules, IOC/IOA, custom STAR-style rules.
- Persist — findings and recent events in bounded JSONL; inventory domains in
*.inventory.json. - Correlate — Netra-shaped network events join by host + PID; threat graph / storyline APIs.
- Present — console,
kavachctl, MCP tools, SIEM webhook/syslog/NDJSON. - 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
| Surface | Default |
|---|---|
| Local listen | Loopback HTTP :8099 |
| Helm chart | In-pod HTTPS, NodePort 30899 |
| Envoy Gateway | Optional HTTPS NodePort 30943 (kavach.<ip>.sslip.io) |
| Auth | KAVACH_TOKEN bearer; console session cookie via POST /v1/session |
| Agent auth | Same bearer; optional mTLS (docs/agent-mtls.md) |
| TLS verify | Lab 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)
| Prefix | Purpose |
|---|---|
/healthz | Liveness |
/v1/summary, /v1/findings, /v1/detections | Core EDR |
/v1/fleet, /v1/hosts, /v1/agents | Fleet |
/v1/hunt/*, /v1/timeline, /v1/threat-graph | Hunt |
/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 domains | Global catalog |
/v1/siem/* | Export |
/v1/session | Console 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.