Integrating EdApp with external systems

This article explains how to seamlessly integrate EdApp with your intranet, LMS, LXP or custom portal. For the best user experience we recommend using SSO through SAML 2.0 for authentication.

1. Setup Single Sign On
   For the best user experience we recommend using SSO. A guide how to set this up can be found here
2. To enable users to launch courses directly from your intranet, metadata like the course title, description, etc need to be transferred to your intranet.
   There a 2 ways to accomplish this.
   1. Using the API and pull in the data on a pre-defined interval. The api endpoint to use is: Get all Courses
   2. Use webhooks to allow EdApp to push the course metadata to your intranet in real time.
      Create Webhook using the "CoursePublishedEvent"
3. Construct the Url to the course to display in your intranet page.
   The url to launch the course looks like this https://web.edapp.com/#course/{courseId}?companyId={companyId}&restrictToCourseScreen=true
   Where:
   {courseId} = the id of the course that was retrieved from EdApp in step 2
   {companyId} = the value you have chosen in step 1 when setting up SSO. This makes sure that the user is redirected to your SSO login screen when the user is not logged in yet.
4. After the users have completed the course, the completion data can be sent from EdApp to your intranet or data warehouse. Again there are 2 ways to do this.
   
   1. Using the API and pull in the data on a pre-defined interval. The api endpoint to use is:
      Get course progress
   2. Use webhooks to allow EdApp to push the course completion to your intranet in real time.
      Create Webhook using the "CourseCompletedEvent"