Creating SSO-enabled links

If you’re on a business plan with SSO (single sign-on), you can create SSO-enabled links to direct users to specific areas of Pluralsight Skills. For example, Plan admins can use an SSO-enabled link to go directly to their dashboard, while learners can use SSO-enabled links to go directly to channels, paths, or courses. 

This article describes SSO URL formats to help you directly access those things that are most important to you in Skills.

SSO-enabled URL templates for Skills content

The Base SP Initiated launch URL for your company will be https://app.pluralsight.com/sso/<company SSO identifier>. The SSO identifier is provided by the Pluralsight Implementation Engineer upon configuring SSO. 

Using this URL directs the learner to the home page of the application after successful SSO authentication. To create new SSO enabled links to different parts of the application, utilize the linking structures outlined below.

Note: IDP-initiated links are generated on the client side, with the IDP Relay State replacing the base URL of https://app.pluralsight.com/sso/ with https://sso.pluralsight.com/. IDPs often require the Relay State to be URL-encoded. You can use your encoder of preference to do this.

Important: When inputting the <company SSO identifier>, or other piece of information surrounded by angle brackets (< >), exclude the angle bracket symbols.

Courses

Course links go directly to the course’s table of contents page. The course ID is the hyphenated course name at the end of the URL for the course. A list of courses and their respective Course IDs is available at the courses API endpoint.

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=courses/<course-id>
  • Example: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=courses/java-web-fundamentals
  • IDP Relay State: https://sso.pluralsight.com/library/courses/<course-id>

Paths

An SSO-enabled path link will take the user to the home page of that path. The path ID can be extracted from the path URL.

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=paths/skill/<path-id>
  • Example: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=paths/skill/angular-js
  • IDP Relay State: https://sso.pluralsight.com/paths/skill/<path-id>

Channels

An SSO-enabled channel link will take the user directly to the channel. Channel IDs can be extracted from the URL of the channel in Skills.

Note: An SSO-enabled channel link will not provide a user access to a channel they do not have access to.

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=channels/details/<channel-id>
  • IDP Relay State: https://sso.pluralsight.com/channels/details/<channel-id>

Skill assessments

Skill assessments tied to paths are used to provide a Skill IQ for a particular technology skill. You can find skill IDs at the end of the URL for the skill assessment. 

You can create a link to automatically launch the assessment, or you can direct the user to the skill assessment intro page which provides a brief instruction before the assessment.

Linking Directly to the skill assessment

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=score/skill-assessment/<skill-id>
  • Example: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=score/skill-assessment/angular-js
  • IDP Relay State: https://sso.pluralsight.com/score/skill-assessment/<skill-id>

Linking to the skill assessment intro page

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=score/skill-assessment/<skill-id>/intro?context=paths&path_type=skill&path_url=<skill-id>#/v2/landing
  • Example: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=score/skill-assessment/angular-js/intro?context=paths&path_type=skill&path_url=angular-js#/v2/landing
  • IDP Relay State: https://sso.pluralsight.com/score/skill-assessment/<skill-id>/intro?context=paths&path_type=skill&path_url=<skill-id>#/v2/landing

Role IQ

An SSO-enabled Role IQ link will direct the learner to the into page for a specific role.

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=roleiq/roles/<role id>
  • Example: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=roleiq/roles/ccba285c-2529-4d29-a80a-624ba0437644
  • IDP Relay State: https://sso.pluralsight.com/roleiq/roles/<role-id>

URL templates for plan admins and team managers

Dashboard

Plan admins and team managers can use this URL to access the admin dashboard to see an overview of what their learners are doing in Skills.

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=plans/dash
  • IDP Relay State: https://sso.pluralsight.com/plans/dash

Analytics

This can be used by plan admins and team managers to access the analytics in Skills.

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=plans/reports
  • IDP Relay State: https://sso.pluralsight.com/plans/reports

People

This can be used by plan admins and team managers to access the People page in Skills.

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=plans/org
  • IDP Relay State: https://sso.pluralsight.com/plans/org

Other URL templates

History

This will let an individual learner view all their learner history and help them keep track of their journey with Skills.

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=library/history
  • IDP Relay State: https://sso.pluralsight.com/library/history

Search

Use SSO-enabled links to link to search results. This will take learners to the search results of whatever is included in the search ID, which is defined by the user when making a search, and found in the URL of the search.

Note: There are some limitations to this functionality. Specifically, additional filters provided when searching in Skills are not supported in these links.

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=library/search?q=<search-id>
  • Example: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=library/search?q=javascript
  • IDP Relay State: https://sso.pluralsight.com/library/search?q=<search-id>

Notes

This navigates to the user’s Notes page.

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=notes
  • IDP Relay State: https://sso.pluralsight.com/notes

Bookmarks

This navigates to the user’s Bookmarks page.

  • Template: https://app.pluralsight.com/sso/<company SSO identifier>?returnUrl=library/bookmarks
  • IDP Relay State: https://sso.pluralsight.com/library/bookmarks

back to top


If you need help, please email support@pluralsight.com for 24/7 assistance.