This document provides information on how Immersive can be integrated with your instance of Degreed. This integration allows users to access and track their Immersive courses and progress directly within the Degreed platform through APIs, which allow the two platforms to communicate and share data.
Setup Single Sign-On SSO
When you’ve set up a Degreed instance with an SSO integration with Immersive, your users will be able to leverage deep links to our labs from within your Degreed instance. Following a link will authenticate and log the user into our platform. If the user is a new user then it will also register them with a license. If you haven’t already set up an SSO integration with Immersive, please refer to our SSO Setup Guide.
Configure Data feed
Immersive will provide Degreed with two different types of data as part of our ongoing data feed for your account:
- Flat-file catalog
- xAPI Completion Data
Flat-File Catalog
The first type of data that is sent daily is the content catalog. This will be a flat-file .csv that contains all of the Labs that your organization has access to, along with the SSO enabled deeplinks. This is sent to Degreed’s endpoint via FTPS. The following details per lab are provided:
| Field | Description | Example |
| ContentID | A unique ID for the lab | 1635 |
| ContentType | A content type we add for Degreed’s benefit. All Labs are Courses | Course |
| Title | The title of the lab | XML External Entity Injection |
| Summary | A description of the lab | When a weakly configured XML parser meets an XML external entity, XXE injection vulnerabilities can be introduced to a web application. |
| URL | The URL a user can use to access the lab, including your custom subdomain. | https://iml.immersivelabs.online/labs/ xml-external-entity-injection |
| Difficulty | The difficulty level of the lab | Advanced |
| Duration | The estimated time required to complete the lab | 60 |
| DurationUnits | The unit of measurement for Duration | minutes |
xAPI Completion Data
The second data type of data that is sent is the user completion data. As users complete labs, Immersive will inform your Degreed instance using xAPI statements. Here’s an example where anna@immersivelabs.com completed a lab:
Getting Started
First you, the customer, must identify your Degreed Technical Project Manager and other key stakeholders to confirm that you are able to setup an integration. After that, you will need to contact your Immersive CSM who will work internally to confirm that integrations are available based on your on contract terms. Once approved, the next step will be to connect with you and your Degreed Technical Project Manager with our Immersive Integrations team who will then begin to establish timelines and deliverable milestones for the project.