https://github.com/samueldonovan1701/express-cookie-session-auth

NodeJS module for handling authentication and authorization using session tokens and cookies on an express web server
https://github.com/samueldonovan1701/express-cookie-session-auth

authentication cookies express nodejs sessions

Last synced: 6 months ago
JSON representation

NodeJS module for handling authentication and authorization using session tokens and cookies on an express web server

• Host: GitHub
• URL: https://github.com/samueldonovan1701/express-cookie-session-auth
• Owner: samueldonovan1701
• License: other
• Created: 2022-01-29T18:11:56.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2022-12-11T03:19:45.000Z (over 3 years ago)
• Last Synced: 2025-09-20T07:43:06.125Z (10 months ago)
• Topics: authentication, cookies, express, nodejs, sessions
• Language: JavaScript
• Homepage: https://github.com/samueldonovan1701/express-auth/wiki
• Size: 42 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# express-cookie-session-auth

`express-cookie-session-auth` is a simple, customizable authentication and authorization manager for express-based applications.

While `express-cookie-session-auth` provides default in-memory user, group, and session managers, these can easily be overridden with developer-provided interfaces.



    GitHub

    Wiki

    npm

    Report an Issue

    Author: Samuel Donovan

    License: Creative Commons Attribution-ShareAlike 3.0 United States License

# Install

TODO: put on npm



npm install express-cookie-session-auth



# Setup



const express = require('express');

const app = express();


app.use(express.json()); //Not always needed

const cookieParser = require('cookie-parser');

app.use(cookieParser("secret"));

const auth = require('express-cookie-session-auth');

app.use(auth);



# Examples

### Get User



app.get('/', (req, res) => {

    if(req.user)

        res.send(`Logged in as ${req.user.id}`);

    else

        res.send(`Not logged in`);

});



### Users & Groups



auth.users.add("John Doe", "password1234", {

    address: "1234 Main St.",

    phone: "(000)000-000"

});


auth.groups.new("example group", ["John Doe"]);

console.log(auth.users.get("John Doe");

console.log(auth.groups.with("John Doe");



### Logging in/out



app.post('/login', (req, res) => {

    let username = req.body.username;

    let password = req.body.username;

    let loggedIn = auth.login(req, res, username, password);

    ...

});


app.post('/logout', (req, res) => {

    let loggedOut = auth.logout(req, res);

    ...

});



### Restricting Access



app.use("/admin", auth.onlyUsers("admin"));


app.use("/manage-users", auth.onlyGroups("managers"));



# Dependencies


### Express

`express-cookie-session-auth` is built specifically to be used with Express web framework for Node.js

Express is distributed under the Creative commons license.

### cookie-parser

`express-cookie-session-auth` uses cookies to track sessions, and `cookie-parser` makes this easier, as well as allow for the use of signed cookies.

`cookie-parser` is distributed under the MIT license.

### express.json() (optional)

Used by the `auth.login.endpoint` for the username and password. Does not need to be used if `auth.login.endpoint` is never used.

This module is included with Express.

# License

This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 United States License.