いまのAPIは、名乗らなくても削除できます。ログインを実装して、セッションとJWTのどちらを使うかを決められるようにします。
前回: URLに動詞を入れない — REST APIの設計 作業場所はVMの中(Ubuntu)です。前回の
~/server/app.jsとappdbをそのまま使います。
前回でCRUDが一周しました。そして、いまのAPIには誰でも触れます。
名乗らずに消せます。 「自分のタスク」という概念が、そもそもありません。
この回で、誰が使っているのかを持たせます。
対象レベル: 初級〜中級 / 区分: 必修
この記事でわかること
- 認証と認可は別物だということ(誰か / 何をしていいか)
- パスワードを保存してはいけない理由と、
SHA-256では駄目な理由 - セッションとJWTの違い、そしてJWTでログアウトが効かない理由
- Cookieに付ける3つの属性(
HttpOnly/Secure/SameSite)
この記事でやること
usersテーブルを作り、パスワードをハッシュで保存する- ログインすると、以降のリクエストで名乗れるようにする
- ログインしていないと
/api/tasksを触れないようにする - 自分のタスクだけが見えるようにする
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| 認証(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 には、わざと表を作る権限を与えていません。
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台なので、共有の保存先で困らない
- 仕組みが単純で、何が起きているか追いやすい
JWTが劣っているわけではありません。 サーバーが何十台もあって、毎回保存先を見に行くのが重い、という場面では強い方式です。 いまの構成には要らない、というだけです。
④ 入れる
bcryptではなくbcryptjsを入れています。bcryptはC言語で書かれた部分があり、入れるときにコンパイルが走ります(node-gyp/make/ Python が要る)。環境によっては失敗します。bcryptjsは全部JavaScriptなので、どこでも同じように入ります。 少し遅いですが、この用途では問題になりません。
.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: true | JavaScriptから読めなくする | XSSを踏んだとき、ログイン情報ごと盗まれる |
sameSite: "lax" | 他サイトからの送信を制限する | 他人のサイトに置かれたボタンで、あなたの権限で操作される(CSRF) |
secure: true | https のときしか送らない | 通信を覗かれたときに、そのまま読まれる |
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は存在する」と分かってしまいます。
⑥ 動かす
curl は Cookie を覚えないので、ファイルに保存させます。
| オプション | 意味 |
|---|---|
-c | 受け取ったCookieをファイルに保存する |
-b | ファイルのCookieを送る |
[スクリーンショット: 01_認証の一周.png] 401 → ログイン → 200 → ログアウト → 401 と並んでいる画面を撮ってください。Cookieだけで出入りが変わっているのが分かる形で。
保存されているものを見る
パスワードがハッシュになっていることを、目で確認してください。
+----+----------------+--------------------------------------------------------------+
| id | email | password_hash |
+----+----------------+--------------------------------------------------------------+
| 1 | me@example.com | $2a$10$N9qo8uLOickgx2ZMRZoMyeIjZAgcfl7p92ldGxad68LJZdL17lhWy |
+----+----------------+--------------------------------------------------------------+
pass12345 はどこにもありません。
セッションも見られます。
ここに1行あるのが「ログイン中の人がいる」という状態です。ログアウトすると消えます。これがJWTとの一番の違いです。
⑦ なぜセッションをデータベースに置いたのか
express-session は、何も指定しないとメモリに置きます。 そして起動時にこう出ます。
Warning: connect.session() MemoryStore is not designed for a production environment
メモリに置くと、こうなります。
- サーバーを再起動すると、全員がログアウトする
- サーバーを2台に増やすと、片方でログインしても、もう片方では他人
MySQLの回でやったのと、まったく同じ話です。 消えて困るものは、プロセスの外に置きます。
確かめられます。
ログインしたままです。 メモリに置いていたら、ここで 401 になっていました。
つまずいたところ
| 症状 | 原因 |
|---|---|
| ログインは成功するのに、次のリクエストで 401 | curl に -b cookie.txt を付けていない(ブラウザなら自動で送る) |
ER_NO_SUCH_TABLE: sessions | sessions テーブルを作っていない(createDatabaseTable: false にしているため) |
CREATE command denied | appuser に表を作る権限が無い。 正しい。sudo mysql で作る |
| Cookieが送られない | secure: true なのに http で動かしている |
| ブラウザからは通るのに、別オリジンからだと Cookie が付かない | CORS で資格情報の送信を許していない(credentials の設定が別に要る) |
npm install bcrypt が失敗する | bcryptjs を使う(コンパイルが要らない) |
後片づけ
全部やり直したいとき。
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なので、そのまま公開しない
参考リンク
- roadmap.sh — Backend(Authentication / Session Based / JWT の項目)
- MDN — HTTP Cookie の使用
- MDN — SameSite 属性
- express-session / bcryptjs
- OWASP — Password Storage Cheat Sheet
次に読む
この記事は 【第5段階】バックエンドとデータベース の 9 / 29 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- Session Based Auth
- JWT
- ハッシュとソルト(bcrypt)
- Cookie の属性
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント