Overview
Every other protocol in this series maintains a single invariant: the key never materializes. Keys are born fragmented (Protocol: Account Creation / KeyGen), maintained fragmented (Protocol: Key Healing, Protocol: PRISM Password Change, Protocol: Decentralized Account Recovery), and exercised fragmented (Protocol: CMK Authentication).
Ragnarök is the deliberate, sole deviation to the 'never assemble' invariant, but not as an exception, as it operates outside the Tide paradigm.
An exit protocol is essential to the trust model. A system that can never release keys creates vendor lock-in - a different form of centralized authority over the organization's data. Ragnarök ensures the organization retains ultimate sovereignty: it can depart the Tide network and operate independently, under governance-controlled conditions with verifiable completion. This deviation strengthens the architecture. Tide's value proposition must be sustained by operational merit, not by captive custody.
Ragnarök operates on the organization's VVK (Vendor Verifiable Key) - not on individual users' CMKs. The VVK governs JWT signing, authorization, and E2EE. It is reconstructed and exported as a standard EdDSA key; Tide-based authentication is disabled; users must re-establish credentials via mass password reset. The protocol supports two disposal paths: Scenario A (Off-Boarding) releases RGK shards directly to TideCloak, and Scenario B (Backup / "Nuclear Codes") distributes the reconstruction capability across the admin quorum so that no single actor ever holds the complete RGK.
Loading diagram...
Preconditions
| Condition | Detail |
|---|---|
| VVK and RGK generated | Both keys created via Nested Shamir DKG (same construction as Protocol: Account Creation / KeyGen) during vendor onboarding. Each ORK holds and shards. |
| Encrypted VVK shards stored | Each ORK has pre-encrypted its VVK shard under : . These are stored on TideCloak, grouped per VRK cycle. TideCloak cannot decrypt without the RGK. |
| Ragnarök enabled | TideCloak extension active. Email collection mandated, duplicate emails prohibited, user database scanned. |
| Admin quorum configured | Tide-IGA active with a governance quorum (). Multiple administrators required for Ragnarök authorization. |
Protocol Flow
Phase 0: Setup (Ragnarök Enablement)
Loading diagram...
The organization prepares for its own exit at onboarding. Each ORK generates its VVK and RGK shards via the standard Nested Shamir DKG (see Protocol: Account Creation / KeyGen for the construction), encrypts its VVK shard under , and deposits the ciphertext on TideCloak. The RGK is purpose-built and dormant - never used for authentication, signing, or any operational task. It exists solely to enable Ragnarök.
Ragnarök enforces email collection and uniqueness during all subsequent user signups. This forward constraint ensures every user is reachable for the post-Ragnarök mass password reset.
Phase 1: Ragnarök Initiation (Governance Gating)
Loading diagram...
An admin initiates Ragnarök on TideCloak. TideCloak verifies that Tide-IGA is active and that a governance quorum with is configured. It creates a formal Ragnarök Draft requiring sequential approvals from distinct administrators before the initiating admin can execute the Ragnarök Commit. The specific quorum mechanisms are detailed in Article 5: Governance Without God Mode.
After commit, TideCloak submits the fully signed approval to the VVK ORK swarm. Each ORK independently validates the governance signatures. The protocol then branches into one of two disposal scenarios.
Phase 2: VVK Disposal - Two Scenarios
Scenario A: Off-Boarding (Direct)
The simpler path - used when the organization is departing Tide and the RGK can be released directly.
Each ORK unlicenses the VRK (marking it invalid for future operations) and revokes it (destroying the distributed key's operational validity), then encrypts its dormant RGK shard under the vendor's ephemeral public key: . These ciphertexts are returned to TideCloak, which decrypts them using and interpolates the RGK shards to reconstruct the complete RGK. Revocation occurs before release - there is no window of dual validity.
Scenario B: Backup (Admin Share Distribution - "Nuclear Codes")
The more secure path - distributes the reconstruction capability across the admin quorum so that no single actor (including TideCloak) holds the complete RGK until all parties converge.
Loading diagram...
After ORK-swarm approval, TideCloak creates a secondary Ragnarök init draft. Each admin independently requests their "Nuclear Codes" through the Secure Web Enclave (SWE). Each ORK verifies the approval, generates a deterministic admin-specific sub-share of its RGK shard (Algorithm 1), unlicenses and revokes the VVK, and returns the sub-share. The SWE interpolates the 20 sub-shares into a single consolidated - this admin's fragment of the global RGK.
After an off-boarding period, administrators contribute their shares to TideCloak, which interpolates them to reconstruct the complete RGK. The nested threshold ensures that reconstruction requires both an ORK quorum (inner, during share distribution) and an admin quorum (outer, during contribution).
Phase 3: VVK Recovery and System Transition
With the RGK reconstructed (from either scenario), TideCloak decrypts the pre-stored shards and assembles the complete VVK private key. The system then executes a clean transition: the reconstructed VVK is installed as a standard EdDSA signing key in TideCloak, the Tide-IdP is disabled, the VVK license cancellation is verified against the ORK network, authentication flows are replaced with standard (non-Tide) modules, IdP-less IGA is toggled on, and all user accounts are placed on mandatory password reset. TideCloak generates new designating itself as the Home ORK, permanently redirecting client software away from the decentralized network.
TideCloak prompts the admin to authorize a mass email dispatching password-reset links to all users - the operational reason Ragnarök mandated email collection and uniqueness from Phase 0.
Phase 4: Post-Ragnarök Operation
Loading diagram...
The system operates as a standard Keycloak deployment. Users authenticate via email-and-password credentials, receiving Dokens that embed TideCloak's URL as the Home ORK. Heimdall then continues to processes decryption and signing requests from the client using the recovered VVK as a conventional EdDSA key, with no ORK involvement.
Loading diagram...
Algorithms
Algorithm 1:
Notation Reference
| Symbol | Description |
|---|---|
| , | Vendor Verifiable Key / ORK 's shard |
| VVK public key | |
| , | Ragnarök Key (dormant, purpose-built) / ORK 's shard |
| RGK public key | |
| Encrypted VVK shard: - stored on TideCloak | |
| , | Vendor's ephemeral public / private key (Scenario A encryption) |
| Voucher-derived token; input to deterministic coefficient chain | |
| ORK 's long-term key; paired with Doken in HMAC | |
| Deterministic Shamir coefficients: , | |
| Shamir Secret Sharing with deterministic coefficients | |
| Admin 's sub-share from ORK | |
| Admin 's consolidated RGK share (interpolated from 20 sub-shares) | |
| Admin governance quorum threshold | |
| ORKs in VVK swarm (20) | |
| Encryption of under key |
Actors and Trust Assumptions
| Actor | Description | Trust Assumption |
|---|---|---|
| Admin (Quorum) | Authorize Ragnarök via multi-admin draft/approval/commit. In Scenario B, each admin receives and later contributes an RGK share. | Quorum assumption: no single admin can trigger Ragnarök. must act independently. |
| User | Not involved in the Ragnarök decision. Affected post-disposal: must re-establish credentials via email-based password reset. | - |
| SWE | Browser agent. In Scenario B: sends approved Ragnarök to ORKs, collects admin-specific sub-shares, interpolates into consolidated admin share. | Standard SWE trust. Handles one admin's sub-shares, never the complete RGK. |
| TideCloak | Vendor's IAM server with Ragnarök extension. Stores . Orchestrates governance. Scenario A: receives RGK shards. Scenario B: collects admin shares. Post-Ragnarök: holds complete VVK as standard EdDSA key. | Under organization's control. Cannot decrypt without RGK. |
| Ragnarök | TideCloak extension (plugin + DLL). Stores encrypted VVK shards, orchestrates Ragnarök workflows, hosts post-Ragnarök SWE replacement. | Within TideCloak's trust boundary. |
| Heimdall | Post-Ragnarök auth handler. Replaces ORK-based authentication; processes requests using recovered VVK as conventional EdDSA key. | Standard IAM trust. |
| ORK Swarm (VVK) | 20 nodes holding VVK and RGK shards. Validate governance approval. Revoke VVK. Release RGK material (directly or as admin sub-shares). | Standard threshold assumption. Each ORK independently validates governance before releasing material. |
Layer Traversal
| Layer | How Ragnarök Engages It |
|---|---|
| Legitimacy | Multi-admin governance approval and ORK-swarm ratification qualify the Ragnarök request. In Scenario B, the Doken provides entropy for deterministic coefficient generation. |
| Authority | Primary layer. Ragnarök is the terminal Authority Layer operation - the disposal of key shares. Encrypted VVK shards are decrypted, RGK shards are released, the distributed VVK is permanently revoked. The key transitions from "fragmented across the Fabric" to "conventional key held by the organization." |
| Agency | Transitional. The VVK's purpose (JWT signing, authorization, E2EE) transitions from threshold MPC operations to standard single-key operations. Post-Ragnarök, Heimdall exercises the VVK as a conventional EdDSA key. |
| Settlement | The Doken participates in deterministic coefficient generation (Scenario B). Accountability is provided by governance audit trail and ORK dLog entries during revocation. |
Security Properties
| Property | Mechanism | Assumption |
|---|---|---|
| Governance-gated disposal | Multi-admin draft + sequential quorum approvals + commit + ORK-swarm ratification. No single actor can trigger Ragnarök. | Tide-IGA quorum integrity |
| Revocation before release | Each ORK unlicenses and revokes VVK before releasing RGK material. No window of dual validity. | - |
| Pre-encryption independence | shards encrypted and deposited at setup. Ragnarök does not require all ORKs online at disposal time. | Encryption scheme security |
| RGK isolation | The Ragnarök Key is dormant from creation. Never used for authentication, signing, or any operational task. Zero operational attack surface. | - |
| Deterministic admin shares (Scenario B) | HMAC-chain-derived Shamir coefficients from . Consistent polynomials across ORKs without coordination. | SHA-256 collision resistance |
| Nested threshold (Scenario B) | Reconstruction requires admin quorum (outer) contributing shares, each interpolated from ORK sub-shares (inner). No single admin, ORK, or system holds complete RGK. | Shamir reconstruction hardness |
| Complete system transition | Tide-IdP disabled, standard EdDSA replaces threshold, email login enforced, all accounts require password reset. No hybrid state or residual Tide dependencies. | - |
| Email mandate as forward constraint | Ragnarök enforces email collection and uniqueness from signup. Ensures all users reachable for post-Ragnarök password reset. | - |
| Audit trail | Governance approvals, ORK ratification, VVK revocation all produce verifiable records (governance logs, dLog). | - |
| Irreversibility | After Ragnarök, the distributed VVK no longer exists. Returning to Tide requires new VVK generation. | - |
Call Summary
| Phase / Call | Direction | Purpose |
|---|---|---|
| Enable Backup | Admin → TideCloak | Activate Ragnarök. Trigger VVK+RGK generation. |
| Generate VVK + RGK | TideCloak → ORK Swarm | Nested Shamir DKG for both keys. |
| storage | ORK Swarm → TideCloak | Pre-encrypted VVK shards deposited for future recovery. |
| Ragnarök draft/approval/commit | Admin Quorum ↔ TideCloak | Multi-admin governance ceremony. |
| Sign Ragnarök approval | TideCloak → ORK Swarm | ORKs validate governance signatures. |
| ORK Swarm → TideCloak | Scenario A: Direct RGK shard release (after VVK revocation). | |
| Request Nuclear Codes | SWE → ORK Swarm | Scenario B: Admin requests deterministic sub-share. |
| ORK Swarm → SWE | Scenario B: Per-ORK sub-share (after VVK revocation). | |
| SWE → Admin | Scenario B: Consolidated share after interpolation. | |
| Admin share contribution | Admin Quorum → TideCloak | Scenario B: admins deposit shares for RGK reconstruction. |
| VVK decryption + transition | TideCloak (internal) | Decrypt , install EdDSA key, disable Tide-IdP, enforce email login. |
| Mass password reset | TideCloak → All users | Email-based credential re-establishment. |
References
- Hall, J. L., Hertzog, Y., et al. (2023). Manifesting Unobtainable Secrets: Threshold Elliptic Curve Key Generation using Nested Shamir Secret Sharing. arXiv:2309.00915. Presented at AustMS 2021.
- Tide Developer Documentation: docs.tidecloak.com
Related Protocol Articles:
- Protocol: Account Creation / KeyGen - The Nested Shamir DKG that generates both VVK and RGK during vendor onboarding.
- Article 5: Governance Without God Mode - The admin quorum model that governs Ragnarök initiation.
- Article 10: TideCloak - TideCloak architecture, the post-Ragnarök operational mode.
- Protocol: PRISM Password Change - Sibling lifecycle protocols maintaining the "never assemble" invariant.
- Protocol: Decentralized Account Recovery - Sibling lifecycle protocols maintaining the "never assemble" invariant.
- Protocol: Key Healing - Sibling lifecycle protocols maintaining the "never assemble" invariant.