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.
An OpenPGP identity is an OpenPGP key that signs documents and receives encrypted messages, for example to sign release files or read mail sent to a shared address. Its private keys live in a threshold vault. Your Guardian Team, the group of devices that together approve each proposal, votes on every signature, every decryption and every change to the key.
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).
Create the OpenPGP identity
In the Web App
- Open the Web App (opens the SplitSecure web app).
- In the sidebar, under Vaults, click your threshold vault.
- Click New resource.
- Under Signing & certificates, click OpenPGP identity.
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 | Release signingRequired. The name the Guardian Team sees on the proposal |
| Description | Optional |
| Full name | Acme ReleasesRequired. The name in the first user ID, marked Primary |
[email protected] Required. Click Add user ID to add more, up to 8 in all | |
| Primary key algorithm | Ed25519 (default)Or ECDSA or RSA. The primary key signs every operation of this identity |
| Encryption subkeys | Cv25519 (default)Click Add subkey for more, or remove every subkey for a sign-only key |
| Expires | Never expiresOr 1 year, 2 years or Custom date |
Under Advanced Options, you can turn on Selective notifications and set the Account Sensitivity. Click Continue.
The Review step lists the user IDs, the algorithms, the expiry, the Location and the Guardian Team under Protected by. The What voters will see box shows the text of the proposal.
- 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.
Approve the OpenPGP identity
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 asks to create the OpenPGP identity, with its user ID and its algorithms. Its OpenPGP key section lists the User IDs, the Algorithms and when it Expires.
The identity is in your vault. Its OpenPGP identity card shows the Fingerprint and the User IDs. The Encryption subkeys card lists each subkey.
Share the public key
- In your vault, open the identity.
- Click More actions → Download public key. The Web App saves an
.ascfile. - Publish the file, or send it to the people who encrypt messages for you or check your signatures.
Anyone can encrypt a message to the identity without a vote: click More actions → Encrypt, type the Message, then click Encrypt.
Sign a document
In the Web App
- On the identity’s page, click Propose signature.
- Under Document, paste the text or upload the file. The limit is 256 KiB, and the enclave signs the exact bytes.
- Under Signature type, keep Binary, or choose Canonical text for a text document.
- Optionally, enter a Reason for signing.
- Click Propose signature.
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 asks to sign a document as the identity. Its OpenPGP signature section shows the document’s size, its SHA-256 digest and, for text, a preview.
When the vote passes, the proposal page shows the Signature card. Click Download signature (.asc), or copy the signature.
gpg --verify with the public key confirms the signature on the document.
Decrypt a message
In the Web App
- On the identity’s page, click More actions → Decrypt a message.
- Paste the message under Encrypted message (ASCII-armored), or upload it. The page shows the Recipient key ID and the subkey the message is encrypted to.
- Optionally, enter a Reason for access.
- Click Propose decryption.
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 asks to release one message’s decryption key. Members cannot read the message: they approve based on who asks and which message they hold.
The plaintext opens once, and only in the browser that proposed the decryption. After a reload, or in another browser, the page reads “This result isn’t viewable here”. Click Request again to open the decrypt form, then propose the decryption again.
When the vote passes, the proposal page decrypts the message in your browser and shows the Plaintext. Copy it, or click Download plaintext, before you leave the page. If the page asks for the message, paste the same encrypted message and click Decrypt.
Only the message’s session key leaves the enclave. Your browser does the decryption, so the enclave never sees the content.
Manage subkeys and user IDs
In the Web App
Each change is a proposal that the Guardian Team votes on, like the creation. All of them sit under More actions on the identity’s page.
| Action | What it does | Button |
|---|---|---|
| Add user ID | Adds a Name and Email to the key | Propose new user ID |
| Revoke user ID | Revokes a user ID, with an optional Reason | Propose user ID revocation |
| Add subkey | Adds an encryption subkey. Use it to rotate subkeys: older messages still decrypt | Propose new subkey |
| Revoke subkey | Stops future use of a subkey. Messages already encrypted to it still decrypt | Propose subkey revocation |
| Set expiry | Changes when the primary key or an encryption subkey expires | Propose expiry change |
- Click More actions, then the action.
- Fill in the form. Optionally, enter a Reason for this change.
- Click the button in the last column.
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 identity’s card shows the change. Download the public key again and share it, so that others see the new user ID, subkey or expiry.
Troubleshooting
| Issue | Solution |
|---|---|
| The OpenPGP identity card cannot be selected | You have no seat in this organizationAsk an organization administrator to assign you a seat |
| Propose creation fails with “user IDs requested, max 8” | A new identity can have at most 8 user IDsRemove user IDs until 8 or fewer remain. Add more after creation with Add user ID |
| “The document exceeds the 256 KiB limit.” | The document is too largeSign a checksum file instead. Run sha256sum big.iso > big.iso.sha256 and sign big.iso.sha256. Readers verify that signature, then run sha256sum -c big.iso.sha256. On macOS, use shasum -a 256 and shasum -a 256 -c |
| “This message is not encrypted to this identity.” | The message was encrypted to another keyAsk the sender to encrypt to this identity’s public key |
| Encrypt is disabled | The identity has no active encryption subkeyAdd a subkey |
| “This result isn’t viewable here” | The plaintext already opened once, or this is another browserClick Request again, then propose the decryption again |
| “This isn’t the message that was approved for decryption.” | The pasted message differs from the one in the proposalPaste the exact message you submitted |
| 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
- RFC 9580: OpenPGP (opens in a new tab): The OpenPGP specification
- SplitSecure plans (opens in a new tab): See the plans and their limits