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..."
}