Creating SSO-enabled links

Tags: Skills

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

This article details how to create SSO URL formats that help you directly access the things that are most important to you in Skills.

Who can use this?

 StndPremStrtProEnt
Learners:  +++
Managers:  +++
Admins:  +++
+ Available as a plan add-on. Contact
your account manager for details.


SSO-enabled URL templates for Skills content

The launch URL for your organization will look like https://app.pluralsight.com/sso/<organization SSO identifier>. The Pluralsight Implementation Engineer configuring SSO for your plan will provide this identifier. This URL directs the learner to the Skills home page after successful SSO authentication. 

Important: Throughout this article, any information surrounded by angle brackets (< >), such as <organization SSO identifier>, are provided as examples in the template. When creating these URLs, exclude the angle bracket symbols.

To create new SSO enabled links to different areas of the Skills platform, use the linking structures outlined below. If your created SSO-enabled link isn't working, you may need to encode the URL using a tool like urlencoder.org.

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.

Courses

Course links go directly to a specific 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/<organization SSO identifier>?returnUrl=courses/<course-id>
  • Example: https://app.pluralsight.com/sso/<organization 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 appears at the end of the path URL.

  • Template: https://app.pluralsight.com/sso/<organization SSO identifier>?returnUrl=paths/skill/<path-id>
  • Example: https://app.pluralsight.com/sso/<organization 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. The channel ID appears at the end of the channel's URL 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/<organization SSO identifier>?returnUrl=channels/details/<channel-id>
  • IDP Relay State: https://sso.pluralsight.com/channels/details/<channel-id>

You can also link to your organization's channels page rather than directly to a channel itself:

  • Template: https://app.pluralsight.com/sso<organization SSO identifier>?returnURL%3Dchannels%3Fnav%3Dcompany%26plan%3D<plan-id>
  • IDP Relay State: https://sso.pluralsight.com/channels?nav=company&plan=<plan-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 skill assessment's URL. 

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

Linking directly to the skill assessment

  • Template: https://app.pluralsight.com/sso/<organization SSO identifier>?returnUrl=score/skill-assessment/<skill-id>
  • Example: https://app.pluralsight.com/sso/<organization 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/<organization 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/<organization 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 intro page for a specific role.

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

back to top


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/<organization SSO identifier>?returnUrl=plans/dash
  • IDP Relay State: https://sso.pluralsight.com/plans/dash

Analytics

Plan admins and team managers can use this link to access the analytics in Skills.

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

People

Plan admins and team managers can use this link to access the People page in Skills.

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

back to top


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/<organization SSO identifier>?returnUrl=library/history
  • IDP Relay State: https://sso.pluralsight.com/library/history

Search

Use SSO-enabled links to link directly to search results. When a user searches for content in Skills, this populates the search ID, which appears at the end of the search’s URL.

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

  • Template: https://app.pluralsight.com/sso/<organization SSO identifier>?returnUrl=library/search?q=<search-id>
  • Example: https://app.pluralsight.com/sso/<organization 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/<organization SSO identifier>?returnUrl=notes
  • IDP Relay State: https://sso.pluralsight.com/notes

Bookmarks

This navigates to a user’s Bookmarks page.

  • Template: https://app.pluralsight.com/sso/<organization 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.