The builder
A policy has four parts:| Field | What it does |
|---|---|
| Name / description | Identify the policy. |
| Hook | The kernel behavior to watch — see Hooks. |
| Action | Monitor records the event (audit); Block stops the operation inline (enforce). Block is only available on blockable hooks and needs kernel 5.4+. |
| Match (optional) | Narrow to specific paths / binaries / values — see Match conditions. Omit to match every event on the hook. |
| Namespace (optional) | Limit the policy to one Kubernetes namespace. |
Hooks
The hook is what the sensor watches. Pick one per policy.| Category | Watches | Can block? |
|---|---|---|
| File | A file is opened / read — sensitive paths (/etc/shadow, SSH keys), file-integrity monitoring | Yes |
| Process | A binary is executed — e.g. nsenter, nc, sudo | Yes |
| Privilege | A Linux capability is requested — privilege use / escalation | Yes |
| Privilege | setuid — a process changes its user id | No |
| Network | Outbound connection (egress), inbound connection (ingress), or connection teardown | No |
| Syscall | ptrace — debugging or process injection | No |
Match conditions
A match narrows the policy to the events you care about — a file path, a binary name, a value. Choose an operator and one or more values:| Operator | Matches |
|---|---|
Prefix | value starts with … (e.g. path Prefix /etc/) |
Postfix | value ends with … (e.g. Postfix .pem) |
Equal / NotEqual | exact match / everything except |
In / NotIn | any of a list / none of a list (e.g. binary In [nsenter, nc]) |
Monitor vs. block
- Monitor (audit) — the event is recorded and appears in Runtime → Events. Nothing is blocked. Start here.
- Block (enforce) — the operation is stopped inline (kernel 5.4+, blockable hooks only). Blocked events appear in Runtime → Enforcement, marked
enforced.
AI assistant
Rather not hand-build it? Describe the policy in plain English and TigerGate AI drafts it — choosing the hook, action, and match for you:“Alert whenever anything reads /etc/shadow”
“Block nsenter and nc from executing in the payments namespace”Review the generated policy (hook / action / match) and save. The assistant only ever produces a single policy and only uses supported hooks.
Examples
| Goal | Hook | Match | Action |
|---|---|---|---|
Alert on reads of /etc/shadow | File open | path Prefix /etc/shadow | Monitor |
| Block breakout tools in payments | Process execution | binary In [nsenter, nc, socat] | Block · namespace payments |
| Flag SSH-key access | File open | path Postfix /.ssh/id_rsa | Monitor |
Watch egress from the db workload | Outbound connection | — | Monitor · namespace db |
denied when blocked, audit when observed). See Runtime Agent for the sensor itself.