#IMS Global - LTI™ Utilities
LTI™ Utilities are a set of utility classes to aid in the development of LTI v1.0 consumers and providers. They deal with much of the heavy lifting and make the process more opaque to the developer.
With Maven:
Include in your project's pom.xml:
<dependency>
<groupId>org.imsglobal</groupId>
<artifactId>basiclti-util</artifactId>
<version>1.1.2</version>
</dependency>This library provides support for:
Tool Providers:
- Verifying an LTI launch request
- Sending LTI 1.1 Outcomes request (xml-based)
- AspectJ launch verifiers for easy integration with Spring-web.
Tool Consumerss:
- Creating a valid LTI launch request
Some exploratory support for LTIv2:
- Parsing Tool Profiles
- Validating Tool Capabilities & Services
Verifying an LTI launch request.
HttpServletRequest request; // java servlet request
LtiVerifier ltiVerifier = new LtiOauthVerifier();
String key = request.getParameter("oauth_consumer_key");
String secret = // retrieve corresponding secret for key from db
LtiVerificationResult ltiResult = ltiVerifier.verify(request, secret);Sending LTI 1.1 Outcomes request (xml-based).
//send Request directly
IMSPOXRequest.sendReplaceResult(url, key, secret, sourcedid, score);
//or build the request to send later:
HttpPost request = IMSPOXRequest.buildReplaceResult(url, key, secret, sourcedid, score, true);AspectJ launch verifiers for easy integration with Spring-web.
Spring Controller (LTI Producer):
@Lti
@RequestMapping(value = "/lti", method = RequestMethod.POST)
public String ltiEntry(HttpServletRequest request, LtiVerificationResult result) {
if(!result.getSuccess()){
return "error";
} else {
return "success";
}
}KeyService Implementation:
public class MockKeyService implements LtiKeySecretService {
public String getSecretForKey(String key) {
return "secret";
}
}Spring Context xml:
<aop:aspectj-autoproxy/>
<bean id="myAspect" class="org.imsglobal.aspect.LtiLaunchVerifier">
<constructor-arg>
<bean class="com.example.MockKeyService"/>
</constructor-arg>
</bean>Building an LTI launch request.
LtiSigner ltiSigner = new LtiOauthSigner();
Map<String, String> signedParameters = signParameters(parameters, key, secret, url, "POST");© 2014 IMS Global Learning Consortium, Inc. All Rights Reserved.