Before you start
A Guardian Team, the group of devices that together approve each proposal, formed and usable. See Form your Guardian Team.
- Enough current members, with a Guardian seat, to reach the threshold and approve the revocation.
Revoke a membership when a device is lost, retired or belongs to someone who leaves your Guardian Team. You propose the revocation in the Web App, and the current members approve it on their devices, in the mobile app. No seat is needed to propose it.
Propose the revocation
In the Web App
- In the sidebar, click Trust → Guardian Teams.
- Open the Guardian Team.
- Click the Members tab.
The table Guardian Team Members has the columns User, Shares, Accepted, Added, Device and Membership. Accepted reads Yes or Pending. A seat badge next to a user shows that their seat no longer allows team membership.
- Check the box of each membership to revoke.
- A bar appears with the number selected, Clear and Revoke Membership.
- Read the warning in the bar, if one shows.
The bar warns when the remaining shares fall below the threshold, so the Guardian Team would be inoperable. It also warns with Guardian Team will depend on a single membership when one device would become essential to every approval.
- Click Revoke Membership.
- Read the Revoke Membership dialog. It says that the revocation creates a proposal that the Guardian Team must approve.
- Click Revoke.
The dialog repeats the warnings that apply: Guardian Team will become inoperable, or Guardian Team will depend on a single membership with the names of the members the team would depend on.
The Web App shows Processing Request, then opens the proposal page under Requests.
When the selection leaves fewer shares than the threshold, the bar shows Delete Guardian Team instead of Revoke Membership.
Deleting a Guardian Team cannot be undone. If the team is the only owner of an identity provider, the dialog shows View Identity Providers instead. Review those identity providers before you go further.
- Click Delete Guardian Team.
- Optionally, enter a Reason for proposal (optional).
- Confirm the deletion in the dialog.
Approve the revocation
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.
After the proposal passes, each revoked device receives a proposal titled Remove Team Membership under Requests. The device then shows Membership removed.
The proposal passes, and each revoked device shows Membership removed. The threshold of the Guardian Team stays the same.
Change the threshold or rotate members
A revocation never changes the threshold, and an invitation never changes it either. To change the threshold or to replace the shares of every member, roll the Guardian Team forward.
- Open the Guardian Team’s Overview.
- Click Roll Forward.
- On Members, pick every member of the new version from your organization, including the current members who stay. Then choose the shares with Simple, Weighted or Bespoke.
When the roll forward completes, the previous version of the team is revoked. A member that you leave out receives Remove Team Membership on their device.
Troubleshooting
| Issue | Solution |
|---|---|
| The bar shows Delete Guardian Team | The selection leaves fewer shares than the thresholdSelect fewer memberships, or roll the team forward with a new threshold |
| The dialog shows View Identity Providers | The team is the only owner of an identity providerClick View Identity Providers and review them first |
| The proposal does not pass | Too few current members have votedAsk the current members to open Requests on their devices |
| A member’s vote is refused | Their seat is Basic or UnassignedAsk an administrator for a Guardian seat |
| The membership still shows on the Members tab | The proposal has not passed yetFollow the vote on the proposal page under Requests |
External resources
- SplitSecure Web App (opens the SplitSecure web app): Open the SplitSecure Web App