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. 

Before you test the Deeplinking URLs mentioned below, make sure you're updating the Custom Footer in Theme settings with the Javascript so that Litmos understands the RelayState query parameter:

<script type="text/javascript">
$("#page-body").ready(
function() {
var referrerurl = document.referrer;
if (referrerurl.search("RelayState") > -1){
var redirecturl = referrerurl.split("RelayState=");
window.location.href = redirecturl[1];
}
});
</script>

 If you notice your deeplink is getting encrypted after authenticating through your SSO provider and you are getting a 400 error use the Javascript below:

<script type="text/javascript">
$("#page-body").ready(
function() {
url =document.referrer;
if (url.search("RelayState") > -1){
var uri = url.split("RelayState=");
uri = decodeURIComponent(uri[1]);
var newurl = uri.split("&Signature");
window.location.href = newurl[0];
}
});
</script>

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 deeplink 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.