History

Fabien "egg" O'Carroll 918db79aa8 Published new versions - @tryghost/limit-service@1.1.0 - @tryghost/mw-error-handler@0.2.2 - @tryghost/mw-session-from-token@0.1.30 - @tryghost/session-service@0.1.40 - @tryghost/vhost-middleware@1.0.24		2022-04-27 11:24:20 +01:00
..
lib
test	Remove trailing commas from .eslintrc.js files	2020-08-04 14:48:07 +01:00
types	Added newly generated TypeScript definiton files	2021-04-07 13:41:49 +12:00
.eslintignore
.eslintrc.js	Remove trailing commas from .eslintrc.js files	2020-08-04 14:48:07 +01:00
index.js
LICENSE	2022	2022-01-06 09:52:35 +00:00
package.json	Published new versions	2022-04-27 11:24:20 +01:00
README.md	2022	2022-01-06 09:52:35 +00:00
tsconfig.json	Stopped type declaration files from being generated	2021-07-14 11:51:14 +01:00

README.md

Session From Token Middleware

Middleware to handle generating sessions from tokens, for example like with magic links, or SSO flows similar to SAML.

Install

npm install @tryghost/mw-session-from-token --save

yarn add @tryghost/mw-session-from-token

Usage

const sessionFromTokenMiddleware = require('@tryghost/mw-session-from-token')({
    callNextWithError: true,
    async createSession(req, res, user) {
        req.session.user_id = user.id;
    },
    async getTokenFromRequest(res) {
        return req.headers['some-cool-header'];
    },
    async getLookupFromToken(token) {
        await someTokenService.validate(token);
        const data = await someTokenService.getData(token);
        return data.email;
    },
    async findUserByLookup(lookup) {
        return await someUserModel.findOne({email: lookup});
    }
});

someExpressApp.get('/some/sso/url', someSessionMiddleware, sessionFromTokenMiddleware, (req, res, next) => {
    res.redirect('/loggedin');
}, (err, res, res, next) => {
    res.redirect('/error');
});

Develop

This is a mono repository, managed with lerna.

Follow the instructions for the top-level repo.

git clone this repo & cd into it as usual
Run yarn to install top-level dependencies.

Run

yarn dev

Test

yarn lint run just eslint
yarn test run lint and tests