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
- Open the Web App (opens the SplitSecure web app).
- In the sidebar, under Vaults, click your threshold vault.
- Click New resource.
- 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 wizard asks for no entity ID or sign-in URL. SplitSecure assigns them when the identity provider is created, and shows them on its page.
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.
- Check the details.
- Pick the members to notify, if you want to limit the notifications.
- Optionally, enter a Justification. The Guardian Team reads it with the proposal.
- Click Propose creation.
The Web App shows Processing Request, then opens the proposal under Requests.
Approve the proposal
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.
The proposal page reads Completed and shows View resource. The identity provider is in your vault.
Find the values for your services
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
- SAML 2.0 technical overview (opens in a new tab): OASIS SAML 2.0 technical overview