Сессия-промежуточное ПО для fibjs

Установка

npm install fib-session [--save]

Тестирование

npm run ci

Создание промежуточного ПО на основе файлов cookie

var Session = require('fib-session')
var session = new Session(conn, opts);

var srv = new http.Server(8000, [
    session.cookie_filter, // использовать идентификатор сессии через файл cookie
    {
        // маршрутизаторы
        '^/foo$': (r) => {
            var v = r.session.v;
        },
        ...
    }
]);

Создание API-промежуточного ПО

var Session = require('fib-session')
var session = new Session(conn, opts);

var srv = new http.Server(8000, [
    session.api_filter, // использовать API-фильтр сессии
    {
        // маршрутизаторы
        '^/foo$': (r) => {
            var v = r.session.v;
        },
        '^/get-token$': session.api_token
    }
]);

Параметры kv и параметры сессии находятся в одном объекте.

Параметры хранилища kv

Параметры сессии

• Сессия-кэш используется для поддержания согласованности сессий среди HTTP-запросов.

• Тайм-аут кэш-памяти сессии должен быть больше, чем его задержка.

• На стороне клиента есть только идентификатор сессии. Сессия управляется на стороне сервера.

Методы

session.setup()

настройка бэкенд-базы данных.

v = session.cookie_filter

возвращает фильтр сессии на основе файла cookie.

session.api_filter

возвращает API-фильтр сеанса.

session.api_token

возвращает обработчик API, который получает новый идентификатор сессии.

JSON Web Token (JWT)

Параметры | Параметры | По умолчанию | | | | | | --- | --- | --- | | session_jwt_algo | null | see jws.ALGORITHMS in fib-jws | | session_jwt_key | null | sign key. see in fib-jws |

— see fib-jws https://github.com/fibjs/fib-jws

— set session_jwt_algo и session_jwt_key для включения JWT:

// session_jwt_algo — это алгоритмы шифрования в fib-jws.
// session_jwt_key используется для проверки подписи.
var session = new Session(conn, { session_jwt_algo: 'HS256', session_jwt_key: verify_key })

Methods

session.setTokenCookie

— устанавливает JSON Web Token в cookie. — sign_key для подписи может отличаться от session_jwt_key в зависимости от алгоритма. — согласно спецификации JSON Web Token, один пользовательский сеанс может вызвать setTokenCookie только один раз для установки информации о пользовательском сеансе. Второй вызов вызовет исключение: new Error('Can't modify the JSON Web Token'). — значение по умолчанию r.session={}.

// подписывает информацию о пользователе: { id: 12345, name: "Frank" } и устанавливает cookie.
// r — запрос.
session.setTokenCookie(r, { id: 12345, name: "Frank" }, sign_key)

session.getToken

— получает токен для режима фильтрации API, см. session.api_filter.

session.getToken ({ id: 12345, name: "Frank" }, sign_key)