Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/1EdTech/basiclti-util-java
https://github.com/1EdTech/basiclti-util-java
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/1EdTech/basiclti-util-java
- Owner: 1EdTech
- License: apache-2.0
- Created: 2014-07-23T15:06:20.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2022-11-16T03:51:43.000Z (over 1 year ago)
- Last Synced: 2024-04-15T02:07:01.251Z (2 months ago)
- Language: Java
- Size: 175 KB
- Stars: 56
- Watchers: 18
- Forks: 43
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-lti - LTI 1.1 `basiclti-util`
- awesome-lti - LTI 1.1 `basiclti-util`
README
#IMS Global - LTI™ Utilities
[](https://travis-ci.org/pfgray/basiclti-util-java)
What is it?
-----------
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.
How to use:
-----------
With Maven:
Include in your project's `pom.xml`:
```xml
org.imsglobal
basiclti-util
1.1.2
```
This library provides support for:
**Tool Providers**:
1. Verifying an LTI launch request
2. Sending LTI 1.1 Outcomes request (xml-based)
3. AspectJ launch verifiers for easy integration with Spring-web.
**Tool Consumers**s:
1. Creating a valid LTI launch request
Some exploratory support for LTIv2:
1. Parsing Tool Profiles
2. Validating Tool Capabilities & Services
LTI Providers:
----
**Verifying an LTI launch request.**
```java
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).**
```java
//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):
```java
@Lti
@RequestMapping(value = "/lti", method = RequestMethod.POST)
public String ltiEntry(HttpServletRequest request, LtiVerificationResult result) {
if(!result.getSuccess()){
return "error";
} else {
return "success";
}
}
```
KeyService Implementation:
```java
public class MockKeyService implements LtiKeySecretService {
public String getSecretForKey(String key) {
return "secret";
}
}
```
Spring Context xml:
```xml
```
LTI Consumers:
----
**Building an LTI launch request.**
```java
LtiSigner ltiSigner = new LtiOauthSigner();
Map signedParameters = signParameters(parameters, key, secret, url, "POST");
```
Contributing:
-------------
You are welcome to contribute code to this work, but before we accept your PR, must sign a Contributors Agreement. To request a Contributors Agreement, please contact [email protected]
© 2014 IMS Global Learning Consortium, Inc. All Rights Reserved.