Skip to content

Cvmcosta/ltijs-sequelize

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation



IMS Global Certified

Ltijs Sequelize Database Plugin.

travisci codecov Node Version NPM package 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

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

V2.4.0

  • Added support for authorizationServer Platform field, introduced on version 5.7.0 of Ltijs.
  • Added support for automatic migrations. This will greatly increase flexibility.

V2.3.0

  • Added support for Dynamic Registration Service, introduced on version 5.5.0 of Ltijs.

Table of Contents


Introduction

This package allows Ltijs to work with the databases supported by Sequelize.

Tested with:

Database Tested
MySQL ✔️
PostgreSQL ✔️
MariaDB

Ltijs Compatibility:

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

Installation

$ npm install ltijs-sequelize

Usage

Setup the plugin just like you would a Sequelize instance.

  • database - Database name.
  • user - Database user.
  • pass - Database password.
  • options - Options as defined in the Sequelize constructor documentation. host and dialect fields are required.
    • host - Database host.
    • dialect - One of mysql, mariadb, postgres, mssql.
const path = require('path')

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

// Setup ltijs-sequelize using the same arguments as Sequelize's generic contructor
const db = new Database('database', 'user', 'password', 
  { 
    host: 'localhost',
    dialect: 'mysql',
    logging: false 
  })

// Setup provider
lti.setup('LTIKEY', // Key used to sign cookies and tokens
  { 
    plugin: db // Passing db object to plugin field
  },
  { // 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: false // Set DevMode to true if the testing platform is in a different domain and https is not being used
  }
)

// 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()

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

About

Ltijs Sequelize Database Plugin

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •