認証の回で、自分でログインを作りました。users 表があって、パスワードは bcrypt のハッシュで入っていて、ログインするとセッションのIDがCookieで返ってきます。
前回: 9時間ずれるのは全部同じ理由 — 日付と時刻の扱い 作業場所はVMの中(Ubuntu)です。セッションとJWTの違い|ログイン機能の実装と使い分けの
~/server/app.jsとappdbをそのまま使います。ブラウザはホストのWindows側を使います(理由は④にあります)。
動いています。それでも、多くのサービスがこう書いてあります。
[ GitHubでログイン ]
[ Googleでログイン ]
この記事は、そのボタンの中身の話です。 そして、始める前に一番大きい誤解を先に潰します。
OAuth は「ログインの仕組み」ではありません。
ここを勘違いしたまま実装した結果、ログインできてしまう穴を作る、というのがこの分野で一番よくある事故です。まずそこから見ます。
対象レベル: 初級〜中級 / 区分: 必修
この記事でわかること
- OAuth は「認可(許可)」の仕組みで、ログイン(認証)用ではないこと。ログインに使うための拡張が OpenID Connect だということ
- 「Googleでログイン」の画面遷移で、実際に何がどこへ渡っているか(そしてトークンはブラウザを通らないこと)
stateを検証しないと、他人のアカウントに勝手に紐づけられること- NATの内側のVMでも、コールバックURLは
http://localhost:3000/...で足りる理由 - メールアドレスが同じというだけで既存アカウントに繋いではいけないこと
この記事でやること
- GitHub の OAuth App を作る(コールバックは
http://localhost:3000/auth/github/callback) - ホストのWindowsからVMへ SSH ポートフォワードして、ホストのブラウザでVMのアプリを開く
identities表を足して、GitHubのアカウントとusersを繋ぐ- 認可コードフローを自分で書く(
stateの生成と検証を含める) - 実際に「GitHubでログイン」して、
usersに何が入ったかをSQLで確かめる
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| OAuth 2.0 | 「このアプリに、私の代わりにこれをさせてよい」を安全に伝えるための決まり。認可の仕組み |
| OpenID Connect(OIDC) | OAuth 2.0 の上に「あなたは誰か」を足した拡張。こちらが認証 |
| プロバイダ | ログインを提供する側。GitHub、Google など |
| クライアント | 提供を受ける側。今回はあなたのExpressアプリ |
| スコープ | 何を許可するかの範囲。read:user なら「プロフィールを読むだけ」 |
| 認可コード | 同意した直後に一度だけ渡される短い文字列。それ自体では何もできない |
| アクセストークン | 認可コードと引き換えに受け取る、APIを叩くための鍵 |
state | 自分で作って往復させるランダムな文字列。戻ってきたのが自分の始めた手続きかを確かめる |
| クライアントシークレット | プロバイダが発行するアプリ側の秘密。漏れたら作り直す |
「認証(あなたは誰か)」と「認可(何をしてよいか)」は別でした。認証の回で分けた、あの区別がそのまま効いてきます。 OAuth は後者、つまり認可の側の仕組みです。 前者に使いたければ、OIDC という追加のルールが要ります。
① OAuth は「ログインの仕組み」ではない
名前がそう言っています。 OAuth は Authorization(認可) の話です。Authentication(認証)ではありません。
OAuth 2.0 が本来解こうとした問題は、こういうものでした。
写真印刷サービスに、Googleフォトの写真を取りに行かせたい。 でも、Googleのパスワードを印刷サービスに教えるのは嫌だ。
これに対する答えが OAuth です。パスワードを渡す代わりに、「写真を読むことだけ許可した鍵」を渡します。
| 昔のやり方 | OAuth | |
|---|---|---|
| 渡すもの | Googleのパスワード | 写真を読むだけの鍵(アクセストークン) |
| できる範囲 | Googleでできること全部 | 許可した範囲だけ |
| 取り消し | パスワードを変えるしかない | その鍵だけ取り消せる |
| 期限 | 無い | ある |
どこにも「あなたが誰か」という話が出てきません。 これが本質です。
「トークンが取れた=本人だ」は成り立たない
ここが事故の入口です。 素のOAuthだけでログインを作ると、こういう発想になります。
アクセストークンが手に入った
→ ユーザー情報APIを叩いたら user_id=12345 と返ってきた
→ よし、12345 としてログインさせよう
トークンは「誰かが、どこかで、このアプリに何かを許可した」ことしか意味しません。
そのトークンが、いま目の前のブラウザの持ち主のものだ、という保証がどこにもありません。 悪意のある人が自分のトークンを他人のブラウザに掴ませると、その他人は攻撃者のアカウントとしてログインした状態になります。逆に、攻撃者が自分のログイン画面に被害者のコードを流し込むと、攻撃者のアカウントに被害者のGitHubが紐づきます。
これを塞ぐのが state の検証で、⑧ で必ず実装します。この手順を書いていない解説記事が本当に多いので、注意してください。
では何でログインするのか — OpenID Connect
OAuth の上に「本人確認の結果」を乗せる決まりを足したものが OpenID Connect(OIDC) です。
| OAuth 2.0 | OpenID Connect | |
|---|---|---|
| 目的 | 認可 | 認証(+認可) |
| 返るもの | アクセストークン | アクセストークン + ID トークン |
| ユーザー情報の取り方 | プロバイダごとにバラバラ | UserInfo エンドポイントが決まっている |
| 設定の場所 | ドキュメントを読む | /.well-known/openid-configuration に全部書いてある |
ID トークン が OIDC の中心です。 これは署名付きのJWTで、中にこう入っています。
iss 誰が発行したか(https://accounts.google.com)
aud 誰宛か(あなたのクライアントID)
sub そのプロバイダの中でのユーザーID(変わらない)
exp いつまで有効か
nonce あなたが送った使い捨ての文字列
「Googleが署名した、あなた宛の、この人だという証明書」です。 署名を検証し、aud が自分か、exp が切れていないかを確かめて初めて、「本人である」と言えます。
GitHub は OIDC ではありません。 GitHub の OAuth App が返すのはアクセストークンだけで、
ID トークンは出ません。 なので今回はGitHub独自のAPI(https://api.github.com/user)を叩いてユーザー情報を取ります。 「GitHubでログイン」は、正確には OAuth をログインに流用している形です。流用でも安全にできますが、stateの検証が必須になります。
② なぜ自分でパスワードを預かるのをやめたくなるのか
理由は1つです。
預からなければ、漏らせません。
認証の回で、パスワードをハッシュで持ちました。あれは「漏れても被害を小さくする」対策で、「漏れない」対策ではありません。
自分でパスワードを持つと、ずっとこれを背負い続けます。
| 背負うもの | 中身 |
|---|---|
| 保管 | ハッシュのアルゴリズムが古くなったら、全員分を移行する |
| パスワード忘れ | メール送信、期限付きトークン、その経路自体が乗っ取りの入口になる |
| 総当たり対策 | 回数制限、ロック、そしてロックを使った嫌がらせへの対策 |
| 使い回しの被害 | 他所で漏れたパスワードで、あなたのサイトに入られる |
| 二要素認証 | 求められたら、これも自分で作る |
OAuth / OIDC を使うと、この列が丸ごと相手側に移ります。 あなたのデータベースには、パスワードが1つも入っていない状態にできます。
ただし、代わりに別のものを背負います。 それは ⑪ で正直に書きます。
③ 「GitHubでログイン」で何が起きているか
画面遷移の順に分解します。 登場人物は3人です。利用者のブラウザ、あなたのサーバー、GitHub。
| # | 起きること | どこからどこへ |
|---|---|---|
| 1 | 利用者が [GitHubでログイン] を押す | ブラウザ → あなたのサーバー |
| 2 | サーバーが state を作って保存し、GitHubへ302リダイレクトする | サーバー → ブラウザ → GitHub |
| 3 | GitHubが同意画面を出す(「このアプリに◯◯を許可しますか」) | GitHub上 |
| 4 | 利用者が Authorize を押す | GitHub上 |
| 5 | GitHubがあなたのコールバックURLへリダイレクトする。?code=...&state=... 付き | GitHub → ブラウザ → あなたのサーバー |
| 6 | サーバーが state を照合する | サーバー内 |
| 7 | サーバーが認可コードとシークレットを送り、アクセストークンを受け取る | サーバー ⇄ GitHub(ブラウザを通らない) |
| 8 | サーバーがトークンでユーザー情報APIを叩く | サーバー ⇄ GitHub |
| 9 | サーバーが自分のセッションを張り、アプリのトップへ戻す | サーバー → ブラウザ |
7と8に注目してください。 ここだけブラウザが一切関与していません。 サーバーとGitHubの直接通信です。
そして9が重要です。 ログインが終わったあと、利用者が持っているのはあなたのサイトのセッションCookieです。GitHubのトークンではありません。
つまり、OAuth はログインの「入口」だけです。 入ったあとの状態を持つのは、これまで通りセッションです。 認証の回で作ったものを捨てる話ではありません。入口が1つ増えるだけです。
なぜ認可コードを挟むのか
「最初からトークンを返せばいいのに」と思うところです。 実際、昔はそういうやり方がありました。暗黙フロー(Implicit Flow)といって、5でコードの代わりにトークンそのものがURLに付いて返ってきます。
使ってはいけません。
| 問題 | 何が起きるか |
|---|---|
| URLに載る | ブラウザの履歴に残る。 リファラで他所のサイトに漏れる。プロキシのログに残る |
| アプリを名乗れない | クライアントシークレットを使わないので、GitHubは「本当にそのアプリか」を確かめられない |
| JavaScriptから読める | XSSを1つ踏んだだけで、トークンごと盗まれる |
認可コードフローは、これを全部避けます。
- ブラウザに載るのは認可コードだけ。それ単体では何もできません(シークレットが無いと交換できない)
- コードは1回使うと無効になり、寿命も数分しかありません
- 実際のトークンはサーバーの中にしか存在しません
判断の基準はこれだけです。 サーバーがある(シークレットを隠せる)なら、認可コードフロー。 これ以外を選ぶ理由はありません。 ブラウザだけ・スマホアプリだけでシークレットを隠せない場合は、認可コードフローに PKCE という仕組みを足します(コードを交換するとき、最初に送った合言葉のハッシュと突き合わせる方式)。それでも暗黙フローには戻りません。
④ VMは外から見えない。コールバックはどうするのか
ここで手が止まります。 いまのVMはNATの内側にいて、インターネットから到達できません。
GitHub ──X──> あなたのVM (届かない)
「GitHubがコールバックURLを叩きに来るなら、公開サーバーが要るのでは?」 と考えます。そこが誤解です。
GitHub は、あなたのサーバーに接続しません。 コールバックは「ブラウザへのリダイレクト指示」です。
③ の 5 をもう一度見てください。GitHubがやっているのは、利用者のブラウザに 302 と Location: を返すことだけです。そのURLへ実際に接続しに行くのは、利用者のブラウザです。
GitHub ──302 Location: http://localhost:3000/...──> ブラウザ
ブラウザ ────────── GET /auth/github/callback ─────> あなたのサーバー
だから、サーバーは「ブラウザから見えれば」十分です。 インターネットから見える必要はありません。
そして 7 と 8 は、VMからGitHubへの外向きの通信です。NATの内側からでも普通に出ていけます。
ブラウザをどこに置くか
Ubuntu Server には画面がありません。 ブラウザがありません。なので、ホストのWindowsのブラウザを使います。
問題は、Windowsのブラウザから見て localhost:3000 はWindows自身であって、VMではないことです。これを繋ぐのが SSH ポートフォワードです。
Windows の PowerShellで打ちます(VMの中ではありません)。
your-nameと192.168.x.xはあなたのVMのユーザー名とIPに置き換えます(VMの中でip aで確認できます)-L 3000:localhost:3000が 「Windowsの3000番へ来たものを、SSHの中を通してVMの3000番へ流す」 という意味です- このウィンドウは開いたままにします。 閉じると転送も止まります
VS Code の Remote SSH を使っている人へ。 VS Code は自動でポート転送をします。 ターミナルで
node app.jsを起動すると、下のパネルの「ポート」に 3000 が現れ、Windows側のlocalhost:3000から開けるようになります。 その場合、上のssh -Lは要りません。
確認します。Windowsのブラウザで開きます。
http://localhost:3000/api/tasks
VMのAPIの応答が出れば、経路はできています。
ここで
{"error":...}や 401 が返るのは正常です。 ログインしていないからです。「何かが返ってくる」ことだけ確認できれば十分です。 繋がらない場合は、VMの中でアプリが動いているか(curl http://localhost:3000/api/tasks)を先に確かめてください。
[スクリーンショット: 01_ポート転送確認.png] Windows の PowerShell で ssh -L 3000:localhost:3000 ... を実行して繋がった状態と、Windowsのブラウザで http://localhost:3000/api/tasks が応答している画面を撮ってください。IPアドレスとユーザー名は隠して構いません。
⑤ GitHub の OAuth App を作る
GitHubにログインした状態で、Settings → Developer settings → OAuth Apps → New OAuth App を開きます。
| 項目 | 入れるもの |
|---|---|
| Application name | obmes-practice(何でもよい。同意画面にこの名前が出ます) |
| Homepage URL | http://localhost:3000 |
| Authorization callback URL | http://localhost:3000/auth/github/callback |
httpのままで登録できます。 GitHub はlocalhostに限りhttpを許容します。外部の本番URLではhttpsが必要です。 コールバックURLは1文字も違ってはいけません。 末尾のスラッシュ1つで弾かれます。GitHubのOAuth Appには、コールバックURLを1つしか登録できません。
作ると Client ID が出ます。Client secret は「Generate a new client secret」を押して作ります。
シークレットは、作った直後の1回しか表示されません。 閉じると二度と見られません。見失ったら作り直すだけなので、慌てなくて大丈夫です。
[スクリーンショット: 02_oauth-app作成.png] New OAuth App の入力画面(callback URL が見えるようにして)を撮ってください。
[スクリーンショット: 03_client-id発行.png] Client ID と Client secret が表示された画面を撮ってください。必ず両方を黒く塗りつぶしてから投稿してください。
⑥ シークレットを置く場所
.env に入れます。 GitHubにpushした回で .gitignore に .env を入れたのは、まさにこのためです。
DB_USER=appuser
DB_PASSWORD=(これまでのもの)
DB_NAME=appdb
SESSION_SECRET=(これまでのもの)
GITHUB_CLIENT_ID=(コピーしたClient ID)
GITHUB_CLIENT_SECRET=(コピーしたClient secret)
確認します。
.env が一覧に出てこなければ正しいです。出てきたら .gitignore を先に直してください。
漏れたと思ったら、すぐ Generate a new client secret を押します。 古いシークレットは即座に無効になります。 「たぶん大丈夫」で放置しない。 シークレットが漏れると、攻撃者があなたのアプリを名乗って同意画面を出せます。 利用者からは区別が付きません。
Client IDのほうは秘密ではありません。 リダイレクトURLに載るので、そもそも隠せません。
⑦ 既存の users とどう繋ぐか
ここが設計の山場です。 いまの users はこうなっています。
users(id, email, password_hash, created_at)
「github_id という列を足せばいい」と思うところですが、そうしません。
| やり方 | 困ること |
|---|---|
users に github_id 列を足す | Googleも足したくなったら google_id、次は line_id。 列が増え続ける |
users に provider と provider_id を足す | 1人が GitHub と Google の両方で入れなくなる(1行に1つしか持てない) |
| 別の表に分ける | 1人のユーザーに、外部アカウントを何個でもぶら下げられる |
3つ目にします。 sudo mysql で作ります(認証の回と同じ理由で、appuser には表を作る権限がありません)。
USE appdb;
CREATE TABLE identities (
id INT AUTO_INCREMENT PRIMARY KEY,
provider VARCHAR(32) NOT NULL,
provider_user_id VARCHAR(64) NOT NULL,
user_id INT NOT NULL,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
UNIQUE KEY uq_provider_user (provider, provider_user_id),
FOREIGN KEY (user_id) REFERENCES users(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
| 決めたこと | 理由 |
|---|---|
provider を文字列で持つ | 'github' 'google' と増やせる |
provider_user_id を VARCHAR | 数値とは限りません。 Googleの sub は長い文字列です |
UNIQUE (provider, provider_user_id) | 同じGitHubアカウントが2人のユーザーに紐づくのを、データベース側で防ぐ |
provider_user_id にユーザー名を使わない | GitHubのユーザー名は変更できます。 変えられた瞬間に別人になります。変わらないIDを使う |
そして users 側を緩めます。
ALTER TABLE users MODIFY email VARCHAR(255) NULL;
ALTER TABLE users MODIFY password_hash VARCHAR(255) NULL;
EXIT;
なぜ緩めるのか。 GitHubでログインした人には、パスワードが存在しません。 そしてメールアドレスも取れないことがあります(非公開設定の人がいます)。
NOT NULLのままだと、登録の瞬間に落ちます。
緩めたら、必ずログイン側を直します。 認証の回で書いた /api/login に、1行足します。
// bcrypt.compare の前に置く
if (!user || !user.password_hash) {
return res.status(401).json({ error: "メールアドレスかパスワードが違います" });
}
これを忘れると危険です。
password_hashが空のままbcrypt.compareに渡す形にしておくと、ライブラリや実装が変わったときに「空文字のパスワードで入れる」穴になり得ます。 「入れないはず」ではなく「明示的に弾く」。 認証の回と同じく、理由は返しません(どちらが違うか教えない)。
メールが同じなら同じ人、としてよいか
一番間違えやすいところです。
GitHubから a@example.com が返ってきた
→ users に a@example.com がある
→ 同じ人だ。そのアカウントにログインさせよう
これを無条件にやると、乗っ取られます。
攻撃者が、自分のGitHubアカウントのメールを a@example.com に設定するだけで、あなたのサイトの a@example.com としてログインできてしまいます。
最低限、こうします。
| やること | なぜ |
|---|---|
| プロバイダ側で「検証済み」のメールだけ見る | GitHubの /user/emails は verified を返します。verified: false は他人のメールを名乗れます |
| メールが取れなければ、繋がずに新規作成する | 推測で繋がない |
| (より安全に)繋ぐ前に本人に確認させる | 「既存のアカウントに連携しますか? パスワードを入力してください」と聞く |
この記事では「検証済みのメールなら繋ぐ」までを実装します。 実運用に出すなら、3つ目までやってください。
⑧ 書く
追加のパッケージは要りません。 Node.js 18 以降には fetch が入っています。
v18 以上であることを確認してください。
~/server/app.js に足します。上のほう(pool を作ったあたり)に定数を置きます。
const crypto = require("crypto");
const GITHUB_CLIENT_ID = process.env.GITHUB_CLIENT_ID;
const GITHUB_CLIENT_SECRET = process.env.GITHUB_CLIENT_SECRET;
const GITHUB_CALLBACK = "http://localhost:3000/auth/github/callback";
1. GitHubへ送り出す
app.get("/auth/github", (req, res) => {
// ⚠️ 使い捨てのランダムな文字列。あとで戻ってきたものと突き合わせる
const state = crypto.randomBytes(16).toString("hex");
req.session.oauthState = state;
const url = new URL("https://github.com/login/oauth/authorize");
url.searchParams.set("client_id", GITHUB_CLIENT_ID);
url.searchParams.set("redirect_uri", GITHUB_CALLBACK);
url.searchParams.set("scope", "read:user user:email");
url.searchParams.set("state", state);
// ⚠️ セッションを保存しきってからリダイレクトする
req.session.save(() => res.redirect(url.toString()));
});
| パラメータ | 意味 |
|---|---|
client_id | どのアプリか。 秘密ではない |
redirect_uri | どこへ戻すか。 OAuth Appに登録したものと完全一致が必要 |
scope | 何を許可してもらうか。 read:user はプロフィール読み取り、user:email はメール読み取り |
state | CSRF対策。 これが無いフローは壊れています |
scopeは最小にします。 ログインしたいだけならrepo(リポジトリの読み書き)は要りません。 同意画面には要求した範囲がそのまま出ます。 過大な要求は、利用者が同意を押さない理由になります。
なぜ
req.session.save()で囲むのか。express-sessionはセッションをデータベースに保存しています(認証の回でそうしました)。 保存が終わる前にリダイレクトが飛ぶと、GitHubから戻ってきたときにstateが入っていないことがあります。時々失敗する、という一番厄介な壊れ方をします。
2. 戻ってきたところを受ける
app.get("/auth/github/callback", async (req, res) => {
const { code, state } = req.query;
const expected = req.session.oauthState;
delete req.session.oauthState; // 一度使ったら捨てる
// ⚠️ ここが本体。省略しない
if (!expected || !state || state !== expected) {
return res.status(400).send("state が一致しません");
}
if (!code) {
return res.status(400).send("code がありません");
}
try {
// ① 認可コード → アクセストークン(サーバー ⇄ GitHub。ブラウザは通らない)
const tokenRes = await fetch("https://github.com/login/oauth/access_token", {
method: "POST",
headers: { "Content-Type": "application/json", Accept: "application/json" },
body: JSON.stringify({
client_id: GITHUB_CLIENT_ID,
client_secret: GITHUB_CLIENT_SECRET,
code,
redirect_uri: GITHUB_CALLBACK,
}),
});
const token = await tokenRes.json();
if (!token.access_token) {
console.error("token error:", token);
return res.status(502).send("トークンを取得できませんでした");
}
// ② トークンでユーザー情報を取る
const gh = {
Authorization: `Bearer ${token.access_token}`,
Accept: "application/vnd.github+json",
"User-Agent": "obmes-practice",
};
const me = await (await fetch("https://api.github.com/user", { headers: gh })).json();
const emails = await (await fetch("https://api.github.com/user/emails", { headers: gh })).json();
// ⚠️ 検証済みかつ主要なメールだけを使う
const primary = Array.isArray(emails)
? emails.find((e) => e.primary && e.verified)
: null;
const userId = await findOrCreateGithubUser(String(me.id), primary ? primary.email : null);
// ⚠️ セッションIDを作り直す(ログイン前のIDを使い回さない)
req.session.regenerate((err) => {
if (err) return res.status(500).send("セッションを作れませんでした");
req.session.userId = userId;
req.session.save(() => res.redirect("/me"));
});
} catch (e) {
console.error(e);
res.status(500).send("認証に失敗しました");
}
});
Accept: application/jsonを付けているのは、これを付けないと GitHub がJSONではなくクエリ文字列の形(access_token=...&scope=...)で返してくるためです。付け忘れるとtoken.access_tokenがundefinedになります。
User-Agentは GitHub API で必須です。付けないと拒否されます。
req.session.regenerateは、ログインの前後でセッションIDを変えるためのものです。 これをしないと、あらかじめ用意したセッションIDを他人に掴ませておく攻撃(セッション固定)が通ります。⑦のパスワードログインにも同じ処理を入れておくと、なおよいです。
3. ユーザーを見つける、または作る
async function findOrCreateGithubUser(providerUserId, email) {
// ① すでに紐づいていれば、それを使う
const [linked] = await pool.query(
"SELECT user_id FROM identities WHERE provider = 'github' AND provider_user_id = ?",
[providerUserId]
);
if (linked.length) return linked[0].user_id;
// ② 検証済みメールが既存ユーザーと一致するなら、そこへ繋ぐ
let userId = null;
if (email) {
const [same] = await pool.query("SELECT id FROM users WHERE email = ?", [email]);
if (same.length) userId = same[0].id;
}
// ③ どちらでもなければ、新しく作る(パスワードは持たせない)
if (userId === null) {
const [ins] = await pool.query(
"INSERT INTO users (email, password_hash) VALUES (?, NULL)",
[email]
);
userId = ins.insertId;
}
await pool.query(
"INSERT INTO identities (provider, provider_user_id, user_id) VALUES ('github', ?, ?)",
[providerUserId, userId]
);
return userId;
}
確認用のルートも足します。
app.get("/me", async (req, res) => {
if (!req.session.userId) return res.status(401).json({ error: "ログインしていません" });
const [rows] = await pool.query("SELECT id, email FROM users WHERE id = ?", [req.session.userId]);
res.json(rows[0]);
});
アクセストークンを保存していないことに気付いたでしょうか。 保存していません。 今回の用途は「誰かを知る」ことだけで、その後GitHubのAPIを叩く予定がないからです。使わないものは持たない。 持てば、漏れます。
⑨ 動かす
VMの中でアプリを起動します。
別のPowerShellウィンドウで、④のポート転送を張ったまま、Windowsのブラウザで開きます。
http://localhost:3000/auth/github
GitHubの同意画面が出れば、ここまで正しいです。
[スクリーンショット: 04_同意画面.png] GitHub の Authorize 画面(アプリ名と要求しているスコープが見えるように)を撮ってください。
Authorize を押すと /me に戻り、JSONが表示されます。
{"id":2,"email":"あなたのGitHubの主要メール"}
[スクリーンショット: 05_ログイン結果.png] /me が JSON を返している画面を撮ってください。メールアドレスは隠して構いません。
中身を確かめる
SELECT id, email, password_hash IS NULL AS no_password FROM users;
SELECT * FROM identities;
no_password が 1 の行ができていれば成功です。パスワードを一切預からずにログインできています。
[スクリーンショット: 06_テーブル確認.png] 上の2つのSELECTの結果を撮ってください。
state が効いているか確かめる
壊してみます。 ブラウザで直接開きます。
http://localhost:3000/auth/github/callback?code=dummy&state=dummy
state が一致しません と 400 が返れば、正しく守れています。 これが攻撃者が外から流し込んできたコードの姿です。
⑩ どこまでを OAuth に任せたか
整理します。
| これまで | 今回 |
|---|---|
| メールとパスワードを受け取る | GitHubへ送り出す |
bcrypt で照合する | GitHubが本人確認する |
| 合っていたらセッションを張る | 戻ってきたらセッションを張る |
変わったのは前半だけです。後半、つまり「セッションを張って以降を守る」部分は、そのまま残っています。
そして Cookieの3属性も、そのまま効いています。
sameSite: "strict"にしてはいけません。strictにすると、GitHubから戻ってきたリクエストにCookieが付かず、stateを保存したセッションを読めません。必ず「state が一致しません」で失敗します。laxなら、トップレベルのGET遷移ではCookieが付くので通ります。このためだけにstrictを避ける、という場面が実際にあります。
そして、いまのVMは
httpです。 認証の回と同じで、このまま外に出してはいけません。 外に出すときは https にして、secure: trueにし、OAuth App の callback URL もhttpsのものに登録し直します。
⑪ やりすぎない — 自前ログインで十分な場面
「これからは全部OAuthでいい」とはなりません。 移したものと同じだけ、新しく背負うものがあります。
| 背負うもの | 中身 |
|---|---|
| 相手が落ちたら、誰も入れない | あなたのサイトの可用性が、相手の可用性に縛られます |
| 利用者がアカウントを持っていない | 社内ツールや、技術者以外が使うサービスではGitHubを持っていない人のほうが多い |
| 相手がルールを変える | APIの仕様、スコープの粒度、料金。あなたの都合では決められません |
| 二重登録 | 同じ人がパスワードでも、GitHubでも登録して、アカウントが2つに割れる |
| 退会したあと | 相手側でアカウントを消されたとき、あなたの側のデータをどうするかを決める必要がある |
判断の目安です。
| 場面 | 選ぶもの |
|---|---|
| 開発者向けのサービス | GitHubログインは相性がよい。 利用者は全員持っている |
| 一般向けのサービス | Google などの OIDC。ただし自前ログインも残すのが普通 |
| 社内ツール | すでにある社内の認証基盤(あるなら)。無いなら自前で十分 |
| 学習用・小さな道具 | 自前で十分。 増やした分だけ壊れる箇所が増えます |
「両方用意する」が現実的な着地です。今回
identitiesを別表にしたのは、そのためでもあります。 1人のユーザーに、パスワードとGitHubとGoogleを何個でもぶら下げられる形になっています。
つまずいたところ
| 症状 | 原因と対処 |
|---|---|
redirect_uri_mismatch と出る | OAuth App の callback URL と、コードの GITHUB_CALLBACK が1文字違う。 末尾のスラッシュ、http/https、ポート番号を見る |
token.access_token が undefined | Accept: application/json を付け忘れている。 GitHubがクエリ文字列で返している。console.error(token) の中身を見る |
| GitHub API が 403 を返す | User-Agent ヘッダが無い。 GitHub API では必須 |
| 時々「state が一致しません」になる | req.session.save() を待たずにリダイレクトしている。 セッション保存とリダイレクトが競争している |
| 毎回「state が一致しません」になる | sameSite: "strict" になっている。 lax にする |
email が null で入る | GitHubでメールを非公開にしている、または user:email スコープを要求していない。 仕様どおりの動作。null を許す設計にしてある |
Column 'password_hash' cannot be null | ⑦の ALTER TABLE を流していない |
Windowsのブラウザで localhost:3000 が開かない | ポート転送のPowerShellを閉じている。 開いたままにする |
fetch is not defined | Node.js が18より古い。 node -v で確認する |
| ログアウトしても、また押すと同意画面なしで入れる | 正常です。 GitHub側の許可が残っているだけ。あなたのサイトのセッションは切れています |
後片づけ
OAuth App を消してください。 練習用に作ったものを残すと、シークレットを持ったアプリが放置されることになります。
Settings → Developer settings → OAuth Apps → 該当のアプリ → Delete application
GitHub側の「許可した記録」も消せます。 Settings → Applications → Authorized OAuth Apps から解除します。
[スクリーンショット: 07_oauth-app削除.png] OAuth App の削除確認画面を撮ってください。
.env からも消します。
GITHUB_CLIENT_ID と GITHUB_CLIENT_SECRET の行を消します。
ポート転送を止めます。 ④で開いたPowerShellで exit と打つか、ウィンドウを閉じます。
全部やり直したいとき。
DROP TABLE identities;
DELETE FROM users WHERE password_hash IS NULL;
~/server/とappdbは残してください。 ここまでで「外部のアカウントでも入れるAPI」ができています。
まとめ
- OAuth は認可(許可)の仕組みで、ログイン用ではない。 ログインに使うための拡張が OpenID Connect
- 「トークンが取れた=本人だ」は成り立たない。 そのトークンが目の前のブラウザの持ち主のものだという保証がどこにも無い
- OIDC の中心は
ID トークン(署名付きJWT)。iss/aud/expを検証して初めて「本人」と言える - GitHub は OIDC ではない。 OAuth をログインに流用する形なので、
stateの検証が必須 stateを検証しないと、攻撃者のGitHubを他人のブラウザのログインやアカウントに紐づけられる。 省略している解説が多いので注意- 認可コードフローを使う。 ブラウザに載るのはコードだけで、トークンはサーバーの中にしか存在しない
- 暗黙フローは使わない。 URLに載る・履歴に残る・アプリを名乗れない
- コールバックは「ブラウザへのリダイレクト指示」。 GitHubがあなたのサーバーに接続するわけではないので、NATの内側のVMでも
http://localhost:3000/...で足りる - ホストのブラウザからは SSH ポートフォワード(
ssh -L 3000:localhost:3000 ...)で見る sameSite: "strict"にするとコールバックでCookieが送られず、必ず失敗する。laxにする- 外部アカウントは別表(
identities)に持つ。usersにgithub_id列を足すと、増やすたびに列が増える - メールが同じというだけで既存アカウントに繋がない。 検証済みのメールだけを見る
- パスワードを持たないユーザーができる。
password_hashが空のときは明示的にログインを弾く - OAuth に移せば安全になるわけではない。 相手の障害・仕様変更・二重登録を新しく背負う。自前で十分な場面は多い
参考リンク
- roadmap.sh — Backend(Authentication の OAuth / OpenID の項目)
- GitHub Docs — Authorizing OAuth apps
- GitHub Docs — Scopes for OAuth apps
- RFC 6749 — The OAuth 2.0 Authorization Framework
- RFC 9700 — OAuth 2.0 Security Best Current Practice
- OpenID Connect — How Connect Works
- Googleの discovery document(OIDCの設定が全部書いてある実例)
- MDN — SameSite 属性
次に読む
この記事は 【第5段階】バックエンドとデータベース の 21 / 29 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | 9時間ずれるのは全部同じ理由 — 日付と時刻の扱い |
| → 次の記事 | 待たせるAPIをやめる — メッセージキューとRabbitMQ |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- OAuth(認可コードフロー)
- OpenID Connect(ID トークン)
- Token Authentication
- CSRF 対策(state の検証)
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント