관리자 역할

Coddy Node.js 여정의 인증과 보안 섹션에 포함된 레슨. 24개 중 19번째.

GET /admin은 로그인했는지만 확인하므로 모든 회원이 이 경로에 접근할 수 있습니다. 사용자에게 저장된 역할(예: 'member' 또는 'admin')은 사용자가 무엇을 할 수 있는지 나타냅니다. 미들웨어를 반환하는 함수인 미들웨어 팩토리는 경로마다 역할 하나를 확인합니다.

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);

역할은 항상 서버에서 설정합니다. 회원가입 과정에서는 req.body에서 예상하는 필드만 복사하므로, "role": "admin"을 보내는 방문자는 이 값으로 아무런 권한도 얻지 못합니다.

챌린지

쉬움

GET /admin은 계정이 몇 개인지 보여 주며, 현재는 로그인한 모든 회원이 이를 볼 수 있습니다. 관리자만 볼 수 있어야 합니다. 각 사용자에게는 서버가 설정하는 역할이 부여되고, 경로는 그 역할을 확인합니다.

server.js의 POST /signup에서 새 사용자는 모두 "role": "member"로 저장합니다. 요청 본문에서 역할을 가져오지 마세요. "role": "admin"을 보내는 방문자도 회원이 됩니다.
미들웨어를 반환하는 함수 requireRole(role)을 작성하세요. 이 미들웨어는 req.user.role을 확인합니다.
- 값이 role이 아니면 상태 코드 403과 {"error": "Not allowed"}로 응답합니다. 403 Forbidden은 서버가 사용자가 누구인지는 알지만, 이 작업은 허용되지 않는다는 뜻입니다. 401은 서버가 사용자가 누구인지 모른다는 뜻입니다.
- 값이 role이면 next()를 호출합니다.
GET /admin에 requireRole('admin')을 추가하되, requireUser 뒤에 추가하세요. 이 미들웨어는 req.user를 읽으며, 이 값은 requireUser만 설정합니다.

서버는 시작할 때 이미 관리자 계정을 하나 만듭니다. 사용자 이름은 admin이고, 비밀번호는 admin-pass-for-tests이며, ADMIN_PASSWORD 환경 변수에서 가져옵니다.

직접 해 보기: ‘실행’을 누르세요. GET /admin을 보내면 상태 코드 401과 {"error": "Log in first"}가 반환됩니다. 이제 mallory라는 사용자가 자신을 관리자로 만들려고 합니다. {"username": "mallory", "password": "correct horse", "role": "admin"}을 담아 POST /signup을 보낸 다음, {"username": "mallory", "password": "correct horse"}를 담아 POST /login을 보내세요. GET /admin을 보내면 상태 코드 403과 {"error": "Not allowed"}가 반환됩니다. 추가 필드로 그녀가 관리자가 된 것은 아니기 때문입니다. {"username": "admin", "password": "admin-pass-for-tests"}를 담아 POST /login을 보낸 다음, GET /admin을 보내세요. 결과는 {"users": 2}입니다.

직접 해보기

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());

// 유일한 관리자 계정입니다. 비밀번호는 환경 변수에서 가져옵니다.
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 });
});

// 세션 쿠키에 해당하는 사용자를 찾거나 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();
});

// 내 노트를 페이지로 보여줍니다.
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>`);
});

// 노트: 각 사용자는 자신의 노트만 읽고 쓸 수 있습니다.
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();
});

// 관리자용: 계정이 몇 개 있는지 확인합니다.
app.get('/admin', requireUser, async (req, res) => {
    res.json({ users: await users.countDocuments() });
});

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

인증과 보안의 모든 레슨

직접 연습해 보세요: Express 플레이그라운드