Roles de administración

Parte de la sección Autenticación y seguridad del Journey de Node.js de Coddy. Lección 19 de 24.

GET /admin solo comprueba que alguien haya iniciado sesión, así que todos los miembros pueden verlo. Un rol almacenado en el usuario, como 'member' o 'admin', indica qué puede hacer. Una fábrica de middleware, es decir, una función que devuelve un middleware, comprueba un rol por ruta:

function requirePlan(plan) {
    return (req, res, next) => {
        if (req.user.plan !== plan) {
            return res.status(402).json({ error: `Needs the ${plan} plan` });
        }
        next();
    };
}

app.get('/exports', requireUser, requirePlan('pro'), sendExports);

El servidor siempre establece el rol. El registro copia únicamente los campos que espera de req.body, así que un visitante que envíe "role": "admin" no consigue nada con ello.

Desafío

Fácil

GET /admin muestra cuántas cuentas existen, y ahora mismo todos los miembros que han iniciado sesión pueden verlo. Solo deberían verlo los administradores. Cada usuario recibe un rol, asignado por el servidor, y la ruta lo comprueba.

En server.js, en POST /signup, guarda a cada usuario nuevo con "role": "member". Nunca tomes el rol del cuerpo de la solicitud: un visitante que envíe "role": "admin" seguirá convirtiéndose en miembro.
Escribe una función requireRole(role) que devuelva un middleware. Ese middleware comprueba req.user.role:
- Cuando no sea role, responde con el estado 403 y {"error": "Not allowed"}. 403 Forbidden significa que el servidor sabe quién eres, pero no tienes permiso para hacer esto. 401 significa que no sabe quién eres.
- Cuando sea role, llama a next().
Añade requireRole('admin') a GET /admin, después de requireUser. Lee req.user, que solo establece requireUser.

El servidor ya crea una cuenta de administrador cuando se inicia. Su nombre de usuario es admin, y su contraseña es admin-pass-for-tests, que proviene de la variable de entorno ADMIN_PASSWORD.

Pruébalo: Pulsa «Ejecutar». Envía GET /admin: estado 401 y {"error": "Log in first"}. Ahora un usuario llamado mallory intenta hacerse administradora. Envía POST /signup con {"username": "mallory", "password": "correct horse", "role": "admin"}, y luego POST /login con {"username": "mallory", "password": "correct horse"}. Envía GET /admin: estado 403 y {"error": "Not allowed"}, porque el campo adicional no la convirtió en administradora. Envía POST /login con {"username": "admin", "password": "admin-pass-for-tests"}, y luego GET /admin: {"users": 2}.

Pruébalo tú mismo

import express from 'express';
import { ObjectId } from 'mongodb';
import { randomBytes } from 'node:crypto';
import { parseCookies } from './cookies.js';
import { notes, sessions, users } from './db.js';
import { hashPassword, verifyPassword } from './passwords.js';

const app = express();
app.use(express.json());

// La única cuenta de administrador. Su contraseña se obtiene del entorno.
await users.insertOne({ username: 'admin', role: 'admin', passwordHash: await hashPassword(process.env.ADMIN_PASSWORD) });

app.post('/signup', async (req, res) => {
    const username = String(req.body.username ?? '').trim().toLowerCase();
    const password = String(req.body.password ?? '');
    if (!username || password.length < 8) {
        return res.status(400).json({ error: 'Pick a username and a password of at least 8 characters' });
    }
    if (await users.findOne({ username })) {
        return res.status(409).json({ error: 'That username is taken' });
    }
    await users.insertOne({ username, passwordHash: await hashPassword(password) });
    res.status(201).json({ username });
});

app.post('/login', async (req, res) => {
    const username = String(req.body.username ?? '').trim().toLowerCase();
    const user = await users.findOne({ username });
    if (!user || !(await verifyPassword(String(req.body.password ?? ''), user.passwordHash))) {
        return res.status(401).json({ error: 'Wrong username or password' });
    }
    const sid = randomBytes(24).toString('base64url');
    await sessions.insertOne({ _id: sid, userId: user._id, createdAt: new Date() });
    res.cookie('sid', sid, {
        httpOnly: true,
        sameSite: 'lax',
        secure: true,
        maxAge: 24 * 60 * 60 * 1000,
    });
    res.json({ username: user.username });
});

// Busca al usuario asociado a la cookie de sesión o responde con 401.
async function requireUser(req, res, next) {
    const { sid } = parseCookies(req.get('cookie'));
    const session = sid && (await sessions.findOne({ _id: sid }));
    const user = session && (await users.findOne({ _id: session.userId }));
    if (!user) {
        return res.status(401).json({ error: 'Log in first' });
    }
    req.user = { id: user._id.toHexString(), username: user.username, role: user.role };
    next();
}

app.get('/me', requireUser, (req, res) => {
    res.json({ username: req.user.username });
});

app.post('/logout', async (req, res) => {
    const { sid } = parseCookies(req.get('cookie'));
    if (sid) {
        await sessions.deleteOne({ _id: sid });
    }
    res.clearCookie('sid');
    res.status(204).end();
});

// Tus notas en una página.
app.get('/', requireUser, async (req, res) => {
    const list = await notes.find({ owner: req.user.id }).toArray();
    const items = list.map((note) => `<li>${note.text}</li>`).join('');
    res.send(`<!doctype html><title>Vault</title><h1>${req.user.username}'s notes</h1><ul>${items}</ul>`);
});

// Notas: cada usuario solo lee y escribe las suyas.
app.get('/notes', requireUser, async (req, res) => {
    res.json(await notes.find({ owner: req.user.id }).toArray());
});

app.post('/notes', requireUser, async (req, res) => {
    const note = { owner: req.user.id, text: String(req.body.text ?? '') };
    await notes.insertOne(note);
    res.status(201).json(note);
});

app.get('/notes/:id', requireUser, async (req, res) => {
    if (!ObjectId.isValid(req.params.id)) {
        return res.status(404).json({ error: 'Note not found' });
    }
    const note = await notes.findOne({ _id: new ObjectId(req.params.id), owner: req.user.id });
    if (!note) {
        return res.status(404).json({ error: 'Note not found' });
    }
    res.json(note);
});

app.delete('/notes/:id', requireUser, async (req, res) => {
    if (!ObjectId.isValid(req.params.id)) {
        return res.status(404).json({ error: 'Note not found' });
    }
    const { deletedCount } = await notes.deleteOne({ _id: new ObjectId(req.params.id), owner: req.user.id });
    if (!deletedCount) {
        return res.status(404).json({ error: 'Note not found' });
    }
    res.status(204).end();
});

// Para administradores: cuántas cuentas hay.
app.get('/admin', requireUser, async (req, res) => {
    res.json({ users: await users.countDocuments() });
});

app.listen(3000, () => {
    console.log('Vault is running on port 3000');
});

Todas las lecciones de Autenticación y seguridad

Practica por tu cuenta: Playground de Express