自分だけのメモ

CoddyのNode.jsジャーニー「認証とセキュリティ」セクションの一部。レッスン 18/24。

ログインしていることが証明するのはあなたが誰かであり、メモがあなたのものだということではありません。GET /notes/:idはidだけでメモを検索するため、共有リンクやログからidを知ったログイン中の人なら誰でも、そのメモを読めます。所有者を確認することを認可と呼びます。

データベースが他人のドキュメントを返さないように、クエリ自体に所有者を指定します。見つからない場合は403ではなく404を返します。403を返すと、訪問者にメモが存在することを知らせてしまうからです。

const order = await orders.findOne({
    _id: new ObjectId(req.params.id),
    customer: req.user.id,
});
if (!order) {
    return res.status(404).json({ error: 'Order not found' });
}

ユーザーのデータにアクセスするすべてのクエリに、このフィルターが必要です。読み取り、更新、削除のいずれにも必要です。

チャレンジ

簡単

この章では、第2章で扱ったセッションログインに戻り、サーバーを拡張します。現在は GET / のページ、1件のノートを扱う GET /notes/:id と DELETE /notes/:id のルート、そして管理者アカウントがあります。2つの /notes/:id ルートには問題があります。ノートをIDだけで検索しているのです。IDを知っているログインユーザーなら誰でも、他のユーザーのノートを読んだり削除したりできます。この問題を解決しましょう。

server.js の GET /notes/:id で、ノートを _id と owner の両方で検索します。所有者はログイン中のユーザー、つまり req.user.id でなければなりません。
DELETE /notes/:id でも同じようにして、自分が所有していないノートを誰も削除できないようにします。
ノートが一致しない場合、どちらのルートもすでにステータス404と {"error": "Note not found"} を返します。他のユーザーのノートの場合も、この応答をそのまま使います。403にすると、ノートが存在することを訪問者に知らせてしまいます。

試してみましょう：「実行」を押します。

POST /signup、続けて POST /login を送信します。どちらにも {"username": "ada", "password": "correct horse"} を指定します。
{"text": "Safe code 4417"} を指定して POST /notes を送信し、応答から _id をコピーします。そのIDに続けて GET /notes/ を送信すると、ノートが返されます。
{"username": "bob", "password": "correct horse"} を使って登録し、ログインします。adaのIDに続けて GET /notes/ を送信します。ステータス404と {"error": "Note not found"} が返されます。同じIDに続けて DELETE /notes/ を送信しても、404が返されます。
最初の手順で使った情報を使って、もう一度adaとしてログインします。ノートはまだ残っています。今度は DELETE で削除します。ステータス204が返されます。

自分で試してみよう

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

// セッションCookieに対応するユーザーを探し、見つからなければ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) });
    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) });
    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プレイグラウンド