Here's a guide to get started with SAML SSO with Okta for your Whimsical workspace, but you can also check Okta’s documentation.
Note: SAML SSO is only available on our Business and Enterprise plans. You must be an admin to enable SAML SSO
Whimsical also supports SCIM Provisioning with Okta.
1. Sign in to the Okta Admin app to generate a metadata file.
metadata.xml
2. Next, log in to your Whimsical account as an administrator.
First, go to Workspace settings, which you'll find under your workspace name in the top left corner:
Then, enable SAML SSO. Once it's enabled:
metadata.xml
file from step 2 in the “SAML Metadata XML” fieldAfter that’s saved:
4. Select the Sign On tab for the Whimsical SAML app, then click Edit:
After that’s done, you can go back to your Whimsical Workspace settings and adjust two more things:
There are some attributes that are the same for all identity providers:
Whimsical uses the e-mail address of the SAML user to identify them on Whimsical. This will come up with configuration options like Name ID Format or Name ID. When in doubt, try to choose the option that will return the user's e-mail.