You can make learning activities you’ve created in your online academy available in another LMS. You can also make learning activities from another LMS available in your online academy. This works through LTI, a standard protocol for sharing learning activities between online learning environments.
LTI handles the entire integration, including creating the user, enrolling them, and single sign-on. It can also pass progress on activities in your online academy back to the other LMS, and vice versa.
We support the following LTI versions:
LTI 1.2
LTI 1.3
If the other LMS also supports LTI 1.3, we recommend using it, as it’s more stable than LTI 1.2.
Please note:
To use LTI 1.3, the integrations feature must be enabled in your environment. Don’t have this feature? Please contact support or your Customer Success Manager.
What would you like to do?
LTI works in both directions. The first option is to make a learning activity from Rakoo available in another LMS. In this case, the other LMS is the ‘Content consumer’. Users are created and logged in to Rakoo from the other LMS. They’re also enrolled in the learning activity and can start it directly in Rakoo. This works with both LTI 1.2 and 1.3, and this article explains the steps for each.
The second option is to make a learning activity from another LMS available in Rakoo. In this case, the other LMS is the ‘Content provider’. Users are created and logged in to the other LMS. They’re also linked to the learning activity and can start it directly in the other LMS. This works with both LTI 1.2 and 1.3, and this article explains the steps for each.
I want to make a learning activity from Rakoo available in another LMS
Do you have a learning activity in Rakoo that you’d also like to make available in another LMS? You can do this with LTI. With LTI, users are logged in to Rakoo directly from the other LMS, where they can start the learning activity. Read below to learn how to make a learning activity from Rakoo available in another LMS using LTI 1.2 or LTI 1.3.
To set up the integration, Rakoo and the other LMS need to exchange several pieces of information. For these fields, Rakoo uses the naming that’s fairly standard in the LTI protocol. A corresponding field in another LMS may have a slightly different name. If you can’t figure it out with the information available, please contact support.
LTI 1.2
Go to “Content” via the menu on the left.
Look for the relevant activity. The following types of activities can be shared:
E-learning
Microlearning
Learning Playlist
Go to the "Share" tab in the relevant learning activity.
Then, go to "Sharing via LTI" and enable the option "Available for LTI".
You will now see the required details for the other system:
LTI 1.2 Key
LTI 1.2 Secret
LTI 1.2 Launch URL
LTI 1.3
To share learning activities via LTI 1.3, there are two steps. First, create an LTI 1.3 integration in Rakoo on the Integrations page. Then, set up the learning activity so it can be shared via LTI 1.3.
Step 1: Create the integration
Go to “Integrations” via the menu on the left.
Under “Training provider”, select “LTI 1.3”.
Click “Add content consumer”.
Fill in all the required fields. You can get this information from the other LMS.
Field name in Rakoo | Description | Also known as |
Name | A recognisable name for the integration, so you can identify which external system it refers to. You can choose this name yourself. | - |
Tool deployment ID | A unique code indicating which integration is used between the two systems. | Also known as 'Deployment ID'. |
Access token URL | The web address used to temporarily access the other system. | Also known as 'OAuth2 Access Token URL'. |
JWKS URL | The web address where the system verifies that messages are secure and reliable. | Also known as Public keyset URL'. |
OIDC URL | The web address used to allow users to log in securely via the other system. | Also known as 'Authentication request URL'. |
Issuer | The unique identifier indicating which system the LTI launch originates from. | Also known as 'Platform ID'. |
Tool client ID | A unique identifier of the other system within this integration | Also known as 'Application ID'. |
5. Set the integration to “Activated”.
6. Save the changes.
7. The information listed under “Details for the other party” can be added to the LTI integration in the other learning system.
Field name in Rakoo | Description | Also known as |
OIDC URL | The web address used to allow users to log in securely via the other system. | Also known as 'Initiate login URL'. |
JWKS URL | The web address where the system verifies that messages are secure and reliable. | Also known as 'Public keyset URL'. |
Redirect URI's | The web addresses in our system to which a user is automatically redirected after logging in. | Also known as 'Redirection URI(s)'. |
Issuer | https://lti13.rakoo.com - The unique identifier indicating which system the LTI launch originates from. | Also known as 'Platform ID'. |
Step 2: Set up the learning activity for sharing via LTI 1.3
Go to “Content” via the menu on the left side of the screen.
Find the relevant activity. The following types of activities can be shared:
E-learning
Microlearning
Learning Playlist
Go to the "Share" tab in the relevant learning activity.
Then, go to "Sharing via LTI" and enable the option "Available for LTI".
You will now see the “LTI 1.3 Resource URL”. You can use this URL in the external system to access the course.
LTI 1.3 deep linking
To make learning activities created in Rakoo available in an external platform, we support the LTI 1.3 deep linking protocol. This allows multiple learning activities from Rakoo to be loaded into the external platform at once. Follow these steps:
Make sure the LTI 1.3 integration has been set up using the steps described above.
In Rakoo, open the learning activities you want to share and enable the toggle "Available for LTI" in the Share tab.
Ensure you are using an administrator account in Rakoo with at least the permission "View learning activities". The email address linked to this administrator account must match the email address you are logged in with as an administrator in the external platform.
Open the deep linking functionality in the external platform.
You will be redirected to Rakoo, where a window appears allowing you to select the learning activities you want to make available in the external platform.
The data is sent to the external platform. Use this data to make the learning activities accessible within the external platform.
I want to make learning activities that were made in other online learning systems available in my online academy
Do you have a learning activity in another LMS that you’d also like to make available in Rakoo? You can do this with LTI. With LTI, users are logged in to the other LMS directly from Rakoo, where they can start the learning activity right away. Read below to learn how to make a learning activity from another LMS available in Rakoo using LTI 1.2 or LTI 1.3.
To set up the integration, Rakoo and the other LMS need to exchange several pieces of information. For these fields, Rakoo uses the naming that’s fairly standard in the LTI protocol. A corresponding field in another LMS may have a slightly different name. If you can’t figure it out with the information available, please contact support.
LTI 1.2
When creating a new e-learning course, select LTI.
Fill in the details of the learning activity, such as title, study time, and description.
In the settings, under LTI, select LTI 1.2.
Enter the LTI details in the settings. You need to request these details from the other online learning system. At a minimum, you will need:
Key
Secret
Launch URL
Resource link: enter any value here, this field cannot be left empty.
Optionally, you can add extra parameters (see “Advanced LTI” below).
LTI score: define here how the score returned by the external platform should be interpreted by this LTI learning activity in Rakoo. If you select progress, the received score will be displayed as progress. If you select final score, the score will be interpreted as a completion score. This means that in Rakoo, the registration will be marked as completed as soon as any score is received from the external system.
Save the changes and the activity will be ready for use.
LTI 1.3
To share learning activities via LTI 1.3, there are two steps. First, create an LTI 1.3 integration in Rakoo on the Integrations page. Then, create a learning activity in Rakoo and add the details of the learning activity from the other LMS to it.
Step 1: Create the integration
Go to “Integrations” via the menu on the left.
Under “Training provider”, select “LTI 1.3”.
Click “Add content provider”.
Fill in all the required fields. You can get this information from the other LMS.
Field name in Rakoo | Description | Also known as |
Name | A recognisable name for the integration, so you can identify which external system it refers to. You can choose this name yourself. | - |
OIDC URL | The web address used to allow users to log in securely via the other system. | Also known as 'Initiate login URL'. |
JWKS URL | The web address where the system verifies that messages are secure and reliable. | Also known as 'Public keyset URL'. |
Redirect URIs | The web addresses in our system to which a user is automatically redirected after logging in. | Also known as 'Redirection URI(s)'. |
5. Set the integration to “Activated” and save.
6. The information listed under “Details for the other party” can be added to the LTI integration in the other learning system.
Field name in Rakoo | Description | Also known as |
Tool client ID | A unique identifier of the other system within this integration. | Also known as 'Application ID'. |
Tool deployment ID | A unique code indicating which integration is used between the two systems. | Also known as 'Deployment ID'. |
Issuer | The unique identifier indicating which system the LTI launch originates from. | Also known as 'Platform ID'. |
OIDC URL | The web address used to allow users to log in securely via the other system. | Also known as 'Authentication request URL'. |
Access Token URL | The web address used to temporarily access the other system. | Also known as 'OAuth2 Access Token URL'. |
JWKS URL | The web address where the system verifies that messages are secure and reliable | Also known as 'Public keyset URL'. |
Step 2: Create the learning activity in Rakoo
When creating a new e-learning course, select LTI.
Fill in the details of the learning activity, such as title, study time, and description.
In the settings, under LTI, select LTI 1.3.
In the settings, enter the LTI details. You’ll need to request this information from the other LMS.
Select the “Tool” you created in the previous steps.
Enter the Resource URL.
Optionally, you can enter additional parameters (see LTI parameters below).
Save the changes.
LTI exam
In Rakoo, you can make an external e-learning available via LTI. You can also add an external activity as an exam in Rakoo. To do this, follow the steps below.
When creating a new learning activity, select “Exam” and then choose LTI.
Follow the steps described above to make an external activity available from Rakoo.
In the activity settings, set a minimum score. This must be between 1 and 100.
The result of the learning activity will be displayed in Rakoo as “failed” or “passed”, in contrast to “completed” for an e-learning course.
LTI parameters
It’s important that the other LMS sends certain information through the LTI integration. This information is needed for users to be able to use the learning activities successfully. Most LTI integrations with other systems are set up correctly by default. For example, with systems like Moodle, you don’t need to change anything, as the correct information is already sent.
Are you using a custom LTI integration? Then it’s important to check that the information (parameters) below is sent correctly.
Field name | LTI parameter key | Required? | Used for? |
lis_person_contact_email_primary | Yes | Finding an existing user or creating a new user. | |
First name | lis_person_name_given | Yes | Creating a new user if they don’t exist yet. |
Last name | lis_person_name_family | Yes | Creating a new user if they don’t exist yet. |
User id | user_id | Yes | Creating a new user if they don’t exist yet. The external ID is used as the user’s ID in your online academy. |
When adding a custom parameter, you always enter a key and a value. You can choose to fill in both fields yourself, or enter the key yourself and have the value always be a variable value from the academy. In that case, the key matches the name of this parameter in the other LMS, and you select the value that’s sent for it. For example, if you choose ‘Department’ as the value, the user’s department is always sent to the other LMS for this parameter.
Example
The Resource URL (LTI 1.3) or Launch URL (LTI 1.2) specifies which training from the other LMS is linked. Some learning environments use a generic URL for this and point to the specific activity through parameters. In that case, you’ll also need to add these parameters in Rakoo. For example: key = courseid, value = the specific ID.