This article is a supplement to our main article on SSO (please read that first for context).
Skedda has a published/official integration with Okta. You can find Okta's detailed guide for the Skedda integration here. Use the Okta guide as your main reference while you're working through the screenshots and process below!
A full walkthrough of the setup process is also available below:
Step 1: 'Browse App Catalog' for the Skedda app
From your 'Applications' settings page in your Okta admin console, select 'Browse App Catalog', as shown in the screenshot above.
From there, search for 'Skedda' in the search bar and select the 'Skedda - SAML' option, as shown in the screenshot below:
Step 2: Add Skedda as an app
Add Skedda as an app, as shown in the screenshot above.
Next, name the app 'Skedda' in the 'Application label' field, as shown in the screenshot below:
Click 'Done' to proceed to the next page.
Step 3: Configure 'Relay State' value in Okta
Click on the 'Edit' button under the 'Sign On' section of the Skedda app, in Okta.
Next, copy the 'Relay State' value from within your Skedda SSO settings page, and paste it into the 'Default Relay State' field in your 'Sign On' settings:
You can copy the 'Relay State' value from your Skedda SSO settings page using the clipboard button, as shown in the screenshot below:
Paste this value into the 'Default Relay State' field in Okta's 'Sign On' settings:
Click 'Save' to complete this step.
Step 4: Provide Skedda with your relevant IdP details
Click on the 'View Setup Instructions' button in order to access your IdP's unique values to paste them into the corresponding fields in your Skedda SSO settings page.
From this page, under step three, copy the different values as shown below and paste them into their respective fields in Skedda:
The table below shows where you should paste each value from Okta, into Skedda.
Value in Okta: | Corresponding field in Skedda: |
Identity Provider Entity ID | Identity Provider Entity ID |
Identity Provider Login URL | Identity Provider Login URL |
Identity Provider Certificate Public Key | Identity Provider Certificate Public Key |
Step 5 (Optional): Set up any additional custom attributes as required
If you wish to create attribute rules on the Skedda side for deciding which Skedda user tags are granted to one of your users when they are automatically provisioned during their first Skedda SSO login (as discussed in our main SSO support doc), you might need to pass additional information in the form of custom attributes from Okta to Skedda (i.e. additional custom attributes). For example, you might need to tell Okta to send "Department" information of a user to Skedda. To do this, click the "Edit" option under the "Sign On" tab of the Skedda application in Okta...
...and then click the small "expand" arrow next to "Attributes (Optional)":
This will then allow you to add further attributes as you require, using the Okta editor:
Step 6: Setup Complete!
Finally, review the "Assignments" page for the Skedda-app in Okta. From here, you'll be able to make sure that the appropriate users/groups are assigned access to the SSO integration between Skedda and Okta, in your organization.
Once that’s completed, you’re all set to begin testing!
Walkthrough video
If you’d like to set your SSO integration while following along with a video walkthrough, take a look at the video below to get going!
If you're having trouble getting SSO to work after setting it up, take a look at our SSO Troubleshooting article!
Please also feel free to reach out to our support team if you have any questions or issues in the setup process.