miroir/docs/runbooks
jedarden e7721f962f test(search-ui): add HTTP endpoint tests and scoped key rotation documentation
Added comprehensive tests for the POST /_miroir/ui/search/{index}/rotate-scoped-key
endpoint and verified old key rejection after rotation. Also added documentation
for the scoped key rotation procedure.

New tests:
- test_http_endpoint_rotate_scoped_key_with_admin_auth: Verifies HTTP endpoint
  triggers rotation with admin authentication
- test_http_endpoint_force_rotation_bypasses_timing: Verifies force=true
  bypasses the timing gate
- test_old_scoped_key_rejected_after_rotation: Verifies old scoped keys are
  cleared from Redis after rotation completes

Documentation:
- docs/runbooks/scoped-key-rotation.md: Complete runbook for scoped key rotation
  covering automatic rotation flow, manual rotation via API/UI, timing and cadence,
  monitoring, troubleshooting, and verification steps.

All acceptance criteria for bead bf-5dy9k are now satisfied:
1.  Comprehensive tests for rotate-scoped-key endpoint
2.  Leader-coordinated rotation before expiry (timing gate) - existing tests
3.  Force=true bypasses timing gate - existing tests
4.  Revocation safety gate confirmed - existing tests
5.  Old scoped keys rejected after rotation - new test
6.  Rotation procedure and timing documented
7.  Integration tests for full rotation lifecycle - existing tests

Closes: bf-5dy9k
2026-05-26 18:29:11 -04:00
..
node-master-key-rotation.md P10.2: nodeMasterKey zero-downtime rotation flow 2026-04-19 15:49:40 -04:00
scoped-key-rotation.md test(search-ui): add HTTP endpoint tests and scoped key rotation documentation 2026-05-26 18:29:11 -04:00
startup-master-key-rotation.md P10.2: nodeMasterKey zero-downtime rotation flow 2026-04-19 15:49:40 -04:00