Page 7 of 8~112 min topic

Webhook lab

Constrain access and rehearse rollback

Least privilege, negative probes, and a timed rollback beat a security essay about FastAPI receiver for batch-index completion events → durable queue.

~14 min this pageSecurity and rollback

1Try it yourself

Decision drill

Webhook lab

Webhooks push events — polling pulls. Verify signatures before acting.

Integration safety70%

1/3Nightly index job finished.

2Learn the idea

Read

Least privilege for this lab

Separate runtime and operator roles for FastAPI receiver for batch-index completion events → durable queue. Runtime may only perform the narrow actions that indexer worker waiting on provider batch.completed callbacks needs; operators get audited break-glass with TTL. Encode a negative probe that denies the privilege trick related to signature optional in staging config accidentally shipped to prod.

Read

Data and secret hygiene

Redact prompts/PII at collection. Secrets enter via a manager or workload identity — never source, fixtures, or exception strings. Incident HOOK-SIG-OFF-16 should be impossible if these controls hold. Output allowlists and schema checks stay in force on error paths.

Read

Implementation artifact

assert os.environ["WEBHOOK_SECRET"]  # required in all envs including staging twins of prod

Read

Rollback drill

Rehearse the rollback or kill switch timed against a clock. Record actor, reason, prior revision/secret/flag, and verification query. Invariant reminder: verify HMAC signature + timestamp skew ≤ 5m; enqueue idempotent by event_id.

Read

Stage depth

Abuse cases unique to this lab include the privilege path implied by signature optional in staging config accidentally shipped to prod. Prove a read-only role cannot mutate. Break-glass tokens expire; leftover tokens fail the drill. Dependency pin/digest story matters when images or models move under you. Document how to rotate the credential that FastAPI receiver for batch-index completion events → durable queue uses without a full outage window longer than your dual-run plan. Security evidence is part of ship, not an appendix nobody reads.

Read

Field notes for `webhook-lab` / `security-ops`

List network egress destinations and justify each. Ensure debug endpoints are off by default in the shipping config. Verify that error responses do not echo secrets or raw stack frames to clients. For multi-tenant paths, add a cross-tenant probe fixture. Time the rollback drill twice — once with the author, once with a peer. Store the drill transcript beside the threat notes for the incident id. In this chapter the product is FastAPI receiver for batch-index completion events → durable queue, the human stakeholder is indexer worker waiting on provider batch.completed callbacks, and the incident id you design against is HOOK-SIG-OFF-16. Re-state the oracle in your notes — valid event → 202 + one queue message; replay same event_id → 202 no duplicate work — and keep the invariant visible: verify HMAC signature + timestamp skew ≤ 5m; enqueue idempotent by event_id. Track webhook_accept_total and duplicate_suppressed_total as the scoreboard. Surface under change control: POST /webhooks/batch-index. If you only have forty minutes, finish the fixture for signature optional in staging config accidentally shipped to prod before polishing UI. Promotion language stays ternary: promote, hold, or roll back based on evidence, not hope.

Go deeper

Before you start

Why this matters

Threat-model FastAPI receiver for batch-index completion events → durable queue in five minutes: who can change config, who can read secrets, what a malicious payload tries to do. Write one negative probe that must yield deny with zero side effects. Reference HOOK-SIG-OFF-16 as the story you refuse to repeat.

Check your understanding

Page assessment

Answer from memory. Completion is saved from this evidence, not from opening the next page.

1. Does deny imply zero side effects?
2. Are secrets absent from logs?
3. Is rollback evidenced with timestamps?

All responses are required.