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
- Open the Web App (opens the SplitSecure web app).
- In the sidebar, under Vaults, click your threshold vault, then open the folder that should hold the secret.
- Click New resource.
- Under Secrets, click Secret.
If you have no seat in this organization, the card reads “You have no seat in this organization.” and you cannot select it.
| 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.
- Check the details.
- If your Guardian Team lets you choose who gets notified, pick the members under Who to Notify.
- Optionally, enter a Reason for creation.
- Click Propose creation.
The Web App opens the proposal under Requests.
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.
The proposal page reads Completed and shows Resource Created. The secret is in the folder you chose.
Release the secret
- In your vault, open the secret.
- Click Propose release. The Reveal secret page opens.
- Optionally, enter a Reason for access. The members read it before they vote.
- Click Propose release.
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.”
The value opens once, in the browser that proposed the release. If you reload the page or open it elsewhere, it reads “This result isn’t viewable here”. Click Request again to open the release form, then click Propose release.
When the vote passes, the proposal page shows the Revealed secret card. The value is hidden.
- Click the eye icon to show the value, or click Copy.
- Use the value, then leave the page.
Delete the secret
In the Web App
Once the vote passes, the secret is destroyed and cannot be recovered.
- On the secret’s page, click More actions → Delete.
- 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
- Vault in the Lexicon
- SplitSecure plans (opens in a new tab): See the plans and their limits