Gatsby is excited to be featured on the Okta Integration Network! You can now leverage your existing Okta SSO at your organization to grant and authorize access to your Gatsby organization.

Supported Features

• Service Provider Initiated Single Sign-On (SP-initiated SSO)
• Identity Provider (IdP) Initiated SSO

Requirements

In order to proceed with configuring login with SSO through Okta, you must:

• Have access to an Okta tenant
• Be an Okta administrator to that tenant
• Be an admin of your Gatsby organization

Configuration Steps

1. Add the Gatsby Application to your Okta Organization

   1. In the Okta dashboard, navigate to Applications and then select the Applications sub-menu.

   2. Click on Browse App Catalog and search for Gatsby to find our Okta application

      

   3. Click Add Integration to kickoff the configuration process. Complete the General Settings section as you deem fitting

      

2. Upload your Client ID, Client Secret, and Issuer URL from Okta into Gatsby

   1. Navigate to your Gatsby Team Settings Page and locate the Okta Configuration settings

   

   1. In the Okta dashboard, navigate back to the Applications section and click into the new Gatsby application

      

   2. In the Okta Sign On tab copy your Client ID and paste it into the first field in the Okta Integration form within Gatsby

   3. In the Okta Sign On tab copy your Client Secret and paste it into the second field in the same form.

   4. In the top right corner of your Okta Management page, click on the dropdown arrow to and press the copy button to the right of your Authorization Server URL and paste it into the 3rd field of the Gatsby form

      

3. Save the form and invite your colleagues to collaborate!

   1. Now that you have configured your Gatsby organization with your Okta credentials, your colleagues will now be able to sign into Gatsby after you invite to them to join!

   2. Your users will be able to login directly to Gatsby from Okta

      

   3. Your users can also login using the Login with Okta option or navigating directly to the Okta Login Page and provide their email

   

Mobile Configuration Steps

If you want to allow your colleagues to sign into the Gatsby Mobile App using Okta, follow these steps after doing the above:

1. In the Okta dashboard, navigate back to the Applications section and click into the Gatsby application

2. In the Okta Sign On tab, click the edit button in the top right corner

   

3. In the top right corner of your Okta Management page, click on the dropdown arrow and copy the first section of your Authorization Server URL before the first period. Then, past that into the input labeled “Okta Domain”

   

4. Save the form!