Setting up an integration between EP and Schoolbox
Adding support for Schoolbox is a straightforward process, which normally requires a couple of hours of work by your school's IT team/LMS manager. Education Perfect's integration may differ from other integrations your school has, because we need a way to match a Schoolbox user to their EP account. This enables us to include the work they do in Schoolbox in their learning record when teachers are writing reports and running parent/teacher interviews.
In this article
The Education Perfect + Schoolbox Integration Process
Key Details
Test app URL: https://sso.educationperfect.com/Content/lti.testpage.educationperfect.com.xml
Live app URL: https://sso.educationperfect.com/Content/lti.educationperfect.com.xml
Get in touch with us
To get started, get in touch with our team. If you're not the person who will be configuring the integration, please also include them in the email so we know who to contact with next steps. Our team will send you a consumer and secret key pair which you can use to authenticate with us.
Install our test page
To check that your keys are working correctly, we've developed a test page that can be added immediately. This page also provides us with valuable information as we progress with the integration.
To install the test page
- As a Schoolbox Administrator, select 'Administration' from the drop-down menu located beneath your name from within Schoolbox.
- Select LTI Providers out of the available options.
- Click the '+' button to open the 'Add Provider' dialogue box.
- Input the test page URL (
https://sso.educationperfect.com/Content/lti.testpage.educationperfect.com.xml
) to the 'Configuration XML URL' field.
Please be sure to include the Consumer Key and Shared Secret we give you- these are required for integrating with Education Perfect.
Now that the test page is available in Schoolbox, add a component in one of your classes, then select Multimedia and Embed Learning Tool. From there, select Education Perfect TEST page from the available options.
Below is an example of the information that will be displayed. Copy all of the information on the page and send it to us - this page contains the information we need to continue the integration.
Match existing users to their Schoolbox accounts
If your students have already been using Education Perfect without a Schoolbox integration, their EP accounts will need to be linked to the unique identifier Schoolbox uses to confirm their identity. This enables any work that students do on Education Perfect in Schoolbox to be stored against their account. Often this is the user's school email address, but it can differ from school to school - the information in the test page above helps us to work out exactly what to use.
If we already have the unique identifier associated with teachers' and students' accounts, for example because it's their email addresses, we'll match up everyone we can on your behalf. We will then send you a list of anyone we couldn't match. Once you send us the details for those people, we'll update them as well.
Please note that if we have not associated identifier with your users based on the test results, your users will get an error if they attempt to access Education Perfect content embedded within Schoolbox.
Install the live App
Once all students and staff have been successfully set up with their identifiers, you can install the live integration in the same way as you added the test integration. The setup URL is https://sso.educationperfect.com/Content/lti.educationperfect.com.xml
.
You will use the same keys, but be sure to select "Picker" as the request type.
Once this is done, your staff will be able to embed content into Schoolbox modules and classes for your students to complete.