Setting up Single Sign On

Walnut uses the WorkOS platform to manage the Sign In process into our platform.

WorkOS also allows us to provide our customers with the ability to use their SSO to sign into Walnut.

The process works as follows:

1. Submit a request here to provision the SSO. Please indicate the system you use, for example, OKTA vs Azure.
   Please note We only allow sign in via SAML at this point.

   

2. Walnut Support will provide you with the ACS URL and the idP URI (entity ID)

3. Create a Walnut app within your SSO platform. Use the following instructions

   1. OKTA - https://workos.com/docs/integrations/okta-saml/1-log-in

   2. Azure - https://workos.com/docs/integrations/azure-ad-saml/1-log-in

   3. Others - https://workos.com/docs/integrations

4. Provide Walnut support with the Metadata URL

5. After Support completes the setup, Test

   1. Try to sign in to Walnut from your SSO provider

   2. Type in your username in app.teamwalnut.com and see if you are redirected to your SSO system