cocolico14 / ltijs

Turn your application into a fully integratable LTI 1.3 tool provider.

Home Page:https://cvmcosta.github.io/ltijs/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool



IMS Global Certified

Easily turn your web application into a LTI® 1.3 Learning Tool.

travisci codecov Node Version NPM package NPM downloads dependencies Status devDependencies Status JavaScript Style Guide APACHE2 License Donate

Please ⭐️ us on GitHub, it always helps!

Ltijs is LTI® Advantage Complete Certified by IMS

Ltijs is the first LTI Library to implement the new LTI® Advantage Dynamic Registration Service, now supported by Moodle 3.10. The Dynamic Registration Service turns the LTI Tool registration flow into a fast, completely automatic process.

v5.7 - D2L Hotfix

  • Created new authorizationServer Platform registration field used as the aud claim for requesting access tokens. Platform methods usage is unchanged.
  • Create new platformAuthorizationServer Platform method to retrieve or set the authorization server. Value defaults to the access token endpoint.

v5.6 - Breaking Changes

  • Removed invalidToken and sessionTimeout routes, Ltijs no longer redirects to error routes, it simply calls the handler methods onInvalidToken and onSessionTimeout.
  • Error handlers sill work in the exact same way.
  • Fixed a spelling error in the Dynamic Registration Service that caused Ltijs to be unable to identify the LMS Family. Big Thanks to @lselden for the pull request!

Table of Contents


Introduction

The Learning Tools Interoperability (LTI®) protocol is a standard for integration of rich learning applications within educational environments. ref

This library implements a tool provider as an Express server, with preconfigured routes and methods that manage the LTI® 1.3 protocol for you. Making it fast and simple to create a working learning tool with access to every LTI® service, without having to worry about manually implementing any of the security and validation required to do so.


Feature roadmap

Feature Implementation Documentation
Keyset endpoint support ✔️ ✔️
Deep Linking Service Class ✔️ ✔️
Grading Service Class ✔️ ✔️
Names and Roles Service Class ✔️ ✔️
Dynamic Registration Service ✔️ ✔️
Database plugins ✔️ ✔️
Revised usability tutorials
Key Rotation
Redis caching

Installation

Installing the package

$ npm install ltijs

MongoDB

This package natively uses mongoDB by default to store and manage the server data, so you need to have it installed, see link bellow for further instructions.

Database Plugins

Ltijs can also be used with other databases through database plugins that use the same structure as the main database class.

Ltijs-sequelize version Ltijs version
^2.4.0 ^5.7.0
^2.3.0 ^5.5.0
^2.2.0 ^5.3.0

Quick start

Setting up Ltijs

const path = require('path')

// Require Provider 
const lti = require('ltijs').Provider

// Setup provider
lti.setup('LTIKEY', // Key used to sign cookies and tokens
  { // Database configuration
    url: 'mongodb://localhost/database',
    connection: { user: 'user', pass: 'password' }
  },
  { // Options
    appRoute: '/', loginRoute: '/login', // Optionally, specify some of the reserved routes
    cookies: {
      secure: false, // Set secure to true if the testing platform is in a different domain and https is being used
      sameSite: '' // Set sameSite to 'None' if the testing platform is in a different domain and https is being used
    },
    devMode: true // Set DevMode to false if running in a production environment with https
  }
)

// Set lti launch callback
lti.onConnect((token, req, res) => {
  console.log(token)
  return res.send('It\'s alive!')
})

const setup = async () => {
  // Deploy server and open connection to the database
  await lti.deploy({ port: 3000 }) // Specifying port. Defaults to 3000

  // Register platform
  await lti.registerPlatform({
    url: 'https://platform.url',
    name: 'Platform Name',
    clientId: 'TOOLCLIENTID',
    authenticationEndpoint: 'https://platform.url/auth',
    accesstokenEndpoint: 'https://platform.url/token',
    authConfig: { method: 'JWK_SET', key: 'https://platform.url/keyset' }
  })
}

setup()

Implementation example


Documentation

See bellow for the complete documentation:

Service documentations:

Additional documentation:


Contributing

Please ⭐️ us on GitHub, it always helps!

If you find a bug or think that something is hard to understand feel free to open an issue or contact me on twitter @cvmcosta, pull requests are also welcome :)

And if you feel like it, you can donate any amount through paypal, it helps a lot.

Buy Me A Coffee

Main contributors

Carlos Costa
Carlos Costa

💻💬 📖 👀 📢
Lucas Terças
Lucas Terças

📖 🔧
Micael Gomes
Micael Gomes

🎨

Special thanks

I would like to thank the Federal University of Maranhão and UNA-SUS/UFMA for the support throughout the entire development process.


I would like to thank CourseKey for making the Certification process possible and allowing me to be an IMS Member through them, which will contribute immensely to the future of the project.


License

APACHE2 License

Learning Tools Interoperability® (LTI®) is a trademark of the IMS Global Learning Consortium, Inc. (https://www.imsglobal.org)

About

Turn your application into a fully integratable LTI 1.3 tool provider.

https://cvmcosta.github.io/ltijs/

License:Apache License 2.0


Languages

Language:JavaScript 100.0%