Once we have the single sign-on setup, we can use the RelayState query parameter to redirect the users to a specific Course directly upon login instead of the dashboard. This would be useful if the users are using the Course assigned email. 

OKTA:

For Okta, the URL for deeplinking to a course should follow the format seen below:

https://Domain.okta.com/app/litmos/exkfxcjddb23t0uKk0h7/sso/saml?RelayState=https://domain.litmos.com/course/12345

Note: exkfxcjddb23t0uKk0h7 is an example Litmos App ID, you will use your own unique App ID generated by Okta for the Litmos App to use in the deeplink. This is found in the Metadata. 

This is basically the HTTP-POST Link followed by the RelayState query parameter. We can find the link in the metadata provided by Okta:

We can use the above in the Course assigned email as a Course link. Below is what we can use in the course assigned email for the deep link to work.

https://Domain.okta.com/app/litmos/exkfxcjddb23t0uKk0h7/sso/saml?RelayState=https://domain.litmos.com/course/[COURSE_ID]

Note: Okta has released a new Litmos app for our SHA-256 endpoint, domain.litmos.com/integration/splogin and is Live.

OneLogin:

For OneLogin, its the same as above but the url would be SAML 2.0 Endpoint which we'll find in the SSO tab in litmos app settings in OneLogin.

Something like this

https://domain.onelogin.com/trust/saml2/http-post/sso/742576?RelayState=https://domain.litmos.com/course/12345

We can follow the same process as of Okta's by using link in the Course assigned email. 

https://domain.onelogin.com/trust/saml2/http-post/sso/742576?RelayState=https://domain.litmos.com/course/[COURSE_ID]

[Course_ID] is the placeholder which will dynamically fetch the course id.