Search the documentation
Search the documentation...
SplitSecure documentation

On this page

Procedure · 5 steps

Create an identity provider

Create a SAML identity provider in a threshold vault, so your Guardian Team approves every sign-in it signs.

Updated

Before you start

  • 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.

  • A threshold vault, backed by that Guardian Team. An online vault cannot hold an identity provider.

The identity provider (IdP) is the part of SplitSecure that signs you in to other services. You create it once, in a vault, and every connected app you add later uses it. Its creation is a proposal: your Guardian Team, the group of devices that together approve each proposal, must approve it.

Propose the identity provider

In the Web App

  1. Open the Web App (opens the SplitSecure web app).
  2. In the sidebar, under Vaults, click your threshold vault.
  3. Click New resource.
  4. Under Identity federation, click SAML identity provider.

The wizard opens on New SAML identity provider, at the Details step.

Field Value
Name Production SSORequired. The name the Guardian Team sees on the proposal
Description Optional
Certificate Validity: From NowCannot be in the past
Certificate Validity: Until Now plus 10 yearsMust be after From. Outside this window, the services reject every sign-in through this identity provider
Selective notifications OptionalUnder Advanced Options. Members can choose who gets notified for the Guardian Team’s proposals
Account Sensitivity OptionalUnder Advanced Options. None, Low, Medium, High or Critical. Sets the banner shown on this resource’s proposals

Click Continue.

The Review step shows the name, the Certificate Validity, the Location and the vault under Protected by. The What voters will see box shows the text of the proposal.

  1. Check the details.
  2. Pick the members to notify, if you want to limit the notifications.
  3. Optionally, enter a Justification. The Guardian Team reads it with the proposal.
  4. Click Propose creation.

The Web App shows Processing Request, then opens the proposal under Requests.

Approve the proposal

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 page in the Web App moves through Proposal Published, Collecting Votes, Executing Proposal and Completed.

Find the values for your services

Now in the Web App

Click View resource on the proposal page, or open the identity provider from your vault.

In the Web App, open Vaults, then your vault, then the identity provider. The SAML endpoints card shows three values:

  • SAML IdP Entity ID
  • SSO URL (HTTP-Redirect)
  • SSO URL (HTTP-Post)

Under them, Download metadata XML saves the metadata file and Download Certificate offers the certificate in PEM format or DER format.

Under them, Download metadata XML saves the metadata file, and Download Certificate offers the signing certificate in PEM format or DER format.

Every service provider guide tells you which of these values to copy into the service, and which of the two sign-in URLs it wants. The SSO URL (HTTP-Redirect) receives a redirect, and the SSO URL (HTTP-Post) receives a form post.

The same page has New Connected App, the button that starts every service provider guide.

Troubleshooting

Issue Solution
The review shows Create resource, which stays disabled The vault is an online vaultStart again from a threshold vault
The Web App refuses to create the identity provider Your access does not let you propose resources in this vaultAsk an organization administrator to grant you access
Continue refuses the dates From is in the past, or Until is not after FromCorrect the dates under Certificate Validity
The proposal stays at Collecting Votes The approvals have not reached the threshold yetAsk the Guardian Team members to open Requests on their devices
A service rejects every sign-in The certificate is outside its validity windowCheck Certificate Validity on the identity provider; create a new one if it has expired

External resources