Break Glass — Emergency Override Procedures
reference
Break Glass
In rare cases, the chain-of-custody invariants may need to be overridden. This article documents the emergency procedures.
When to use break-glass
- All authenticators for a tenant are lost
- The audit chain is corrupted and cannot be repaired
- A tenant is halted due to a false-positive divergence detection
Clearing a custody halt
POST /api/v1/admin/tenants/:id/clear-haltRequires a fresh WebAuthn assertion from a root authenticator.
Key recovery
If the Fly secret containing the audit signing key is deleted, contact the loopctl maintainer. Recovery requires:
- Proof of tenant ownership (WebAuthn assertion)
- A new keypair generation
- A key-rotation audit entry signed by the new key
- Manual update of the Fly secret
This is intentionally difficult — it represents a total compromise of the trust anchor.
See Tenant Signup for normal key management.