Online Learning Integration Docs

SSO Deep Linking Support

Introduction to Deep Linking

O’Reilly Media’s support of SAML SSO allows for deep linking, which authenticates a user and redirects that user to a specific area or title on the O’Reilly Learning Platform. These deep links can be used in communication to users in your organization, in a corporate portal, or to associate with learning events/objects in a Learning Management System.

Creating a Deep Link

To create a deep link, or “go-link,” you can appaend a relative path or the complete URL to https://go.oreilly.com/{CONNECTION_STRING}. The connection string is unique to your organization and will be provided to you as a part of your onboarding. Accessing that URL with your connection string appended will authenticate you and direct you to the O’Reilly Learning home page.

To link directly into content, append the relative path to the URL, like so:

https://go.oreilly.com/{CONNECTION_STRING}{CONTENT_PATH}

Whether you use the relative path or complete URL, the results will be the same. Let’s look at an example. In this example, our connection string is AcmeCo, and we want to link to chapter 5 of Hands-on Machine Learning with Scikit-Learn, Keras, and TensorFlow, which can be found at:

https://learning.oreilly.com/library/view/hands-on-machine-learning/9781492032632/ch05.html

We’d create a deep link to chapter 5 using the relative path like so:

https://go.oreilly.com/AcmeCo/library/view/hands-on-machine-learning/9781492032632/ch05.html

Or create a deep link with the complete URL:

https://go.oreilly.com/AcmeCo/https://learning.oreilly.com/library/view/hands-on-machine-learning/9781492032632/ch05.html

A go-link can link to any piece of content on O’Reilly online learning and even to a specific part of the content. Simply navigate to the specific place within the content you’d like to link to, copy the URL from the browser address bar, and append that path to the go-link URL as described above. In all cases, you can use the relative path or the complete URL. Some examples follow.

Link to chapter 6 of a video:

https://go.oreilly.com/AcmeCo/library/view/learning-python/video6_1.html

Link to a learning path:

https://go.oreilly.com/AcmeCo/learning-paths/learning-path-getting/9781492027102

Link to a case study:

https://go.oreilly.com/AcmeCo/case-studies/dev-ops/building-engineering-teams-und/9781491991336-video318233

Link to a playlist:

https://go.oreilly.com/AcmeCo/playlists/306ddb2d-f48b-4a34-8598-e84bd3199095

Link to a search query

https://go.oreilly.com/AcmeCo/search/?query=python

Or a multiword search query:

https://go.oreilly.com/AcmeCo/search/?query=quantum%20physics

Migrating from Legacy Formats

For existing deep links in your catalog, O’Reilly recommends that you replace the text

https://safarijv.auth0.com/authorize?client_id=UtNi1m1IRXgzYFIwZrhSxell9EDRaL2v&response_type=code&redirect_uri=https://learning.oreilly.com/complete/auth0-oauth2/&connection=

with the text

https://go.oreilly.com/

resulting in

https://go.oreilly.com/{CONNECTION_STRING}{CONTENT_PATH}

As an example, let’s update an SSO deep link published by the fictitious University of Sebastopol. The connection string for this fictitious account is: UofSebastopol. The book they have linked is Building Microservices at the URL:

https://learning.oreilly.com/library/view/building-microservices/9781491950340/

The existing SSO deep link to Building Microservices is:

https://safarijv.auth0.com/authorize?client_id=UtNi1m1IRXgzYFIwZrhSxell9EDRaL2v&response_type=code&redirect_uri=https://learning.oreilly.com/complete/auth0-oauth2/&connection=UofSebastopol&state=/library/view/building-microservices/9781491950340/

After migrating to O’Reilly’s go-link format, the link to Building Microservices will become:

https://go.oreilly.com/UofSebastopol?state=/library/view/building-microservices/9781491950340/