Get started with SSO

Chi
Chi
  • Updated

This feature is only available on 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 an Enterprise 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:

 

Set up SSO

1) In Your Organization page under the Integrations section, click Setup SSO

 

Team integrations page

 

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

Okta

ADFS

Azure

G Suite

OneLogin

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

 

Red arrow pointing to Sign in with SSO

 

9) If you want to disable SSO, contact support@zeroheight.com.

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.

 

Was this article helpful?