Integrations

SSO Deep Linking Support

Introduction to deep linking

O’Reilly’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 with users in your organization, in a corporate portal, or to associate with learning events/objects in a learning management system.

Please note that if your account has more than one SSO integration, you’ll need to maintain separate deep links for each integration.

Creating a deep link

To create a deep link, or “go-link,” you can append 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 home page.

To link directly into content, append the relative path to the URL, as shown here:

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

Whether you use the relative path or complete URL, the results will be the same. 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, as shown here:

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

Link to a multiword search query:

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

Migrating from legacy formats

For existing deep links in your catalog, we recommend 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 linked book is Building Microservices at this 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/

Have a problem or question? Reach out.

For issues and support regarding your O’Reilly account, please contact your account admin directly or email the customer support team at