Write a certificate-expiry incident handoff
On-call staff need a safe response when one peer fails certificate validation.
- Focused work estimate
- 1h + prerequisites
- Priority in the scenario
- Low
- Engineering practice
- Runbooks
Estimated field mix
- Site reliability50%
- Security30%
- Networking20%
Field percentages are editorial estimates of the ticket's engineering focus. They total 100%; they are not measured time, proficiency scores, or ownership evidence.
Review it, then add it to your workspace.
The board opens an editable draft; nothing is saved until you confirm it. Sign-in and workspace permissions apply, and Demo boards remain ephemeral.
Project context
A fictional internal report exporter uses mutual TLS. Certificates are renewed manually, and operators cannot distinguish peer identity failures from network outages.
Setup prerequisites
- Generate disposable test-only certificate authorities and leaf certificates for loopback services; use no production keys.
Preceding work
Complete these dependencies, or supply their agreed outputs before taking this ticket.
- BMTLS-101 · Define expected service names and certificate usage
- BMTLS-102 · Validate certificate chains without disabling hostname checks
- BMTLS-103 · Separate certificate expiry alerts from connection failure rates
- BMTLS-104 · Refresh connection pools after client-certificate rotation
- BMTLS-105 · Keep TLS errors from exposing peer secrets or request payloads
- BMTLS-106 · Rehearse leaf renewal under an unchanged trust anchor
- BMTLS-107 · Rotate trust anchors without accepting unrelated authorities
- BMTLS-108 · Enforce peer revocation on reused connections
- BMTLS-109 · Compare certificate overlap availability against retained trust risk
Acceptance criteria
- Identify failing peer class and certificate generation.
- Show approved renewal and trust-check steps.
- Explain when to stop retries and escalate ownership.
Implementation constraints
- Never recommend disabling certificate verification.
Verification to include
- Resolve a synthetic expired leaf using the guide.
- Keep an unknown-CA failure closed.
Deliverables
- TLS support runbook.
Rollout and recovery
Store with the service identity inventory and rotation schedule.
Value of the work
For the engineer: Practice transport identity, trust-store changes, and certificate failure diagnosis.
For the team: Provide repeatable rotation and recovery behavior for authenticated service communication.
Evidence boundaries
Outcome Evidence: Tests, patches, and runbooks are requested deliverables. They become Outcome Evidence only through a qualified Mission and immutable Evidence IDs.
Ownership Evidence: Independent adaptation must be observed under a declared verification policy and cite immutable Evidence IDs. Completing a planning ticket establishes no Ownership Evidence.