パスワードは保存しない — セッションとJWT

セッションとJWT。ログイン画面と鍵、入場証のカードと保護されたデータ。

いまのAPIは、名乗らなくても削除できます。ログインを実装して、セッションとJWTのどちらを使うかを決められるようにします。

前回: URLに動詞を入れない — REST APIの設計 作業場所はVMの中(Ubuntu)です。前回の ~/server/app.js と appdb をそのまま使います。

前回でCRUDが一周しました。そして、いまのAPIには誰でも触れます。

bash
$ curl -i -s -X DELETE http://localhost:3000/api/tasks/1

名乗らずに消せます。 「自分のタスク」という概念が、そもそもありません。

この回で、誰が使っているのかを持たせます。

対象レベル: 初級〜中級 / 区分: 必修

目次

この記事でわかること

  • 認証と認可は別物だということ(誰か / 何をしていいか)
  • パスワードを保存してはいけない理由と、SHA-256 では駄目な理由
  • セッションとJWTの違い、そしてJWTでログアウトが効かない理由
  • Cookieに付ける3つの属性(HttpOnly / Secure / SameSite)

この記事でやること

  1. users テーブルを作り、パスワードをハッシュで保存する
  2. ログインすると、以降のリクエストで名乗れるようにする
  3. ログインしていないと /api/tasks を触れないようにする
  4. 自分のタスクだけが見えるようにする

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
認証(Authentication)あなたが誰かを確かめること。ログイン
認可(Authorization)あなたが何をしていいかを決めること。他人のタスクは消せない
ハッシュ文字列を戻せない形に変換したもの。同じ入力なら必ず同じ結果になる
ソルトハッシュを作るときに混ぜるランダムな文字列。同じパスワードでも別の結果にするため
セッションサーバー側が「この人は誰か」を覚えておくやり方
JWTサーバーが覚えず、利用者に署名付きの札を渡すやり方
Cookieブラウザが自動で送り返してくれる小さなデータ

認証と認可は、よく一緒に語られますが別の話です。 認証は「入口で本人確認をする」、認可は「入ったあと、どの部屋に入れるか」。 認証だけ作って認可を忘れると、「ログインさえすれば他人のデータを全部見られる」という穴になります。実際によくある事故です。

この記事は練習です

先に断っておきます。

この回で作るものを、そのまま外に公開してはいけません。 理由は1つです。

いまのVMは http で、暗号化されていません。

ログインの情報も、Cookieも、通信の途中で読めます。 同じネットワークにいる人には見えてしまいます。

本番では必ず https にします。 それはSSLとhttps強制の回と、この先の nginx の回で扱います。いまは「仕組みを手で作る」ことに集中してください。

① パスワードを保存してはいけない

まず、やってはいけないほうを見ます。

INSERT INTO users (email, password) VALUES ('a@example.com', 'himitsu123');

そのまま入っています。 何が困るか。

データベースの中身が漏れたとき、全員のパスワードがそのまま漏れます。 そして最悪なのは、多くの人が同じパスワードを他のサービスでも使っていることです。あなたのサイトの事故が、その人の銀行の事故になります。

「うちは漏れないから大丈夫」は成り立ちません。 漏れる前提で設計します。 漏れても被害が出ない形で持つ、というのがこの節の目的です。

戻せない形にする — ハッシュ

ハッシュは、一方通行の変換です。

himitsu123  →  $2a$10$N9qo8uLOickgx2ZMRZoMy...

元に戻せません。 ではどうやってログインを確かめるのか。

入力されたパスワードを同じ方法で変換して、保存してある文字列と一致するかを見ます。 こちらは元のパスワードを知らないまま、正しいかどうかだけ分かります。

なぜ SHA-256 では駄目なのか

「ハッシュならなんでもいい」ではありません。

SHA-256 や MD5 は、速いことが目的の道具です。1秒間に何十億回も計算できます。

攻撃する側から見ると、これは最悪です。 よくあるパスワードを片っ端からハッシュ化して突き合わせれば、短いパスワードは数秒で割れます。

パスワード用のハッシュは、わざと遅く作られています。

用途速さ
MD5 / SHA-256ファイルが壊れていないかの確認速い(=パスワードには不向き)
bcryptパスワード専用わざと遅い。回数を指定できる

さらに bcrypt は、ソルトを自動で混ぜます。

同じ "himitsu123" でも
$2a$10$N9qo8uLOickgx2ZMRZoMy...   ← Aさん
$2a$10$7EqJtq98hPqEX7fNZaFWoO...   ← Bさん

同じパスワードなのに、保存されるものが違います。 だから「この2人は同じパスワードだ」ということすら分かりません。

② テーブルを用意する

root で入ります。 前回作った appuser には、わざと表を作る権限を与えていません。

bash
$ sudo mysql
USE appdb;

CREATE TABLE users (
  id            INT AUTO_INCREMENT PRIMARY KEY,
  email         VARCHAR(255) NOT NULL UNIQUE,
  password_hash VARCHAR(255) NOT NULL,
  created_at    TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
);
部分意味
UNIQUE同じメールアドレスで2人作れない。 データベース側で止める
password_hash名前を password にしない。 「生のパスワードではない」と読んで分かるように
VARCHAR(255)bcrypt の結果は60文字だが、方式が変わっても入るよう広く取る

タスクに「持ち主」を足します。

ALTER TABLE tasks ADD COLUMN user_id INT NULL;

NULL を許しているのは、すでに入っているタスクに持ち主がいないからです。 後から列を足すときは、既存の行をどうするかを必ず考えます。 NOT NULL にすると、既存の行が違反するので ALTER 自体が失敗します。

セッションを保存する表も作ります(理由は後述)。

CREATE TABLE sessions (
  session_id VARCHAR(128) COLLATE utf8mb4_bin NOT NULL,
  expires    INT UNSIGNED NOT NULL,
  data       MEDIUMTEXT COLLATE utf8mb4_bin,
  PRIMARY KEY (session_id)
);

exit で抜けます。

③ セッションか、JWTか

ログインしたあと、「この人はさっきログインした人だ」とどう分かるのか。 やり方は大きく2つです。

セッションJWT
覚えるのはサーバー利用者(ブラウザ)
渡すものただのID(中身に意味は無い)署名付きのデータそのもの
毎回やることIDから保存先を引く署名を検証する(保存先を見ない)
ログアウトできる(サーバー側で消す)できない(後述)
サーバーを増やすと共有の保存先が要る要らない

JWTでログアウトできない、とはどういうことか

JWTは「有効期限まで有効な、署名された札」です。サーバーはそれを覚えていません。 検証しているだけです。

つまり、一度渡した札を取り消す手段がありません。

パスワードを変えても、盗まれた札は期限まで使えます。 対策として「取り消した札の一覧」をサーバーに持つ方法がありますが、それをやると「サーバーが覚えない」というJWTの利点が消えます。

この記事ではセッションを使います。 理由は3つです。

  1. ログアウトが素直に効く
  2. サーバーは1台なので、共有の保存先で困らない
  3. 仕組みが単純で、何が起きているか追いやすい

JWTが劣っているわけではありません。 サーバーが何十台もあって、毎回保存先を見に行くのが重い、という場面では強い方式です。 いまの構成には要らない、というだけです。

④ 入れる

bash
$ cd ~/server
$ npm install express-session express-mysql-session bcryptjs

bcrypt ではなく bcryptjs を入れています。 bcrypt はC言語で書かれた部分があり、入れるときにコンパイルが走ります(node-gyp / make / Python が要る)。環境によっては失敗します。 bcryptjs は全部JavaScriptなので、どこでも同じように入ります。 少し遅いですが、この用途では問題になりません。

.env に、署名用の秘密の文字列を足します。

bash
$ openssl rand -base64 32
$ nano ~/server/.env
DB_USER=appuser
DB_PASSWORD=(前回のもの)
DB_NAME=appdb
SESSION_SECRET=(いま作った文字列)

SESSION_SECRET は、Cookieが改ざんされていないかを確かめるための鍵です。 これが漏れると、他人になりすませます。 .env に置いて .gitignore、が前回と同じ理由で効いてきます。

⑤ 書く

~/server/app.js の上のほう(pool を作った直後)に足します。

const session = require("express-session");
const MySQLStore = require("express-mysql-session")(session);
const bcrypt = require("bcryptjs");

const store = new MySQLStore({
  host: "127.0.0.1",
  user: process.env.DB_USER,
  password: process.env.DB_PASSWORD,
  database: process.env.DB_NAME,
  createDatabaseTable: false,   // 表は自分で作った(appuser に CREATE を与えていないため)
});

app.use(
  session({
    secret: process.env.SESSION_SECRET,
    store,
    resave: false,
    saveUninitialized: false,
    cookie: {
      httpOnly: true,
      sameSite: "lax",
      secure: false,          // ⚠️ https にしたら必ず true にする
      maxAge: 1000 * 60 * 60 * 24 * 7,
    },
  })
);

Cookieの3つの属性

ここが、この記事でいちばん実害に近いところです。

属性何をするか外すとどうなるか
httpOnly: trueJavaScriptから読めなくするXSSを踏んだとき、ログイン情報ごと盗まれる
sameSite: "lax"他サイトからの送信を制限する他人のサイトに置かれたボタンで、あなたの権限で操作される(CSRF)
secure: truehttps のときしか送らない通信を覗かれたときに、そのまま読まれる

secure: false にしているのは、いまが http だからです。 true にするとCookieが一切送られなくなり、ログインできません。 そして https にしたときに false のままだと、通信が覗かれます。 https にした瞬間に true に変える。 これを忘れないでください。

登録とログイン

app.listen の上に足します。

// 登録
app.post("/api/users", async (req, res) => {
  const { email, password } = req.body;
  if (typeof email !== "string" || !email.includes("@")) {
    return res.status(400).json({ error: "email が正しくありません" });
  }
  if (typeof password !== "string" || password.length < 8) {
    return res.status(400).json({ error: "password は8文字以上にしてください" });
  }
  try {
    const hash = await bcrypt.hash(password, 10);
    const [result] = await pool.query(
      "INSERT INTO users (email, password_hash) VALUES (?, ?)",
      [email, hash]
    );
    res.status(201).json({ id: result.insertId, email });
  } catch (err) {
    if (err.code === "ER_DUP_ENTRY") {
      return res.status(409).json({ error: "そのメールアドレスは登録済みです" });
    }
    console.error(err);
    res.status(500).json({ error: "登録できませんでした" });
  }
});

// ログイン
// メールが無いとき用のダミー(中身は使わない。起動時に1回だけ作る)
const DUMMY_HASH = bcrypt.hashSync("dummy-not-a-real-password", 10);

app.post("/api/login", async (req, res) => {
  const { email, password } = req.body;
  try {
    const [rows] = await pool.query(
      "SELECT id, email, password_hash FROM users WHERE email = ?",
      [email]
    );
    const user = rows[0];
    // メールが無くても compare を1回走らせる(応答時間で登録の有無を悟らせない)
    const hash = user ? user.password_hash : DUMMY_HASH;
    const ok = (await bcrypt.compare(password || "", hash)) && Boolean(user);

    if (!ok) {
      // ⚠️ 「メールが無い」と「パスワードが違う」を区別しない
      return res.status(401).json({ error: "メールアドレスかパスワードが違います" });
    }

    req.session.userId = user.id;
    res.json({ id: user.id, email: user.email });
  } catch (err) {
    console.error(err);
    res.status(500).json({ error: "ログインできませんでした" });
  }
});

// ログアウト
app.post("/api/logout", (req, res) => {
  req.session.destroy(() => res.status(204).end());
});

「そのメールアドレスは登録されていません」と返してはいけません。 親切に見えますが、「このメールアドレスがこのサービスに登録されているか」を誰でも調べられるようになります。 登録の有無自体が個人情報です。だからどちらの失敗も同じ文言・同じ 401 にします。応答の速さでも分かってしまうので、メールが無いときもダミーのハッシュと compare を1回走らせて、かかる時間を揃えています。

409 Conflict は「すでにある」という意味の番号です。登録のときだけは重複を知らせないと登録できないので、ここは返します。

保護する

// ログインしていなければ、ここで止める
const requireLogin = (req, res, next) => {
  if (!req.session.userId) {
    return res.status(401).json({ error: "ログインしてください" });
  }
  next();
};

前回作った /api/tasks の4本に、これを挟みます。

app.get("/api/tasks", requireLogin, async (req, res) => {

app.get の第2引数に入れるだけです。post / put / patch / delete も同じように書き換えます。

APIの回で app.use() を「全部のリクエストが通る場所」と書きました。 next() を呼べば次へ進み、呼ばなければそこで止まる。 認証はまさにこの形で差し込みます。app.use に置けば全部に、引数に置けばその1本だけに効きます。

自分のものだけにする — これが「認可」

ログインを求めるだけでは足りません。 ログインした人が他人のタスクを消せるからです。

SQLに user_id の条件を足します。

app.get("/api/tasks", requireLogin, async (req, res) => {
  const [rows] = await pool.query(
    "SELECT id, title, done, created_at FROM tasks WHERE user_id = ? ORDER BY id",
    [req.session.userId]
  );
  res.json(rows);
});

追加のときは、持ち主を書き込みます。

    const [result] = await pool.query(
      "INSERT INTO tasks (title, user_id) VALUES (?, ?)",
      [req.body.title, req.session.userId]
    );

変更と削除は、WHERE に足します。

    const [result] = await pool.query(
      "DELETE FROM tasks WHERE id = ? AND user_id = ?",
      [req.params.id, req.session.userId]
    );

AND user_id = ? を足すのが要点です。 こうすると、他人のタスクを消そうとしても affectedRows が 0 になり、前回書いた分岐がそのまま 404 を返します。 「他人のものだ」と教えないのも設計です。 403(禁止)を返すと「そのIDは存在する」と分かってしまいます。

⑥ 動かす

bash
$ node --env-file=.env app.js

curl は Cookie を覚えないので、ファイルに保存させます。

bash
$ # 登録
$ curl -s -X POST http://localhost:3000/api/users \
    -H "Content-Type: application/json" \
    -d '{"email":"me@example.com","password":"pass12345"}' | jq

$ # ログインしていない状態で叩く → 401
$ curl -i -s http://localhost:3000/api/tasks | head -n 1

$ # ログイン(Cookie を cookie.txt に保存)
$ curl -s -c cookie.txt -X POST http://localhost:3000/api/login \
    -H "Content-Type: application/json" \
    -d '{"email":"me@example.com","password":"pass12345"}' | jq

$ # Cookie を送って叩く → 200
$ curl -s -b cookie.txt http://localhost:3000/api/tasks | jq

$ # 追加すると、自分のものとして入る
$ curl -s -b cookie.txt -X POST http://localhost:3000/api/tasks \
    -H "Content-Type: application/json" -d '{"title":"認証をつけた"}' | jq

$ # ログアウト → また 401
$ curl -s -b cookie.txt -X POST http://localhost:3000/api/logout
$ curl -i -s -b cookie.txt http://localhost:3000/api/tasks | head -n 1
オプション意味
-c受け取ったCookieをファイルに保存する
-bファイルのCookieを送る

[スクリーンショット: 01_認証の一周.png] 401 → ログイン → 200 → ログアウト → 401 と並んでいる画面を撮ってください。Cookieだけで出入りが変わっているのが分かる形で。

保存されているものを見る

パスワードがハッシュになっていることを、目で確認してください。

bash
$ sudo mysql -e "SELECT id, email, password_hash FROM appdb.users;"
+----+----------------+--------------------------------------------------------------+
| id | email          | password_hash                                                |
+----+----------------+--------------------------------------------------------------+
|  1 | me@example.com | $2a$10$N9qo8uLOickgx2ZMRZoMyeIjZAgcfl7p92ldGxad68LJZdL17lhWy |
+----+----------------+--------------------------------------------------------------+

pass12345 はどこにもありません。

セッションも見られます。

bash
$ sudo mysql -e "SELECT session_id, expires FROM appdb.sessions;"

ここに1行あるのが「ログイン中の人がいる」という状態です。ログアウトすると消えます。これがJWTとの一番の違いです。

⑦ なぜセッションをデータベースに置いたのか

express-session は、何も指定しないとメモリに置きます。 そして起動時にこう出ます。

Warning: connect.session() MemoryStore is not designed for a production environment

メモリに置くと、こうなります。

  • サーバーを再起動すると、全員がログアウトする
  • サーバーを2台に増やすと、片方でログインしても、もう片方では他人

MySQLの回でやったのと、まったく同じ話です。 消えて困るものは、プロセスの外に置きます。

確かめられます。

bash
$ # ログインした状態で Ctrl+C → 立て直す
$ node --env-file=.env app.js
$ curl -s -b cookie.txt http://localhost:3000/api/tasks | jq

ログインしたままです。 メモリに置いていたら、ここで 401 になっていました。

つまずいたところ

症状原因
ログインは成功するのに、次のリクエストで 401curl に -b cookie.txt を付けていない(ブラウザなら自動で送る)
ER_NO_SUCH_TABLE: sessionssessions テーブルを作っていない(createDatabaseTable: false にしているため)
CREATE command deniedappuser に表を作る権限が無い。 正しい。sudo mysql で作る
Cookieが送られないsecure: true なのに http で動かしている
ブラウザからは通るのに、別オリジンからだと Cookie が付かないCORS で資格情報の送信を許していない(credentials の設定が別に要る)
npm install bcrypt が失敗するbcryptjs を使う(コンパイルが要らない)

後片づけ

bash
$ rm -f ~/server/cookie.txt

全部やり直したいとき。

DROP TABLE sessions;
DROP TABLE users;
ALTER TABLE tasks DROP COLUMN user_id;

~/server/ と appdb は残してください。 ここまでで「誰が使っているかを持ったAPI」が完成しています。

まとめ

  • 認証は「誰か」、認可は「何をしていいか」。 認証だけ作って認可を忘れると、ログインすれば他人のデータが全部見える穴になる
  • パスワードは保存しない。 漏れる前提で、戻せない形(ハッシュ)で持つ
  • SHA-256 や MD5 は速いので、パスワードには向かない。 bcrypt はわざと遅く、ソルトも自動で混ざる
  • ログイン失敗の理由を教えない。 「登録されていません」は、登録の有無を誰でも調べられる入口になる
  • セッションはサーバーが覚える、JWTは利用者が持つ。 JWTは渡した札を取り消せない(ログアウトが効かない)
  • Cookieには httpOnly / sameSite / secure。 https にしたら secure: true を必ず入れる
  • AND user_id = ? を WHERE に足すのが認可の実装。 他人のものは affectedRows が 0 になり、404 になる
  • 403 ではなく 404 を返す。 403 だと「そのIDは存在する」と分かってしまう
  • セッションをメモリに置くと、再起動で全員ログアウトする。 消えて困るものはプロセスの外へ
  • この記事のものは http なので、そのまま公開しない

参考リンク


次に読む

この記事は 【第5段階】バックエンドとデータベース の 9 / 29 本目です。

記事
← 前の記事アプリのログ出力 — レベルの決め方とリクエストIDで1件を追う
→ 次の記事速いハッシュは使わない — パスワード保存とbcrypt

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Backend›Authentication
  • Session Based Auth
  • JWT
  • ハッシュとソルト(bcrypt)
  • Cookie の属性

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次