Page 7 of 8~112 min topic

Secrets rotation lab

Constrain access and rehearse rollback

Least privilege, negative probes, and a timed rollback beat a security essay about answer API + indexer sharing provider key via versioned secrets manager.

~14 min this pageSecurity and rollback

1Try it yourself

Decision drill

Secrets rotation lab

Revoke leaked keys, rotate on schedule, audit access.

Secret safety68%

1/3API key found in a public gist.

2Learn the idea

Read

Least privilege for this lab

Separate runtime and operator roles for answer API + indexer sharing provider key via versioned secrets manager. Runtime may only perform the narrow actions that security engineer rotating openai/prod after contractor offboarding needs; operators get audited break-glass with TTL. Encode a negative probe that denies the privilege trick related to revoke v1 while indexer still cached v1 → 401 storm.

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 SEC-REVOKE-EARLY-21 should be impossible if these controls hold. Output allowlists and schema checks stay in force on error paths.

Read

Implementation artifact

Read

Never log key material; audit ROT-2026-07-30 records actor, reason, versions only.

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: dual-key window: readers accept v1+v2; revoke v1 only after emit proves zero v1 use for 30m.

Read

Stage depth

Abuse cases unique to this lab include the privilege path implied by revoke v1 while indexer still cached v1 → 401 storm. 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 answer API + indexer sharing provider key via versioned secrets manager 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 `secrets-rotation-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 answer API + indexer sharing provider key via versioned secrets manager, the human stakeholder is security engineer rotating openai/prod after contractor offboarding, and the incident id you design against is SEC-REVOKE-EARLY-21. Re-state the oracle in your notes — rotate to v2 → deploy → traffic on v2 → revoke v1 with audit event ROT-2026-07-30 — and keep the invariant visible: dual-key window: readers accept v1+v2; revoke v1 only after emit proves zero v1 use for 30m. Track secret_version_share and auth_fail_rate as the scoreboard. Surface under change control: secrets manager path openai/prod. If you only have forty minutes, finish the fixture for revoke v1 while indexer still cached v1 → 401 storm 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 answer API + indexer sharing provider key via versioned secrets manager 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 SEC-REVOKE-EARLY-21 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.