secure-csrf v1.0.1

Secure CSRF

secure-csrf

CSRF protection for Node JS Applications. Built with TypeScript and ESM.

This package is updated version of csrf package. It includes types and new uid package is used to generate uid/secure secret.

Installation

You can install csrf-tokens package with popular package managers for NodeJS.

npm npm install csrf-tokens --save

yarn yarn add csrf-tokens

pnpm pnpm install csrf-tokens

Usage

In order to use this package, create a secret key for each user and store it securely for short amount of time.

Available methods

secret

Asyncronous method, that generates secure uuid and returns it. Should be awaited.

import express, { Request, Response, NextFunction } from 'express';
import CSRF from 'csrf-tokens';

const app = express();

app.use(async(req: Request, res: Response, next: NextFunction) => {
    try {
        const csrf = new CSRF();
        const secret = await csrf.secret();
        next();
    } catch(error) {
       return next(error);
    }
}); 

Create CSRF Token

import CSRF from 'csrf-tokens';

const csrf = new CSRF();

const token = csrf.create(secret);

import express, { Request, Response, NextFunction } from 'express';
import CSRF from 'csrf-tokens';

const app = express();

app.use(async(req: Request, res: Response, next: NextFunction) => {
    try {
        const csrf = new CSRF();
        const secret = await csrf.secret();
        const token = csrf.create(secret);
        next();
    } catch(error) {
       return next(error);
    }
}); 

Verify CSRF Token

import CSRF from 'csrf-tokens';

const csrf = new CSRF();

const token = csrf.verify(secret, token);

import express, { Request, Response, NextFunction } from 'express';
import CSRF from 'csrf-tokens';

const app = express();

app.use(async(req: Request, res: Response, next: NextFunction) => {
    try {
        const csrf = new CSRF();
        const secret = await csrf.secret();
        csrf.verify(req.session.secret, req.body.token);
        next();
    } catch(error) {
       return next(error);
    }
});