Security & Access Control

Authentication & Dual-Token Extraction

How create-modern-mern-app combines secure browser HTTP-only cookies with standard Bearer authorization headers for Postman, Thunder Client, and mobile clients.

1. Dual-Token Architecture

In server/src/middlewares/requireToken.js, the authentication middleware inspects the incoming request with zero friction:

requireToken Middleware
typescript
export const requireToken = async (req, res, next) => {
  // 1. Check for standard Authorization: Bearer 
  const authHeader = req.headers.authorization;
  let token = (typeof authHeader === 'string' && authHeader.startsWith('Bearer '))
    ? authHeader.slice(7).trim()
    : null;

  // 2. Fall back to secure HTTP-only browser cookie
  if (!token) {
    const cookie = (req.headers.cookie || '')
      .split(';')
      .map(v => v.trim())
      .find(v => v.startsWith(cookieName + '='));
    if (cookie) token = cookie.slice(cookieName.length + 1);
  }

  if (!token) {
    res.status(401).json({ message: 'Sign in to continue.' });
    return;
  }

  try {
    const payload = verifyToken(token);
    const rawSub = payload.sub || payload.id;
    const user = await getUserById(rawSub);
    if (!user) {
      res.status(401).json({ message: 'Account no longer exists.' });
      return;
    }

    // Attach decoded user to both req.user and res.locals.user
    req.user = user;
    res.locals.user = user;
    next();
  } catch {
    res.status(401).json({ message: 'Sign in to continue.' });
  }
};

2. Role Authorization (`requireRole`)

The requireRole middleware supports both single role strings and arrays of permitted roles:

Protecting endpoints with requireRole
javascript
import { Router } from 'express';
import { requireToken } from '../middlewares/requireToken.js';
import { requireRole } from '../middlewares/requireRole.js';
import { getUsers } from '../controllers/api.controller.js';

const router = Router();

// Member or Admin access
router.get('/profile', requireToken, (req, res) => {
  res.json({ success: true, user: req.user });
});

// Admin-only access
router.get('/users', requireToken, requireRole('admin'), getUsers);

// Multi-role access
router.get('/analytics', requireToken, requireRole(['admin', 'member']), getAnalytics);

3. Login & Registration Controllers

Controllers return explicit developer-friendly payloads while attaching the session cookie:

POST /api/auth/login Response Payload
json
{
  "success": true,
  "message": "User logged in successfully",
  "user": {
    "id": "67341ad626e2a5f1e81f1234",
    "name": "Jane Developer",
    "email": "jane@example.com",
    "role": "member",
    "createdAt": "2026-11-13T00:00:00.000Z"
  },
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}