Skip to main content

Receiving your first launch

If you are reading this, you have successfully registered your tool with an LMS. Now you are ready to receive to your first LTI® Launch.

The LTIAAS launch redirection

LTIAAS Launch

When a user clicks on a link to your tool in the LMS, LTIAAS will receive a launch request and perform the LTI® protocol handshake on your behalf. After both parties' identities are verified, LTIAAS will redirect the user to your application's registered target launch URL.

You can also add any query parameters you want to the LTIAAS launch URL, as they will be passed along to your application's registered target launch URL during subsequent LTI® launches.

Content item URL:

https://your.ltiaas.com/lti/launch?resource=123

Final target URL after LTI® launch:

https://your.application.com/your-launch-endpoint?resource=123

tip

These parameters can be used to identify which of your application's resources is linked to a certain activity. You can check our Deep Linking guide to know more about this.

Dealing with errors during the launch

If you run into any errors during your launch process, please check our troubleshooting section.

Next steps

Now that you have successfully received your first LTI® launch, here are a few possibilities to expand your LTI® integration even further:

Display a simple tool

This is our most basic use case, you just want to display a simple tool to the user, without any authentication or context based customization. No additional work is needed to achieve this. After LTIAAS redirects the user to your application, all you need to do is display the content you want users to see.

Retrieve the ID Token and perform SSO

The ID Token is the main piece of data in the LTI® protocol, it's sent by the LMS to the LTI® tool and contains information regarding the current LTI® launch, this includes user information, LMS information, launch context information and everything you need to use the many LTI® services.

You can use the information contained in the ID Token to perform SSO and authenticate users into your application, automatically logging them into a preexisting account or provisioning a new one on the spot. To learn more about this, please check our Retrieving ID Token guide and its Performing SSO section.

tip

Besides performing SSO, you can also use the ID Token information to customize your tool's UI or content based on the LMS, course, and/or user role.

Retrieve roster information

The LTI® protocol allows you to retrieve roster information for an LMS context through the Names and Roles Provisioning service. LTIAAS gives you access to this service through the Memberships API endpoint. To learn more about this functionality, please check our Retrieving course roster guide.

Manipulate user grades

The LTI® protocol allows you to manipulate user's grades and LMS grade lines through the Assignment and Grades service. LTIAAS gives you access to this service through the Line Items API endpoint. To learn more about this functionality, please check our Manipulating grade lines guide and Manipulating grades guide.

Serving multiple resources through your tool

If your application is a hub of multiple resources and/or activities, the LTI® protocol makes this easy to manage through the Deep Linking service. You can use this service to allow teachers and administrators to select one specific resource from your application when creating an activity in the LMS. LTIAAS gives you access to this service through the Deep Linking flow and API endpoint. To learn more about this functionality, please check our Performing Deep Linking guide.

All trademarks, logos, and service marks displayed on this website are the property of their respective owners. LTIAAS is a trademark of GatherAct, LLC, doing business as LTIAAS. Learning Tools Interoperability (LTI)® and LTI® are trademarks of 1EdTech Consortium, Inc. LTIAAS is not affiliated with, endorsed or sponsored by 1EdTech Consortium, Inc. or by any other owners of third-party trademarks used on this website. LTIAAS is not responsible for the content, quality, or accuracy of any websites linked to or from this website that are not owned by LTIAAS. If you have any questions or concerns about the use of any trademarks or content on this website, please contact us.