Get started with SSO
Brienne Wong
This feature is available on all Professional and Enterprise plans. Want this and other premium features? Update your plan here.
We support any provider that supports SAML 2.0 SSO. See the guides below for specific providers.
To enable SSO, you must be on our Enterprise or Professional plan; please contact us for pricing.
Frequently asked questions
If you still have questions after reading this, see our SSO FAQ page.
Why set up SSO?
There are a few different use cases for setting up SSO:
- Manage editor and viewer access
- Invite editors and viewers via email
- Use zeroheight with a VPN
- Create private pages
- Use it in conjunction with the following features:
Set up SSO
If you need to setup separate SSO providers/configurations for workspaces, please do not follow these instructions. Specific guidance on this is available here.
1) In Your Organization page under the Integrations section, click Setup SSO
2) On the SSO setup page, you will see the generated SSO ID URL and SSO IDs. Send both the SSO ID URL and SSO ID to your IT team to set up.
3) Your IT team typically completes this step. Follow the setup instructions for your SSO provider in our guides below.
Providers
4) Once they have completed the setup, ask your IT team for the Metadata XML URL or Identity Provider Single Sign-On URL and X.509 Certificate.
Note: If you’re using the Identify Provider Single Sign-On URL and the X.509 Certificate and your IT team sends you an XML file, you will need to extract the Identity Provider Single Sign-On URL and X.509 Certificate from it. Ask your IT team if you’re unsure what you should provide to us.
5) Enter the Metadata XML URL or Identity Provider Single Sign-On URL and X.509 Certificate in the SSO setup page (Step two)
6) Click Enable SSO
7) You have enabled SSO for your account!
8) Once you have enabled SSO, editors and reviewers will no longer be able to log in using their username and password. They will need to log in using SSO.
You can enable Allow login with SSO or email and password to allow for both login methods and we would recommend turning this on to ensure your SSO is working.
9) If you want to disable SSO, contact support.
10) Once SSO is enabled, you should see SSO as an option in the Security section of the Styleguide settings. You can now choose to protect your styleguide with SSO.
