Use cases
Practical ways teams use Kavach. Every scenario stays inside the observation-only contract.
1. SOC triage desk
Goal: Prioritize what’s noisy vs urgent without touching hosts.
- Open Overview — metric band shows findings, fleet online, high severity, OverWatch, CVEs.
- Detect / Detections — filter by severity; open a finding drawer.
kavachctl ai briefingor console AI Hub → Daily briefing.- Transition incident state in Incidents (workflow ledger).
- Export for the SIEM:
kavachctl siem exportor Integrations download.
APIs: /v1/findings, /v1/detections, /v1/incidents, /v1/ai/briefing, /v1/siem/export
2. Threat hunting
Goal: Answer “who ran what, where, with which network friends?”
kavachctl hunt query 'severity:high host:web'
kavachctl hunt kql 'DeviceProcessEvents | where ...' # if KQL path enabled
kavachctl ai nl-hunt 'processes that look like living-off-the-land on prod'
kavachctl storyline --host web-01
kavachctl threat-graph
kavachctl timeline
Console: Hunt, Timeline, World → storyline.
3. Fleet & sensor hygiene
Goal: Know which nodes are reporting and how.
kavachctl fleet
kavachctl agents
kavachctl sensor
kavachctl sensor-health
kavachctl ebpf coverage
kavachctl ebpf health
Enroll from Fleet (console) or agent with bearer token. Revoke when decommissioning.
4. Vulnerability & asset posture
Goal: Spotlight-style CVE and Discover-style inventory views.
kavachctl discover assets
kavachctl discover apps
kavachctl spotlight --severity critical
kavachctl exposure
kavachctl compliance
kavachctl zero-trust
Agent collectors refresh FIM / SBOM / persistence / firewall / browser inventories.
5. Identity & UEBA
Goal: Surface spray / anomalous identity without AD write access.
kavachctl identity events
kavachctl identity entities
kavachctl ueba
kavachctl itdr
Console: Identity.
6. XDR with Netra
Goal: Join host process findings with network drops/flows.
- Enable poller:
KAVACH_NETRA_POLLER_ENABLED=true,KAVACH_NETRA_URL=…, API key. - Or pipe events:
netra-bridge→ Kavach. - Inspect:
kavachctl ebpf netra status
kavachctl ebpf netra drops
kavachctl get /v1/recent-events
Kavach never writes Netra BPF maps or flips Netra to enforce.
7. eBPF host telemetry
Goal: Falco/Tracee-class signals on Linux nodes.
./scripts/build-bpf.sh
# pin programs (see ebpf.md)
kavachctl ebpf events --type exec
kavachctl ebpf events --type memfd
kavachctl ebpf events --type priv
Agents can POST /v1/ebpf/events with decoded ringbuf batches + lost counts.
8. Bank / FI / stock-market observe
Goal: Surface market-desk, UPI, fraud, and regulatory posture without touching money rails.
kavachctl finance summary
kavachctl finance exchanges
kavachctl finance trading-desks
kavachctl finance upi
kavachctl finance cards
kavachctl finance fraud
kavachctl finance insider
kavachctl finance sebi
kavachctl finance rbi
kavachctl finance insurance
kavachctl finance irdai
kavachctl finance motor-insurance
kavachctl finance events --type claims_burst
Hard rule: never freeze accounts, block orders, pause algos, cancel policies, or rewrite SWIFT/UPI. See finance.md.
9. Railways / government / critical infra observe
Goal: Cover public-sector and critical infrastructure IT without touching OT control or citizen service availability.
kavachctl sectors summary
kavachctl sectors railways
kavachctl sectors stations
kavachctl sectors gov-portals
kavachctl sectors tax
kavachctl sectors power
kavachctl sectors scada
kavachctl sectors airports
kavachctl sectors flights
kavachctl sectors airlines
kavachctl sectors defence
kavachctl sectors border
kavachctl sectors gov-vehicles
kavachctl sectors public-vehicles
kavachctl sectors city-buses
kavachctl sectors taxis-cabs
kavachctl sectors school-buses
kavachctl sectors municipal-fleet
kavachctl sectors ferries
kavachctl sectors automotive
kavachctl sectors manufacturing
kavachctl sectors isro-centers
kavachctl sectors space
kavachctl sectors critical-sites
kavachctl sectors events --sector city-buses
Hard rule: never stop trains, cancel flights, control ATC, immobilize vehicles, command spacecraft, write plant OT, trip breakers, take portals offline, touch EVMs, or weapons/C2. See sectors.md.
10. AI-assisted IR
Goal: Speed up narrative and next steps without autonomous response.
kavachctl ai narrative --id <finding-id>
kavachctl ai attack-path --id <finding-id>
kavachctl ai remediation --id <finding-id>
kavachctl ai report
kavachctl ai agents
kavachctl air
Optional: point KAVACH_LLM_URL at your gateway. Guardians and what-if stay advisory.
11. Compliance evidence pack
Goal: Snapshot posture for auditors (read-only).
kavachctl report
kavachctl audit
kavachctl compliance
kavachctl zero-trust
kavachctl rbac
kavachctl retention
Combine with SIEM NDJSON export for long-term retention outside Kavach.
12. Developer / platform lab
Goal: Validate chart + Gateway + console before production eval.
./scripts/deploy-remote.sh user@lab --k8s --envoy-gateway
./scripts/demo-lab.sh
go test ./...
Follow tutorial.md and testing.md.
Anti-use-cases (out of scope)
| Request | Kavach answer |
|---|---|
| Freeze a bank account / block a trade / cancel a policy | No — finance observe only |
| Stop a train / cancel a flight / immobilize a vehicle / trip a breaker | No — sectors observe only |
| Command spacecraft / write plant OT / weapons / C2 / EVMs | No — sectors observe only |
| Auto-isolate a host | No — ledger only |
| Kill a PID from console | No |
| Quarantine a binary | No |
| Drop a 5-tuple in-kernel | Use Netra (leased) — not Kavach |
| Silent prevention | Detect-only policies |
If you need enforcement, use Netra’s leased datapath controls or an external SOAR that reads Kavach exports — never claim Kavach did the enforce.