ログイン後のルート

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

すべての非公開ルートには、GET /meからセッションを取得する処理が必要です。各ルートにコピーすると、一度は忘れてしまい、そのルートが誰にでも公開されてしまいます。代わりに、ミドルウェアとして一度だけ書きましょう。

ミドルウェアはルートの前に実行されます。reqにreq.userのような値を設定すると、ルートはそこから値を読み取ります。ユーザーの_idはObjectIdです。user._id.toHexString()を使うと、テキスト形式で取得できます。ミドルウェアは応答して処理を終了するか、取得した値をreqに設定してnext()を呼び出します。必要な各ルートでは、ハンドラーの前にミドルウェアを渡します。

function requireAdult(req, res, next) {
    if (Number(req.query.age) < 18) {
        return res.status(403).json({ error: 'Adults only' });
    }
    req.adult = true;
    next();
}

app.get('/wines', requireAdult, (req, res) => res.json(wines));

returnが重要です。これがないと、ルートも実行されてしまいます。

チャレンジ

簡単

メモはまだ誰でも閲覧できます。非公開にしましょう。ログインしたユーザーだけがメモを読んだり追加したりでき、各ユーザーには自分のメモだけが表示されるようにします。

server.jsで、ミドルウェア関数requireUser(req, res, next)を記述します。GET /meからセッションの検索処理を移し、sidクッキーを読み取り、セッションを見つけてから、そのユーザーを見つけます。
- 該当するユーザーがいない場合は、ステータス401と{"error": "Log in first"}を返し、そこで処理を終了します。
- それ以外の場合は、2つのフィールドを持つオブジェクトとして、ユーザーをreq.userに設定し、next()を呼び出します。2つのフィールドは、ユーザーの_idをテキストにしたidと、usernameです。ObjectIdのtoHexString()メソッドを使うと、"66f1c2a9e4b0a1b2c3d4e5f6"のようなテキストが得られます。
GET /me、GET /notes、POST /notesでは、それぞれのルートの関数の前にrequireUserを渡します。するとGET /meは、req.userから読み取った{"username": "ada"}を返します。
POST /notesでは、req.user.idを保持するownerフィールドを付けて、各メモを保存します。レスポンスは新しいメモです。{"owner": "66f1c2a9e4b0a1b2c3d4e5f6", "text": "Door code 1234", "_id": "66f1c2b0e4b0a1b2c3d4e5f7"}
GET /notesでは、ログイン中のユーザーがownerであるメモだけを返します。

試してみましょう：「実行」を押します。GET /notesを送信すると、ステータス401と{"error": "Log in first"}が返ります。{"username": "ada", "password": "correct horse"}を使って、POST /signup、次にPOST /loginを送信します。{"text": "Door code 1234"}を使ってPOST /notesを送信すると、ステータス201とowner付きのメモが返ります。GET /notesを送信すると、そのメモ1件を含むリストが返ります。次に、{"username": "bob", "password": "correct horse"}を使って登録し、ログインします。bobはまだ何も書いていないため、GET /notesは[]を返します。

自分で試してみよう

import express from 'express';
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());

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 });
    res.json({ username: user.username });
});

app.get('/me', async (req, res) => {
    const { sid } = parseCookies(req.get('cookie'));
    const session = sid && (await sessions.findOne({ _id: sid }));
    if (!session) {
        return res.status(401).json({ error: 'Log in first' });
    }
    const user = await users.findOne({ _id: session.userId });
    res.json({ username: user.username });
});

// このブラウザーが GET /visit を呼び出した回数を数えます。
app.get('/visit', (req, res) => {
    const cookies = parseCookies(req.get('cookie'));
    const visits = Number(cookies.visits ?? 0) + 1;
    res.cookie('visits', String(visits));
    res.json({ visits });
});

// ノート。現時点では誰でも読み書きできます。
app.get('/notes', async (req, res) => {
    res.json(await notes.find().toArray());
});

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

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

腕試し

このレッスンには短いクイズがあります。レッスンを始めて解答し、進捗を記録しましょう。

認証とセキュリティのすべてのレッスン

自分で練習してみよう: Expressプレイグラウンド