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


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 team member configuring SSO for your plan will provide this identifier. This URL directs your learners 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 URL Encoder (external site, opens in new tab).

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 (.csv download, <20MB).

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

Paths

An SSO-enabled path link takes 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/python-3
  • IDP Relay State: https://sso.pluralsight.com/paths/skill/<path-id>

Channels

An SSO-enabled channel link takes the user directly to a channel. The channel ID appears at the end of the channel's URL.

Note: An SSO-enabled channel link won't provide a user access to a channel they don't already 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>

Another option is to 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 are tied to paths and provide users with a Skill IQ measurement for a particular technology skill. Find a skill ID at the end of the skill assessment's URL.

Create a link to automatically launch the assessment, or 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 directs 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

This URL takes plan admins and team managers directly to 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 link shows an individual learner their learner history and helps 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—additional filters applied when searching in Skills are not supported in these links.

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