Search the documentation
Search the documentation...
SplitSecure documentation

On this page

Procedure · 8 steps

Store and release a secret

Store a secret in a threshold vault, and reveal it only after your Guardian Team approves each release.

Updated

Before you start

  • A Basic or Guardian seat, on any plan. The members who vote need a Guardian seat.

  • The SplitSecure mobile app, set up and signed in to the same account as the Web App. See Set up your device and browser.

  • A Guardian Team, the group of devices that together approve each proposal, formed and usable. See Form your Guardian Team.

  • Use or Edit access to a vault backed by that Guardian Team. Forming a Guardian Team creates one, named after the team.

A secret is a value nobody should read alone, such as a root password, a recovery code or an API key. You store it in a threshold vault, and your Guardian Team, the group of devices that together approve each proposal, votes before anyone sees it again.

Passkeys, X.509 CAs, SSH principals, signing keys, OpenPGP identities, wallets, secrets and connected apps share one Secrets limit. Each seat adds the allowance your plan sets for its kind. By default, a Guardian seat adds to the limit and a Basic seat adds nothing. An administrator sees the count under Organization → Overview, on the Resource usage card. To make room, delete any of these resources, or add seats of a kind that carries an allowance. See the plans (opens in a new tab).

Store the secret

In the Web App

  1. Open the Web App (opens the SplitSecure web app).
  2. In the sidebar, under Vaults, click your threshold vault, then open the folder that should hold the secret.
  3. Click New resource.
  4. Under Secrets, click Secret.
Field Value
Name Root passwordRequired. The name the Guardian Team sees on every proposal
Description Optional
Secret value The valueRequired. Your browser encrypts it before it leaves your computer

Under Advanced Options, you can turn on Selective notifications and set the Account Sensitivity. Click Continue.

The Review step lists the details, the Location and the Guardian Team under Protected by. The What voters will see box shows the text of the proposal. The value itself never shows again.

  1. Check the details.
  2. If your Guardian Team lets you choose who gets notified, pick the members under Who to Notify.
  3. Optionally, enter a Reason for creation.
  4. Click Propose creation.

The Web App opens the proposal under Requests.

Now on each member’s device

On each member’s device, the proposal appears under Requests. The member opens it, checks the details, then taps Approve. The proposal passes when the approvals reach the Guardian Team’s threshold.

The proposal reads, for example, “Alice wants to store a secret named Root password”. Members never see the value.

Release the secret

Now in the Web App
  1. In your vault, open the secret.
  2. Click Propose release. The Reveal secret page opens.
  3. Optionally, enter a Reason for access. The members read it before they vote.
  4. Click Propose release.
Now on each member’s device

On each member’s device, the proposal appears under Requests. The member opens it, checks the details, then taps Approve. The proposal passes when the approvals reach the Guardian Team’s threshold.

The proposal reads, for example, “Alice wants to reveal a secret named Root password.”

Now in the Web App

When the vote passes, the proposal page shows the Revealed secret card. The value is hidden.

  1. Click the eye icon to show the value, or click Copy.
  2. Use the value, then leave the page.

Delete the secret

In the Web App

  1. On the secret’s page, click More actions → Delete.
  2. Optionally, enter a reason, then click Propose deletion.

The members vote on their devices, as for a release.

Troubleshooting

Issue Solution
The Secret card cannot be selected You have no seat in this organizationAsk an organization administrator to assign you a seat
Propose release is disabled You have no Use access to the secret, or you have no seatAsk someone with Edit access for Use access, or ask an administrator to assign you a seat
“This result isn’t viewable here” The value was already shown, or this is another browserClick Request again, then Propose release
“Request limit reached for this billing period” Your organization used every request its plan includes. Proposals and StepAuth requests both countWait for the next billing period, or move to a plan (opens in a new tab) with more
The proposal stays at Collecting Votes The approvals have not reached the threshold yetAsk the Guardian Team members to open Requests on their devices

External resources