Skip to main content
All CollectionsHelp Center
Quilt SSO Setup Instructions
Quilt SSO Setup Instructions

These instructions describe how to set up SSO using Okta OIDC in Quilt.

P
Written by Polina Vishnevskaya
Updated over a week ago

If you have any issues, please contact [email protected]

Step 1: Set up Quilt in Okta

  1. Log into your Okta admin account

  2. Navigate to Applications > Applications

  3. Click “Create a new app integration”

  4. Click “OIDC” and “Web Application”, then “Next” or “Continue”

  5. Change the "App integration name” to “Quilt”

  6. Under “Grant type”, make sure “Authorization Code” and “Refresh Token” are checked.

  7. Change the “Sign-in redirect URI” to https://web.quilt.app/__/auth/handler (replace the first one so that the quilt URL is the only one)

  8. Remove the “Sign-out redirect URIs” URL

  9. Set the “Assignments” in whatever way you choose for your organization.

  10. Click Save

  11. Go to the “General” Tab (you may already be there)

  12. Scroll down to “General Settings” and click “Edit”

  13. Change “Login initiated by” to “Either Okta or App”

  14. [optional] Check the box next to “Application Visibility” saying “Display application icon to users”

  15. Change “Initiate login URI” to https://web.quilt.app/?sso=1

  16. Click Save

  17. Scroll up to the “Client Credentials” section of the “General” tab, make note of these credentials or keep this page open

Step 2. Set up on Quilt

Next you will add the SSO credentials from Okta to Quilt.

Since SSO is not set up yet, you will need to sign in using Google or another sign in method.

If you cannot sign into Quilt, please contact us at [email protected]

  1. Sign in with your admin account

  2. Click the bottom left corner of the screen showing a letter or your profile picture

  3. Click “Your Group”

  4. Click “Settings” in the top right corner

  5. You should be on the page https://web.quilt.app/group/settings

  6. Click the tab “SSO”. If this tab isn’t visible, contact quilt to enable SSO on your account.

  7. Click “Add SSO”

  8. Add the Client ID and Client Secret from Okta to the form

  9. Add your Okta URL as the “Issuer URL”

  10. Click Submit

You are done! Try logging out and logging back in with SSO to make sure it works.

Did this answer your question?