Adds an /admin route, visible only to users with role=admin, that lets an operator manage the user base from the UI: - list / search users (active + inactive) - create new accounts (with role and optional display name) - reset a user's password - promote/demote between admin and member - deactivate / reactivate (soft-delete via is_active flag) Backend changes: - New adminOrApiKeyMiddleware accepts EITHER a Bearer JWT belonging to a role=admin user (UI path) OR the existing X-API-Key (bot/server-to-server). - Existing /api/admin/* routes switched to the hybrid middleware, so the same endpoints serve both the dashboard and any external scripts. - Added PUT /api/admin/users/:id/role and PUT /api/admin/users/:id/reactivate. - Self-deactivation and self-demotion are explicitly blocked so an admin can't lock themselves out. Frontend changes: - New Admin.tsx page (table view, modals for create + reset, toast feedback). - Admin button in CollectionList header, only rendered for admin role. - Wired into App.tsx routing. Also: friendly error when poppler-utils is missing on the host (PDF uploads return 501 POPPLER_MISSING with a one-line install hint instead of crashing the request); README clarifies poppler is required for the manual install.
127 lines
3.5 KiB
JavaScript
127 lines
3.5 KiB
JavaScript
const jwt = require('jsonwebtoken');
|
|
const bcrypt = require('bcryptjs');
|
|
|
|
const JWT_SECRET = process.env.JWT_SECRET || (() => {
|
|
if (process.env.NODE_ENV === 'production') {
|
|
throw new Error('JWT_SECRET environment variable is required in production');
|
|
}
|
|
return 'refboard-dev-secret-do-not-use-in-prod';
|
|
})();
|
|
|
|
const JWT_EXPIRES_IN = process.env.JWT_EXPIRES_IN || '7d';
|
|
const BCRYPT_ROUNDS = 12;
|
|
const REFBOARD_API_KEY = process.env.REFBOARD_API_KEY || '';
|
|
|
|
function generateToken(user) {
|
|
return jwt.sign(
|
|
{ id: user.id, email: user.email, role: user.role, username: user.username, display_name: user.display_name },
|
|
JWT_SECRET,
|
|
{ expiresIn: JWT_EXPIRES_IN }
|
|
);
|
|
}
|
|
|
|
function verifyToken(token) {
|
|
return jwt.verify(token, JWT_SECRET);
|
|
}
|
|
|
|
async function hashPassword(password) {
|
|
return bcrypt.hash(password, BCRYPT_ROUNDS);
|
|
}
|
|
|
|
async function comparePassword(password, hash) {
|
|
return bcrypt.compare(password, hash);
|
|
}
|
|
|
|
/**
|
|
* Express middleware: validates Bearer token from Authorization header.
|
|
* Attaches decoded user to req.user.
|
|
*/
|
|
function authMiddleware(req, res, next) {
|
|
try {
|
|
const authHeader = req.headers.authorization;
|
|
if (!authHeader || !authHeader.startsWith('Bearer ')) {
|
|
return res.status(401).json({ error: 'Authentication required' });
|
|
}
|
|
|
|
const token = authHeader.slice(7);
|
|
const decoded = verifyToken(token);
|
|
req.user = decoded;
|
|
next();
|
|
} catch (err) {
|
|
if (err.name === 'TokenExpiredError') {
|
|
return res.status(401).json({ error: 'Token expired' });
|
|
}
|
|
return res.status(401).json({ error: 'Invalid token' });
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Express middleware: checks that authenticated user has admin role.
|
|
* Must be used after authMiddleware.
|
|
*/
|
|
function adminMiddleware(req, res, next) {
|
|
if (!req.user || req.user.role !== 'admin') {
|
|
return res.status(403).json({ error: 'Admin access required' });
|
|
}
|
|
next();
|
|
}
|
|
|
|
/**
|
|
* Express middleware: validates X-API-Key header against REFBOARD_API_KEY env var.
|
|
* Used for admin/bot API routes.
|
|
*/
|
|
function apiKeyMiddleware(req, res, next) {
|
|
const apiKey = req.headers['x-api-key'];
|
|
if (!REFBOARD_API_KEY) {
|
|
return res.status(503).json({ error: 'API key not configured on server' });
|
|
}
|
|
if (!apiKey || apiKey !== REFBOARD_API_KEY) {
|
|
return res.status(401).json({ error: 'Invalid or missing API key' });
|
|
}
|
|
next();
|
|
}
|
|
|
|
/**
|
|
* Express middleware: accepts EITHER a valid X-API-Key (server-to-server / bot)
|
|
* OR a Bearer JWT belonging to a user with role=admin (UI dashboard).
|
|
*
|
|
* On JWT path: attaches decoded user to req.user.
|
|
*/
|
|
function adminOrApiKeyMiddleware(req, res, next) {
|
|
const apiKey = req.headers['x-api-key'];
|
|
if (apiKey && REFBOARD_API_KEY && apiKey === REFBOARD_API_KEY) {
|
|
return next();
|
|
}
|
|
|
|
const authHeader = req.headers.authorization;
|
|
if (authHeader && authHeader.startsWith('Bearer ')) {
|
|
try {
|
|
const decoded = verifyToken(authHeader.slice(7));
|
|
if (decoded.role !== 'admin') {
|
|
return res.status(403).json({ error: 'Admin access required' });
|
|
}
|
|
req.user = decoded;
|
|
return next();
|
|
} catch (err) {
|
|
if (err.name === 'TokenExpiredError') {
|
|
return res.status(401).json({ error: 'Token expired' });
|
|
}
|
|
return res.status(401).json({ error: 'Invalid token' });
|
|
}
|
|
}
|
|
|
|
return res.status(401).json({ error: 'Admin authentication required' });
|
|
}
|
|
|
|
module.exports = {
|
|
generateToken,
|
|
verifyToken,
|
|
hashPassword,
|
|
comparePassword,
|
|
authMiddleware,
|
|
adminMiddleware,
|
|
apiKeyMiddleware,
|
|
adminOrApiKeyMiddleware,
|
|
JWT_SECRET,
|
|
};
|