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.
1Try it yourself
Decision drill
Webhook lab
Webhooks push events — polling pulls. Verify signatures before acting.
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.
Related lessons
Check your understanding
Page assessment
Answer from memory. Completion is saved from this evidence, not from opening the next page.
All responses are required.